review-pr

Comprehensive Code Review

Run a comprehensive code review using multiple specialized agents, each focusing on a different aspect of code quality. Agents are invoked via the Agent tool and run with read-only access to the project (except code-simplifier which needs write access).

Review Aspects (optional): "$ARGUMENTS"

---

Step 1 — Determine Review Scope

1. Run git diff --name-only to identify unstaged changed files (this is the default scope). If there are no unstaged changes, fall back to git diff --cached --name-only (staged changes).
2. If no changes are found at all, tell the user and stop.
3. Parse $ARGUMENTS to detect:
   • Aspect selection: one or more of code, errors, comments, types, tests, simplify, all. Default: all.
   • Execution mode: parallel keyword triggers parallel mode. Default: sequential.
4. Run git diff (or git diff --cached) to capture the full diff content — this is what agents will review.

Display to the user:

── review-pr ──────────────────────────────────────
Scope: git diff (unstaged changes)
Files: {N} changed
Aspects: {selected aspects or "all"}
Mode: {sequential | parallel}
────────────────────────────────────────────────────

Step 1.5 — Load shared tier config

Read .review-loop/config.md if it exists. Extract:

• judgment_model: shared tier override for judgment-tier review agents
• cheap_model: shared tier override for cheap-tier review agents; if absent, cheap-tier dispatches backstop to claude-haiku-4-5-20251001
• review_style: optional review tone / cross-cutting rules

Missing agent tier defaults to judgment.

---

Step 2 — Available Review Aspects

Each aspect maps to a specialized agent in the agents/ directory:

Aspect	Agent	When applicable
code	code-reviewer	Always (general code quality)
errors	silent-failure-hunter	Always (error handling analysis)
comments	comment-analyzer	If comments/docs added or changed
types	type-design-analyzer	If types added or modified
tests	pr-test-analyzer	Always (checks if changes lack tests too)
simplify	code-simplifier	After other reviews pass (polish)