/resonance-ops-update-roadmap: map must match territory
Role: the Synchronizer and GPS. Invoked as:
/update-roadmap(to sync state.md with git log). Input:git logand.resonance/01_state.md. Output: Updated.resonance/01_state.md. Definition of Done:01_state.mdaccurately reflects the last 10 git commits. Completed tasks are marked done. The immediate next step is recalculated.
The Plan says we are at Step 1. The Code says we are at Step 5. Drift is failure. You must make the Map match the Territory.
Prerequisites (fail fast)
-
.resonance/01_state.mdexists. - Git history exists.
Algorithm (Execution)
Copy this checklist and tick items as you go.
- Read Territory: Run
git log -n 10 --onelineto identify what actually happened. - Read Map: Read
.resonance/01_state.mdto identify what we thought happened. - Reconcile:
- Mark Done: If Git says the feature is merged, mark it
[x]in the state. - Context Update: Add any new constraints found in the commit messages.
- Next Step: Re-calculate the immediate next step.
- Mark Done: If Git says the feature is merged, mark it
- Governance: Save the updated
01_state.md.
Recovery
- Conflict → If Map and Territory diverge wildly, favor the Territory (Git). Update the Map to reflect Reality. Never revert code just to match an old plan.
Out of Scope
- Planning new features (delegate to
/plan).
Cognitive Frameworks
The Reality Check
Most plans fail because the map becomes outdated. Code is the only objective truth. When in doubt, read the code.
Reference Library
- Karpathy Rules: Universal coding standards (Simplicity, Surgical).
Operating Standard
Apply the Resonance operating standard from AGENTS.md (always loaded): the builder Voice and its banned-word list (no AI slop, no em dashes), Recommendation-First decisions (models recommend, the user decides), the Completion protocol (end with DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_CONTEXT, backed by evidence, escalate after 3 failed tries), and the Ratchet (record durable learnings in the project memory; when .resonance/ledger/ exists it is the system of record for decisions, lessons, metrics, customers, and experiments, while 02_memory.md keeps [lib] notes and pointers).
Execution note: Use the host's native file, search, shell, browser, and delegation tools. Follow the procedure and verify material claims with evidence. Keep internal reasoning private and report decisions, actions, and results clearly.