From 784ece65d0cab451d7fe6baea48f732c4e301140 Mon Sep 17 00:00:00 2001 From: Mathias Date: Sun, 19 Jul 2026 13:05:06 +0200 Subject: [PATCH] docs: record Inception Sprint Oath; descope S3 (var-go enforcement) to #1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) --- .aider.conventions.md | 1 + .context/PROJECT.md | 1 + .context/system-prompt.txt | 1 + .cursorrules | 1 + AGENTS.md | 1 + CLAUDE.md | 1 + docs/INCEPTION-OATH.md | 49 ++++++++++++++++++++++++++++++++++++++ 7 files changed, 55 insertions(+) create mode 100644 docs/INCEPTION-OATH.md diff --git a/.aider.conventions.md b/.aider.conventions.md index 1bc8d98..a2ad84e 100644 --- a/.aider.conventions.md +++ b/.aider.conventions.md @@ -340,6 +340,7 @@ is advisory here. Wiring it is a first tracked task; disclosed in code, this doc ## Brain references (source of truth — `brain_get `) - `wiki/homelab/decisions/cad-atlas-audit-chain-is-viz-data.md` — **this project's genesis note**: the audit-chain-is-viz-data thesis, the three gates, template-go-web footguns +- `wiki/homelab/decisions/inception-sprint-and-oath.md` — the Inception Sprint + Oath methodology (this repo's birth is the worked example); see [`docs/INCEPTION-OATH.md`](docs/INCEPTION-OATH.md) for the kept Oath - `knowledge/workflow-idea-to-running-service.md` — Double Diamond idea→service workflow - `wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md` — CAD definition - `wiki/agentsquad/decisions/cad-dispatch-bridge.md` — claude.ai → agentsquad trigger path diff --git a/.context/PROJECT.md b/.context/PROJECT.md index ebbf5a6..4017e9e 100644 --- a/.context/PROJECT.md +++ b/.context/PROJECT.md @@ -61,6 +61,7 @@ is advisory here. Wiring it is a first tracked task; disclosed in code, this doc ## Brain references (source of truth — `brain_get `) - `wiki/homelab/decisions/cad-atlas-audit-chain-is-viz-data.md` — **this project's genesis note**: the audit-chain-is-viz-data thesis, the three gates, template-go-web footguns +- `wiki/homelab/decisions/inception-sprint-and-oath.md` — the Inception Sprint + Oath methodology (this repo's birth is the worked example); see [`docs/INCEPTION-OATH.md`](docs/INCEPTION-OATH.md) for the kept Oath - `knowledge/workflow-idea-to-running-service.md` — Double Diamond idea→service workflow - `wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md` — CAD definition - `wiki/agentsquad/decisions/cad-dispatch-bridge.md` — claude.ai → agentsquad trigger path diff --git a/.context/system-prompt.txt b/.context/system-prompt.txt index 3b36067..1373944 100644 --- a/.context/system-prompt.txt +++ b/.context/system-prompt.txt @@ -345,6 +345,7 @@ is advisory here. Wiring it is a first tracked task; disclosed in code, this doc ## Brain references (source of truth — `brain_get `) - `wiki/homelab/decisions/cad-atlas-audit-chain-is-viz-data.md` — **this project's genesis note**: the audit-chain-is-viz-data thesis, the three gates, template-go-web footguns +- `wiki/homelab/decisions/inception-sprint-and-oath.md` — the Inception Sprint + Oath methodology (this repo's birth is the worked example); see [`docs/INCEPTION-OATH.md`](docs/INCEPTION-OATH.md) for the kept Oath - `knowledge/workflow-idea-to-running-service.md` — Double Diamond idea→service workflow - `wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md` — CAD definition - `wiki/agentsquad/decisions/cad-dispatch-bridge.md` — claude.ai → agentsquad trigger path diff --git a/.cursorrules b/.cursorrules index ded7ce1..a1eb899 100644 --- a/.cursorrules +++ b/.cursorrules @@ -343,6 +343,7 @@ is advisory here. Wiring it is a first tracked task; disclosed in code, this doc ## Brain references (source of truth — `brain_get `) - `wiki/homelab/decisions/cad-atlas-audit-chain-is-viz-data.md` — **this project's genesis note**: the audit-chain-is-viz-data thesis, the three gates, template-go-web footguns +- `wiki/homelab/decisions/inception-sprint-and-oath.md` — the Inception Sprint + Oath methodology (this repo's birth is the worked example); see [`docs/INCEPTION-OATH.md`](docs/INCEPTION-OATH.md) for the kept Oath - `knowledge/workflow-idea-to-running-service.md` — Double Diamond idea→service workflow - `wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md` — CAD definition - `wiki/agentsquad/decisions/cad-dispatch-bridge.md` — claude.ai → agentsquad trigger path diff --git a/AGENTS.md b/AGENTS.md index 1bc8d98..a2ad84e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -340,6 +340,7 @@ is advisory here. Wiring it is a first tracked task; disclosed in code, this doc ## Brain references (source of truth — `brain_get `) - `wiki/homelab/decisions/cad-atlas-audit-chain-is-viz-data.md` — **this project's genesis note**: the audit-chain-is-viz-data thesis, the three gates, template-go-web footguns +- `wiki/homelab/decisions/inception-sprint-and-oath.md` — the Inception Sprint + Oath methodology (this repo's birth is the worked example); see [`docs/INCEPTION-OATH.md`](docs/INCEPTION-OATH.md) for the kept Oath - `knowledge/workflow-idea-to-running-service.md` — Double Diamond idea→service workflow - `wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md` — CAD definition - `wiki/agentsquad/decisions/cad-dispatch-bridge.md` — claude.ai → agentsquad trigger path diff --git a/CLAUDE.md b/CLAUDE.md index ebbf5a6..4017e9e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -61,6 +61,7 @@ is advisory here. Wiring it is a first tracked task; disclosed in code, this doc ## Brain references (source of truth — `brain_get `) - `wiki/homelab/decisions/cad-atlas-audit-chain-is-viz-data.md` — **this project's genesis note**: the audit-chain-is-viz-data thesis, the three gates, template-go-web footguns +- `wiki/homelab/decisions/inception-sprint-and-oath.md` — the Inception Sprint + Oath methodology (this repo's birth is the worked example); see [`docs/INCEPTION-OATH.md`](docs/INCEPTION-OATH.md) for the kept Oath - `knowledge/workflow-idea-to-running-service.md` — Double Diamond idea→service workflow - `wiki/homelab/decisions/continuous-agentic-development-cad-concept-2026-06-16.md` — CAD definition - `wiki/agentsquad/decisions/cad-dispatch-bridge.md` — claude.ai → agentsquad trigger path diff --git a/docs/INCEPTION-OATH.md b/docs/INCEPTION-OATH.md new file mode 100644 index 0000000..b51bc3d --- /dev/null +++ b/docs/INCEPTION-OATH.md @@ -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 +```