Imported from LPFchan/Aware (
AGENTS.md). Install upstream withnpx skills add LPFchan/Aware. Copyright stays with the author.
Agent Instructions
AGENTS.md is the canonical editable agent-instructions file. It enforces repo behavior while deferring canonical policy to records/REPO.md.
Read First
records/REPO.mdrecords/SPEC.mdrecords/STATUS.mdrecords/PLANS.mdrecords/INBOX.mdskills/README.md
Before writing into an artifact directory, read its README.md and follow its prescriptive shape when it defines one.
Skills
Load the skill before the trigger condition fires. Each skill defines the procedure; follow it.
| Trigger | Skill |
|---|---|
| Before creating a normal commit | skills/commit-generator/SKILL.md |
| Before replacing, deleting, or rewriting content that already exists | skills/clean-correction/SKILL.md |
| When routing work or creating repo artifacts | skills/repo-orchestrator/SKILL.md |
| When reviewing inbox pressure | skills/daily-inbox-pressure-review/SKILL.md |
| When reviewing upstream changes | skills/upstream-intake/SKILL.md |
Repo-agnostic skills (sharpen-the-tip, prototype-mode, housekeeping, proactive-docs) are global, not vendored per repo — they live in ~/.agents/skills/ via the agents module of LPFchan/setup, and your runtime surfaces them automatically.
Rules
- Keep durable truth in repo files, not only in external tools.
- Route work using the routing ladder in
records/REPO.md. - Preserve the boundary between
records/SPEC.md,records/STATUS.md,records/PLANS.md,records/INBOX.md,records/research/,records/decisions/, commit-backedLOG-*, andrecords/upstream-intake/. - Worker agents produce evidence, proposals, and compliant
LOG-*commits. The orchestrator or operator owns truth-doc updates unless the operator explicitly allows otherwise. - Treat
records/INBOX.mdas pressure, not a backlog. Cluster capture; promote only survived triage. - Promote sparsely. Do not mirror one thought into research, decisions, plans, spec, status, upstream, and execution records.
- Every normal commit must be created from a skeleton registered by
scripts/new-commit-message.shand must pass local and remote provenance checks. - Follow the stable-ID and provenance rules in
records/REPO.md. - Do not put
LOG-*ids insideartifacts:. - Do not invent a document shape when the repo already provides a canonical surface, directory
README.md, or template. - Do not promote exploratory debate into truth docs or decisions until there is a concise accepted outcome.
- Do not turn an inbox review into a digest of every low-confidence idea. Report counts or clusters.
- Do not write chatty transcripts where the repo expects normalized records.
- Do not bypass commit provenance checks unless the commit is an explicit bootstrap or migration exception.
Local Divergence
- Build verification:
xcodebuild -scheme Aware -configuration Debug -derivedDataPath build build - Commit provenance setup:
scripts/install-hooks.shconfigures the trackedcommit-msghook locally. - Commit provenance checks:
scripts/check-commit-standards.sh <commit-message-file>andscripts/check-commit-range.sh <base> <head> - There is no dedicated automated test suite in the repo today. For runtime changes, use the build plus focused manual validation.
- Preserve the product and workflow constraints in
SPEC.md: menu bar-only UX, local presence detection, no telemetry or analytics, and safe failure when camera access is denied or unavailable. AWARE-AGENT-PROMPT.mdis a legacy bootstrap helper. Do not treat it as a second policy layer.upstream-intake/is omitted in Aware because the repo does not currently track upstream review.