Codex Loop (fix until clean)

Critic→Refiner loop with the Codex CLI as external critic: review → fix approved findings → verify → re-review, until codex is clean or rounds run out. Codex reviews; Claude fixes. Complements /phx:review (Claude panel), run either or both before a PR.

Usage

/phx:codex-loop                    # diff vs default branch, interactive
/phx:codex-loop --uncommitted      # staged + unstaged + untracked
/phx:codex-loop --base develop     # explicit base branch
/phx:codex-loop --auto             # auto-approve P0/P1/P2, skip P3
/phx:codex-loop --max-rounds 2     # default 3

Iron Laws

1. BOUNDED rounds, never exceed --max-rounds (default 3), each round costs codex quota; report remaining findings instead of looping on
2. Verify BEFORE re-review, mix compile --warnings-as-errors + tests must pass before burning a codex round on broken code
3. NEVER commit or push, leave git to the user
4. Codex findings get Iron Law scrutiny, decline suggestions that violate an Iron Law, with explanation in the round report
5. Skipped findings are reported, never dropped, every finding ends as fixed, declined (with reason), or deferred-by-user
6. Missing CLI stops the skill with an install hint, suggest /phx:review as the codex-free alternative; never crash

Workflow

Step 1: Preflight

Run command -v codex. If missing: STOP. Show the install hint (brew install codex or npm i -g @openai/codex, then codex login; codex doctor to diagnose) and suggest /phx:review.

Then two cheap checks that save review rounds: