Handoff

Maintains .docs/handoff.md as the project-local cold-start primer for the next coding agent or human developer. The file captures transient session state only: what changed, what was decided, what is blocked, and exactly how to resume.

Reference Files

File	Contents	Load When
`references/schema.md`	Verbatim handoff schema and line-budget rules	Always before writing
`references/authority-boundaries.md`	Boundary between handoff, memory, CLAUDE.md, plans, and git	Always before writing

When To Use

Use handoff	Use another surface
In-flight work, uncommitted edits, current branch, blockers, resume steps	`git log` for committed history
Session-scoped decisions and failed approaches	Memory or ADRs for durable project facts
Immediate validation state and exact next command	`CLAUDE.md` for stable setup instructions
Current roadmap cursor	Plan files for strategic roadmap content