chore(memory): BDR-151 + LRN-304 + EVAL-060 — feat done-triage-levers

This commit is contained in:
bchanot committed 2026-11-20 16:24:51 +01:00
1 parent e8c061e4f0
commit b58d8857cd
7 files changed
+447 -1

No files matched your search

+6
View File
@@ -1614,3 +1614,9 @@ Supersedes [[BDR-030]].
- **Status (2026-11-17)**: accepted, amended 6022b9d: B2 stuck trigger in 6 gate skills (points to verify-secure-loop); end-of-run call before done/merge in feat, bugfix, ship-feature, init-project, a11y, guardrails, audit-delta+tour (fix applied only), release-candidate STEP 4; own budget; gate flows print diff stat, fix back through gates; verifier/security-auditor/plan-challenger advise only when dispatched; auditor raise upward only; plan-challenger protocol mirror. Commits f48343e 24354d9 6022b9d - **Status (2026-11-17)**: accepted, amended 6022b9d: B2 stuck trigger in 6 gate skills (points to verify-secure-loop); end-of-run call before done/merge in feat, bugfix, ship-feature, init-project, a11y, guardrails, audit-delta+tour (fix applied only), release-candidate STEP 4; own budget; gate flows print diff stat, fix back through gates; verifier/security-auditor/plan-challenger advise only when dispatched; auditor raise upward only; plan-challenger protocol mirror. Commits f48343e 24354d9 6022b9d
- **Status (2026-11-18)**: accepted, amended 51f343f: B3: challenge route rides first lib/challenge-plan.md call; summary Advisor row in 12 callers; feat/bugfix skip end call when GATE 0 MET + verifier CONFORME + security PASS (not DEGRADED, TOOL line) first attempt, ADVISOR field shows skip; item 3 reuse clause names later code commits - **Status (2026-11-18)**: accepted, amended 51f343f: B3: challenge route rides first lib/challenge-plan.md call; summary Advisor row in 12 callers; feat/bugfix skip end call when GATE 0 MET + verifier CONFORME + security PASS (not DEGRADED, TOOL line) first attempt, ADVISOR field shows skip; item 3 reuse clause names later code commits
- **Status (2026-11-20)**: accepted, amended 7979b9b..b71db28: allowed set + opus code review (ship-feature STEP 6, init-project STEP 10, standalone SDD final) one call via brief; never-call lines in opus agents/briefs; SubagentStart hook hooks/subagent-advisor.sh backstop; standalone SDD workers sonnet; Advisor row reason sub-agent - **Status (2026-11-20)**: accepted, amended 7979b9b..b71db28: allowed set + opus code review (ship-feature STEP 6, init-project STEP 10, standalone SDD final) one call via brief; never-call lines in opus agents/briefs; SubagentStart hook hooks/subagent-advisor.sh backstop; standalone SDD workers sonnet; Advisor row reason sub-agent
## BDR-151 — Done and triage levers: done = oracles green, MINOR fold-or-drop, placed-decision skip, contract dry run, TODO +n/-m [accepted] (2026-11-20)
- **Decision**: six done/triage levers adopted (user 2026-11-20). Done = GATE 0 MET + verifier CONFORME + security PASS on same diff; later review reopens only with reproducible evidence (command failing on HEAD, real output shown wrong); scenario → one try to make it a failing command, else MINOR. MINOR on plan/diff: fold before dispatch or drop as `MINOR dropped:` line (report + run plan), never TODO/BUGS-FOUND/registry; security finding never droppable → user. Challenge skip for placed decision: text dictated by decision, decision = user's own words or challenged in run that wrote it, caller runs verify-secure-loop after dispatch. Contract dry run before dispatch: `- run-base: <sha>` in contract + `gates.sh run` on mktemp copy. TODO loop notes start SHA in TODO.md. Memory-commit report ends `· TODO +n / -m`, counted before step 2. Verifier STEP 4: added plan files, appended `MINOR dropped:` lines, handed contract (whole if untracked, else EVIDENCE/run-base/[gated]) in scope.
- **Why**: session c9afbcbf open TODO 44→50 while closing items; MINOR→backlog was habit, no rule; challenge on placement runs found no MAJOR; verifier ECARTS were own contract bookkeeping.
- **Alternatives rejected**: TODO cap/expiry (cap 10 starts violated); "fix if under five minutes" post-gate exit; base from merge-base (overcounts multi-run branch) or pending diff only (misses earlier commits); verifier exempting whole `.claude/tasks/plans/` (142 durable plans, BDR-065 amendment).
- **Reference**: 19dfe7e, 39cf9dd, docs e8c061e; handoff plan .claude/tasks/plans/2026-11-20-done-and-triage-levers.md; contract .claude/tasks/contracts/2026-11-20-done-triage-levers-1413.md. Follow-up /feat (contract-interview, ship-feature STEP 6, init-project STEP 10, run_base `--end-of-options`, [gated] only untracked) open in TODO.
+7
View File
@@ -461,3 +461,10 @@ Dogfood: 3 blind lenses attacked the v1 plan for the plan-challenge feature itse
- **Result**: 3.0.0 cut; E1/E2/G/H1-H7/BLK-049/Fable 5.2/perl runner merged, all `make test` green; F faunosteo branch ready (user merges). Every phase 0/0b/4a/1/5/2/4b-4d TODO line closed, BUGS-FOUND BDR-125 items fixed or closed with reason. - **Result**: 3.0.0 cut; E1/E2/G/H1-H7/BLK-049/Fable 5.2/perl runner merged, all `make test` green; F faunosteo branch ready (user merges). Every phase 0/0b/4a/1/5/2/4b-4d TODO line closed, BUGS-FOUND BDR-125 items fixed or closed with reason.
- **Anomalies**: (1) gates caught what executors missed: H6b verifier ECARTS (profile.test.sh:123 comment silenced shellcheck from that line on; my brief said "counts equal to HEAD", gate said "clean"); perl plan r1 FATAL(3) (impossible digest assertion without tty, single quotes = SC2016, timeout(1) misread) and r2 still let a fast-failing runner pass timing-only tests. (2) my own slips: contract without EVIDENCE lines (H7, gates ERROR), reconcile loop misused `reconcile_blk_open`, awk print `" || "` tripped our own H4a deny row. (3) E3 npm -g edit refused by auto-mode classifier twice → user hand edit. (4) one feater died on API 403 mid-run, gates proved its diff. (5) doc audits found real drift twice (CLAUDE.global.md `open: unknown` clause, MIGRATION step 1 restoring enabledPlugins only). - **Anomalies**: (1) gates caught what executors missed: H6b verifier ECARTS (profile.test.sh:123 comment silenced shellcheck from that line on; my brief said "counts equal to HEAD", gate said "clean"); perl plan r1 FATAL(3) (impossible digest assertion without tty, single quotes = SC2016, timeout(1) misread) and r2 still let a fast-failing runner pass timing-only tests. (2) my own slips: contract without EVIDENCE lines (H7, gates ERROR), reconcile loop misused `reconcile_blk_open`, awk print `" || "` tripped our own H4a deny row. (3) E3 npm -g edit refused by auto-mode classifier twice → user hand edit. (4) one feater died on API 403 mid-run, gates proved its diff. (5) doc audits found real drift twice (CLAUDE.global.md `open: unknown` clause, MIGRATION step 1 restoring enabledPlugins only).
- **Action**: keep fresh gates + confirmation challenger (they paid every time); briefs quote the contract criterion verbatim, never paraphrase it; LRN-289/290 written; gates.sh label guard TODO stays. - **Action**: keep fresh gates + confirmation challenger (they paid every time); briefs quote the contract criterion verbatim, never paraphrase it; LRN-289/290 written; gates.sh label guard TODO stays.
## EVAL-060 — /feat done-triage-levers: r1 9 MAJOR on unrecorded base, r2 2 MAJOR in r1 fixes, gates first pass (2026-11-20)
- **Subject**: /feat done-triage-levers 2026-11-20 (6 doctrine levers, 5 files + 1 gated citer).
- **Method**: advisor on plan, 3-lens challenge r1, 1 confirmation r2, GATE 0/1/2, positive control on untouched tree, scratch-clone simulation each revision.
- **Result**: advisor 5 pre-challenge fixes (exact prose in plan, criterion 12 oracle, TODO n/a, pass B batch). r1: 9 MAJOR → 5 distinct; all 3 lenses converged on unrecorded `base`; 2 on verifier scope too wide (142 durable plans). r2: 2 MAJOR inside r1 fixes (count after commit = silent 0; DONE claimed to bind ship-feature/init-project act sites unchanged). Gates first pass: MET 12/12, CONFORME, PASS (semgrep). Citer re-loop (effort-shift) MET 13/13, CONFORME, PASS.
- **Anomalies**: first dogfood of triage: GATE 2 REPORTED 2 items (run_base option injection LOW, [gated] lines on tracked contract) routed to user, not dropped → follow-up /feat. Census reads `§ Advisor point 1` as heading name (LRN-296 again). Doc-sync found un-patched citer (effort-shift § Advisor point 1).
- **Action**: challenge earned cost on a mechanism run (keep). Follow-up /feat + MEASURE line in TODO. Rule "rule changed → patch citers" needs a grep for every `§ <heading>` the change discharges, before the plan.
+1
View File
@@ -789,3 +789,4 @@ rules:
## 2026-11-20 ## 2026-11-20
- /ship-feature advisor-subagent-scope (7979b9b 6be0669 b71db28): leak root cause = advisor server tool on every sub-agent, no filter, opus ignores CLAUDE.md attachment; rule moved into agent defs/briefs + SubagentStart hook + SDD sonnet pin; LRN-303; behavioural proof pending next usage table. - /ship-feature advisor-subagent-scope (7979b9b 6be0669 b71db28): leak root cause = advisor server tool on every sub-agent, no filter, opus ignores CLAUDE.md attachment; rule moved into agent defs/briefs + SubagentStart hook + SDD sonnet pin; LRN-303; behavioural proof pending next usage table.
- /feat done-triage-levers (19dfe7e 39cf9dd, docs e8c061e): six levers in verify-secure-loop/challenge-plan/capitalize-commit/verifier/CLAUDE.global + effort-shift citer. r1 3 lenses 9 MAJOR (unrecorded base), r2 2 MAJOR in r1 fixes; gates first pass. BDR-151 LRN-304 EVAL-060. Follow-up /feat (5 files) + MEASURE line in TODO. Branch UNMERGED.
+6
View File
@@ -2180,3 +2180,9 @@ Rule: when editing a doctrine file under structure locks, grep the test's lock s
- **Context**: 2026-11-19/20 advisor leak (Run C table: general-purpose 30 calls 7.1M tok, 29 from standalone SDD on opus in another repo). Fix 7979b9b..b71db28: rule in each agent definition/brief, SDD workers sonnet, hook backstop. - **Context**: 2026-11-19/20 advisor leak (Run C table: general-purpose 30 calls 7.1M tok, 29 from standalone SDD on opus in another repo). Fix 7979b9b..b71db28: rule in each agent definition/brief, SDD workers sonnet, hook backstop.
- **Apply**: to scope any harness-listed server tool per sub-agent: put rule in agent definition or dispatcher brief, not CLAUDE.md; word allowance as explicit permission ("one call allowed"); hook = backstop only; behavioural proof = transcript tally, not delivery. - **Apply**: to scope any harness-listed server tool per sub-agent: put rule in agent definition or dispatcher brief, not CLAUDE.md; word allowance as explicit permission ("one call allowed"); hook = backstop only; behavioural proof = transcript tally, not delivery.
- **Reference**: hooks/subagent-advisor.sh, lib/effort-shift.md § Advisor, LRN-294, LRN-295, LRN-301, BDR-150 - **Reference**: hooks/subagent-advisor.sh, lib/effort-shift.md § Advisor, LRN-294, LRN-295, LRN-301, BDR-150
## LRN-304 — Run-movement counter must run before the commit step; after it the diff is a silent +0 (2026-11-20)
- **Pattern**: snippet measuring a run's working-tree movement must run BEFORE the step that commits it. Read after `memory-commit.sh commit` (stages `.claude/tasks`), tree == HEAD, `git diff HEAD` empty rc 0 → silent `+0 / -0`. Fixture must cover the committed case, not only uncommitted.
- **Context**: 2026-11-20 /feat done-triage-levers, lever 6 `TODO +n / -m`. r1 put count in DO step 3 ("taken before step 2" in prose, but placed after). Contract CHECK ran on uncommitted fixture → green. r2 confirmation challenger traced step order → MAJOR. Fix: count in DO step 1, run-base SHA from contract, root pathspec `:/` (subdir cwd = silent 0 too), `--no-color --no-ext-diff`.
- **Apply**: any "report what the run changed" counter: place it before the commit step in the doc's own numbering; base = SHA recorded at run start, never a branch name; fixture rows: uncommitted, committed, subdir cwd, bad SHA → n/a.
- **Reference**: lib/capitalize-commit.md DO step 1, lib/memory-commit.sh MC_PATHS, LRN-298 (placement semantics), LRN-193
+3 -1
View File
@@ -4,7 +4,9 @@
Done history before 2026-10-08 removed 2026-10-23 (git keeps it: `git log -p -- .claude/tasks/TODO.md`); decisions live in `.claude/memory/`. Done history before 2026-10-08 removed 2026-10-23 (git keeps it: `git log -p -- .claude/tasks/TODO.md`); decisions live in `.claude/memory/`.
### Done, triage and loop levers (user 2026-11-20: "oui lance une session neuve avec les six leviers") ### Done, triage and loop levers (user 2026-11-20: "oui lance une session neuve avec les six leviers")
- [ ] NEXT, fresh session: /feat the six levers in .claude/tasks/plans/2026-11-20-done-and-triage-levers.md (done = oracles green, reopen only on reproducible evidence; MINOR fixed before dispatch or dropped; no challenge on a placed decision; loop on a frozen list; contract dry run + plan artifacts in scope; `TODO +n / -m` in summaries). 5 files: lib/verify-secure-loop.md, lib/challenge-plan.md, CLAUDE.global.md (1 line), lib/capitalize-commit.md, agents/verifier.md - [x] DONE 19dfe7e + 39cf9dd (docs e8c061e) /feat feature/done-triage-levers, UNMERGED: /feat the six levers in .claude/tasks/plans/2026-11-20-done-and-triage-levers.md (done = oracles green, reopen only on reproducible evidence; MINOR fixed before dispatch or dropped; no challenge on a placed decision; loop on a frozen list; contract dry run + plan artifacts in scope; `TODO +n / -m` in summaries). 5 files: lib/verify-secure-loop.md, lib/challenge-plan.md, CLAUDE.global.md (1 line), lib/capitalize-commit.md, agents/verifier.md (contract .claude/tasks/contracts/2026-11-20-done-triage-levers-1413.md)
- [ ] NEXT: follow-up /feat (user 2026-11-20, pass B + GATE 2 answers), 5 files: lib/contract-interview.md STEP 4 (dry run + `- run-base:` from every contract-writing flow: guardrails, a11y, ship-feature, init-project, bugfix fast path, hotfix); skills/ship-feature STEP 6 (:262/:344) and skills/init-project STEP 10 (:280/:382) "Fix all CRITICAL" bound by lever 1 (reopen only on reproducible evidence); lib/capitalize-commit.md:75 `git diff --end-of-options` + `^[0-9a-f]{7,40}$` check on `run_base` (GATE 2 LOW); agents/verifier.md STEP 4 `[gated]` lines in scope only on an untracked contract (GATE 2 design note)
- [ ] MEASURE 2026-11-20 levers, after ~5 runs from 19dfe7e: dispatches/run, `TODO +n / -m` per run (measurement lines counted apart), `MINOR dropped:` lines per run plan, challenge skips taken → EVAL. Tripwires (reopen the levers): a BUGS-FOUND entry whose cause matches a `MINOR dropped:` line of a merged run; net open TODO growing run over run; a placed-decision skip on a run that settled an open choice
### Advisor call points (user 2026-11-17: "oui 1 et 2, et le 3 aussi"; amends BDR-150) ### Advisor call points (user 2026-11-17: "oui 1 et 2, et le 3 aussi"; amends BDR-150)
- [x] Run A DONE 6ef3069, merged fc2d84d (docs 09277f5, audits c1a0c32, memory 78a6942) /feat feature/advisor-call-points: CLAUDE.global § Workflow + lib/effort-shift.md § Advisor + plan-challenger/verifier/security-auditor one-call rule (contract .claude/tasks/contracts/2026-11-17-advisor-call-points-1130.md) - [x] Run A DONE 6ef3069, merged fc2d84d (docs 09277f5, audits c1a0c32, memory 78a6942) /feat feature/advisor-call-points: CLAUDE.global § Workflow + lib/effort-shift.md § Advisor + plan-challenger/verifier/security-auditor one-call rule (contract .claude/tasks/contracts/2026-11-17-advisor-call-points-1130.md)
@@ -0,0 +1,77 @@
# CONTRACT — done-triage-levers
- date: 2026-11-20 | flow: feat | branch: feature/done-triage-levers
- status: active
- run-base: 68a4d8b
## REQUEST (verbatim — IMMUTABLE)
Implémente les six leviers décrits dans .claude/tasks/plans/2026-11-20-done-and-triage-levers.md (TODO "NEXT, fresh session"). Suis le plan tel quel : 5 fichiers, challenge maintenu car c'est un nouveau mécanisme.
## CLARIFICATIONS
none — request complete (the handoff plan names the six levers, their substance and their five carriers; placement and exact prose are settled in the run plan .claude/tasks/plans/2026-11-20-done-triage-levers-1413.md, challenged r1 by three lenses)
Q: CLAUDE.global.md lever-4 line wording / A: keep "A TODO loop notes its start SHA in TODO.md, runs that list + user adds; new items: report, run if one breaks its work." [gated 2026-11-20]
Q: strings `MINOR dropped: <finding>` and `Challenge: skipped (placed decision: …)` / A: both OK [gated 2026-11-20]
Q: extend scope to (a) lib/contract-interview.md STEP 4 and (b) skills/ship-feature STEP 6 + skills/init-project STEP 10? / A: both (a) and (b). Three more files exceed /feat's five-file cap: this run stays on its five files, (a)+(b) run as a follow-up /feat right after this one (3 files) [gated 2026-11-20]
Q: GATE 2 REPORTED (1) LOW `$run_base` reaches `git diff` without `--end-of-options`/SHA check (lib/capitalize-commit.md:75), (2) verifier STEP 4 accepts `[gated]` lines on a tracked contract / A: fix both in the follow-up /feat (now 5 files: contract-interview, ship-feature, init-project, capitalize-commit, verifier) [gated 2026-11-20]
## ACCEPTANCE CRITERIA
1. Lever 1, done = oracles green: lib/verify-secure-loop.md has `## DONE: oracles green, reopened only on evidence`: done at GATE 0 MET + GATE 1 CONFORME + GATE 2 PASS; a review reopens only with reproducible evidence (a command failing on HEAD, or real output shown wrong); a plausible scenario gets one attempt at a failing command, else it is a MINOR; a behavioural claim is done at locks green + one live probe + one dated measurement.
CHECK: f=lib/verify-secure-loop.md; grep -q '^## DONE: oracles green, reopened only on evidence$' $f && grep -q 'only with reproducible evidence: a command that fails on HEAD, or real$' $f && grep -q '^output shown wrong. A plausible scenario alone does not reopen the run:$' $f && grep -q '^the main loop tries once to turn it into a failing command, and if it$' $f && grep -q '^the rule") is done at its locks green, one live probe and one dated$' $f && echo LEVER1_OK
EXPECT: LEVER1_OK
EVIDENCE: MET exit=0 marker-found :: LEVER1_OK
2. Lever 2, MINOR triage: lib/verify-secure-loop.md has `## MINOR triage: fold before dispatch, or drop`: a MINOR on the run's plan or diff is folded before dispatch or dropped; no post-gate fix round; a drop is one `MINOR dropped:` line in the report and the run's plan file, nothing in TODO.md / BUGS-FOUND.md / a registry; backlog only on reproducible evidence or user ask; a security finding is never droppable and goes to the user; doc-syncer's `[MINOR]` patch class, guardrails, gates and user questions are untouched.
CHECK: f=lib/verify-secure-loop.md; grep -q '^## MINOR triage: fold before dispatch, or drop$' $f && grep -q '^fix round after the gates for a MINOR: it costs a full gate cycle. A drop$' $f && grep -q 'is one line, `MINOR dropped: <finding>`, in the run report and appended to$' $f && grep -q 'the run.s plan file; nothing goes to TODO.md, BUGS-FOUND.md or any$' $f && grep -q 'what the user asks for. Never a droppable MINOR: a security finding (a$' $f && grep -q '^Untouched by this triage: doc-syncer.s `\[MINOR\]` patch class, the safety$' $f && echo LEVER2_OK
EXPECT: LEVER2_OK
EVIDENCE: MET exit=0 marker-found :: LEVER2_OK
3. Lever 3, placed decision: lib/challenge-plan.md has `## SKIP: a placed decision` before `## DISPATCH`: skip = no challengers and no plan advisor call; three required conditions (text dictated by the decision; the decision is the user's own words or was challenged in the run that wrote it; the caller runs verify-secure-loop.md after its dispatch); the open-choice test, never code versus text, in doubt challenge; the skip is the include's own path (user decision 2026-11-20) and discharges the plan point of effort-shift § Advisor; the caller prints `Challenge: skipped (placed decision: …)`.
CHECK: f=lib/challenge-plan.md; s=$(grep -n '^## SKIP: a placed decision$' $f | cut -d: -f1); d=$(grep -n '^## DISPATCH' $f | cut -d: -f1); [ -n "$s" ] && [ "$s" -lt "$d" ] && grep -q '^no challengers and no plan advisor call. Three conditions, all required:$' $f && grep -q '^decision.s text is the user.s own words, or was challenged in the run that$' $f && grep -q '^user did not dictate), never code versus text; in doubt, challenge. The$' $f && grep -q '^skip is this include.s own path (user decision 2026-11-20): a skill.s$' $f && grep -q '^discharges the plan point (`lib/effort-shift.md` § Advisor). The caller prints$' $f && grep -q '^`Challenge: skipped (placed decision: <the user.s decision, date>)` in$' $f && echo LEVER3_OK
EXPECT: LEVER3_OK
EVIDENCE: MET exit=0 marker-found :: LEVER3_OK
4. Lever 2 at the challenge synthesis: lib/challenge-plan.md's SYNTHESIZE MINOR bullet says each MINOR is folded now or dropped, gives the drop format inline, routes a security finding to the user, and cites `lib/verify-secure-loop.md` § MINOR triage.
CHECK: f=lib/challenge-plan.md; grep -q '^ Each MINOR is folded into the plan now or dropped: a drop is one$' $f && grep -q '^ `MINOR dropped: <finding>` line in the report and the plan file, nothing$' $f && grep -q '^ (`lib/verify-secure-loop.md` § MINOR triage).$' $f && echo SYNTH_OK
EXPECT: SYNTH_OK
EVIDENCE: MET exit=0 marker-found :: SYNTH_OK
5. Lever 4, frozen loop list: CLAUDE.global.md's Planning & TODO section says a TODO loop notes its start SHA in TODO.md, runs that list plus user adds, reports new items and runs one only if it breaks its work; the file stays at or under 320 lines and the new lines at or under 80 chars.
CHECK: f=CLAUDE.global.md; [ "$(wc -l < $f)" -le 320 ] && awk '/^## Planning & TODO/{p=1;next} /^## /{p=0} p' $f > /tmp/.cg5.$$ && grep -q '^ then carries one line per run. A TODO loop notes its start SHA in TODO.md,$' /tmp/.cg5.$$ && grep -q '^ runs that list + user adds; new items: report, run if one breaks its work.$' /tmp/.cg5.$$ && [ "$(git diff -U0 68a4d8b -- $f | grep '^+[^+]' | awk 'length($0)>81' | wc -l)" -eq 0 ] && rm -f /tmp/.cg5.$$ && echo LEVER4_OK
EXPECT: LEVER4_OK
EVIDENCE: MET exit=0 marker-found :: LEVER4_OK
6. Lever 5 main-loop side: lib/verify-secure-loop.md's header says its first section runs before the dev dispatch; `## BEFORE THE FIRST DISPATCH: contract dry run (main loop)` sits before `## GATE 0`, applies when the flow wrote a contract with `CHECK:` lines, records `- run-base: <git rev-parse HEAD>` (a SHA), runs `gates.sh run` on a `mktemp -d` copy from the project root (no ERROR, NOT-MET only for undone work and for that reason, already-MET valid only for keep-green rows), states the scratch-copy simulation for prose oracles inline, and fixes bad oracles before any floor loop. lib/challenge-plan.md restates the two actions outside the SKIP condition, before the executor dispatch.
CHECK: f=lib/verify-secure-loop.md; b=$(grep -n '^## BEFORE THE FIRST DISPATCH: contract dry run (main loop)$' $f | cut -d: -f1); g=$(grep -n '^## GATE 0' $f | cut -d: -f1); [ -n "$b" ] && [ "$b" -lt "$g" ] && grep -q '^section runs before the dev step is dispatched). Turns a$' $f && grep -q '^When the flow wrote a contract with `CHECK:` lines, the main loop does two$' $f && grep -q '^ `- run-base: <git rev-parse HEAD>` (a SHA, never a branch name;$' $f && grep -q '^2. Copies the contract to a `mktemp -d` path and, from the project root,$' $f && grep -q '^ to a scratch copy of the repo and run the CHECKs there (LRN-296).$' $f && grep -q '^A bad oracle is fixed in the contract here, before any floor loop.$' $f && grep -q '^Challenged or skipped: when the flow wrote a contract with `CHECK:` lines,$' lib/challenge-plan.md && grep -q '^before the executor dispatch the main loop records `- run-base:` in the$' lib/challenge-plan.md && grep -q '^(`lib/verify-secure-loop.md` § BEFORE THE FIRST DISPATCH).$' lib/challenge-plan.md && echo DRYRUN_OK
EXPECT: DRYRUN_OK
EVIDENCE: MET exit=0 marker-found :: DRYRUN_OK
7. Lever 5 verifier side: agents/verifier.md STEP 4 counts run artifacts in scope by default (name-status plus untracked): a plan file the diff ADDS under `.claude/tasks/plans/` or `docs/superpowers/plans/`; on an existing plan, appended `MINOR dropped:` lines only; the CONTRACT handed to the verifier, whole when untracked or added, else only its `EVIDENCE:`, `- run-base:` and `[gated]` lines; any other plan or contract change stays out of scope. lib/verify-secure-loop.md's out-of-scope bullet points to it.
CHECK: f=agents/verifier.md; awk '/^## STEP 4/{p=1;next} /^## /{p=0} p' $f > /tmp/.vf7.$$; grep -q '^`FILE SCOPE` says: a plan file the diff ADDS under `.claude/tasks/plans/`$' /tmp/.vf7.$$ && grep -q '^`MINOR dropped:` lines only; the CONTRACT you were handed, whole when$' /tmp/.vf7.$$ && grep -q '^untracked or added, else only its `EVIDENCE:` lines, `- run-base:` line and$' /tmp/.vf7.$$ && grep -q '^`\[gated\]` entries. Any other change to a plan or a contract stays out of$' /tmp/.vf7.$$ && grep -q '^ default (`agents/verifier.md`, STEP 4).$' lib/verify-secure-loop.md && rm -f /tmp/.vf7.$$ && echo SCOPE_OK
EXPECT: SCOPE_OK
EVIDENCE: MET exit=0 marker-found :: SCOPE_OK
8. Lever 6, `TODO +n / -m`: lib/capitalize-commit.md computes `<todo>` in DO step 1, before step 2's commit; `run_base` is a SHA from the contract's `- run-base:` line else `git rev-parse HEAD` at that point (with a `shortcut:` note); a failing diff gives `TODO n/a`; step 3 and both rc 0 templates carry `· <todo>`. The 6-line snippet, on a fixture where a run closes one open item, edits a closed one and adds two, yields `TODO +2 / -1` with the start SHA (uncommitted, then committed, run from a subdirectory), the same with `HEAD` on the uncommitted change, and `TODO n/a` on an unknown SHA.
CHECK: f=$PWD/lib/capitalize-commit.md; a=$(grep -n '^ Then, still before step 2, count the run.s TODO movement as `<todo>`:$' $f | cut -d: -f1); c=$(grep -n '^2. Commit surgically' $f | cut -d: -f1); [ -n "$a" ] && [ "$a" -lt "$c" ] && grep -q '^3. Report by (rc, mem_hash). Every report line ends with `· <todo>` (step 1):$' $f && grep -q '`✅ mémoire committée <mem_hash> · <todo>`' $f && grep -q '`CAPITALIZE: rien à committer · <todo>`' $f && grep -q 'never the gitflow base branch: the contract.s `- run-base:` line' $f && grep -q '`git rev-parse HEAD` now (shortcut: without a contract only the pending' $f && t=$(mktemp -d) && s=$t/s.sh && awk '/^ if d=\$\(git diff --no-color/{p=1} p{print} p&&/todo="TODO n\/a"; fi$/{exit}' $f | sed 's/^ //' > $s && [ "$(wc -l < $s)" -eq 6 ] && mkdir $t/r && cd $t/r && git init -q && mkdir -p .claude/tasks sub && printf -- '- [ ] a\n- [ ] b\n- [x] old\n' > .claude/tasks/TODO.md && git add . && git -c user.email=t@t -c user.name=t commit -qm base && b=$(git rev-parse HEAD) && printf -- '- [x] a DONE\n- [ ] b\n- [x] old edited\n- [ ] c\n- [ ] d\n' > .claude/tasks/TODO.md && r1=$(run_base=$b bash -c ". $s; echo \"\$todo\"") && r2=$(run_base=HEAD bash -c ". $s; echo \"\$todo\"") && r3=$(run_base=0123456789abcdef0123456789abcdef01234567 bash -c ". $s; echo \"\$todo\"") && git add . && git -c user.email=t@t -c user.name=t commit -qm run && r4=$(cd sub && run_base=$b bash -c ". $s; echo \"\$todo\"") && echo "R1=$r1 R2=$r2 R3=$r3 R4=$r4"
EXPECT: R1=TODO +2 / -1 R2=TODO +2 / -1 R3=TODO n/a R4=TODO +2 / -1
EVIDENCE: MET exit=0 marker-found :: R1=TODO +2 / -1 R2=TODO +2 / -1 R3=TODO n/a R4=TODO +2 / -1
9. No em-dash in any line this run adds to the five files, and all five files are changed.
CHECK: n=$(git diff -U0 68a4d8b -- lib/verify-secure-loop.md lib/challenge-plan.md CLAUDE.global.md lib/capitalize-commit.md agents/verifier.md | grep '^+[^+]' | grep -c '—'); [ "$n" -eq 0 ] && [ "$(git diff --name-only 68a4d8b -- lib/verify-secure-loop.md lib/challenge-plan.md CLAUDE.global.md lib/capitalize-commit.md agents/verifier.md | wc -l)" -eq 5 ] && echo NODASH_OK
EXPECT: NODASH_OK
EVIDENCE: MET exit=0 marker-found :: NODASH_OK
10. Locking suites stay green (doctrine census incl. the new § citations, escalate-route count, challenge wiring, advisor row lock).
CHECK: make test suite="lib/tests/doctrine-citers.test.sh lib/tests/effort-routing.test.sh lib/tests/plan-challenger.test.sh lib/tests/subagent-advisor.test.sh" 2>&1 | tail -1
EXPECT: all suites green
EVIDENCE: MET exit=0 marker-found :: all suites green
11. Loop and gate suites stay green.
CHECK: make test suite="lib/tests/loops-light.test.sh lib/tests/loops-heavy.test.sh lib/tests/gates.test.sh lib/tests/contract-verifier.test.sh lib/tests/model-routing.test.sh lib/tests/curated-config-guard.test.sh" 2>&1 | tail -1
EXPECT: all suites green
EVIDENCE: MET exit=0 marker-found :: all suites green
12. Not loosened: apart from the changes criteria 1-8 name (criterion 13's file is outside this count), no existing line of the five files is removed or weakened. Exactly 8 lines are removed against 68a4d8b, each an anchor the plan extends or re-wraps (verify-secure-loop.md header line 3 and "otherwise the dev removes the file.", CLAUDE.global.md "then carries one line per run.", verifier.md's two STEP 4 lines "Compare against the contract's `FILE SCOPE`. Report every out-of-scope" / "file. Disposition is NOT your call: …", capitalize-commit.md "3. Report by (rc, mem_hash):" and its two rc 0 templates); GATE 0 and the security gate read as before.
CHECK: n=$(git diff --numstat 68a4d8b -- lib/verify-secure-loop.md lib/challenge-plan.md CLAUDE.global.md lib/capitalize-commit.md agents/verifier.md | awk '{d+=$2} END{print d+0}'); [ "$n" -eq 8 ] && echo REMOVED_8
EXPECT: REMOVED_8
EVIDENCE: MET exit=0 marker-found :: REMOVED_8
13. [gated 2026-11-20] Citer: lib/effort-shift.md § Advisor point 1 says the plan advisor call is skipped with the challenge for a placed decision, citing `lib/challenge-plan.md` § SKIP; the census still resolves every citation.
CHECK: f=lib/effort-shift.md; grep -q '^ challengers see it (`lib/challenge-plan.md`), at most once per skill run;$' $f && grep -q '^ skipped with the challenge for a placed decision (`lib/challenge-plan.md` § SKIP).$' $f && make test suite=lib/tests/doctrine-citers.test.sh 2>&1 | tail -1 | grep -q 'all suites green' && echo CITER_OK
EXPECT: CITER_OK
EVIDENCE: MET exit=0 marker-found :: CITER_OK
## FILE SCOPE
- lib/verify-secure-loop.md
- lib/challenge-plan.md
- CLAUDE.global.md
- lib/capitalize-commit.md
- agents/verifier.md
- lib/effort-shift.md [gated 2026-11-20] (citer of lever 3)
- this contract and .claude/tasks/plans/2026-11-20-done-triage-levers-1413.md (run artifacts)
@@ -0,0 +1,347 @@
# PLAN r3 — done-triage-levers (/feat, 2026-11-20 14:13)
Source: handoff plan `.claude/tasks/plans/2026-11-20-done-and-triage-levers.md` (six levers,
five carriers, user-approved). Contract: `.claude/tasks/contracts/2026-11-20-done-triage-levers-1413.md`.
Base: develop 68a4d8b. Branch: feature/done-triage-levers.
## Mechanism (exact text: § EXACT DIFF below)
- [ ] lib/verify-secure-loop.md
- header line 3: the include runs after the dev step, except its first section (before dispatch).
- new `## BEFORE THE FIRST DISPATCH: contract dry run (main loop)` before `## GATE 0` (lever 5,
main-loop side), only when the flow wrote a contract with `CHECK:` lines: (1) record
`- run-base: <git rev-parse HEAD>` in the contract header (a SHA; feeds lever 6); (2) from
the project root, `gates.sh run` on a `mktemp -d` copy of the contract (real ledger stays
pending): no ERROR, NOT-MET only for undone work and for that reason, a row already MET
valid only when the work must keep it green; prose oracles: simulate the planned text on a
scratch copy and run the CHECKs there (LRN-296, stated inline). Bad oracle fixed before any
floor loop.
- out-of-scope bullet: "Run artifacts are in scope by default (`agents/verifier.md`, STEP 4)."
- after `## Order invariant`: `## DONE: oracles green, reopened only on evidence` (lever 1,
one attempt to turn a scenario into a failing command) and
`## MINOR triage: fold before dispatch, or drop` (lever 2: findings on the run's plan or diff;
drop line in the report and the run's plan file; security findings never droppable, to the
user; doc-syncer `[MINOR]` patch class untouched).
- unchanged: the three `route(phase="escalate")` (effort-routing lock = 3).
- [ ] lib/challenge-plan.md
- new `## SKIP: a placed decision` before `## DISPATCH` (lever 3): three required conditions
(dictated text; the decision is the user's own words or was challenged in the run that wrote
it; the caller runs verify-secure-loop.md after its dispatch); open-choice test, in doubt
challenge; the skip is the include's own path (user decision 2026-11-20) and discharges the
plan point of effort-shift § Advisor; the `Challenge: skipped (…)` line replaces the summary.
- second paragraph, outside the skip condition: the two dry-run actions restated inline, before
the executor dispatch, citing § BEFORE THE FIRST DISPATCH (pre-dispatch reach of lever 5).
- SYNTHESIZE MINOR bullet: fold or drop, drop format inline, security → user, cites § MINOR triage.
- [ ] CLAUDE.global.md — Planning & TODO last bullet (lever 4): "A TODO loop notes its start SHA
in TODO.md, runs that list + user adds; new items: report, run if one breaks its work."
319 → 320 lines (guard fires only above 320).
- [ ] lib/capitalize-commit.md — DO step 1, before step 2's commit (lever 6): compute `<todo>`;
`run_base` = the contract's `- run-base:` SHA, else `git rev-parse HEAD` then (`shortcut:`:
only pending TODO edits); 6-line snippet, `--no-color --no-ext-diff`, root pathspec
`:/.claude/tasks/TODO.md`; failing diff → `TODO n/a`; step 3 and both rc 0 templates carry
`· <todo>`.
- [ ] agents/verifier.md — STEP 4 (lever 5), with `--name-status` plus untracked: in scope by
default = a plan file the diff ADDS under `.claude/tasks/plans/` or `docs/superpowers/plans/`;
appended `MINOR dropped:` lines on an existing plan; the CONTRACT handed to the verifier, whole
when untracked or added, else only its `EVIDENCE:`, `- run-base:`, `[gated]` lines; any other
plan or contract change stays out of scope.
## Executor steps
1. Extract the EXACT DIFF block of this file and apply it atomically:
`t=$(mktemp -d); awk '/^```diff$/{p=1;next} p&&/^```$/{exit} p'
/home/bchanot/Documents/claude/.claude/tasks/plans/2026-11-20-done-triage-levers-1413.md
> "$t/levers.patch"`, then, from the repo root, `git apply --check "$t/levers.patch"` and
`git apply "$t/levers.patch"` (same shell call, so `$t` survives). git apply is
all-or-nothing; recovery if anything goes wrong: `git checkout -- lib/verify-secure-loop.md
lib/challenge-plan.md CLAUDE.global.md lib/capitalize-commit.md agents/verifier.md`.
2. `bash ~/.claude/lib/gates.sh run .claude/tasks/contracts/2026-11-20-done-triage-levers-1413.md`
→ `GATES — VERDICT: MET`.
3. No other edit. No commit.
## Edge cases
- CLAUDE.global.md at exactly 320 lines: the session-start guard fires only above 320.
- `run_base` unknown SHA or failing diff → `TODO n/a`; start SHA counts uncommitted and
committed edits, from a subdirectory too; `HEAD` taken before the commit counts pending edits
(all fixture-tested, criterion 8).
- `- run-base:` header line: `gates.sh status` parses it unchanged (PENDING(12) checked).
- `§` citations (§ BEFORE THE FIRST DISPATCH, § MINOR triage, § Advisor): resolved by the
doctrine-citers census, flip-tested (renaming a heading turns T6 red).
- Contract CHECKs pinned to 68a4d8b, not `develop`.
## Proof done before dispatch
Fresh scratch clone + r3 text: 12/12 criteria MET (10 suites green, fixture 4 cases, 8 removed
lines). Positive control on the
untouched tree: 10 NOT-MET, the 2 keep-green suite rows MET.
## Challenge r1 (3 lenses: correctness CONCERNS(3), robustness CONCERNS(4), simplicity CONCERNS(1))
- `base` never recorded (3 lenses) → `- run-base:` SHA written at the dry run, `HEAD` fallback,
name distinct from the gitflow base, `--no-color --no-ext-diff`.
- verifier scope too wide, `.claude/tasks` mislabelled transient (2 lenses) → only ADDED plan
files and EVIDENCE/run-base/[gated] contract changes; edits to existing plans stay out.
- dry run unreached before dispatch → header line 3 fixed, actions restated inline in
challenge-plan.md outside the skip; unreached flows named below.
- security findings droppable → never a droppable MINOR, to the user.
- post-gate review precedence → DONE binds ship-feature STEP 6 / init-project STEP 10.
- MINORs taken: `gates.sh run` on a mktemp copy instead of hand runs; LRN-296 reduced to a
citation; SKIP conditions (user's own words or challenged; caller has gates), discharges the
advisor plan point; drop line also in the plan file (tripwire traceable); doc-syncer `[MINOR]`
untouched; triage limited to plan or diff findings; frozen list anchored on the start SHA;
applier dropped for `git apply` of this diff (atomic, named recovery); drop format inline at
SYNTHESIZE; dry run conditional on a contract with CHECKs.
- MINOR dropped: tripwire "open TODO still growing" confounded by measurement lines; the dated
measurement lines are counted apart at the EVAL, no text change.
## Challenge r2 (confirmation, correctness: CONCERNS(2)), closed in r3
- `HEAD` fallback read after step 2's commit → silent `+0 / -0` → count moved to DO step 1,
before the commit; fixture adds the committed and subdirectory cases.
- DONE claimed to bind ship-feature STEP 6 / init-project STEP 10, act sites unchanged → sentence
dropped; both sites go to the pass B scope question.
- MINORs taken: verifier clause keyed on the handed CONTRACT (untracked/added = whole) and on
appended `MINOR dropped:` lines of an existing plan, `--name-status` + untracked; dry run cwd
= project root; LRN-296 procedure inline, "never" dropped; skip grounded in the user decision
of 2026-11-20; lever-4 start SHA written into TODO.md by the loop; executor step names the
plan's absolute path and keeps `$t`; root pathspec `:/`; ship-feature and init-project named
unreached below.
- No further re-challenge: lib/challenge-plan.md allows one confirmation pass.
## This run under lever 1 (a behavioural claim)
Locks: the three `§` citations (census T6) and this contract's CHECKs. Live probe: the next
/feat or /bugfix run (dry run + run-base, SKIP decision, MINOR drops, `TODO +n / -m` line).
Dated measurement: the TODO line written at capitalize, "2026-11-20 levers: after ~5 runs, log
dispatches/run, TODO +n/-m per run (measurement lines apart), `MINOR dropped:` lines per plan,
any post-merge bug traced to a dropped MINOR (EVAL)"; tripwires: a BUGS-FOUND entry whose cause
matches a `MINOR dropped:` line of a merged run, or net open TODO growing run over run.
## User answers (pass B, 2026-11-20): CLAUDE.global line kept, both strings OK, scope (a)+(b) yes → follow-up /feat (3 files) after this run
## Questions asked (pass B)
- The CLAUDE.global.md line wording (loaded in every session).
- The strings `MINOR dropped: <finding>` and `Challenge: skipped (placed decision: …)`.
- Scope beyond five files: (a) lib/contract-interview.md STEP 4 would reach the dry run +
run-base from every contract-writing flow; (b) ship-feature STEP 6 (:262/:344) and
init-project STEP 10 (:280/:382) still say "Fix all CRITICAL", unbound by lever 1.
## Not done (named)
- No skill file changes (five-file limit). Unreached by the pre-dispatch pointer: guardrails and
a11y (contract + executor, no challenge-plan.md), bugfix's trivial fast path and hotfix's
cosmetic skip (no challenge read), bugfix STEP 3b (reads challenge-plan.md before its contract
exists), ship-feature and init-project (dispatch in a later turn, after a human gate).
Contract-less flows count `TODO` from `HEAD` (pending edits only).
- Lever 1 does not bind ship-feature STEP 6 / init-project STEP 10 (their text unchanged).
- Proof of the change after ~5 runs (EVAL) stays a TODO line, per the handoff plan.
## Disposition (STEP 0.6)
- honors BDR-062/BDR-098: CLAUDE.global.md ≤ 320 (one line added).
- honors BDR-065 (amendment: `.claude/tasks/{contracts,plans}` durable): the verifier default
covers only plan files a run ADDS and EVIDENCE/run-base/[gated] contract changes; an edit to
an existing plan stays a gap.
- honors BDR-075: the three-lens challenge stays for every run with an open choice; the skip is
limited to placement of a user's own or already-challenged decision (user approval of lever 3).
- honors BDR-049/BDR-083: fresh blind verifier and GATE 0 untouched.
- applies LRN-296 (scratch simulation), LRN-297 (pointer restates the actions at the act site),
LRN-298 (placement by line order in CHECKs 3 and 6), LRN-281/LRN-173 (EVIDENCE lines, literal
markers, CHECKs run on the precedent and on the untouched tree).
## EXACT DIFF (against develop 68a4d8b)
```diff
diff --git a/CLAUDE.global.md b/CLAUDE.global.md
index 778434e..e87a323 100644
--- a/CLAUDE.global.md
+++ b/CLAUDE.global.md
@@ -113,7 +113,8 @@ code" wins. Repo-specific instructions override both.
- Once it qualifies: plan before code → one subtask = one coherent change
→ check off as you go → high-level note at each milestone. A plan a skill
persists (`.claude/tasks/plans/`, contract) satisfies the rule; TODO.md
- then carries one line per run.
+ then carries one line per run. A TODO loop notes its start SHA in TODO.md,
+ runs that list + user adds; new items: report, run if one breaks its work.
## After code changes
1. Run tests, lint, build, type-check if available. Report what was
diff --git a/agents/verifier.md b/agents/verifier.md
index cd3f0ec..15b7b5b 100644
--- a/agents/verifier.md
+++ b/agents/verifier.md
@@ -101,8 +101,15 @@ Parse the single `FLOOR GUARD:` line:
## STEP 4 — SCOPE CHECK
List the files actually touched (`git diff --name-only` over `DIFF`).
-Compare against the contract's `FILE SCOPE`. Report every out-of-scope
-file. Disposition is NOT your call: the orchestrator treats each one as a
+Compare against the contract's `FILE SCOPE` (`git diff --name-status`
+plus untracked files). Run artifacts are in scope by default, whatever
+`FILE SCOPE` says: a plan file the diff ADDS under `.claude/tasks/plans/`
+or `docs/superpowers/plans/`; on an existing plan, appended
+`MINOR dropped:` lines only; the CONTRACT you were handed, whole when
+untracked or added, else only its `EVIDENCE:` lines, `- run-base:` line and
+`[gated]` entries. Any other change to a plan or a contract stays out of
+scope. Report every other out-of-scope file.
+Disposition is NOT your call: the orchestrator treats each one as a
gap — the dev removes it or justifies it, and an accepted justification
only enters the contract through a human micro-gate.
diff --git a/lib/capitalize-commit.md b/lib/capitalize-commit.md
index 59bc2ac..de907ec 100644
--- a/lib/capitalize-commit.md
+++ b/lib/capitalize-commit.md
@@ -63,14 +63,30 @@ never a shell argument.
- `chore(memory): BLK-010 resolved — bugfix profile path`
- `chore(memory): journal — hotfix copy typo` (journal-only, nothing else)
+ Then, still before step 2, count the run's TODO movement as `<todo>`:
+ `TODO +n / -m`, the open TODO items the run added and removed (closed or
+ dropped); a reworded open item counts on both sides. `run_base` is a SHA,
+ never the gitflow base branch: the contract's `- run-base:` line
+ (`lib/verify-secure-loop.md` § BEFORE THE FIRST DISPATCH), else
+ `git rev-parse HEAD` now (shortcut: without a contract only the pending
+ TODO edits count; edits committed earlier in the run are missed). A
+ failing `git diff` → `TODO n/a`, never a silent `+0 / -0`.
+
+ if d=$(git diff --no-color --no-ext-diff "$run_base" \
+ -- ':/.claude/tasks/TODO.md' 2>/dev/null); then
+ n=$(printf '%s\n' "$d" | grep -c '^+ *- \[ \]')
+ m=$(printf '%s\n' "$d" | grep -c '^- *- \[ \]')
+ todo="TODO +$n / -$m"
+ else todo="TODO n/a"; fi
+
2. Commit surgically via the helper, capturing the memory-commit hash it prints:
mem_hash=$(bash "$HOME/.claude/lib/memory-commit.sh" commit "<message>")
rc=$?
-3. Report by (rc, mem_hash):
- - rc 0, mem_hash non-empty → `✅ mémoire committée <mem_hash>`
- - rc 0, mem_hash empty → `CAPITALIZE: rien à committer` (helper no-op)
+3. Report by (rc, mem_hash). Every report line ends with `· <todo>` (step 1):
+ - rc 0, mem_hash non-empty → `✅ mémoire committée <mem_hash> · <todo>`
+ - rc 0, mem_hash empty → `CAPITALIZE: rien à committer · <todo>` (helper no-op)
- rc 3 → unsafe git state (detached / merge in progress);
memory stays in the working tree for a manual
commit — surface the helper's stderr.
diff --git a/lib/challenge-plan.md b/lib/challenge-plan.md
index fd69e67..2941ff1 100644
--- a/lib/challenge-plan.md
+++ b/lib/challenge-plan.md
@@ -30,6 +30,27 @@ SOLID, synthesis is a no-op. It only costs more when a lens lands a real finding
The main loop's advisor call before the dispatch (below) is the costliest
single item: once per skill run.
+## SKIP: a placed decision
+
+A run that only places a decision the user already made skips this phase:
+no challengers and no plan advisor call. Three conditions, all required:
+the exact text or change is dictated by that decision (no new design); the
+decision's text is the user's own words, or was challenged in the run that
+wrote it; and the caller runs `lib/verify-secure-loop.md` after its
+dispatch, so the gates still run. The test is whether the run settles an
+open choice of its own (a mechanism, a condition, a threshold, wording the
+user did not dictate), never code versus text; in doubt, challenge. The
+skip is this include's own path (user decision 2026-11-20): a skill's
+challenge step that reads this section runs as written, and the skip
+discharges the plan point (`lib/effort-shift.md` § Advisor). The caller prints
+`Challenge: skipped (placed decision: <the user's decision, date>)` in
+place of its CHALLENGE SUMMARY.
+
+Challenged or skipped: when the flow wrote a contract with `CHECK:` lines,
+before the executor dispatch the main loop records `- run-base:` in the
+contract and runs `gates.sh run` on a `mktemp -d` copy of it
+(`lib/verify-secure-loop.md` § BEFORE THE FIRST DISPATCH).
+
## DISPATCH — three fresh challengers, in parallel, blind
**Advisor first (main loop).** Before the first dispatch, with no main-loop
@@ -88,6 +109,10 @@ Parse each `CHALLENGE — LENS: … — VERDICT:` line and merge the FINDINGS:
- **Severity-driven, not consensus.** Any `[BLOCKER]` from ANY single lens is
must-address — the lenses are orthogonal, so a lone security/rollback finding
is real, never outvoted by lens-count. Cross-lens agreement only RANKS the MINORs.
+ Each MINOR is folded into the plan now or dropped: a drop is one
+ `MINOR dropped: <finding>` line in the report and the plan file, nothing
+ in TODO.md or a registry; a security finding goes to the user
+ (`lib/verify-secure-loop.md` § MINOR triage).
- **RE-THINK the aspect the challenge pointed at.** For each BLOCKER (and each
MAJOR you accept): revise the plan on THAT aspect — a NAMED, diffable change to
the plan, never a self-authored "addressed" line. A BLOCKER you consciously keep
diff --git a/lib/verify-secure-loop.md b/lib/verify-secure-loop.md
index b2aaa32..1141a1e 100644
--- a/lib/verify-secure-loop.md
+++ b/lib/verify-secure-loop.md
@@ -1,6 +1,7 @@
# Verify + secure loop — shared orchestrator include (feat, bugfix, guardrails, a11y)
-Runs in the ORCHESTRATOR MAIN LOOP after the dev step completes. Turns a
+Runs in the ORCHESTRATOR MAIN LOOP after the dev step completes (its first
+section runs before the dev step is dispatched). Turns a
finished diff into a verified, security-cleared change through two fresh
gates and bounded loops. Loop decisions live here, in the main loop
(LRN-083: subagents = execution + report). The dev step is a dispatched
@@ -17,6 +18,26 @@ Nominal path is cheap — a free floor run, then
one verifier dispatch + one security dispatch, done. The loop only costs
more when it actually loops.
+## BEFORE THE FIRST DISPATCH: contract dry run (main loop)
+
+When the flow wrote a contract with `CHECK:` lines, the main loop does two
+things before the dev step is dispatched:
+
+1. Records the run's start commit in the contract header, once:
+ `- run-base: <git rev-parse HEAD>` (a SHA, never a branch name;
+ `lib/capitalize-commit.md` counts the run's TODO movement from it).
+2. Copies the contract to a `mktemp -d` path and, from the project root,
+ runs `bash ~/.claude/lib/gates.sh run <copy>`, so the real ledger stays
+ `pending`. Expected: no `ERROR(n)` (malformed ledger: fix it here),
+ NOT-MET rows only where the work is not done yet, each failing for that
+ reason and not for a syntax error, a missing tool or a wrong path. A row
+ already MET is valid only when the work must keep it green (a suite, a
+ line cap); any other is vacuous. A marker that can never match fails
+ like undone work: for oracles that grep prose, apply the planned text
+ to a scratch copy of the repo and run the CHECKs there (LRN-296).
+
+A bad oracle is fixed in the contract here, before any floor loop.
+
## GATE 0 — DETERMINISTIC FLOOR (no dispatch, no model)
Before spending a verifier dispatch, execute the oracles the contract itself
@@ -92,7 +113,8 @@ Parse its single `VERIFY — VERDICT:` line:
cannot fix unverifiability); do not spend a loop on it.
- Out-of-scope files: a dev justification is accepted ONLY through the human
micro-gate that appends `[gated <date>]` to the contract's FILE SCOPE;
- otherwise the dev removes the file.
+ otherwise the dev removes the file. Run artifacts are in scope by
+ default (`agents/verifier.md`, STEP 4).
- Structural failure (`ERROR(…)`, missing/duplicated VERDICT line,
unparsable, crash, `CONFORME` without `PROOF` or without `FLOOR`) → retry
ONCE with a fresh verifier; a 2nd structural failure → human escalation.
@@ -147,3 +169,31 @@ verifier's verdict meaningless. REQUEST conformity is
always re-checked BEFORE security on any re-loop — a security fix that breaks
the feature must not slip through because only the security gate re-ran.
Never the reverse order.
+
+## DONE: oracles green, reopened only on evidence
+
+A run is done when its oracles are green: GATE 0 MET (the suite criterion
+included), GATE 1 CONFORME and GATE 2 PASS on the same diff. After done, a
+review (the end-of-run advisor call, a code review, a re-read) reopens the
+run only with reproducible evidence: a command that fails on HEAD, or real
+output shown wrong. A plausible scenario alone does not reopen the run:
+the main loop tries once to turn it into a failing command, and if it
+cannot, the finding is a MINOR (below). A behavioural claim ("agents obey
+the rule") is done at its locks green, one live probe and one dated
+measurement: a TODO line that carries the date and the tripwires that
+would reopen it.
+
+## MINOR triage: fold before dispatch, or drop
+
+A MINOR finding on the run's plan or diff (from a challenger, a review, an
+advisor) is either folded into the plan before the dispatch or dropped. No
+fix round after the gates for a MINOR: it costs a full gate cycle. A drop
+is one line, `MINOR dropped: <finding>`, in the run report and appended to
+the run's plan file; nothing goes to TODO.md, BUGS-FOUND.md or any
+registry. The backlog takes only findings with reproducible evidence, or
+what the user asks for. Never a droppable MINOR: a security finding (a
+GATE 2 `REPORTED` item, a secret, an injection, authorization or exposure
+issue from any review) goes to the user, who decides fix or record.
+Untouched by this triage: doc-syncer's `[MINOR]` patch class, the safety
+guardrails, every gate, and the user's questions on visible, public-name
+and scope choices.
```