ADR 0081: decisions are in the chain — no orphan records #49

2026-09-17T20:36:43Z

jschoubben commented

2026-09-17 20:36:43 +00:00

Decisions were the one link cycle.py skipped. Measuring found 19 of 70 accepted records cited by nothing — including the credential flow (0048) and the module-runtime cluster (0044–0055) — which is exactly how a stale premise about a settled decision survived in working memory this session. Now: every accepted record must be reachable (a design doc's decisions:, a research became:, an issue, 00-META, or a supersession chain); the 19 orphans got true homes; the overview names the practice spec-driven development, with provenance. All checks green (records, index, cycle: 178 documents).

https://claude.ai/code/session_01D6qtiYU3P9jk3pnAXyAFyx

Decisions were the one link `cycle.py` skipped. Measuring found 19 of 70 accepted records cited by nothing — including the credential flow (0048) and the module-runtime cluster (0044–0055) — which is exactly how a stale premise about a settled decision survived in working memory this session. Now: every accepted record must be reachable (a design doc's `decisions:`, a research `became:`, an issue, 00-META, or a supersession chain); the 19 orphans got true homes; the overview names the practice **spec-driven development, with provenance**. All checks green (records, index, cycle: 178 documents). https://claude.ai/code/session_01D6qtiYU3P9jk3pnAXyAFyx

jschoubben added 1 commit 2026-09-17 20:36:43 +00:00

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

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

jschoubben merged commit 5395b6a47f into main

2026-09-17 20:36:48 +00:00

jschoubben deleted branch process/decisions-in-the-chain

2026-09-17 20:36:49 +00:00

jschoubben referenced this issue from a commit

2026-09-23 22:38:56 +00:00

ADR 0105: what review settled — carried peers, the flip, the refusals, and keeping the hub's identity

jschoubben referenced this pull request

2026-09-23 22:39:04 +00:00

ADR 0105: what review settled — the tunnel adoption is implemented #95

Sign in to join this conversation.