When to Use
- •After Quick Verify for small tasks.
- •After Full Verify for feature or major changes.
- •Always before committing (review staged-only changes).
Review Prompt Template
code
Task: Scope: Key files: Relevant docs: Tests run: Primary risks: Focus areas: High-priority issues only (DRY/SRP, reuse opportunities, regressions, missing tests, security).
Staged-Only Enforcement
Review only staged changes. If anything is unstaged or untracked, stop and fix it.
bash
if git status --porcelain | rg -q '^\?\?'; then echo "Untracked files found. Stage or remove them first."; exit 1; fi if git status --porcelain | rg -q '^.[^ ]'; then echo "Unstaged changes found. Stage or stash them first."; exit 1; fi if git diff --cached --quiet; then echo "No staged changes to review."; exit 1; fi
Output Locations
- •Review bundle:
agents/skills/code-review/reviews/<task>_<timestamp>/- •Context:
context.md - •Claude:
claude.md - •Gemini:
gemini.md - •Codex:
codex.md - •Review resolution:
result.md
- •Context:
Command Template
bash
ts=$(date -u +"%Y%m%dT%H%M%SZ")
task="short-slug"
review_dir="agents/skills/code-review/reviews/${task}_${ts}"
mkdir -p "$review_dir"
prompt_file="${review_dir}/context.md"
result_file="${review_dir}/result.md"
{
cat <<'EOF'
Task:
Scope:
Key files:
Relevant docs:
Tests run:
Primary risks:
Focus areas: High-priority issues only (DRY/SRP, reuse opportunities, regressions, missing tests, security).
Diff:
```diff
EOF
git diff --staged
echo '```'
} > "$prompt_file"
prompt=$(cat "$prompt_file")
claude --model sonnet -p "$prompt" > "${review_dir}/claude.md"
gemini -m gemini-2.5-pro "$prompt" > "${review_dir}/gemini.md"
codex review --uncommitted -c model="codex-5.2-codex" "$prompt" > "${review_dir}/codex.md"
cat <<'EOF' > "$result_file"
# Review Resolution
## High-Priority Issues
- [ ] Item:
- Source: claude|gemini|codex
- Decision: accept|defer|reject
- Rationale:
- Action taken (if any):
## Lower-Priority/Informational
- [ ] Item:
- Source:
- Decision:
- Rationale:
- Action taken (if any):
EOF
Base Branch Reviews
- •For reviewing committed branch changes, use
codex review --base main.
Review Handling
- •Focus reviewers on high-priority issues (bugs, regressions, security, missing tests, DRY/SRP violations).
- •Triage the feedback: verify each point against the staged diff and decide accept/defer/reject.
- •Record decisions and rationale in
result.md, including what was changed or why it was skipped. - •Prioritize DRY/SRP and reuse opportunities.
- •Call out any behavior changes or missing tests.