| name | cc:handoff |
| description | Write ~/.claude/custom-handoff.md to hand off current work to the next session |
| disable-model-invocation | true |
| allowed-tools | Write, Bash(trash-put:*), Bash(git status:*), Bash(git log:*), Bash(git diff:*) |
Write ~/.claude/custom-handoff.md (resolve ~ to the user's home directory) summarizing current work so the next Claude session can pick up where this one left off.
Steps
- Run
trash-put ~/.claude/custom-handoff.md 2>/dev/null || true to remove any prior handoff (ignore error if file absent).
- Write fresh content per template. No merge, no preserve.
Template
# ORIGINAL PROMPT
<the user's opening prompt from this conversation, verbatim if short; otherwise a one-to-two-sentence summary that preserves the ask>
# GOAL
<one line: what we're doing now>
# DONE
- <thing done>
- <thing done>
# RECENT CONCLUSIONS
- <decision, agreement, or insight from last few turns — what shifted the plan>
- <open question raised at end, still unanswered>
# NEXT
<concrete next action — derived from RECENT CONCLUSIONS, not stale earlier intent>
# WATCH OUT
<gotchas; omit section if none>
Rules
- Terse, scannable, under 250 words total.
# ORIGINAL PROMPT anchors intent across sessions — do not drop it even if the work has drifted.- Weight the final turns heaviest. Conclusions, decisions, course corrections, and open questions from the last few messages drive
NEXT. Early-conversation context is backdrop, not the lead.
# RECENT CONCLUSIONS captures what was just decided or learned — not a re-summary of DONE. If the last turns only restated earlier work, leave it empty rather than padding.- If user and assistant disagreed or pivoted near the end, record the resolution (or that it's unresolved).
- Use file paths, not descriptions (e.g.
src/auth.ts:42, not "the auth file").
- No prose narration ("we decided to...").
- Omit
# WATCH OUT when there are no gotchas.
