boma/docs
sjat f0d189ca09 Thread the VERIFY.md convention through ADR-004/new-role/README
Review O1-O3: ADR-017's per-service VERIFY.md requirement now appears in the
ADR-004 service-role file table, as a new-role runbook step, and the README
docs index/tree are refreshed (ADRs 010-017, security/testing/hardware dirs).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-05 18:52:42 +02:00
..
decisions Thread the VERIFY.md convention through ADR-004/new-role/README 2026-06-05 18:52:42 +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 CAPABILITIES: VPN decided — NetBird self-hosted (ADR-016) 2026-06-05 11:50:04 +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: fix DNS-write contradictions + stale control-node/template refs 2026-06-05 18:23:16 +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.