cw-handoff

A handoff is read by an agent with none of your context and every incentive to believe you. That makes an optimistic handoff worse than no handoff: it converts your guesses into the next session's premises. Write it so the reader can re-derive the state instead of trusting the prose.

Stage 6 of the loop, and the one that makes the loop a loop: the next session starts at cw-orient with what you leave here.

When to use

• Ending a session with work in flight.
• Asked for "a prompt for another agent", takeover instructions, a continuation note, or a summary of current state for async work.
• Handing work to a different model, a fleet worker, or a remote session.

Workflow

1. Write it as a prompt the next agent can paste directly. Not a report about the work, instructions for continuing it.

2. Open with the refresh block, not with your summary. The first thing the reader should do is verify you:

   cd <repo path>
   git status --short --branch && git branch --show-current
   git log --oneline --decorate -20
   git log --oneline origin/main..HEAD
   ./scripts/release/check-versions.sh
   

   Tell them to trust that output over anything below it.