Handoff: Invoke

A handoff is a task the user parked earlier so they could stay focused on something else. Invoking one means: load it, give the user a solid orientation on what it is, and then continue together.

Step 1 — Resolve which handoff

Handoffs live in .handoffs/ in the project root, named handoff-NNNN.md.

• If .handoffs/ does not exist or is empty, tell the user there are no saved handoffs yet and mention they can create one with handoff-create. Stop there.
• If the user gave a number, open .handoffs/handoff-NNNN.md (zero-pad it).
• If they gave a topic instead of a number, scan the <handoff-summary> and title of each file and match the most likely one. If two or more are plausible, briefly list the candidates and ask which one.
• If the specific file does not exist, say so and list what is available.

Step 2 — Read it fully