codex-plan-review

Reviews implementation plans through iterative cross-model feedback via Codex CLI.

34|5|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/AndreevED/claude-code-external-review --skill codex-plan-review-andreeved
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-plan-review
Source: https://github.com/AndreevED/claude-code-external-review/tree/main/skills/codex-plan-review
Command: npx skills add https://github.com/AndreevED/claude-code-external-review --skill codex-plan-review-andreeved

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Implementation plans often contain hidden flaws, missed edge cases, or over-engineered designs that only surface during coding. This Skill sends your plan to an independent external model (Codex) for review, verifies each finding against the actual codebase, and iteratively fixes the plan until it is approved. ## Core Features & Use Cases - Iterative cross-model review loop: Sends the plan plus project rules (CLAUDE.md, .claude/rules) to Codex in headless mode, receives structured JSON findings, and repeats until approval or the iteration limit (default 5). - Verified findings, not blind trust: Every Codex issue is checked against the real code and classified as CONFIRMED (fixed in the plan) or FALSE POSITIVE (rejected with arguments sent back to the reviewer). - Over-engineering detection and confidence threshold: The reviewer flags unnecessary abstractions and scope creep, and only reports issues with confidence >= 75, filtering out stylistic nitpicks. - Use Case: Before implementing a large refactoring, run the skill on your plan file; it produces a corrected plan, a final report, and a full audit log in .codex-plan-review/. ## Quick Start Ask the AI to run /codex-plan-review on your plan file, for example: review my implementation plan at docs/refactor-plan.md with at most 5 iterations.

Frequently Asked Questions about codex-plan-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review an implementation plan with an external AI model?

Run /codex-plan-review with the path to your plan file and an optional iteration limit. The skill sends the plan plus your project rules to Codex, verifies each finding against the codebase, fixes confirmed issues, and repeats until approval.

How does cross-model plan review verification work?

Each issue returned by Codex is checked against the real code before being applied. Confirmed issues are fixed in the plan, while false positives are rejected with detailed arguments sent back to the reviewer on the next iteration.

What do I need installed to use codex-plan-review?

You need the codex CLI available in your PATH, since the skill invokes codex exec in read-only headless mode. Claude Code is also required, as the skill runs as a slash command within it.

What happens when the reviewer and Claude disagree on an issue?

Rejected issues are sent back to Codex with detailed arguments and code references. If findings start repeating across iterations, stalemate detection stops the loop and presents the disagreement to the user for a manual decision.

Where are the review results and logs stored?

All artifacts are written to a .codex-plan-review directory in the project root, including per-iteration prompts, the run log, and a markdown review log documenting findings, verifications, and the final status.