| name | handoff |
| description | Compact the current conversation into a handoff document for another agent to pick up. |
| argument-hint | What will the next session be used for? |
Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it under the workspace's .scratch/ directory (create it if it does not exist) — prefer the relevant feature subdirectory .scratch/<feature-slug>/ when the work maps to one, otherwise .scratch/handoffs/. .scratch/ is gitignored/local-only, so the handoff stays out of version control.
Before writing, list existing *.md files in the target folder to determine the next index: find the highest leading numeric index (e.g. 03- → next is 04), defaulting to 01 if none exist. Name the file MM-DD_<N>_<slug>.md (e.g. 06-25_02_evaluate-refine-loop.md) so multiple handoffs in the same folder sort chronologically then by creation order within the same day.
Open the document with a Created: timestamp on the first line (e.g. Created: 2026-06-25 14:32) so the exact creation time is visible without inspecting file metadata.
Include a "suggested skills" section in the document, which suggests skills that the agent should invoke.
Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
Redact any sensitive information, such as API keys, passwords, or personally identifiable information.
If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.