anup4khandelwal/codex-stack/review

/review

Use this mode for pre-merge review. Treat it as a production-risk audit, not a lint pass.

Objective

Find the problems that pass CI but still create outages, regressions, or broken product behavior.

Workflow

1. Check current branch and diff against main.
2. Read skills/review/checklist.md.
3. Review the full diff in two passes:

• critical correctness and safety
• warnings and missing coverage

1. Output findings ordered by severity.
2. Recommend concrete fixes and tests.
3. When running in CI on a pull request, publish the findings in a stable PR comment instead of leaving them only in logs.

CLI

bun src/cli.ts review
bun src/cli.ts review --json
bun src/cli.ts review --base origin/main

Output format

• Critical findings
• Warnings
• Missing tests
• Release risk
• Suggested fixes

Guardrails

• Do not nitpick formatting.
• Do not flag issues already fixed in the diff.
• Read the entire diff before concluding.