Skip to content

Once work exists under an intent, a criterion no issue serves, an issue under its milestones that serves nothing and a link to a criterion that does not exist are each refused by name

An issue names the criterion it serves in serves (ADR 0073). From those links the coverage of every criterion is derived, and every issue under an intent's milestones answers why it exists. Once an intent has work, a criterion nothing serves is criterion_uncovered, an issue that serves nothing is issue_without_purpose, and a link to an unknown intent or criterion is refused.

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: stale 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

An issue names the criterion it serves in `serves`; coverage from criterion to issue is derived on every read and `majordomus intent coverage` prints it, with the reason every issue exists. An intent with no work yet is `intent_not_planned`, a warning, because that is where every intent starts.

What it means

An issue names the criterion it serves in serves (ADR 0073). From those links the coverage of every criterion is derived, and every issue under an intent's milestones answers why it exists. Once an intent has work, a criterion nothing serves is criterion_uncovered, an issue that serves nothing is issue_without_purpose, and a link to an unknown intent or criterion is refused.

How it works

apps/majordomus-cli/src/intent_plan.rs reads serves from the plan and judges it; the plan itself derives no finding from it. A criterion is covered, weak, observed or uncovered, and an issue's purpose is intent, maintenance or unexplained. intent validate and the intent-check gate carry the failures.

How to see it

majordomus intent coverage   # each criterion, its strength and the issues serving it
majordomus intent validate   # exit 10 on criterion_uncovered, issue_without_purpose, serves_unknown_*

What it does not cover

An intent with no work yet is intent_not_planned, a warning, because that is where every intent starts. Nothing derives the issues from the criteria: a worker writes them.

Why it exists

A milestone can be finished while a criterion of the intent above it was never planned at all. Coverage makes that omission a named failure before the work closes, rather than a surprise when the intent never becomes satisfied.

Detail rendered from docs/claims/intent-criteria-covered.md.

From the statement to the proof

  1. 1 · the public statement

    Once work exists under an intent, a criterion no issue serves, an issue under its milestones that serves nothing and a link to a criterion that does not exist are each refused by name

    Made on Planning, Plan.

  2. 2 · the canonical claim

    intent-criteria-covereddeclared status: guaranteed in docs/CLAIMS.yaml

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

  3. 3 · the implementation

    apps/majordomus-cli/src/intent_plan.rs

  4. 4 · the test and the scenarios

    Test: test/cases/386_a_plan_is_held_to_its_intent.sh

  5. 5 · the recorded runs

    recorded evidence: stale 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 386_a_plan_is_held_to_its_intent

Where this claim is used

responsibilities it covers

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