docs: 12 factors as whole-system constitution (CANON.md alignment)

[boshu2]

Re-expresses the doctrine per mt-olympus CANON.md (2026-06-06): the 12 are the constitution of the whole agent system (worker / factory / runtime) lived at altitudes, not the retired 'AgentOps I–IX / MTO X–XII' partition. Names and numbers frozen at v3.0.0 — no factor renamed, renumbered, or deleted.

Changes

• V — claims-vs-verdicts / single-writer authority promoted to the spine (the moat); + two-altitude (worker honesty vs factory authority).
• VII/VIII — producer/consumer boundary; flywheel diagram no longer owns EXTRACT (inbound handoff from VII); VIII gains promotion-authority altitude.
• XII — rewritten to its distinct mechanism: failure-as-routing-hint (prunes search) + fresh-agent-on-failure — not a restatement of VII.
• III/X — temporal vs concurrent 'fresh context'; fungible/disposable workers.
• X/XI — framed as independence (peers) vs authority (chain), not one 'scale' blob.
• README — retire 'Scale = optional / skip if solo' → factory-altitude framing; add Core+Skin rule and a Doctrine-Stability (no-renumber/no-delete) guard.

Gates

validate-factors checks pass locally: all 12 files present · structure + ≥500 words · no stale framing.

Epic ag-nf8s. Pairs with the agentops-showcase PR of the same branch name.

[boshu2]

Scope expanded (commit 603dfcf) — repo-wide alignment + v3.1.0 prep

The first commit aligned the 12 factor files + README. This follow-up propagates the same corrections across the rest of the repo so no surface still carries the retired 'AgentOps I–IX / scale-optional' partition — handled by three parallel subagents with non-overlapping file ownership, then integrated + version-stamped:

• docs/00-SUMMARY.md, docs/principles/{README,evolution-of-12-factor,comparison-table}.md, docs/explanation/{from-theory-to-production,vibe-coding-integration}.md, docs/reference/README.md — Factor V → claims-vs-verdicts; Factor XII → routing-hints / fresh-agent-on-failure; Scale tier 'optional / skip if solo' → factory altitude (adoption funnel preserved).
• GOALS.yaml — success criterion no longer encodes the optional-tier partition; now verifies the factory-altitude framing.
• README.md — fixed the XII table row (was still old wording); badge + VERSION → v3.1.0; CHANGELOG + Version History v3.1.0 entry.

Left intact as history: docs/plans/*, docs/_archived/*, CHANGELOG [3.0.0].

Gates: validate-factors checks pass (12 files, structure, no stale CI framing); GOALS.yaml valid; repo-wide stale-framing sweep clean. Tracks the 3.1 release line.