handoff git:20261012.f7b3bf1A

Immutable. This exact content never changes and is served at /api/v1/blob/8515c7b3b9bd9b9a.

---
name: handoff
description: Write a handoff note so a fresh session can continue this one's work. Use when the user says to hand off, wrap up, or save progress for later, or when a long session is about to end with work still open.
argument-hint: 'What the next session will focus on'
disable-model-invocation: true
---

# Handoff

Write a note that lets a session with no memory of this one carry on without asking what happened.

## Where

Save it to `~/.claude/handoffs/<project-folder-name>/<YYYY-MM-DD>-<topic>.md`, the topic in two to four kebab-case words. Keep it outside the repository so it never lands in a commit, and outside any session scratch directory, which the next session cannot see. Tell the user the path.

## What goes in it, in this order

1. **Goal**: one or two sentences on what the work is for.
2. **State**: what is done, and how each "done" was verified (the command and its result, the PR, the commit).
3. **Decisions**: what was decided and why, so the next session does not reopen it.
4. **Open questions**: what is still undecided, and who decides it.
5. **Next steps**: in order, each one concrete enough to start on.
6. **Useful skills and agents**: which ones fit the next steps.

Put Goal and State first; tools that preview a handoff often show only its opening.

## Rules

- Point to issues, PRs, commits and files by number, hash or path. Do not copy their content in.
- Leave out secrets: API keys, tokens, webhook URLs, passwords, personal data.
- If the user passed an argument, shape the note around that focus.