Agent skill · duc01226
why-review-loop
[Code Quality] Use when you need to combine /why-review + /fix in a recursive loop — each round runs /why-review to find validated findings then /fix to resolve them, then loops again over the CHANGED target until a fresh full /why-review produces zero findings (nothing left to fix).
What it needs
About 11k tokens when loaded.
What this skill does
<!-- PROMPT-ENHANCE:STEP-TASK-ANCHOR:START --> [BLOCKING] Execute skill steps in declared order. NEVER skip, reorder, or merge steps without explicit user approval. [BLOCKING] Before each step or sub-skill call, update task tracking: set inprogress when step starts, set completed when step ends. [BLOCKING] Every completed/skipped step MUST include brief evidence or explicit skip reason. [BLOCKING] If Task tools are unavailable, create and maintain an equivalent step-by-step plan tracker with the same status transitions. <!-- PROMPT-ENHANCE:STEP-TASK-ANCHOR:END --> Quick Summary Goal: Drive a review target to a clean pass by pairing /why-review with /fix in a recursive loop — each round runs /why-review INLINE to surface validated findings, then /fix to resolve them, then loops again over the CHANGED target — stopping when a complete /why-review pass clears the round's exit bar: zero findings in rounds 1-2, and zero CRITICAL/HIGH/MEDIUM from round 3 (LOW-only ENDS the loop, deferred not fixed). Summary: Each round = /why-review + /fix — /why-review is review-ONLY and never edits the target, so the loop MUST pair it with a fix half; one without the other never converges. Steps (in order): (0) resolve target + Goal Contract → (0b) bind the convergence loop (protocol loop primary + optional /goal accelerator) → (1) round loop { run /why-review INLINE → clear the Trade-Off Gate on the fix set → run /fix on the VALIDATED findings at the owning layer → log iteration } → (2) converge on a zero-findings round OR escalate on non-progress → (3) recap. Convergence: stop ONLY when a fresh full /why-review over the CURRENT (post-fix) target clears that round's exit bar — not a stale PASS predating the last fix. Severity floor — from round 3, LOW stops blocking. Rounds 1-2 converge on an empty validated-finding set (any severity). From round 3 the bar is zero validated CRITICAL/HIGH/MEDIUM — a round whose validated findings are ALL LOW ENDS the loop. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills duc01226/why-review-loop--b650dd