<feed xmlns='http://www.w3.org/2005/Atom'>
<title>nav.git/.agent/review-intent-reality.md, branch main</title>
<subtitle>nav — android navigation app
</subtitle>
<id>https://git.terst.org/nav.git/atom?h=main</id>
<link rel='self' href='https://git.terst.org/nav.git/atom?h=main'/>
<link rel='alternate' type='text/html' href='https://git.terst.org/nav.git/'/>
<updated>2026-06-05T00:09:44+00:00</updated>
<entry>
<title>docs(agent): fix code-map GPS section; add intent-reality audit process</title>
<updated>2026-06-05T00:09:44+00:00</updated>
<author>
<name>Claude</name>
<email>noreply@anthropic.com</email>
</author>
<published>2026-06-05T00:09:44+00:00</published>
<link rel='alternate' type='text/html' href='https://git.terst.org/nav.git/commit/?id=bc8382014a8cd8cf781a95714b2b18f4920e2dce'/>
<id>urn:sha1:bc8382014a8cd8cf781a95714b2b18f4920e2dce</id>
<content type='text'>
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
</content>
</entry>
</feed>
