Persist decisions
A chat can explain why a decision was made, but it is not a dependable handoff mechanism. Record the decision where planning and implementation can trace back to it.
Answer page
Store durable intent, scope, validation, decisions, and implementation evidence in repository artifacts instead of relying on remembered chat context.
Direct answer
Prevent context drift by treating the repository as the source of truth. Keep specifications, task definitions, implementation summaries, unresolved items, and reconciliation in versioned files that every new session can read before changing code.
Practical guidance
A chat can explain why a decision was made, but it is not a dependable handoff mechanism. Record the decision where planning and implementation can trace back to it.
A new agent should be able to locate the current task, planned scope, and acceptance boundary without asking a previous session to summarize from memory.
A written implementation summary and milestone review make any remaining ambiguity visible before it becomes the next session's hidden assumption.
Verified demo evidence
Repository-writing command
Prompt: "Register a canonical specification entry for this request."
outcome: Registered specification: tic-tac-toe-demoAuthorship and sources
Keep exploring
What belongs in versioned repository artifacts when coding assistants do the implementation work.
Read nextA concrete view of the repository artifacts that make human-agent implementation work traceable and reviewable.
Read nextCoordinate multiple agents through task boundaries, dependencies, and shared repository evidence.
Read nextFind your answer
Search practical answer pages and product context, then follow each result to the canonical workflow or reference owner.
Search by a problem, workflow step, or tool boundary, or choose a filter.