docs: record Inception Sprint Oath; descope S3 (var-go enforcement) to #1

Add docs/INCEPTION-OATH.md — the sprint's acceptance contract (general + cad-atlas-specific clauses, tagging as the closing act). S3 (var-go/oath enforcing cad-atlas PRs) is descoped to a tracked fast-follow (#1): var-go v1's candidate is a hardcoded self-test and its module is not cross-repo consumable, so a green status would prove wiring, not verification. Honesty rule: a clause blocked by an external dependency is descoped and tracked, never claimed. Methodology persisted: brain wiki/homelab/decisions/inception-sprint-and-oath.md Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-19 13:05:06 +02:00
parent 506b428b2c
commit 784ece65d0
7 changed files with 55 additions and 0 deletions
@@ -0,0 +1,49 @@
+# cad-atlas — Inception Sprint Oath
+
+The acceptance contract for standing up cad-atlas. The sprint is finalized only when this
+Oath holds. Methodology: brain `wiki/homelab/decisions/inception-sprint-and-oath.md`.
+
+> **Status of enforcement:** this Oath is currently **advisory** (human-verified). Machine
+> enforcement via `var-go/oath` is deferred — see the honesty rule below and issue #1.
+
+## General clauses (any inception sprint)
+
+| # | Clause | Status | Evidence |
+|---|--------|--------|----------|
+| G1 | Repo born from template on Gitea, dispatch-eligible | ✅ | `create_project_from_template`, `.dispatch-allow`, dispatch-allowlisted |
+| G2 | Self-contained context + brain deep-links + external refs | ✅ | `.context/PROJECT.md`, `README.md` |
+| G3 | Green CI on main: build · vet · lint · test (TDD) | ✅ | CI runs 16–17 green; `internal/web/handler_test.go` |
+| G4 | Genesis learning persisted to brain, linked from repo | ✅ | `wiki/homelab/decisions/cad-atlas-audit-chain-is-viz-data.md` |
+| G5 | Discovered findings filed as tracker issues | ✅ | template-go-web#8, local-dev#20 |
+| G6 | SemVer tag marks the milestone (closing act) | ✅ | `v0.1.0` |
+| G7 | Agent-ready spec issue for the next increment | ✅ | #1 |
+
+## Specific clauses (cad-atlas)
+
+| # | Clause | Status | Evidence |
+|---|--------|--------|----------|
+| S1 | Atlas served at `/`, renders all 9 stages signal→pod | ✅ | `internal/web/handler.go` + `static/cad-atlas.html` |
+| S2 | Oath covered in the viz (stages 03 + 06) | ✅ | var-go Oath nodes in the atlas |
+| S3 | `var-go/oath` enforces cad-atlas's own PRs | ⏸ **deferred → #1** | var-go v1 candidate is a toy self-test; module not cross-repo consumable. See honesty rule. |
+
+## The honesty rule
+
+A clause blocked by an external dependency is **descoped and tracked, never marked satisfied** —
+a self-lying Oath is a rubber stamp, the exact failure the Oath exists to prevent. S3's real
+enforcement depends on a var-go Executor (swedsl#27) + a published `oath` module; it is tracked as
+a fast-follow on **#1**, not claimed here. The `DMABE_GITEA_API_TOKEN` Actions secret is
+pre-provisioned so #1 can land without a secret-write.
+
+## The Oath (advisory form)
+
+```var
+Given a new software thing is being stood up as an inception sprint
+Then its repo is born from template on Gitea and is dispatch-eligible
+And its context is self-contained with brain deep-links and external references
+And CI on main is green across build, vet, lint and test
+And the genesis learning is persisted to brain and linked from the repo
+And every discovered finding is filed as a tracker issue
+And an agent-ready spec issue exists for the next increment
+And a SemVer tag marks the milestone as the closing act
+And any clause blocked by an external dependency is descoped and tracked, never claimed
+```