---
name: handoff
description: Write or update a HANDOFF.md so a fresh agent can continue this work. Use when the user says "handoff", "compact this", "context is full", or "/clear and continue".
---

Write or update a handoff document so the next agent with fresh context can continue.

## Steps

1. If `HANDOFF.md` exists in the project root, read it first.
2. Do not duplicate content already in PRDs, plans, ADRs, issues, commits, or diffs — reference them by path or URL.
3. Write or update `HANDOFF.md` in the project root with:
   - **Goal** — what we're trying to accomplish
   - **Current Progress** — what's done (link commits/PRs)
   - **In flight** — running or cut work, if any: run id and resume command, branch or worktree, uncommitted paths and their owner, submitted remote jobs
   - **What Worked** — approaches that succeeded
   - **What Didn't Work** — dead ends, so they aren't retried
   - **Next Steps** — concrete action items
   - **Suggested skills** — which skills the next session should load, if any
4. If the user passed arguments, tailor the doc to that focus.
5. Tell the user the path so they can start a fresh conversation with it.