---
name: handoff
description: Use when ending a session to create a handoff document so a fresh agent can continue the work
---

# handoff

audience: AI coding agents first. Imperative, BLUF.

Produce the prose handoff doc a fresh agent needs to continue.

## 1. Prose handoff doc (always)

Summarize the current conversation so a fresh agent can continue. Save to **OS temp dir** — NOT the workspace (it is ephemeral session scratch).
- Include a "suggested skills" section: which skills the next agent should invoke.
- **No duplicate content** from other artifacts (PRDs, plans, ADRs, specs, issues, commits, diffs). Reference by path/URL.
- User passed args → treat as the next session's focus; tailor the doc.

## 2. Factory runs

For factory work, include the `adw_id`, the request-spec path, and the last observed phase or result. The factory trace is the run record: inspect it on `/factory` or replay it with `factory watch <ADW_ID> --since-start`. A new launch always creates a new run.
