diff options
Diffstat (limited to '.agent/config.md')
| -rw-r--r-- | .agent/config.md | 3 |
1 files changed, 3 insertions, 0 deletions
diff --git a/.agent/config.md b/.agent/config.md index 56d9df5..376cd89 100644 --- a/.agent/config.md +++ b/.agent/config.md @@ -14,6 +14,7 @@ This is the primary source of truth for all AI agents working on **Nav**. These | `mission.md` | **Mission & Values** — Strategic goals and agent personality. | | `narrative.md` | **Background** — Historical context and evolution of the project. | | `preferences.md` | **User Prefs** — Living record of user-specific likes/dislikes. | +| `review-intent-reality.md` | **Audit Prompt** — Structured review to find gaps between documented intent and implemented reality. Run after major merges or when a regression reveals a code-map error. | ## 2. Branch Policy — MANDATORY SESSION START ACTION @@ -48,3 +49,5 @@ The repo ships a pre-commit hook in `scripts/git-hooks/pre-commit` that hard-blo 1. **Continuous Capture:** Agents MUST proactively update the files in ".agent/" as new decisions, patterns, or user preferences are revealed. 2. **No Stale Instructions:** If a workflow or technical standard evolves, the agent is responsible for reflecting that change in the Master Rulebook immediately. 3. **Worklog Integrity:** The ".agent/worklog.md" must be updated at the start and end of EVERY session. +4. **Code-Map Accuracy:** `code-map.md` must describe what the code **does**, not what was intended. If a refactor changes a class's role, removes a feature, or leaves dead code, update `code-map.md` in the same commit. Never leave a known-wrong entry — a wrong code-map is worse than no code-map. +5. **Intent-Reality Audit:** After any significant merge or refactor, check whether existing code-map entries, comments, and `design.md` still reflect reality. When they don't, fix them immediately. For a full audit, run the prompt in `review-intent-reality.md`. |