Update an existing handoff document with this session's progress.
Determine which file to update, in this priority order:
$ARGUMENTS[0] was provided, use it as the file path./handoff:resume, look in conversation history for the argument that was passed to it.claudedocs/handoffs/handoff_YYYYMMDD_HHMMSS.md. Inform the user that no existing handoff was found.Read the resolved file completely. Parse all sections as the baseline for the merge.
Rewrite the file with updated content using these merge rules:
| Section | Rule | Notes |
|---|---|---|
| Task | Keep original | Update only if scope fundamentally changed |
| Scope | Keep or refine | Narrow it if new understanding emerged |
| Files | Merge | Add new files touched in this session. Keep originals. Use path:line format |
| Discoveries | Append | Add new findings below existing list. Never remove prior discoveries |
| Work Done | Append only | Add new completed items below existing list. Never remove entries. Include commit hashes |
| Status | Replace | Write the current state: what is done now, what remains, test status |
| Next Steps | Replace | Write the updated actionable checklist |
| Code | Update | Replace with the most relevant snippets from the current state |
The append-only rule for Work Done is strict. Even if a previous entry describes work that was later revised, keep it. The history is the record. Add a new entry describing the revision instead of removing the old one.
After saving, confirm:
This command implements the Handoff Triad pattern documented in this guide's Session Handoff Pattern section. Template inspired by Packmind's handoff commands (Apache 2.0).