roadmap: close DESIGN.md->design/ ([~]->[x]); WhatsNew: design-spec-restructure done-state

This commit is contained in:
2026-05-19 13:46:14 +02:00
parent f683f1aec8
commit 2ee408770e
2 changed files with 44 additions and 15 deletions
+40 -15
View File
@@ -381,15 +381,39 @@ work progresses.
## P2 — Medium-term
- [~] **\[milestone\]** DESIGN.md → `design/`role-split into a
typed contract ledger + per-model whitepapers, decision-records
rehomed to `docs/journals/`. `docs/DESIGN.md` is one 2905-line
file doing three different jobs for three different consumers
with three different lifetimes; the line count is the symptom of
role-conflation, not of mess. Replace it with a `design/`
directory split along the consumer/lifetime axis, with a typed
`design/INDEX.md` as the sole addressable spine and primary
entry point.
- [x] **\[milestone\]** DESIGN.md → `design/`CLOSED 2026-05-19.
The 3020-line `docs/DESIGN.md` is **deleted** (clean cut, no
stub) and replaced by the `design/` ledger: `design/INDEX.md`
(sole addressable spine, typed Contracts+Models tables with
polymorphic links — prose file OR authoritative source `//!`),
14 `design/contracts/*.md` test-linked invariants + 3
source-link-only contracts (mangling/env-construction/
qualified-xref — code is SoT), 5 `design/models/*.md`
whitepapers, and `docs/journals/2026-05-19-design-decision-records.md`
(the relitigation-guard archive). RED-first
`design_index_pin.rs` 4-clause anti-regrowth spine; clause-3 is
a hand-rolled **faithful Sweep-1 superset** so the in-code hard
gate enforces the honesty spirit (clause-3 GREEN ⟹ Sweep-1
clean in contracts/). Build-atomic by task ordering (the only
compile-time consumer's `include_str!` retargeted before the
deletion). Every live `DESIGN.md` reference — 4 executables, 2
diagnostics + 2 E2Es, ~12 agent reading lists, 5 SKILL bodies,
CLAUDE.md, README, ~25 code/C/.ail/spec comment xrefs —
retargeted in lockstep; the honesty rule rewritten to name the
new rationale home. Process: spec `a64b2cc`/`314e5e4`
(grounding-check PASS ×2) → plan `deeffb1` → iter .1 `176821c`
(DONE 9/9) → `audit` `2ba5e16` (architect drift_found
`[medium]`+`[low]`, relocation byte-faithful; bencher
causally-exonerated DECISIVE on byte-identical IR+binaries,
baseline pristine — M2/M3/M5 disposition) → tidy `f2cdd67`/
`f683f1a` (DONE 7/7; the audit Resolution mechanism+scope
corrected on planning-time evidence after a correctly-BLOCKED
plan defect — the "two+ defects ⇒ fix the upstream artifact"
discipline, not a third patch). No fieldtest (zero
authoring-surface change — reasoned exclusion). Stays briefly
for context; remove once stale (full record in
`docs/journals/INDEX.md`). Original decided-shape rationale
retained below for context until pruned.
**Motivation.** The just-closed `docs-honesty-lint` milestone is
the proof this is not a cleanup problem: it ran a full docs pass
@@ -474,12 +498,13 @@ work progresses.
DESIGN.md. Brainstorm hard-gate before any plan/code — it
rewrites enforced invariants and agent contracts.
- context: spec `docs/specs/2026-05-19-design-md-rolesplit.md`
(grounding-check PASS 13/13, one re-dispatch after a corrected
commitment-4 pin-status claim); 2026-05-18 chat
(DESIGN.md-management dialogue — six-turn convergence:
role-conflation diagnosis, three-job split axis, "let the code
speak" principle, qmd rejection, blast-radius sequencing).
In flight — ABI-arc sequencing blocker cleared by M5 close.
(incl. the Boss-adjudicated relocation Appendix; grounding-check
PASS ×2); audit `docs/journals/2026-05-19-audit-design-md-rolesplit.md`;
iter journals `2026-05-19-iter-design-md-rolesplit.{1,tidy}.md`;
`docs/journals/2026-05-19-design-decision-records.md`; origin
2026-05-18 chat (DESIGN.md-management dialogue — six-turn
convergence). CLOSED — audited + drift-resolved; hard gate
enforces the honesty spirit.
- [ ] **\[milestone\]** Flat array/slice primitive — performance
follow-up to the Embedding ABI arc, *not* a capability gap.