Handoff

Goal

Auto-generate a comprehensive handoff document that captures current work state, progress, and context. This supports the "Document & Clear" workflow for complex tasks - create a handoff document, /clear the session, then later resume by reading the handoff.

The document is written to the repository root by default, so it is next to the work it describes and you can commit it if you want to. Pass a path to put it anywhere else.

Because it lands in the working tree, it will show as untracked — which means a subsequent /verify may pull it into review scope and /create-pr may stage it. If you do not want to commit handoffs, add handoff-*.md to the repo's .gitignore, or pass a path outside the repository.

Input