handoff

# 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 | ## Triggers - Direct commands: `/handoff`, `/handoff init` - Refresh phrases: "update handoff", "session handoff", "refresh handoff", "save handoff" - Resume phrases: "cold-start primer", "resume checklist", "handoff to next session" - Stop hook: refresh silently when `.docs/handoff.md` already exists ## Prerequisites - `git` available in the project root. - Project write access for `.docs/handoff.md`. - Optional project-local marker files: - `.docs/handoff.last-validation` containing the last veri...