handoff-writer

Write a compact HANDOFF.md snapshot to restore context after session resets.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025⬇️1downloads

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.
namehandoff_writer
descriptionWrite a compact HANDOFF.md snapshot to restore context after session resets.
short-descriptionWrite handoff snapshot

Purpose

Create a short, high-signal state snapshot that survives long runs and chat resets.

Steps

  1. Summarize the active task, current status, and next actions.
  2. Link to PLANS.md, AUTO_CONTEXT.md, relevant files, and ADRs.
  3. Record last verification commands and outcomes.
  4. 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.