Skip to content

A handover is a state record, not a transcript - its required sections must be present and non-empty, a placeholder body is refused, and its identity is computed and refused when written into the body; a transcript pasted into a section is not detected

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.

declared statusdeclared status: guaranteed Declared deterministic and blocking, implemented, and naming the behavioural test that is to prove it. Whether a recorded run supports it is the evidence verdict, shown beside it.

recorded evidencerecorded evidence: not run Declared guaranteed, and not supported by a recorded run: the test is named, and no passing run of the current inputs is recorded. how evidence is recorded

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.

From the statement to the proof

  1. 1 · the public statement

    A handover is a state record, not a transcript - its required sections must be present and non-empty, a placeholder body is refused, and its identity is computed and refused when written into the body; a transcript pasted into a section is not detected

    Made on Continuity, Handover.

  2. 2 · the canonical claim

    no-transcriptsdeclared status: guaranteed in docs/CLAIMS.yaml

    Defined in read it on this site · docs/DESIGN.md

  3. 3 · the implementation

    lib/handover.sh · majordomus handover

  4. 4 · the test and the scenarios

    Test: test/cases/05_handover.sh

    Executed in Hand unfinished work to the next session.

  5. 5 · the recorded runs

    recorded evidence: not run how evidence is recorded

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

Searches the titles and descriptions of every page this site publishes.