Concepts
The mental model. Read top to bottom for first-time understanding; each page is independently load-bearing.
| Page | Why it matters |
|---|---|
| Control plane vs source-of-truth | The framing: methodology centralised, project truth in each repo. |
| Registry | The declarative list of governed repos. |
| Verbs | The mechanical pipeline: typed input → schema-validate → constraint-check → dry-run / apply → PR. |
| Idempotency keys | Why re-runs are no-ops. |
| Fleets | Agent identity and the fleets_allowed gate. |
| Profiles | strict / standard / permissive. |
| Dry-run vs apply | Why dry-run is the default. |
| Schema fingerprints | How old PRs trace back to their contract version. |
| Boundary diagram | The single most load-bearing visual. |
See also
Section titled “See also”- Overview — the one-screen explainer that motivates these concepts.
- Architecture — the rationale behind the concepts.
- Verb reference — applying the concepts to real verbs.