Skip to content
~/agentops
← all factors
IIPREPARE

Track Everything in Git

Keep work state, decisions, and learnings in git.

Rule

Keep work state, decisions, learnings, and handoffs in git.

What AgentOps Enforces

  • Put issues, plans, session notes, validation evidence, and promoted learnings in repo-owned files.
  • Make every meaningful change diffable and reviewable.
  • Push finished work so the remote is the shared source of truth.
  • Avoid private dashboards as the only place where work state exists.

Failure Signal

  • A new agent needs credentials to five systems before it can see the project state.
  • A decision exists only in chat history.
  • The repo builds, but nobody can explain why the current shape was chosen.
  • 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.