Update an existing handoff document with current session progress. Applies section-specific merge rules: append-only for Work Done (never deletes history), replace for Status and Next Steps, merge for Files and Discoveries. Falls back to creating a new handoff if no source file is found.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
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 | Preserve exclusions, acceptance, authorization, and ownership; record a new contract revision for material changes |
| Files | Merge | Add new files touched in this session. Keep originals. Use paths and symbols; include lines only when verified at the recorded revision |
| 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 | Record the observed revision and time, checks and their scope, blockers, and next owner; distinguish task, run, and acceptance state |
| 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 records prior claims; live evidence determines what is currently true. Append a correction with its evidence instead of removing the old entry.
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).
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Audit Claude Code agents, skills, and commands for quality and production readiness. Use when evaluating skill quality, checking production readiness scores, or comparing agents against best-practice templates.
The English summary is being prepared. Showing the original description.
Codebase health audit scoring 7 categories with progression plan
The English summary is being prepared. Showing the original description.
Autonomous improvement loop: scan codebase metrics, scaffold experiment files, run agent-driven iterations until metric improves
The English summary is being prepared. Showing the original description.
Generate bounded independent candidates, score them against a frozen rubric, and verify the selected result with a proof log.
The English summary is being prepared. Showing the original description.
Post-deploy monitoring: watch production after a deploy and alert on regressions
The English summary is being prepared. Showing the original description.
Restore context after /clear by summarizing recent work and project state
The English summary is being prepared. Showing the original description.