From f11bcad567b18835e7732ee014015197bd598d9a Mon Sep 17 00:00:00 2001 From: Boden Fuller Date: Mon, 18 May 2026 20:48:26 -0400 Subject: [PATCH] docs(doctrine): single-runtime default + sovereignty-proof link MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mirror the agentops 3.0 doctrine-ship convergence into the doctrine source repo. The agentops-showcase site now hosts /sovereignty-proof, a public running ledger of /council --mixed runs where Codex judges surfaced load-bearing findings that all-Claude councils missed. What changes - README.md: adds 'Single-runtime by default. Cross-vendor where it pays.' paragraph after the Solution section, with a callout pointing at https://12factoragentops.com/sovereignty-proof. - PRODUCT.md: sharpens the 'Vendor-neutral doctrine' core value prop to explicitly name single-runtime as the default install path and cross-vendor as a falsifiable capability whose justification lives in the standing proof artifact, not in the install matrix. Why The council convergence on 2026-05-18 called for mixed-model capability to stay visible as load-bearing proof of the sovereignty thesis rather than buried as opt-in obscurity. The showcase shipped the proof page; this commit keeps the doctrine source in step so the reference-implementation README, the showcase site, and the doctrine docs all carry the same line. Out of scope - Factor docs (factors/05-validate-externally.md etc.) — too high- leverage to retouch without a focused factor-update epic. - The 6 operational non-negotiables that ship inside the agentops reference implementation — those land in boshu2/agentops PRs per the slice-1..7 cohort. Source - Council: boshu2/agentops .agents/council/2026-05-18-validate-agentops-3.0-doctrine.md - Plan: boshu2/agentops-showcase .agents/plans/2026-05-18-agentops-3.0-doctrine-ship.md - Sister PR: boshu2/agentops-showcase#28 (merged, commit 6b02591) --- PRODUCT.md | 2 +- README.md | 12 ++++++++++++ 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/PRODUCT.md b/PRODUCT.md index 0e0d8ba..71cb25a 100644 --- a/PRODUCT.md +++ b/PRODUCT.md @@ -29,7 +29,7 @@ that compound. - **Bookkeeping compounds across sessions** — Every session makes the next one smarter. Not a wiki nobody reads — extracted learnings become reusable context. - **Validation becomes an operating rule** — The doctrine makes separate review, ratcheting, and evidence-backed closeout part of the normal flow. - **Primitives and flows scale from one developer to many** — Start with one dev + one agent. The same principles extend to multi-agent orchestration. -- **Vendor-neutral doctrine** — Works with Claude Code, Cursor, Codex, Copilot, or custom setups. Not locked to any toolchain. +- **Vendor-neutral doctrine, single-runtime default** — Every factor applies whether you run Claude Code, Cursor, Codex, Copilot, or custom setups. The reference implementation defaults to a single runtime so install-to-first-value stays cheap. Cross-vendor coordination is kept as a falsifiable capability — preserved because in real `/council --mixed` runs the second vendor has changed load-bearing verdicts, not because it sits in the install matrix. The [standing proof](https://12factoragentops.com/sovereignty-proof) is auditable. ## Competitive Landscape diff --git a/README.md b/README.md index c158753..203b30c 100644 --- a/README.md +++ b/README.md @@ -52,6 +52,18 @@ builds on everything that came before. **The hook:** Compounding work is the one thing no amount of model improvement replaces. Better models with no bookkeeping still repeat your mistakes. +### Single-runtime by default. Cross-vendor where it pays. + +The doctrine is vendor-neutral by design — every factor applies whether you run +Claude Code, Codex CLI, Cursor, or OpenCode. The reference implementation +defaults to a single runtime so install-to-first-value stays cheap. Cross-vendor +coordination (mixed-model councils, runtime-asymmetric planning) is kept because +in real runs Codex judges have surfaced load-bearing findings that all-Claude +councils missed. That capability earns its place by changing verdicts, not by +sitting in the install matrix. + +**[Read the sovereignty proof →](https://12factoragentops.com/sovereignty-proof)** — three real `/council --mixed` runs with file:line citations, the standing exhibit for the cross-vendor claim. + --- ## Quickstart: 5 Minutes, Zero Infrastructure