Goal: capture enough state that the next worker continues immediately.
Use for:
- ending a session with work in progress
- passing a task to another agent or teammate
- checkpointing before a risky or long-running step
Workflow:
- State the goal and current status in two sentences.
- List what is done and verified, with evidence.
- List what remains, in priority order.
- Record key decisions and the reasons behind them.
- Note blockers, open questions, and known risks.
- Point to the exact files, branches, and commands involved.
Handoff contents:
- objective and acceptance criteria
- done vs. remaining
- decisions and rejected alternatives
- blockers and next concrete action
Rules:
- write for someone with zero prior context
- link specifics, not vague references
- separate verified facts from assumptions
- make the very next step unambiguous