Record index
handoff.index.toml
Handoffs, namespace HO, at
.working/toml/handoff.index.toml.
About
A handoff is the durable state snapshot a session resumes from: where the work stands, what
is in flight, what comes next. It is current until superseded, and
posting a new handoff supersedes the previous one in the same act, so at most one current
handoff exists.
Why
Sessions end, contexts truncate, and whatever lived only in conversation is gone. A records-first discipline resumes from the durable handoff rather than starting cold, and the single-current rule means there is never ambiguity about which snapshot is authoritative.
Description
The shared index shape with the standard envelope and no type-specific extra fields; the
handoff's content rides summary, links, and refs.
States: current (initial) to superseded (terminal).
How it works
Supersession is atomic with posting: the new handoff and the old one's terminal transition land together, and the current handoff never rotates to the archive. The chain of superseded handoffs remains a readable history of how the work's state evolved.
Generated view
HANDOFF.md, composed from this index, plus the optional
HANDOFF-INDEX.md mirror; both byte-drift-gated.
Value
Continuity across sessions and machines: resuming from the recorded handoff helps reduce cold-start reconstruction and helps prevent constraints and in-flight state from lapsing when a context is lost.
Usage
- Created by:
opf init(empty index); a new record at each session close or state checkpoint. - Updated by: supersession, in the same act as the next handoff's posting.
- Read by: session resume;
opf render(HANDOFF.md and the mirror);opf doctor(schema, the at-most-one-current invariant).