docs(agent): fix code-map GPS section; add intent-reality audit process

code-map.md:
- Correct the GPS gotcha section: DeviceGpsProvider uses LocationManager
  (not FusedLocationProviderClient) and is dead code — never instantiated
- Remove the false claim that MainViewModel shows a "No GPS" banner
- Document locationFlow replay=1 staleness behaviour accurately
- Document ACTION_STOP_UPDATES background-idle behaviour added in this session

config.md:
- Add review-intent-reality.md to the directory table
- Add two Living Documentation mandates: code-map accuracy obligation
  and intent-reality audit cadence

review-intent-reality.md (new):
- Structured audit prompt covering 6 categories: code-map vs implementation,
  dead code with documented intent, lying comments, architectural invariants,
  design-doc vs shipped code, worklog vs current state
- Standardised finding format (doc claim / code reality / severity / fix)
- Post-review commit convention

https://claude.ai/code/session_0126zvB69ccVoFtx2o96oaE2

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`.