codex-review

1# Codex Review
2 
3Run an independent code review via the OpenAI Codex CLI (`codex review`). The value is a second opinion from a **different model family** than the one that wrote the code — Codex catches things Claude misses due to author bias.
4 
5Complements `brains-trust` (generic multi-model opinions). This skill is specialised: git-aware, uses a tuned review prompt, saves structured output.
6 
7## When to Use
8 
9- After a meaningful change, before committing or shipping
10- Before opening a PR, to self-review with an independent reviewer
11- When something feels off but you can't articulate what
12- Periodic whole-app reviews for projects in active development
13- When the user explicitly asks for an "independent" or "second opinion" review
14 
15**Do NOT use** for:
16- Trivial changes (typos, one-line fixes)
17- Research questions or architecture discussions — use `brains-trust` instead
18- Auto-fixing issues — this is advisory only
19 
20## Preflight
21 
221. Confirm Codex CLI is installed:
23   ```bash
24   which codex
25   ```
26   If missing: tell the user to install it (`brew install codex` on macOS, or see https://github.com/openai/codex) and stop. Do not continue.
27 
282. Confirm auth: the first `codex review` call will fail clearly if not logged in. If that happens, instruct the user to run `codex login` and stop.
29 
30## Determine scope
31 
32Pick the scope flag based on what the user asked for:
33 
34| User intent | Flag |
35|---|---|
36…