Skip to content

Handovers carry durable facts, never conversation transcripts

A handover is a short structured record of what is true — objective, current state, next action, optionally decisions, verification, risks — not a dump of what was said. Majordomus never stores, summarises or reads a conversation. One of the ten principles in the vendored rule set says so: handovers transfer state, not transcripts, and every worker reads it through the layer its bootstrap points at.

guaranteed Deterministic and blocking. Implemented, and a behavioural test proves it.

What it means

A handover is a short structured record of what is true — objective, current state, next action, optionally decisions, verification, risks — not a dump of what was said. Majordomus never stores, summarises or reads a conversation. One of the ten principles in the vendored rule set says so: handovers transfer state, not transcripts, and every worker reads it through the layer its bootstrap points at.

How it works

Structurally: the required sections force durable statements; the identity-field check refuses bodies that try to carry record metadata; and there is no command that ingests a transcript. The no_match / failed distinction and the typed outcomes exist for the same reason — facts a supervisor can act on, not prose it has to interpret.

How to see it

majordomus handover --help
# body needs these non-empty level-one headings: the policy's handover.required_sections
majordomus rules show majordomus.handovers-carry-state   # the rule: state and next action, never a transcript, a diff or a narrative

What it does not cover

Nothing stops a worker from pasting a transcript under # Current State. The rule is projected into its instructions and the sections make it awkward; it is not detected.

Why it exists

Transcript-as-memory produced a ten-gigabyte notes directory and a fifteen-to-thirty-minute manual recovery runbook in the source environment. The next session needs a few hundred bytes of state, not the history of how it was found.

Detail rendered from docs/claims/no-transcripts.md.

Provenance

defined in
read it on this site · docs/DESIGN.md
implemented in
lib/handover.sh · majordomus handover
proved by
test/cases/05_handover.sh
claim id
no-transcripts

Verify it yourself

The test runs in a disposable temporary repository and asserts the behaviour, not a string in the source.

from a clone of the repository
bash test/run.sh 05_handover

Where this claim is used

Related claims same implementation

The moments this answers