codex-review-branch · git:20260727.b984ff3 · 2026-07-27 · sha256 dcc5d0f32ad4a5ac

codex-review-branch git:20260727.b984ff3A

Immutable. This exact content is served forever at /api/v1/blob/dcc5d0f32ad4a5ac.

---
name: codex-review-branch
description: "Fully automated review of an entire feature branch using Codex MCP"
allowed-tools: mcp__codex__codex, mcp__codex__codex-reply, Bash(git:*), Bash(bash:*), Read, Grep, Glob, Task
---

# Codex Review Branch

Thin entry-point skill — routes to the parent skill for full workflow.

## Parent Skill

This is the **Branch** variant of `codex-code-review`. Full workflow, prompt templates, and review logic are defined in the parent skill.

See `@skills/codex-code-review/SKILL.md`

## Variant

| Property | Value |
|----------|-------|
| Scope | Full branch (all commits since base) |
| Pre-checks | None |
| Prompt template | `@skills/codex-code-review/references/codex-prompt-branch.md` |
| Reviewers | Codex alone. `--dual` adds a secondary reviewer — **off unless the flag is passed** |
| Tier | `thorough` (this is the depth variant — P0/P1/P2 block, round cap 30) |

## Flags

| Flag | Default | Effect |
|------|---------|--------|
| `--dual` | off | Adds a second reviewer in parallel (see parent skill Step 3). Emits `emit-review-gate.sh PENDING`, sets `review_mode=dual`, and **forces stop-guard into `strict` until the state file is rebuilt or the field is changed by hand** — SessionStart does not reset `review_mode` and no supported `dual → single` downgrade exists, so this outlives the session that asked for it. A second opinion that can block. Use for releases, security-sensitive changes, and public API surfaces. |

`--dual` is the only code-review entry point where two reviewers run. `/codex-review-fast` and `/codex-review-doc` are single-reviewer by design and offer no such flag: the cost of the second opinion is only worth paying where the change warrants it, and this is that variant. `/plan-review --dual` is the plan-mode counterpart — same opt-in shape, same default of off, a different loop.

## Trigger

- Keywords: branch review, full branch, review branch, codex-review-branch

## When NOT to Use

- Quick diff-only review (use `/codex-review-fast`)
- Full review with lint + build (use `/codex-review`)
- Document review (use `/codex-review-doc`)