boma/docs
sjat db76be2a63 review-repo: clear O7-O12 clarity items
- ADR-011: ruled-out row was "digest-pinning stateful" (contradicted Decision 2);
  now "digest-only (no readable tag)" — tag@digest is adopted (O7)
- ADR-003/010: act_runner names ubongo as the runner host, runner VM as a future
  option (O8)
- ADR-008: WireGuard Molecule-exclusion row reframed to NetBird wt0 data plane (O9)
- ADR-011: scheduled_jobs xref points to TODO 8.3, not ADR-010 (O10)
- CAPABILITIES: add /verify-service Level 4 capability row (O11)
- TODO 3.10: rewrite the garbled base-container question (O12)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-05 19:28:07 +02:00
..
decisions review-repo: clear O7-O12 clarity items 2026-06-05 19:28:07 +02:00
hardware ADR-012/hardware: add ubongo as physical control node 2026-06-05 09:43:09 +02:00
reviews review-repo: 2026-06-05 report (4 auto-fixed, 12 open) 2026-06-05 18:24:39 +02:00
runbooks Thread the VERIFY.md convention through ADR-004/new-role/README 2026-06-05 18:52:42 +02:00
security service-checklist: add Level 4 UI verification to the gate 2026-06-05 13:17:16 +02:00
superpowers Add implementation plan for service-UI verification (Level 4) 2026-06-05 13:11:43 +02:00
testing Git-ignore verify screenshots; add testing/reviews dir 2026-06-05 13:19:04 +02:00
CAPABILITIES.md review-repo: clear O7-O12 clarity items 2026-06-05 19:28:07 +02:00
FRICTION.md FRICTION: stale-deferred-item pattern recurred a 3rd time — build the check 2026-06-05 18:06:26 +02:00
README.md Add architecture decision records and runbooks 2026-05-30 14:10:01 +02:00
TODO.md review-repo: clear O7-O12 clarity items 2026-06-05 19:28:07 +02:00

docs/

Project documentation.

  • decisions/ — Architecture Decision Records (ADRs): the "why" behind the design. Numbered from 001; each records context, the decision, and what was ruled out.
  • runbooks/ — step-by-step operational procedures (add a host, add a role, rotate secrets).

For what is actually built vs only designed, see STATUS.md at the repo root — the ADRs describe intent, not necessarily current reality.