handoff-writer
Write a compact HANDOFF.md snapshot to restore context after session resets.
When & Why to Use This Skill
The Handoff Writer skill is a specialized utility designed to maintain workflow continuity for AI agents by generating compact, high-signal state snapshots. By documenting active tasks, current status, and next actions into a HANDOFF.md file, it ensures that critical project context is preserved and easily restorable after session resets or during long-running development cycles.
Use Cases
- Session Continuity: Automatically restore project state and context after a chat timeout or session reset to avoid re-explaining tasks to the AI.
- Workflow Handoff: Create a standardized summary of progress and pending actions when transitioning a project between different AI agents or human collaborators.
- Milestone Tracking: Document major development milestones, including last-run verification commands and outcomes, to maintain a clear audit trail of the project's evolution.
- Context Optimization: Reduce token usage in long conversations by summarizing extensive history into a concise, high-signal snapshot for future reference.
| name | handoff_writer |
|---|---|
| description | Write a compact HANDOFF.md snapshot to restore context after session resets. |
| short-description | Write handoff snapshot |
Purpose
Create a short, high-signal state snapshot that survives long runs and chat resets.
Steps
- Summarize the active task, current status, and next actions.
- Link to
PLANS.md,AUTO_CONTEXT.md, relevant files, and ADRs. - Record last verification commands and outcomes.
- Keep it concise and update it at major milestones.
Output
- Update
.agent-docs/memory/HANDOFF.md.
Guardrails
- Do not include secrets or sensitive data.
- Prefer links and file paths over large pasted content.