Skip to content

One worker, one clear scope

One worker, one clear scope

majordomus://rule/majordomus.one-worker-one-scope@1active principle

it references

Nothing. This object declares no reference.

referenced by

Rationale

Two workers editing one file, and forty worktrees producing thousands of concurrently modified files, are the failures a declared scope prevents. The scope is a contract other workers can read and a boundary a command can check.

Required behaviour

Claim the paths a task needs when it starts; if the fix is elsewhere, stop and record it rather than widening the scope silently.

Failure behaviour

Nothing decides this rule directly, so a violation is reported by nobody; it is the rules that depend on it that decide what a machine can decide and stop or warn accordingly.

Verification

The enforced rules whose depends_on names this one carry the validators, the tests and the CI wiring. majordomus doctrine list shows them.

Where this comes from

canonical file
.ai/repo/rules/vendor/majordomus/rules/principle-04-one-worker-one-scope.v1.md
identity
majordomus.one-worker-one-scope@1
also served as
MCP resource majordomus://rule/majordomus.one-worker-one-scope@1 · majordomus entity show rule/majordomus-one-worker-one-scope-1 · GET /api/v1/entity?uri=majordomus://rule/majordomus.one-worker-one-scope@1
in the Cockpit
/cockpit/objects/rule/majordomus-one-worker-one-scope-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.