Codex-Native PR Code Review

Use this workflow to review a pull request or diff with gh when available. Keep findings high-signal, actionable, and grounded in the actual change.

Source of truth

eferences/code-review-command.md

Review Workflow

1. Eligibility check

   • Confirm the PR is still open and ready for review.
   • Skip review if it is clearly out of scope, already handled, or obviously trivial.

2. Collect local guidance

   • Identify the relevant AGENTS.md files for the touched paths.
   • Treat those files as code-review guidance when applicable.

3. Summarize the change

   • Use one fast subagent to summarize the PR and changed areas.

4. Run parallel review passes

   • Launch independent review subagents with different lenses:
     • conventions and AGENTS.md compliance
     • correctness and bug risk
     • history and git blame context
     • prior PR or discussion context when relevant
     • comments or invariants near the changed code

5. Confidence-check findings

   • Re-check each finding with a separate pass before surfacing it.
   • Drop weak or speculative issues.

6. Filter for signal

   • Ignore trivial lint, formatting, or typecheck issues that CI should catch separately.
   • Ignore pre-existing issues unless the current PR makes them worse.
   • Keep only the issues that matter to a senior engineer reviewing this change.

7. Comment or report

   • If the user asked for a GitHub comment, use gh to post it.
   • Otherwise, present the findings directly in the session.

Comment Format

Use this structure for final findings:

`markdown

Code review

Found 2 issues:

1. Brief description of issue

   • Why it matters
   • Evidence: file path or URL with full commit SHA when linking to GitHub

2. Brief description of issue

   • Why it matters
   • Evidence: file path or URL with full commit SHA when linking to GitHub `

If no issues remain after filtering:

`markdown

Code review

No actionable issues found. Checked for correctness, local guidance, and regression risk. `

Review Rules

• Use gh for GitHub operations when available.
• Prefer concrete evidence over speculation.
• Keep comments brief and free of signatures or emojis.
• Cite paths or links precisely when pointing to code.