Skip to content

No claim without a test

No claim without a test

majordomus://rule/project.no-claim-without-test@1active documentationevidence

Rationale

A claim nobody can run is a promise; docs/CLAIMS.yaml exists so that every guaranteed claim names the test that proves it and the site refuses to render one that does not.

Required behaviour

A capability sentence in README.md or docs/ is backed by a case in test/cases/ or is phrased as a target.

Failure behaviour

No command decides this rule; a reviewer does, and a change that violates it is not merged. Where a behavioural case covers part of it, that case is named below.

Verification

Review. scripts/generate-site-data refuses a guaranteed claim with no test, and test/cases/28_no_hardcoded_values.sh checks every claim's detail page and test path.

Where this comes from

canonical file
.ai/repo/rules/project/no-claim-without-test.v1.md
identity
project.no-claim-without-test@1
also served as
MCP resource majordomus://rule/project.no-claim-without-test@1 · majordomus entity show rule/project-no-claim-without-test-1 · GET /api/v1/entity?uri=majordomus://rule/project.no-claim-without-test@1
in the Cockpit
/cockpit/objects/rule/project-no-claim-without-test-1

This page is generated from the file above by scripts/generate-site-data; editing the page changes nothing, editing the file changes every surface. The relations above are edges of docs/generated/graph.json, which the executable writes from the same index.

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