ADR 0080: the development cycle is checked, not trusted — plus review fixes #48

2026-09-17T20:28:16Z

jschoubben commented

2026-09-17 20:28:16 +00:00

Two commits:

Review fixes — a thorough records review found the glossary still naming the controller's seat the-controller in two entries (contradicting its own seat section post-0079), issue 058's heading keeping the pre-renumber number, 055's fixed-by naming branches that stop existing after merge (now merge commits/PRs) and file paths where the convention wants repos, 056's located-in naming mesh-host (no fix landed there) instead of mesh-catalog, and the design layer never stating that one-store/one-broker is enforced — 07-the-foundation and the installation table now say the seats.
ADR 0080 + cycle.py — the knowledge flow was a rule enforced by nothing. The new check refuses: a to-be design naming no decision; an in-progress/implemented design naming no owning code:; a located/fixed issue with no located-in:; a fixed/resolved issue with no fixed-by:; a graduated research overview with no existing became: targets. AGENTS.md gains the cycle statement ("no design without a decision; no development without a design that names its owner") and a where-to-look table so a cleared session follows frontmatter pointers instead of assuming. Grounding the check fixed two real gaps (work-ahead's missing code:, research 003's duplicate became).

All three checks green: records (70), index current, cycle (107 documents).

https://claude.ai/code/session_01D6qtiYU3P9jk3pnAXyAFyx

Two commits: 1. **Review fixes** — a thorough records review found the glossary still naming the controller's seat `the-controller` in two entries (contradicting its own seat section post-0079), issue 058's heading keeping the pre-renumber number, 055's `fixed-by` naming branches that stop existing after merge (now merge commits/PRs) and file paths where the convention wants repos, 056's `located-in` naming mesh-host (no fix landed there) instead of mesh-catalog, and the design layer never stating that one-store/one-broker is *enforced* — 07-the-foundation and the installation table now say the seats. 2. **ADR 0080 + `cycle.py`** — the knowledge flow was a rule enforced by nothing. The new check refuses: a to-be design naming no decision; an in-progress/implemented design naming no owning `code:`; a located/fixed issue with no `located-in:`; a fixed/resolved issue with no `fixed-by:`; a graduated research overview with no existing `became:` targets. AGENTS.md gains the cycle statement ("no design without a decision; no development without a design that names its owner") and a where-to-look table so a cleared session follows frontmatter pointers instead of assuming. Grounding the check fixed two real gaps (work-ahead's missing `code:`, research 003's duplicate `became`). All three checks green: records (70), index current, cycle (107 documents). https://claude.ai/code/session_01D6qtiYU3P9jk3pnAXyAFyx

jschoubben added 2 commits 2026-09-17 20:28:16 +00:00

Fix what the records review found 94fee5d849

The glossary's authority page still named the controller's seat the-controller in two
entries, contradicting its own seat section after ADR 0079; issue 058's heading kept the
pre-renumber 059; 055's fixed-by named branches that stop existing after merge (now merge
commits/PRs) and its located-in listed file paths where the convention wants repos; 056's
located-in named mesh-host, which received no fix, instead of mesh-catalog; and the design
layer never said the one-store/one-broker property is enforced — 07-the-foundation and the
installation table now state the seats.

https://claude.ai/code/session_01D6qtiYU3P9jk3pnAXyAFyx

ADR 0080: the development cycle is checked, not trusted becae7ba51

The flow the process overview draws — idea/symptom -> decision -> to-be design -> code ->
as-is — was enforced by nothing. cycle.py now refuses a to-be design naming no decision, an
in-progress/implemented design naming no owning code, a located/fixed issue with no owner,
a fixed/resolved issue with no fix, and a graduated research overview that does not say what
it became. AGENTS.md carries the cycle and a where-to-look table so a fresh session (or a
cleared context) finds the chain in frontmatter instead of assuming it. Grounding the check
surfaced two real gaps, fixed here: the work-ahead design named no owning code, and research
003 listed one became target twice.

https://claude.ai/code/session_01D6qtiYU3P9jk3pnAXyAFyx

jschoubben merged commit 1162f7fe25 into main

2026-09-17 20:28:22 +00:00

jschoubben deleted branch process/the-development-cycle

2026-09-17 20:28:22 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: novox/hq#48