Skill Utility

Session Handoff Writer

Producer contract for /dr-save — writes self-contained session artefacts with append-only semantics, per-layer cap, and claim-provenance enforcement.

Overview

The session-handoff-writer skill is the producer side of the cross-runtime session handoff system. It is loaded by /dr-save and instructs the agent that the session will be destroyed — so everything needed to resume must be captured now.

Key Concepts

  • Producer-awareness clause — the session WILL be destroyed; capture git state, task status, related files, open questions, and failed approaches.
  • 5-layer body — Layer 1 (git state, non-truncatable), Layer 2 (active tasks), Layer 3 (related files), Layer 4 (open questions), Layer 5 (failed approaches, non-truncatable).
  • Append-only semantics — a second /dr-save in the same session appends a new block; prior blocks are never truncated.
  • 32 KB cap — Layer-1 and Layer-5 are protected from truncation; Layer-3/4 truncated first if the body exceeds the budget.
  • Claim provenance — every line with pushed/merged/deployed/green/passing must carry verified: or assumed:. Writer rejects untagged claims (exit 1).

Canonical source

Full contract in the Datarim repo: skills/session-handoff-writer/SKILL.md.