spec-review

/codex:spec-review — Adversarial Codex review of a spec or plan

Summon OpenAI Codex to adversarially review the latest (or named) superpowers spec or plan, then debate until Codex approves. Codex is the hard gate.

$ARGUMENTS (optional): a target word spec or plan, and/or a name keyword. Examples: /codex:spec-review, /codex:spec-review plan, /codex:spec-review spec evals-dataset.

Every shell block below runs under bash. codex-lib.sh and its helpers use bash arrays and abort under zsh/sh, so each block is wrapped in bash <<'CODEX_SH' … CODEX_SH — it runs under bash even when your default shell is zsh. And because each block runs in a fresh shell (sourced functions and vars do not persist between calls), every block re-resolves and re-sources the lib, then hands values to the next block through a per-repo state file (sr_state_file / sr_state_save / sr_state_load). The shared preamble — resolve LIB, source it, sr_state_load "$STATE" — opens every block.

1. Preflight

bash <<'CODEX_SH'
# Resolve the plugin's lib. Order: installed plugin root, project-local checkout,
# a manual ~/.claude install, then the plugin cache (the unset-env fallback).
LIB=""
for d in "${CLAUDE_PLUGIN_ROOT:-}" ".claude/commands/codex" "${CLAUDE_HOME:-$HOME/.claude}/commands/codex" $(printf '%s\n' "${CLAUDE_HOME:-$HOME/.claude}"/plugins/cache/*/codex/* 2>/dev/null | sort -Vr); do
  [ -n "$d" ] && [ -f "$d/codex-lib.sh" ] && { LIB="$d/codex-lib.sh"; break; }
done
[ -n "$LIB" ] || { echo "codex-lib.sh missing — install the plugin or run install.sh"; exit 1; }
. "$LIB" || { echo "codex-lib.sh failed to source"; exit 1; }
command -v codex >/dev/null 2>&1 || { echo "codex CLI not on PATH"; exit 1; }
have="$(codex --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)"
sr_version_ge "${have:-0.0.0}" 0.140.0 || { echo "codex >= 0.140.0 required (have ${have:-none})"; exit 1; }
# Fresh-shell handoff: start a clean state file and persist LIB for later blocks.
STATE="$(sr_state_file spec-review)"; : > "$STATE"; sr_state_save "$STATE" LIB
echo "Preflight OK (codex ${have:-?}); state $STATE"
CODEX_SH