rc-codemaplisted

# Codemap Maintain a hierarchical, per-directory map of the repository so every exploration-heavy task starts from a written summary instead of re-scanning source. Each significant directory gets a `codemap.md`; a root `codemap.md` links them. Regeneration is **incremental** — only directories that changed since the last run are rebuilt. ## Store & staleness - Maps live as `codemap.md` inside each mapped directory (committed alongside the code). - State lives at `.rc/codemap/last-commit` (the git SHA at the last generation). - `scripts/stale.sh [root]` prints the directories that changed since that SHA — or every directory when there is no state yet (first build). `scripts/stale.sh --record [root]` records the current HEAD after a successful generation. Both **fail open**: on any git problem they behave as if everything is stale, which is safe. ## Workflow 1. **Scope.** Run `scripts/stale.sh` to get the stale directories. If it returns everything, you're doing a first full build. 2. **Regenerate stale maps.** For each stale directory — skipping vendored/generated dirs (`.git`, `node_modules`, `vendor`, build output, fixtures) — read its files enough to summarize, then (re)write its `codemap.md` with: the directory's responsibility, its key files and their roles, notable patterns, and how it connects to sibling directories. Anchor claims to real paths. 3. **Update the index.** Refresh the root `codemap.md` so it links every directory map. 4. **Record