docs: bring the specification in line with the accepted implementation
The operator ruled the implementation repo's main (50c8719) the latest and accepted state. Sync the spec to it. Accepted changes are reflected: one bare-metal environment, TrueNAS bulk storage, R2 off-cluster backup, CloudNativePG, single-node VPN gateway with Cilium fail-closed, inbound WireGuard, per-app auth sidecars, Renovate, the CI gate as approver, and the pm-agent. New ADR-0017..0025; ADR-0016 corrected and accepted; R-* IDs unchanged, eight amended. Where the implementation has simply not met a requirement, the requirement stands and the shortfall is recorded in docs/16-known-gaps.md. Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
1 parent
1ddc14b918
commit
250fb54154
43 files changed
+1672
-575
No files matched your search
+11
-4
@@ -6,15 +6,22 @@ not people — one agent may hold several early on; split as work scales.
|
||||
|
||||
## Coordination roles
|
||||
|
||||
### Platform Architect (steward of this spec repo)
|
||||
### System Architect (steward of this spec repo)
|
||||
- Guards the source-of-truth hierarchy ([`../AGENTS.md` §2](../AGENTS.md)); approves/records ADRs.
|
||||
- Resolves cross-workstream interface conflicts; keeps requirement traceability honest.
|
||||
- Does **not** write implementation code; owns specs, ADRs, roadmap, and this coordination layer.
|
||||
|
||||
### Integration/Release Lead
|
||||
- Owns the implementation repo structure, CI gates, and Flux bootstrap health.
|
||||
- Runs phase entry/exit reviews against the **automated conformance suite**; keeps the task board
|
||||
truthful.
|
||||
- Runs phase entry/exit reviews against the **automated conformance suite**; keeps the handoff log
|
||||
and the derived requirement status truthful.
|
||||
|
||||
### Program Manager
|
||||
- Decides what should happen about implementation work: starts, revises, or declines it, and briefs
|
||||
workers. Lives in the implementation repo; delegates code and debugging rather than doing them.
|
||||
- Does **not** hold the System Architect role: work that needs a spec change is escalated. The
|
||||
in-cluster pm-agent ([ADR-0025](../decisions/adr-0025-in-cluster-ai-program-manager.md)) is an
|
||||
automated instance of this role.
|
||||
|
||||
### QA/Conformance Engineer (WS-TEST)
|
||||
- Owns the conformance testing capability ([14](../docs/14-testing-and-conformance.md),
|
||||
@@ -52,5 +59,5 @@ not people — one agent may hold several early on; split as work scales.
|
||||
([`../decisions/README.md`](../decisions/README.md)).
|
||||
- Negotiate interface changes before breaking another workstream's contract
|
||||
([coordination-protocol.md](coordination-protocol.md)).
|
||||
- Never build on prod hardware before Phase 7 is opened.
|
||||
- Reach production only through the PR gate and Flux (R-ENV-03).
|
||||
- Never emit plaintext secrets.
|
||||
Reference in new issue
Block a user