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-savein 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/passingmust carryverified:orassumed:. Writer rejects untagged claims (exit 1).
Canonical source
Full contract in the Datarim repo: skills/session-handoff-writer/SKILL.md.