Commit Graph

2 Commits

Author SHA1 Message Date
Bo 852d74b3b6 docs: reconcile legacy-RPI-lane doctrine + ADR-0009 substrate marker (ag-etgr #frozen-rpi-doctrine) (#698)
## What
Two doc-reconciliation findings from the codebase-discovery (ag-etgr P2,
ag-xa7q P3):

- **ag-etgr** — the CLAUDE.md *Legacy RPI lane* note said "do not write
new tests for"
`rpi_loop_supervisor.go`/`rpi_c2_events.go`/`rpi_phased_tmux.go`/`rpi_parallel.go`,
but **all four have substantial test suites** and the
`check-test-count-regression` ratchet expects them maintained — the
doctrine and the ratchet pulled opposite ways. Reframed to "live,
tested, **no new surface area**; extend tests for caller-driven changes;
full removal needs soc-1gbpz". Also fixed the stale "superseded by the
gc bridge" line in `docs/ROADMAP.md` (gc bridge was removed).
- **ag-xa7q** — `ADR-0009` names Gas City as the reference substrate
throughout (predates the ag-124p prune). Added a dated historical note:
the **decision stands**, but the substrate is now NTM+MCP+managed-agents
(→ docs/3.0.md). Decision record preserved for provenance.

## Note
A 3rd discovery bead (ag-xoam, BC mid-numbering) was **closed
not-reproducible** — grep showed docs already use canonical BC2
Validation/BC3 Loop/BC4 Factory consistently; the archaeology agent had
confabulated the divergent labels.

Docs-only. markdownlint clean; validate-agents-split green.

Closes-scenario: ag-etgr#frozen-rpi-doctrine
Bounded-context: BC3-Loop
Evidence: CLAUDE.md
2026-06-03 12:51:49 +00:00
Bo b8aa715fa8 docs(roadmap): move aspirational claims into docs/ROADMAP.md (soc-icvff #w1b-roadmap) (#470)
W1b of the 3.0 reconciliation (match reality). Designed-but-unbuilt
features were scattered through live docs; consolidated into one roadmap
so live docs describe only what exists.

- **docs/ROADMAP.md (NEW)**: gt convoy / bd mol / bd cook, curation
later stages, hookless default-install (ADR-0002 S2–S5), legacy-RPI
removal (soc-1gbpz) — non-committed framing
- troubleshooting.md / brownian-ratchet.md / curation-pipeline.md:
removed inline unbuilt-command examples → ROADMAP pointers
- documentation-index.md + mkdocs nav: cataloged

No code. grep confirms no unbuilt-as-available language left in live
docs.

NOTE: claude-review infra-red (weekly limit, resets May 25) —
operator-authorized bypass when sole red.

Closes-scenario: soc-icvff#w1b-roadmap
Bounded-context: BC1-Corpus
Evidence: docs/ROADMAP.md
2026-05-23 10:08:13 -04:00