Updated: 2026-07-27 Created: 2026-06-29
Before writing or reviewing any ADR, read
../PRINCIPLES.md. An ADR that contradicts a principle is wrong, and the contradiction is the finding.
Each ADR records a decision the 3-way red-team forced, so it can't be quietly regressed.
| ADR | Decision | Kills |
|---|---|---|
| 0001 | Ship a verified zip bundle, not a single embedded .rvf (single-container = deferred spike) |
F9 "one magic file" fiction |
| 0002 | Quality gate of record = ground-truth-against-source + multi-vendor panel, not a captured LLM grader | F5/F8 asserted-not-proven |
| 0003 | Point deeper: KB resolves to exact file:line + neighbors + whole-doc; agent never chooses to dig |
F1 the 15-month skim-and-quit |
| 0004 | Effectiveness first; size is a later pass; f32/multi-vector over SQ8 for v1 | shallow-for-the-sake-of-small |
| 0005 | Retrieve-and-inject grounding (⚠ reconciled 2026-07-06 — hard-deny/Stop/SLO NOT shipped; see the ADR banner + ADR-0009) | F4 drift; enforcement theater |
| 0006 | Segment-per-repo + cross-segment normalization, not one merged HNSW | merge-confusion / false "cheap incremental" |
| 0007 | Tiered scope (T0–T3) by ingest depth; union selection rule | F7 unbounded-scope death |
| 0008 | Autonomous build loop: Ruflo decides · Claude Code acts · brain grounds; SPARC + score-to-≥98 + ADR-0005 hooks + one-command install | the "brain alone is the product" / drift-on-action |
| 0009 | Mirror Discipline: the brain passes its own bar — single version SoT, smoke-gated publish, eval flywheel, ADR-QA/DDD-QA/doc-currency as capabilities, ADR-0005/DDD reconciled to reality | self-drift; the "grounded product that lies about its own version" |
| 0010 | Security hardening (SEC-0010): Dragan's QE review — fail-closed fences, single version SoT, CVSS-9.8 dep cleared, injection-guard recall, unsigned-updater RCE vector closed (signing tracked), CI, secret-leak scrub — each finding's root cause + exact fix + verification | fence-fails-open; unsigned-RCE; CVSS-9.8; secret-leak; the drift class |