sjat/boma
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
boma/docs
History
sjat 1da117d65b docs(review): 2026-06-11 repo audit — fix build-wave doc drift 
/review-repo run at 67f2aba. Auto-fixed 5 safe doc-drift items left by the
base(firewall)+dev_env build wave: README/playbook/role notes that still called
the roles "empty/not built", plus README tree gaps and the reciprocal ADR-021
cross-links in ADR-016/020.

18 open findings reported (not fixed). Headline: `make lint` is red on `main`
(site.yml imports the non-existent docker_host role) and an ADR-004 <-> ADR-022
backup-scope contradiction. Deferral checklist clean (0 stale-deferred); 7 of
12 prior findings confirmed resolved. See docs/reviews/2026-06-11-review.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-11 14:48:00 +02:00
..
access docs(access): correct ADR-021 governance (runbook+gate, not scaffold) 2026-06-09 17:52:24 +02:00
backup docs(backup): add BACKUP.md template + backup__* contract (ADR-022) 2026-06-10 11:20:01 +02:00
decisions docs(review): 2026-06-11 repo audit — fix build-wave doc drift 2026-06-11 14:48:00 +02:00
hardware docs: record ubongo physical build (2026-06-11) 2026-06-11 10:32:26 +02:00
reviews docs(review): 2026-06-11 repo audit — fix build-wave doc drift 2026-06-11 14:48:00 +02:00
runbooks docs: record ubongo physical build (2026-06-11) 2026-06-11 10:32:26 +02:00
security docs: record ubongo physical build (2026-06-11) 2026-06-11 10:32:26 +02:00
superpowers Add dev_env role: zsh/tmux/nvim for workstation-class hosts 2026-06-11 13:50:11 +02:00
testing docs(kaizen): migrate gotchas to docs; curate FRICTION log (2026-06-10 review) 2026-06-10 12:51:39 +02:00
CAPABILITIES.md docs(backup): update hardware ref (ubongo M70q, add fisi) + CAPABILITIES §9 (ADR-022) 2026-06-10 11:25:37 +02:00
FRICTION.md docs(kaizen): FRICTION signal — controller must diff-audit subagent restructures 2026-06-10 15:01:21 +02:00
README.md Add architecture decision records and runbooks 2026-05-30 14:10:01 +02:00
TODO.md docs(backup): record ADR-022; wire into CLAUDE.md, STATUS, TODO 2026-06-10 11:19:01 +02:00

README.md

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.