handoff

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?
disable-model-invocation	true

Handoff

Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS — not the current workspace.

Format

Use this structure:

# Handoff — [brief topic]

## What we're doing
[1-3 sentences on the goal and current state]

## Key decisions
- [Decision 1]
- [Decision 2]

## Where things are
- [path/to/file — what it contains]
- [URL to issue/PR/ADR]

## What's next
[Specific next step the next agent should take]

## Gotchas
- [Any surprises, constraints, or things to avoid]

## Suggested skills
- `skill-name` — why it's relevant

Rules

• Reference, don't duplicate. Point to specs, plans, ADRs, issues, commits, or diffs by path or URL instead of re-explaining them.
• Redact sensitive info. Strip API keys, passwords, tokens, and PII.
• Use the user's argument (if provided) as the focus for "What's next" and tailor the whole document toward that next session's goal.
• Save to $TMPDIR (or /tmp on Linux, $TMPDIR on macOS). Name the file handoff-<slug>.md.