Skip to content

Add /codex:plan-review command#136

Open
erickreutz wants to merge 3 commits intoopenai:mainfrom
erickreutz:eric/plan-review
Open

Add /codex:plan-review command#136
erickreutz wants to merge 3 commits intoopenai:mainfrom
erickreutz:eric/plan-review

Conversation

@erickreutz
Copy link
Copy Markdown

Summary

  • Adds /codex:plan-review — validates a Claude Code plan against the codebase before implementation
  • Codex searches the repo to check completeness, safety, exclusion correctness, ordering risks, and edge cases
  • Picks the most recently modified plan from ~/.claude/plans/ by default, or accepts --plan <name>
  • Supports --background, --wait, --model, and free-form focus text

Motivation

Common workflow: write a detailed plan in Claude Code's plan mode, then want a second opinion from Codex before executing. Currently requires manually constructing a codex exec command with the plan content piped in. This automates that into a single slash command.

Changes

  • plugins/codex/commands/plan-review.md — command definition
  • plugins/codex/prompts/plan-review.md — prompt template with 5 review dimensions
  • plugins/codex/scripts/codex-companion.mjsplan-review subcommand (+135 lines)
  • tests/commands.test.mjs — test for new command, updated command list assertion
  • README.md — documentation and typical flows

Validates Claude Code plans against the codebase before implementation.
Codex searches the repo to check completeness, safety, exclusion
correctness, ordering, and edge cases.

Picks the most recently modified plan from ~/.claude/plans/ by default,
or accepts --plan <name>. Supports --background, --wait, --model, and
free-form focus text.
Update command list test to include plan-review.md, add assertion
test for the command markdown, and document the new command in README.
@erickreutz erickreutz requested a review from a team April 3, 2026 16:43
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8d366a258e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Validate that the resolved plan path stays inside ~/.claude/plans/
before reading. Rejects inputs like --plan ../../etc/passwd.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant