codex-review-loop

name	codex-review-loop
description	Review a requested diff target with the Codex CLI, fix actionable issues, and rerun until no actionable findings remain.

Codex Review Loop

Use the Codex CLI as the reviewer. You are the editor.

Use codex review - for every review pass. The prompt names the target and any already-checked findings.

codex review - <<'PROMPT'
Review the current uncommitted changes.

Report only actionable issues.
PROMPT

Loop

1. Run codex review -. Name the target in the prompt: uncommitted changes, a commit, a branch comparison, or another requested scope.
2. Treat review findings as leads, not verdicts. Validate each finding yourself. Actionable means a real issue in files this repo ships or uses.
3. For a confirmed bug, add a failing test or a repro command before fixing it when the repo has a practical place for one.
4. Fix confirmed issues yourself.
5. Re-run the relevant checks, such as tests, typecheck, or lint.
6. Re-run codex review - with the same target prompt and any already-checked findings.
7. Stop when there are no actionable findings left.

Repeated Findings

When a finding repeats after you validate it as not actionable, add it to the next prompt. Restate the same target and include the exact Codex finding text plus your validation result.

codex review - <<'PROMPT'
Review the changes introduced by commit <sha>.

Earlier review findings already checked:
- For each repeated finding, paste the exact Codex text and why your validation showed it is not actionable.

Report only new actionable issues.
PROMPT

Judgment

• Fix a finding only after you understand why it is real.
• Touch generated, vendored, or unrelated code only when the requested change depends on it.
• Record false findings as non-actionable instead of changing code to satisfy them.

Report the review command, fixes made, verification commands, and remaining non-actionable findings if any.