feat(loops): max-rondes-noodrem (r5) in spec- én plan-review-loop + rondebeleid reviewprompts #84

Merged
janpeter merged 1 commit from feat/spec-plan-loop-max-rondes into main 2026-07-09 18:40:17 +02:00
Owner

Wat & waarom

De M23-spec-review-loop (applySpecReviewVerdict, CHANGES_REQUESTED-tak) had geen max-rondes-guard en de M20-plan-loop (applyIdeaReviewVerdict) evenmin: een niet-convergerende reviewer kon onbeperkt IDEA_REVISE_SPEC-/IDEA_MAKE_PLAN-rondes (opus-4-8, ~$1/ronde) blijven queuen. E2E-1 (IDEA-138) convergeerde in 4 rondes (5→5→3→1 findings), dus niet acuut — maar niets dwong het af.

Twee verdedigingslinies (beleidskeuze JP 2026-07-09: beide maatregelen, grens 5, beide loops):

  1. Server-side cap (hard): MAX_LOOP_ROUNDS = 5 in src/lib/idea-plan-loop.ts. Bij CHANGES_REQUESTED in ronde ≥ 5 queuet submit_review geen revisie meer maar volgt het bestaande REJECTED-escalatiepad: SPEC_FAILED/PLAN_REVIEW_FAILED + claude_question + push met eerlijke tekst ("… convergeert niet"), nieuw outcome max-rounds. De active-job-check blijft voorgaan (geen valse statusclaim terwijl een andere loop-job draait); de plan-loop-variant schrijft de verdict-ronde nog wél in plan_review_log (dual-write blijft kloppend).
  2. Rondebeleid in de prompts (zacht): wait_for_job geeft review_round + max_rounds mee in de SPEC_REVIEW- (pipeline) en IDEA_REVIEW_PLAN-payloads; de vier reviewprompts kregen een convergentie-paragraaf: vanaf r3 rechtvaardigen alleen fundamentele gebreken/blockers nog CHANGES_REQUESTED, geen nieuwe niet-blockers over ongewijzigde tekst, en de laatste ronde wordt aangekondigd. De safe-default ("bij twijfel nooit APPROVED" voor kernpunten) blijft intact.

Semantiek: r1–r5 krijgen elk een review; is r5 nóg CHANGES_REQUESTED, dan escaleert de keten naar de gebruiker. E2E-1 (approve in r4) zou ongewijzigd slagen. Ad-hoc SPEC_REVIEW (zonder idea) is ongemoeid.

Verificatie

  • TDD: nieuwe tests eerst rood gezien (outcome revision→max-rounds, PLANNING→PLAN_REVIEW_FAILED), daarna groen.
  • npm test: 149 files, 1095 tests PASS (incl. 5 nieuwe: cap r5→escalatie, grens r4→revisie r5, active-check-voorrang; gespiegeld in submit-review-{spec,idea}-loop.test.ts).
  • npm run build (tsc --noEmit): schoon.

Rollout

Geen DB-migratie, geen shared-lib/enum-lockstep. Na merge: mcp-stable bijtrekken (pull --ff-only + npm ci) zoals gebruikelijk; fleet-workers pakken de nieuwe prompts/payloads bij de volgende job-claim. Runbook-vermelding in de web-repo kan meeliften met de openstaande "docs-anchor"-follow-up.

🤖 Generated with Claude Code

