boma/docs/decisions
sjat 0e4050fa59 Add ADR-013 (V4 heritage policy); track ADR-011
ADR-013 sets how boma draws on AnsibleBaobabV4 without inheriting it:
translate-don't-transplant — V4 is evidence, never authority. It is a legitimate
source only of operational gotchas and working config snippets (re-derived on
boma's terms); never requirements, domain values, structure, or conventions.
Provenance stays transient (commits/conversation), durable docs stay clean. AI
consultation guardrails included. Resolves TODO 3.3 and 10.1.

Also bring ADR-011 (update management, Proposed draft) under version control:
- fix its "reuse V4's ntfy topics" line to "boma defines its own" (ADR-013)
- track its 6 open questions in TODO 16, plus a 7th: reconcile its tags-not-digests
  pinning with the digest-pinning the security work now mandates (R1 / checklist /
  15.6) — they currently conflict.

CLAUDE.md gains a V4 guardrail + ADR-013 pointer.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-04 19:07:48 +02:00
..
001-architecture.md Reconcile CI to trunk-based; mark base/docker_host not-built (R6-R8,R15-R16) 2026-05-30 19:32:37 +02:00
002-security.md Add per-service SECURITY.md convention; one role per service 2026-06-04 16:09:33 +02:00
003-toolchain.md Reconcile CI to trunk-based; mark base/docker_host not-built (R6-R8,R15-R16) 2026-05-30 19:32:37 +02:00
004-docker-model.md Add per-service SECURITY.md convention; one role per service 2026-06-04 16:09:33 +02:00
005-bootstrapping.md Purge residual .vault_pass references (review R1-R5) 2026-05-30 19:17:25 +02:00
006-terraform.md Use local Terraform state; drop unworkable Forgejo HTTP backend (R10b) 2026-05-30 21:34:05 +02:00
007-network.md Correct Forgejo host to forgejo.nyumbani.baobab.band 2026-05-30 18:16:38 +02:00
008-testing.md Fix Forgejo registry path to owner/image format (review R10a) 2026-05-30 21:34:02 +02:00
009-provisioning-handoff.md Correct Forgejo host to forgejo.nyumbani.baobab.band 2026-05-30 18:16:38 +02:00
010-forgejo-ci.md Record the Vaultwarden item name for the Forgejo token in ADR-010 2026-05-30 21:35:24 +02:00
011-update-management.md Add ADR-013 (V4 heritage policy); track ADR-011 2026-06-04 19:07:48 +02:00
012-hardware-capacity.md Note latest.md report mirror in ADR-012 2026-06-01 10:40:16 +02:00
013-heritage-v4.md Add ADR-013 (V4 heritage policy); track ADR-011 2026-06-04 19:07:48 +02:00