Rule
Record what the session learned, not only what it changed.
This is the write half of the knowledge loop: capture the lesson so it survives the session. Getting it back into a future session is a different job — that's Factor X.
What AgentOps Enforces
- Capture decisions, traps, successful patterns, failed approaches, and commands that mattered.
- Separate durable lessons from temporary session noise.
- Promote reusable findings into repo-owned docs, memories, skills, or issues.
- Keep closeout short enough that future agents will actually read it.
Failure Signal
- The next session repeats the same investigation.
- A commit explains what changed but not why the shape is correct.
- Hard-won debugging knowledge disappears when the chat closes.
- Follow-up work depends on a human remembering the details.
Done Looks Like
A future agent can avoid at least one mistake because this session left a concrete lesson behind.