Work Handoff (Cross-Tool)

No AI coding tool can read another's transcript — each locks its session in a proprietary .jsonl, SQLite DB, or encrypted .pb. The only portable thing is a self-contained handoff document. This skill assembles SpecWeave's durable on-disk state (active increment, task/AC progress, decisions, ambient rules) plus a full diff of your uncommitted edits into one document that any other tool can read to pick up exactly where you left off.

This skill is the Claude Code surface of the cross-tool handoff feature. It is intentionally thin: the deterministic engine is the specweave handoff CLI subcommand. The same engine backs the PreCompact auto-handoff hook and the vskill handoff skill that carries this capability to other tools — so a handoff written here is continuable in Codex/OpenCode/Gemini/Cursor unchanged.

When to use

• Low on subscription tokens — hand off and continue in another tool's free or separate quota.
• Want a durable artifact in case the session dies at context exhaustion.
• Moving to another machine — use --inline so the full doc travels inside the paste-prompt.

Workflow

1. Run the CLI, forwarding any short context the agent can supply cheaply:

   specweave handoff [incrementId] [--reason ...] [--summary ...] [--next ...] [--gotcha ...] [--decision ...] [--inline]