You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Doc-release sweep during PR 4 of 4 of the CorpusBackend arc (#65) caught stale predictive language in docs/TENSIONS.md T9 ("Spec doc surface is growing alongside code surface").
Evidence
docs/TENSIONS.md lines 182-195:
"21 spec docs today (01-anatomy.md through 20-memory-backend.md plus 27-doctor.md)" -- actual count is 31 locked docs + 2 RFCs.
"When this bites: Around spec doc docs: refresh README status table #25 (~CorpusBackend land)." -- CorpusBackend landed at spec/34, not spec/25. The prediction failed.
The tension itself (spec surface grows alongside code surface; spec drift risk; discoverability at scale) is still valid and worth keeping. Only the specific numeric predictions and the "Around spec doc #25" landmark are stale.
Proposed fix
One-paragraph rewrite to T9 that:
Updates "21 spec docs today" to "31 locked docs (+ 2 RFCs) today" with the canonical list scoped to the actual spec/ contents.
Replaces with present-tense observation: spec surface grew from 21 to 31 across the v1.0 backend-protocol arcs; the trend is the tension, not a specific count.
The "What to watch for" subsection (consolidation possibilities, re-numbering at v1.0) stays unchanged. The architecture.md anchor sentence stays unchanged.
Acceptance criteria
T9 contains no future-tense predictions about spec count at a particular issue number.
The count "31 locked docs (+ 2 RFCs)" matches the current state (or whatever is current at the time of the fix).
The tension's substantive framing (spec drift; discoverability at 30+ specs) is preserved.
Source
PR 4 of #65 (CorpusBackend arc closer), Step 18 doc-release subagent sweep, Check 3 classified as FOLLOW_UP.
Context
Doc-release sweep during PR 4 of 4 of the CorpusBackend arc (#65) caught stale predictive language in
docs/TENSIONS.mdT9 ("Spec doc surface is growing alongside code surface").Evidence
docs/TENSIONS.mdlines 182-195:01-anatomy.mdthrough20-memory-backend.mdplus27-doctor.md)" -- actual count is 31 locked docs + 2 RFCs.The tension itself (spec surface grows alongside code surface; spec drift risk; discoverability at scale) is still valid and worth keeping. Only the specific numeric predictions and the "Around spec doc #25" landmark are stale.
Proposed fix
One-paragraph rewrite to T9 that:
The "What to watch for" subsection (consolidation possibilities, re-numbering at v1.0) stays unchanged. The architecture.md anchor sentence stays unchanged.
Acceptance criteria
Source
PR 4 of #65 (CorpusBackend arc closer), Step 18 doc-release subagent sweep, Check 3 classified as FOLLOW_UP.