Hand Off

Compact this conversation into a document a fresh agent can resume from. Write it to the OS temp directory ($TMPDIR, falling back to /tmp; %TEMP% on Windows), never into the workspace — a handoff is session ephemera, not a project artifact. Name it handoff-<topic>-<timestamp>.md and tell the user the absolute path.

If the user passed an argument to this skill, treat it as what the next session will focus on and orient the whole document around that focus — trim anything the focus makes irrelevant.

Contents

• Goal — what the work is ultimately for, in the user's terms.
• Current state — what is done, what is in flight, exact branch/worktree, whether the working tree is dirty.
• Tried and rejected — every approach that was attempted or considered and dropped, each with why. This section saves the successor from re-walking dead ends; it is usually the most valuable one.
• Knowns / unknowns (when present) — path to the latest knowns inventory and a one-line summary of what it locks, what it leaves open, and which blindspots are still unresolved; point at .skills/*-knowns.md or .skills/*-scan.md Blindspot when those files exist.
• Deviations (when present) — path to .skills/implementation-notes.md and a one-line summary of each logged deviation; the successor must not rediscover them from chat memory.
• Next actions — concrete, ordered, starting with the very next command or edit.
• Suggested skills — which skills of this set the successor should invoke, and at which step (e.g. "resume execute-plan at task 4", "run verify before claiming task 3 done"). Name /comprehend-change for the user when a multi-task branch is ready for author self-check before merge, and /explain-change when a team-shared pitch+map under docs/explainers/ would help reviewers on a large or architecture-affecting change (user-invoked — do not auto-invoke either).
• Team context (when present) — if docs/agents/project.md has ## Team with a non-empty roster or band override, one line: band + how packaging applies; Small/Multi: if the roster or ownership notes name an owner for this work, state who owns the next actions; if they do not, omit the owner line. Missing Team → omit the whole section (do not invent a team).

Rules