Handoff Resume

---
name: handoff-resume
description: Load a handoff document and resume work from where a previous session left off. Parses scope, file references, completed work, and next steps, then confirms understanding before proceeding.
argument-hint: <handoff-file-path>
effort: low
disable-model-invocation: true
---

Read and load the handoff document at `$ARGUMENTS[0]`.

## Steps

1. **Read the file** at the provided path. If the path does not exist, list files in `claudedocs/handoffs/` and ask the user which one to load.

2. **Parse and confirm**:
   - Task and scope
   - Files involved (with line numbers)
   - Key discoveries
   - Work completed so far
   - Current status
   - Next steps (ordered)

3. **Confirm understanding**: Summarize what you have loaded in 3-5 bullet points. Ask: "Should I proceed with the next step, or do you want to adjust the plan first?"

4. **Do not start working** until the user confirms. The confirmation step is mandatory.

## Notes

- If the handoff file references commits (`commit: abc1234`), note them but do not re-run the work.
- If next steps are unclear or conflicting, flag it before proceeding.
- The "Work Done" section is the authoritative record of what has been completed. Trust it.