docs(idea): M20 plan-review-loop runbook + statusmodel + noodrem-guard (T-1424) #124

Merged
janpeter merged 1 commit from docs/M20-review-plan-runbook into main 2026-07-08 15:02:15 +02:00
Owner

Wat

D1-docs-afronding van de M20 plan-review-loop (T-1424).

  • docs/runbooks/review-plan-job.md — herschreven voor het M20-model. De oude versie (2026-05-16) beschreef een self-review-orchestrator met drie interne rondes (structure/logic/risk) + convergentie-detectie; dat bestaat niet meer. Nieuw: pure codex-review, de auto-dispatch-loop, de verdict-keten (applyIdeaReviewVerdict), de toggles, revisierondes + hardstop, en de noodrem-guard (reviewStillActive).
  • docs/manual/02-statuses-and-transitions.md — de Idea-statusdiagram + -tabel bevatte al M20-statussen (via PR #123 docs-audit); aangevuld met de ontbrekende noodrem-transitie (REVIEWING_PLAN → PLAN_READY via cancel), de submit_review-verdict-triggers, auto_materialize_plan, en IDEA_REVIEW_PLAN in de kind-lijst.
  • docs/specs/dialogs/idea.md — transitie-tabel op de M20-verdict-keten + een toggles/noodrem-noot; plus correctie van drie bestaande onnauwkeurigheden die tegen de code zijn geverifieerd:
    • PLAN_FAILED is niet re-grillbaar (GRILL_TRIGGERABLE_FROM sluit het uit);
    • materializeIdeaPlanAction staat toe vanuit {PLAN_READY, PLAN_REVIEWED} (niet alleen PLAN_READY);
    • PLAN_REVIEW_FAILED-herstel loopt niet via startReviewPlanJobAction.

Verificatie

  • Adversariële doc-review-workflow tegen de gemergede code: runbook accuraat bevonden, statusmodel-findings toegepast.
  • npm run docs (INDEX + link-check) groen (151 files).

Context

Sluit M20 af (E2E-1/2a/2b/3 groen; de noodrem-gap die E2E-2b vond is gefixt in mcp PR #80 en uitgerold op de fleet). Alleen docs — geen code/schema.

Product-docs DB-sync volgt via de normale doc-pipeline na merge.

🤖 Generated with Claude Code

## Wat D1-docs-afronding van de M20 plan-review-loop (T-1424). - **`docs/runbooks/review-plan-job.md`** — herschreven voor het M20-model. De oude versie (2026-05-16) beschreef een self-review-orchestrator met drie interne rondes (structure/logic/risk) + convergentie-detectie; dat bestaat niet meer. Nieuw: pure **codex-review**, de auto-dispatch-loop, de verdict-keten (`applyIdeaReviewVerdict`), de toggles, revisierondes + hardstop, en de **noodrem-guard** (`reviewStillActive`). - **`docs/manual/02-statuses-and-transitions.md`** — de Idea-statusdiagram + -tabel bevatte al M20-statussen (via PR #123 docs-audit); aangevuld met de ontbrekende **noodrem-transitie** (`REVIEWING_PLAN → PLAN_READY` via cancel), de `submit_review`-verdict-triggers, `auto_materialize_plan`, en `IDEA_REVIEW_PLAN` in de kind-lijst. - **`docs/specs/dialogs/idea.md`** — transitie-tabel op de M20-verdict-keten + een toggles/noodrem-noot; plus correctie van drie bestaande onnauwkeurigheden die tegen de code zijn geverifieerd: - `PLAN_FAILED` is niet re-grillbaar (`GRILL_TRIGGERABLE_FROM` sluit het uit); - `materializeIdeaPlanAction` staat toe vanuit `{PLAN_READY, PLAN_REVIEWED}` (niet alleen `PLAN_READY`); - `PLAN_REVIEW_FAILED`-herstel loopt niet via `startReviewPlanJobAction`. ## Verificatie - Adversariële doc-review-workflow tegen de gemergede code: runbook accuraat bevonden, statusmodel-findings toegepast. - `npm run docs` (INDEX + link-check) groen (151 files). ## Context Sluit M20 af (E2E-1/2a/2b/3 groen; de noodrem-gap die E2E-2b vond is gefixt in mcp PR #80 en uitgerold op de fleet). Alleen docs — geen code/schema. > Product-docs DB-sync volgt via de normale doc-pipeline na merge. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
docs(idea): M20 plan-review-loop runbook + statusmodel + noodrem-guard (T-1424)
All checks were successful
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 5m23s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / Detect deploy-relevant changes (pull_request) Has been skipped
CI / Deploy Preview (PR) (pull_request) Has been skipped
CI / Deploy Production (main) (pull_request) Has been skipped
b7efb87d69
- docs/runbooks/review-plan-job.md: herschreven voor het M20-model (pure codex-
  review i.p.v. self-review-orchestrator): auto-dispatch loop, verdict-keten,
  toggles (auto_plan_review/auto_materialize_plan), revisierondes + hardstop, en
  de noodrem-guard (reviewStillActive). Vervangt de stale 2026-05-16-versie.
- docs/manual/02-statuses-and-transitions.md: Idea-diagram + tabel aangevuld met
  de noodrem-transitie (REVIEWING_PLAN → PLAN_READY via cancel), verdict-keten-
  triggers en de auto_materialize-materialisatie; IDEA_REVIEW_PLAN in de kinds.
- docs/specs/dialogs/idea.md: transitie-tabel op de M20-verdict-keten + toggles/
  noodrem-noot; plus correcties van bestaande onnauwkeurigheden (PLAN_FAILED niet
  re-grillbaar; materialize vanuit PLAN_READY|PLAN_REVIEWED; PLAN_REVIEW_FAILED-
  herstel niet via startReviewPlanJobAction) — geverifieerd tegen lib/idea-status.ts.

Docs geverifieerd via adversariële doc-review (runbook accuraat; statusmodel-
findings toegepast). Link-check groen.

Co-Authored-By: Claude Opus 4.8 <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!124
No description provided.