boma/docs
sjat 7a47dd9dec docs(spec): M1 — public DNS migration to Gandi (DNS-as-code) design
Settles the M1 design: full registrar transfer Cloudflare -> Gandi; three-tier
naming scheme (host.boma / service.bare / service.askari), nyumbani dropped,
mesh/LAN-only default; public-DNS-as-code via a control-node `public_dns` role
driven by group_vars data, using community.general.gandi_livedns with a PAT
(api_key is deprecated/rejected by Gandi — verified per ADR-014). Stale records +
unused MX cleaned by omission. Cert scope is DNS+PAT only (issuance deferred to
M4/Phase 2). Human/agent division of labour + token-scoping recorded.

Resolves TODO 4 and review finding O12 once the ADR-007 amendment lands. Point
ROADMAP.md M1 at the spec.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-11 23:17:19 +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 docs(spec): M1 — public DNS migration to Gandi (DNS-as-code) design 2026-06-11 23:17:19 +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(spec): M1 — public DNS migration to Gandi (DNS-as-code) design 2026-06-11 23:17:19 +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.