| name | handoff |
| description | Wrap up a work session so the next session (or another agent) can pick up cleanly — what was done, what's in flight, what to watch out for. Use when ending a session, switching tasks, or asked to hand off, wrap up, or save state for later. |
Handoff
Goal: leave the project state recorded so the next session starts from catch-up, not from scratch. The end-of-session counterpart to catch-up.
- Snapshot what changed —
git_context for the modified/uncommitted files and recent commits, so the handoff names the exact files touched this session.
- Record caveats —
annotate any fragile spot, constraint, race, or workaround you discovered or introduced this session, on the file it lives in; get_annotations on the touched files to confirm earlier notes still hold (delete_annotation ones a fix made stale).
- Record the decision & next step —
create_checkpoint (type handoff) with what was done, which files changed, why, and the concrete next action. Keep the summary tight (it has a length cap). If the session was a dead end or a direction change, say so and why.
Finish: a short handoff note — done / in flight / next step / open caveats — each with a file:line or checkpoint reference, so a fresh session can resume without re-deriving context.
