docs: route vendored doctrine through the manifest
Some checks failed
labels / labels (pull_request) Failing after 17s
CI / test (pull_request) Has been cancelled
CI / release-exercise (pull_request) Has been cancelled
CI / self-guards (pull_request) Has been cancelled
CI / action-exercise (pull_request) Has been cancelled
CI / docs-sync-exercise (pull_request) Has been cancelled
Refs guard / refs-not-closing (pull_request) Has been cancelled

This commit is contained in:
codex-bot-andresmgsl 2026-08-19 03:50:10 +00:00
parent c2ef6a2fc2
commit d12cc3d84f
2 changed files with 14 additions and 23 deletions

View file

@ -97,14 +97,13 @@ table repeats it (#104).
## Doctrine conventions ## Doctrine conventions
The vendored role files — `AGENTS.md`, `TRIAGE.md`, `BUILDER.md`, The vendored role files — the set [`docs/VENDORED.txt`](docs/VENDORED.txt)
`REVIEWER.md`, `LABELS.md`, and `RELEASES.md` — state each normative rule declares — state each normative rule completely, keep at most one sentence of
completely, keep at most one sentence of why, and cite its record only with a why, and cite its record only with a bare parenthetical such as `(#N)`,
bare parenthetical such as `(#N)`, `(#N D3)`, or `(#N, #M)`. Incident `(#N D3)`, or `(#N, #M)`. Incident narrative — timestamps, actors, quoted
narrative — timestamps, actors, quoted comments, measured counts, and links to comments, measured counts, and links to specific comments — belongs in that
specific comments — belongs in that record. If a rule cannot be followed record. If a rule cannot be followed without chasing its cite, the rule is
without chasing its cite, the rule is under-stated: fix the statement, not the under-stated: fix the statement, not the citation. (#280)
citation. (#280)
Normative text in those files does not cite issues from other repositories. Normative text in those files does not cite issues from other repositories.
Consumers read the vendored bytes outside this organization's context, and a Consumers read the vendored bytes outside this organization's context, and a
@ -119,21 +118,12 @@ every session. (#280)
## How the other repos use this ## How the other repos use this
Two consumption modes, split by what has a runtime: Two consumption modes, split by what has a runtime: **machinery by
reference**, fetched at run time from the ref a caller pins, and **doctrine
- **Machinery is consumed by reference.** Workflows and actions are fetched as a mirror** — the set [`docs/VENDORED.txt`](docs/VENDORED.txt) declares,
by GitHub at run time from the ref the caller pins — no copy exists in the vendored at `.ceremony/` and held to the pin by a guard (issue #19). The
consumer. [README](README.md) states both modes in full, and why they differ; what
- **Doctrine is consumed as a machine-verified mirror.** A document's only follows is only what they leave a governed repo to carry.
"runtime" is an agent reading the working tree of the repo it stands in —
a doc that requires a cross-repo fetch before it governs is a doc that
sometimes goes unread. So the agent-facing set — **AGENTS.md, TRIAGE.md,
BUILDER.md, REVIEWER.md, LABELS.md, RELEASES.md** — is vendored into each governed
repo at **`.ceremony/`**, byte-identical to this repo at the pinned ref,
by the sync tool (issue #19). A CI guard diffs the mirror against the pin
on every PR: hand-editing a vendored file, or bumping the pin without
re-syncing, goes red. It is a copy that cannot drift — which is the only
kind of copy this org allows.
A governed repo (box, rig, cast, incubator, …) therefore carries: A governed repo (box, rig, cast, incubator, …) therefore carries:

1
changelog.d/229.md Normal file
View file

@ -0,0 +1 @@
- Forge consumers now receive the upstream 0.6.1 and 0.6.2 doctrine for vendored-set routing, review-round signalling, operator-owned remainders, producer liveness, and post-merge release edges (#229).