docs(plan): close ordering question, pin the untested age premise

Two corrections to the brief committed in 3086e8b.

The ordering question (§7.4) still pointed at STATE.md for a decision the
operator had already made, and STATE.md is gitignored — so the tracked artifact
carried a stale queue and deferred to a file a future session cannot read. It
now records the decision inline: delete-and-rebuild goes ahead of pipeline step
4, prior order stands underneath.

§8 gains the premise the brief was quietly resting on: §5A claims project-level
CLAUDE.md/rules yield usable per-block git ages. That is untested. If instruction
blocks trace to one bulk commit, the age signal carries no information and shape
A collapses to the phrasing heuristic — which would answer §7.2 for us. Checked
before any scanner code, not after.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JNrtHo9hKSLKNyMS6b4Zuy
This commit is contained in:
Kjell Tore Guttormsen 2026-07-29 09:50:33 +02:00
commit 3252b514ed

View file

@ -130,8 +130,11 @@ workflow that consumes A's output. C stays a documented idea until A+B exist.
agent layer (like `optimize`'s precision-gated `optimization-lens-agent`)? agent layer (like `optimize`'s precision-gated `optimization-lens-agent`)?
3. Does this ship as its own command, or as a `--subtract` mode of `optimize`? 3. Does this ship as its own command, or as a `--subtract` mode of `optimize`?
Both are defensible; command count is already 21. Both are defensible; command count is already 21.
4. Ordering against the existing queue: pipeline step 4 `rollback`, then the 4. ~~Ordering against the existing queue.~~ **Decided 2026-07-29:** the operator
M-11→M-20 batch release, then the v5.13 plan. See STATE.md. prioritized this work ahead of pipeline step 4 (`rollback`), to start Thursday
2026-07-30. Do not re-litigate. The open part is only what follows it — the
prior order stands underneath: step 4 `rollback`, then the M-11→M-20 batch
release, then the v5.13 plan.
## 8. Verifisering (testable criteria) ## 8. Verifisering (testable criteria)
@ -143,6 +146,13 @@ workflow that consumes A's output. C stays a documented idea until A+B exist.
`lib/baseline.mjs` round-trips → confirms §4 reuse is real, not assumed. `lib/baseline.mjs` round-trips → confirms §4 reuse is real, not assumed.
- [ ] If any claim from §1 is to be written into the register: a primary source exists - [ ] If any claim from §1 is to be written into the register: a primary source exists
(URL to the talk or an Anthropic doc). Otherwise the entry is not written. (URL to the talk or an Anthropic doc). Otherwise the entry is not written.
- [ ] **The age signal actually exists.** §5A's fallback claim — "project-level
CLAUDE.md/rules get real git ages" — is untested. Run
`git log --format=%ad --follow -- CLAUDE.md .claude/rules/` across two or three
real repos. If most instruction blocks trace back to a single bulk commit, per-block
age carries no information, shape A's primary signal collapses to the
compensatory-phrasing heuristic alone, and §7.2 (agent layer) is answered for us.
Check this *before* writing any scanner code.
**If shape A is built:** **If shape A is built:**