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.
What AgentOps Enforces
- 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.