adversarial-workflow

Adversarial Review Workflow

This project has an adversarial review plugin that orchestrates iterative review loops between Claude Code and OpenAI Codex CLI.

Available Commands

/adversarial-plan <task description>

Creates an implementation plan with adversarial review:

1. Claude analyzes the codebase and writes a detailed implementation plan
2. Codex reviews the plan critically as a senior staff engineer
3. Claude revises based on feedback
4. Loop continues until Codex approves or max iterations (20) reached
5. Pauses for user approval before any implementation

/adversarial-review

Runs adversarial code review on current changes:

1. Captures git diff of all changes
2. Codex reviews the code for bugs, security issues, performance, and style
3. Claude autonomously fixes any critical issues found
4. Loop continues until Codex approves or max iterations (20) reached
5. No pause — fixes are applied automatically

Convergence Protocol

Codex ends every review with exactly one of:

• APPROVED — no blocking issues, work is acceptable
• NEEDS_REVISION — blocking issues listed that must be addressed

Convergence typically happens in 2-3 iterations. The 20-iteration limit is a safety backstop.

Artifact Storage

All artifacts are saved to .adversarial-review/<session-slug>/ in the project root. Each run of /adversarial-plan or /adversarial-review creates a new session directory with a unique slug, so previous sessions are preserved.

A latest symlink at .adversarial-review/latest always points to the most recent session. This is used by /adversarial-review to find plan_final.md from a prior planning session.

.adversarial-review/
  latest -> abcd-efgh-ijkl/
  abcd-efgh-ijkl/           # planning session
    plan_v1.md, plan_v2.md, ...
    review_v1.md, review_v2.md, ...
    plan_final.md
  mnop-qrst-uvwx/           # code review session
    diff_for_review.md
    code_review_v1.md, code_review_v2.md, ...

You may want to add .adversarial-review/ to your project's .gitignore.

Customization

Plugin files are installed to the Claude Code plugin cache. To customize, fork the repo and point your marketplace at your fork, or edit files in the cache directly (changes will be overwritten on update).

• Iteration limit: Currently hardcoded to 20 in the command files (commands/adversarial-plan.md, commands/adversarial-review.md)
• Review prompts: Customize what Codex evaluates by editing scripts/codex-review.sh
• Review types: The script supports plan (architectural review) and code (code change review) types