Rule
The repository is the ground truth. Work state, decisions, evidence, and learnings live in git; everything else (sessions, terminals, task lists, dashboards) is a projection that dies with its host.
Sessions are disposable. A terminal closes, a context window compacts, a host reboots, and whatever lived only there is gone. The store survives because it is files in a repo: diffable, reviewable, cloneable by the next agent.
Put It to Work
- Put issues, plans, session notes, validation evidence, and promoted learnings in repo-owned files.
- Treat in-memory task lists and live sessions as views over the store, never as the store.
- Make every meaningful change diffable and reviewable.
- Push finished work so the remote is the shared source of truth.
Failure Signal
- A decision exists only in chat history.
- Ending a session loses work state that no file records.
- A new agent needs credentials to five systems before it can see the project state.
- A handoff says "check my notes" instead of pointing to committed files.
Done Looks Like
A fresh clone contains the work, the issue state, the evidence, and enough history for the next agent to continue, with every live surface reconstructable from it.