Issue 00 · Autumn 2026日本語 · RSS
AgentKoji

When to Stop AI Code Review

A design plan needed four review passes before it got a GO. How to tell an endless loop from one you must not cut short, plus review CLI traps.

When a second model reviews your code, the hard question is when to stop. Stop too early and holes remain; too late and you get endless “could be stricter” findings. The basic stopping rule is in Choosing a Coding Agent. Here are cases and CLI traps we didn’t cover there. For having another AI rebut a design before any code exists, see Have Another AI Rebut Your Design. CLI behavior was checked with Codex CLI (@openai/codex, codex-cli 0.163.0) on 2026-10-16.

Things that never pass in one round

Plans. One plan went through four passes, v1 to v4.1, absorbing 9 Critical and 12 Important findings in total. Every place that claimed “fully backward compatible” had a slightly different response shape. Check compatibility by diffing real response bodies.

Fail-open code. An implementation meant to keep working when notifications fail piled up P2s for five rounds: per-step outcomes, silent exits under set -e, URLs leaking through argv, a missing --fail-with-body. Walking the reviewer through “secret unset, payload failure, HTTP failure, transport failure” one layer at a time made it converge.

Review the fix too

Fix commits produce their own P2s. “Retry every failed push” queued permanent 4xx errors forever. Run one more round on the fix diff alone.

Don’t rush to fix every finding

A reviewer without conversation history re-raises points you already settled, sometimes as Critical. Check the agreement document and reject with the section number. Before calling existing code a defect, read the decision log and commit bodies. In one consultation, all three findings re-opened settled decisions; we had paid another model to confirm them. Ask only whether a premise changed.

Isolated reviewers for heavy conclusions

For irreversible conclusions, assign several reviewers per claim, each with a different lens and no view of the others. In one analysis, one of nine claims survived.

An adversarial review also caught 33 wrong deletions.

CLI traps

$ codex review --base main "check"
error: the argument '--base <BRANCH>' cannot be used with '[PROMPT]'

We pipe the prompt to codex exec and start it with “review git diff main...HEAD”.

How review output differs by tool: Claude Code vs Cursor vs Codex in Practice.

Summary