Skip to content

review

/jkz:review <pr-number> runs the phase that scrutinizes the Builder’s diff before it can reach QA. The Judge (adversarial backend) reviews the pull request assuming there is a bug, and the Inspector (validator backend) is the precision filter on that review. A failing verdict does not reach you — it routes straight to the Doctor’s fix cycle, up to three times.

What it does

The command orchestrates the review stage of the build phase in the pipeline:

flowchart LR
    pr(["jkz:reviewing<br/>(PR open)"]) --> CR["CodeRabbit pre-scan<br/>+ CR fix loop"]
    CR --> Val["Pre-push validators"]
    Val --> J["Judge reviews"]
    J --> I["Inspector verifies"]
    I -- PASS --> qa(["jkz:qa"])
    I -. "FAIL · Doctor fixes · up to 3x" .-> J
  • A CodeRabbit pre-scan and fix loop catch the obvious issues first.
  • Pre-push validators run deterministic checks on the diff (secrets, leftover debug statements, capability invariants) and feed the results to the Judge as Level-1 evidence it should not re-flag.
  • The Judge chaos-engineers the diff against the approved plan: it assumes a bug exists and asks how the code fails.
  • The Inspector verifies the Judge’s findings — edge cases and execution claims — filtering out noise and confirming what’s real.
  • After a PASS, a CR reconciliation triages any remaining CodeRabbit-bot findings (VALID / FALSE_POSITIVE / OUT_OF_SCOPE / ALREADY_FIXED) before the issue advances.

On a FAIL, the Doctor applies a minimal targeted fix and the diff goes back through review — up to three attempts before the pipeline escalates to a human.

When to run it

  • After /jkz:build has opened the PR.
  • As the review stage of /jkz:pipeline, which runs it automatically after the build.

Inputs

InputRequiredNotes
PR numberYes/jkz:review <pr-number>. The PR should have been created by /jkz:build.
PR diffRead automaticallyThe Judge and Inspector receive the full diff plus the approved plan.
Pre-validated checksComputed automaticallyDeterministic findings injected into the Judge’s prompt.

What phase it drives

Phase labeljkz:reviewingjkz:qa (PASS) or jkz:fixing (FAIL)
IterationsUp to 3 Doctor fix cycles on FAIL
Active agentsJudge, Inspector, Doctor on FAIL

How issue type changes the review

TypeReview focus
featureCode quality
bugFix correctness
refactorBehavior preserved
choreNo behavior shift

Human checkpoint

Review is an internal gate, not a human checkpoint — its job is to catch problems automatically. A FAIL routes to the Doctor rather than to you; the human decision points sit at plan approval (before) and the post-QA gate plus the merge (after). The pipeline escalates to you only if three fix attempts cannot clear the verdict.

See also