boma/docs
sjat 8eb5ccf97d Add design spec for logging + log integrity (ship all to Loki)
All logs -> on-cluster Loki for troubleshooting/trends; a security-relevant
subset also ships write-only off-site to askari (append-only, tamper-resistant
against full-cluster compromise); skip WORM (accepted-risk R4). Alloy agent in
base; loki/grafana service roles; disk-wear handled as a design parameter.
Basis for ADR-018.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-05 22:03:31 +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 design spec for logging + log integrity (ship all to Loki) 2026-06-05 22:03:31 +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.