## Wat & waarom De M23-spec-review-loop (`applySpecReviewVerdict`, CHANGES_REQUESTED-tak) had geen max-rondes-guard en de M20-plan-loop (`applyIdeaReviewVerdict`) evenmin: een niet-convergerende reviewer kon onbeperkt IDEA_REVISE_SPEC-/IDEA_MAKE_PLAN-rondes (opus-4-8, ~$1/ronde) blijven queuen. E2E-1 (IDEA-138) convergeerde in 4 rondes (5→5→3→1 findings), dus niet acuut — maar niets dwong het af. Twee verdedigingslinies (beleidskeuze JP 2026-07-09: beide maatregelen, grens 5, beide loops): 1. **Server-side cap (hard):** `MAX_LOOP_ROUNDS = 5` in `src/lib/idea-plan-loop.ts`. Bij CHANGES_REQUESTED in ronde ≥ 5 queuet `submit_review` geen revisie meer maar volgt het bestaande REJECTED-escalatiepad: `SPEC_FAILED`/`PLAN_REVIEW_FAILED` + `claude_question` + push met eerlijke tekst ("… convergeert niet"), nieuw outcome `max-rounds`. De active-job-check blijft voorgaan (geen valse statusclaim terwijl een andere loop-job draait); de plan-loop-variant schrijft de verdict-ronde nog wél in `plan_review_log` (dual-write blijft kloppend). 2. **Rondebeleid in de prompts (zacht):** `wait_for_job` geeft `review_round` + `max_rounds` mee in de SPEC_REVIEW- (pipeline) en IDEA_REVIEW_PLAN-payloads; de vier reviewprompts kregen een convergentie-paragraaf: vanaf r3 rechtvaardigen alleen fundamentele gebreken/blockers nog CHANGES_REQUESTED, geen nieuwe niet-blockers over ongewijzigde tekst, en de laatste ronde wordt aangekondigd. De safe-default ("bij twijfel nooit APPROVED" voor kernpunten) blijft intact. Semantiek: r1–r5 krijgen elk een review; is r5 nóg CHANGES_REQUESTED, dan escaleert de keten naar de gebruiker. E2E-1 (approve in r4) zou ongewijzigd slagen. Ad-hoc SPEC_REVIEW (zonder idea) is ongemoeid. ## Verificatie - TDD: nieuwe tests eerst rood gezien (outcome `revision`→`max-rounds`, `PLANNING`→`PLAN_REVIEW_FAILED`), daarna groen. - `npm test`: 149 files, **1095 tests PASS** (incl. 5 nieuwe: cap r5→escalatie, grens r4→revisie r5, active-check-voorrang; gespiegeld in `submit-review-{spec,idea}-loop.test.ts`). - `npm run build` (tsc --noEmit): schoon. ## Rollout Geen DB-migratie, geen shared-lib/enum-lockstep. Na merge: `mcp-stable` bijtrekken (pull --ff-only + npm ci) zoals gebruikelijk; fleet-workers pakken de nieuwe prompts/payloads bij de volgende job-claim. Runbook-vermelding in de web-repo kan meeliften met de openstaande "docs-anchor"-follow-up. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
feat(loops): max-rondes-noodrem (r5) in spec- én plan-review-loop + rondebeleid reviewprompts
All checks were successful
CI / Verify (pull_request) Successful in 2m5s
f873b74dbc
Een niet-convergerende reviewer kon onbeperkt IDEA_REVISE_SPEC-/IDEA_MAKE_PLAN-
rondes (opus, ~$1/ronde) blijven queuen: de CHANGES_REQUESTED-takken van
applySpecReviewVerdict en applyIdeaReviewVerdict hadden geen rondegrens.

- MAX_LOOP_ROUNDS=5 in lib/idea-plan-loop.ts; bij CHANGES_REQUESTED in
  ronde >= 5 volgt het REJECTED-escalatiepad (SPEC_FAILED/PLAN_REVIEW_FAILED
  + claude_question + push "convergeert niet") i.p.v. een nieuwe revisie
  (outcome 'max-rounds'); de active-job-check blijft voorgaan (geen valse
  statusclaim terwijl een andere loop-job draait).
- wait_for_job geeft review_round + max_rounds mee in de SPEC_REVIEW-
  (pipeline) en IDEA_REVIEW_PLAN-payloads.
- Rondebeleid in de vier reviewprompts: vanaf r3 rechtvaardigen alleen
  fundamentele gebreken/blockers nog CHANGES_REQUESTED; geen nieuwe
  niet-blockers over tekst die er in eerdere rondes al zo stond.
- Tests: cap (r5 → escalatie), grens (r4 → gewoon revisie r5) en
  active-check-voorrang, gespiegeld in submit-review-{spec,idea}-loop.

Beleidskeuze JP 2026-07-09: beide maatregelen (cap + promptbeleid),
grens 5, beide loops.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/scrum4me-mcp!84
No description provided.