# Handoff

> Create a continuation brief for a real agent, runtime, machine, parallel-lane, or context-window boundary. Use when the user clearly asks to hand work to another agent or make it resumable across a named boundary. Do not infer handoff from casual closeout or use it as a substitute for current workstream state.

- Skill: `aylee/handoff` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add aylee/handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aylee/handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: aylee (https://skillmd.com/u/aylee)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aylee/handoff

---


# Handoff

The linked `WORKSTREAM.md` must remain independently resumable. A handoff is optional acceleration for a specific boundary.

1. Read `docs/state-protocol.md`, `library/templates/handoff.md`, the canonical workstream, and its referenced artifacts. Reconcile stale facts in the workstream before composing the handoff.
2. Copy the template exactly. Preserve its required frontmatter names: `schema_version`, `handoff_id`, `workstream_id`, `base_revision`, `created_at`, `created_by_runtime`, and `target`.
3. Create a uniquely named file under `state/handoffs/<workstream-id>/` using UTC time and a `handoff-<uuid>` ID.
4. Preserve the template's section names and order: Boundary, Base Snapshot, Boundary Delta, Artifact References, Risks and Approvals, Suggested Skills, and Receiver First Action. Base Snapshot must name the workspace-relative workstream path, literal `workstream_id`, and exact `base_revision`.
5. Keep Boundary Delta limited to transfer-specific context. Reference durable artifacts instead of copying current truth, open decisions, verification, or the workstream's next action. Exclude transcripts, hidden prompts, credentials, personal integration URLs, hostnames, and absolute paths.
6. Never mutate the handoff into a receipt. A receiving agent may create a separate `consume-handoff` receipt.

If there is no real boundary, update the workstream and decline to create handoff theater.