Handoff

Flags

--resume <path>

--path <path>

<path>

--resume

--path

--resume

--path

--resume

--path

Handoffs directory

• Root:

  ./handoffs/

• Naming:

  ./handoffs/handoff-<YYYY-MM-DD-HHmmss>.md

--path <path>

Workflow A: Create (default, no

--resume

)

1. Resolve the save path:

   --path

   if given, else

   <anchor>/handoffs/handoff-<timestamp>.md

   . Create

   ./handoffs/

   if absent.
2. Survey artifacts from the workspace and conversation, plans, PRDs, ADRs, issues, PRs, commits, diffs. You will reference them by path or URL, never paste their contents.
3. Write the doc using the format in

   ./REFERENCE.md

   . Keep it readable by a fresh agent in under two minutes.
4. Redact API keys, tokens, passwords, and PII.
5. If a positional arg was passed, add

   ## Next session focus

   at the top and frame open tasks and suggested skills around it.
6. Report the save path, a one-line capture summary, and the resume command:

   /handoff --resume <path>

   .

Workflow B: Resume (

--resume <path>

)

1. Read the file. If absent, stop: "Handoff file not found at

   <path>

   ."
2. Summarize context, progress, key decisions, prioritized open tasks, and blockers for the user.
3. If a positional arg was also passed, treat it as the narrowed focus.
4. From

   ## Suggested skills

   , list each skill with its rationale and offer to invoke the ones relevant to the focus.
5. Continue from the open tasks, referencing artifacts by path or URL rather than re-deriving captured content.

Constraints

• Redact sensitive values before saving.
• When resuming, never write a new handoff unless the user explicitly asks.