handoff-archival

What problem does it solve?

Archive consumed handoffs by moving files older than 48 hours from tasks/handoffs/ to archive/handoffs/ and checks .gitignore safety. This skill should be used when cleaning up old handoffs, when the handoffs directory is cluttered, or as part of periodic maintenance. Invoked by /update-docs (Phase 8) or standalone.

Core Features & Use Cases

• Chain-aware archival (supersession pass): Before the time-based sweep, scan all active handoffs for Continuing from references; if the referenced predecessor file is still in tasks/handoffs/, archive it immediately — the successor has absorbed both the predecessor's context (via the preamble) and its unresolved obligations (via the ## Carried Forward section). The predecessor is fully superseded. This pass runs regardless of age.
• Move old handoffs to archive: Any handoff in tasks/handoffs/ older than 48 hours is a candidate for archival. Before moving, apply the branch-activity check:
• The 48-hour window ensures multi-session work retains its handoff context — /session-start no longer archives on read, so this is the only archival path. Still concurrent-agent-safe.
• Do NOT delete archived handoffs — they are the paper trail for why things are written the way they are.

Quick Start

Run the handoff-archival skill via /update-docs (Phase 8) or schedule a maintenance job to clean up old handoffs.