ADR 0081: a decision nothing cites is not yet in the chain

Decisions were the one link the cycle checks skipped, and measuring found 19 of 70 records orphaned — the credential flow and the module-runtime cluster among them, which is how a stale premise about a settled decision survived in working memory. cycle.py now refuses an accepted record nothing cites; the 19 got true homes (design frontmatter, the playbook that implements 0021, META for the process records). The overview names the practice: spec-driven development with provenance. https://claude.ai/code/session_01D6qtiYU3P9jk3pnAXyAFyx
2026-09-17 22:36:33 +02:00
parent 1162f7fe25
commit 90e4a368dc
12 changed files with 107 additions and 1 deletions
@@ -1,6 +1,10 @@
 # Process — overview

-How work moves through HQ, and who may do what. Every other document in this folder is a
+How work moves through HQ, and who may do what. In industry terms this is **spec-driven
+development, with provenance**: the decision is the why, the design doc is the spec, `code:`
+names the implementation, and the lab beds are the conformance tests — and unlike the common
+form, the chain itself is checked ([ADR 0080](../../02-DECISIONS/0080-the-development-cycle-is-checked.md),
+[0081](../../02-DECISIONS/0081-a-decision-nothing-cites-is-not-yet-in-the-chain.md)). Every other document in this folder is a
 playbook: trigger, who runs it, steps, outputs. Engineers and agents follow the same
 playbooks; agents must not act outside them.

@@ -1,5 +1,8 @@
 # Playbook 05 — Constitution sync

+Implements [ADR 0021](../../02-DECISIONS/0021-hq-is-the-source-of-the-constitution.md): HQ is
+the source of the constitution, and the knowledge-base page is derived, never edited.
+
 **Trigger.** [`how-we-build.md`](../how-we-build.md) changed a rule that the mesh enforces at
 runtime.