boma/docs
sjat 3cfcb1c2e9 docs(roadmap): add ROADMAP.md — remote-access-first build order
High-level build order for the project (Approach A): one Off-site/Remote-access
track first (Gandi DNS-as-code -> askari -> NetBird control plane -> enroll
ubongo + road-warrior laptops -> harden), a procurement gate sized by
/capacity-review, then the Cluster track. Sequences the docs/TODO.md backlog into
milestones and records why the order is what it is.

Decisions captured this session: Gandi over Cloudflare is values-driven and
independent of NetBird (sequenced first so records are born at Gandi); public DNS
managed as code (Ansible, consistent with internal DNS + Terraform-owns-no-DNS);
NetBird-on-ubongo before base default-deny (chicken-and-egg); cluster procurement
gated on patterns proven on two cheap hosts.

Wire ROADMAP.md into CLAUDE.md's Further-reading index and point TODO.md at it.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-11 22:12:38 +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
ROADMAP.md docs(roadmap): add ROADMAP.md — remote-access-first build order 2026-06-11 22:12:38 +02:00
TODO.md docs(roadmap): add ROADMAP.md — remote-access-first build order 2026-06-11 22:12:38 +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.