review

Unified Orchestrated Code Review

Detect changed files, dispatch specialized reviewer agents in parallel with injected git context, independently validate every finding, and produce a deduplicated report. Optionally post the results to a GitHub PR.

Target

$ARGUMENTS

Hard Rules

1. Review ONLY the diff scope — changed lines plus their surrounding context. Pre-existing issues outside the diff are out of scope (exception: --full reviews all tracked files).
2. Dispatch each agent at most once, and only agents that exist in .claude/agents/.
3. Every HIGH/MEDIUM-confidence finding passes independent validation (Step 5) before reaching the report. LOW-confidence (<60) items skip validation and go to Open Questions — never silently dropped.
4. goal-verifier produces a verdict report (PASS / NEEDS-ATTENTION / NEEDS-REMEDIATION), not severity findings — its output bypasses Steps 4–6 validation and lands in its own report section.
5. Zero confirmed findings is a valid outcome — report "clean" honestly, do not pad.

Step 1 — Parse Arguments and Detect Changes

Flags: --comment → post GitHub PR comments (default: terminal only). Remaining argument → diff target.

Diff base:

• PR#NNN or a number → gh pr diff $TARGET --name-only
• branch name → git diff --name-only $TARGET...HEAD
• --full → all tracked files (git ls-files)
• empty → git diff --name-only HEAD~1

Gather context (run in parallel):

git diff --stat ${BASE}...HEAD        # changed files + line counts
git diff ${BASE}...HEAD               # full hunks for agent injection
git log --oneline -5                  # intent
gh pr view $PR_NUMBER --json title,body 2>/dev/null   # PR mode only

Build a REVIEW_CONTEXT block:

=== REVIEW CONTEXT ===
## PR Info (if available)
Title / Description (first 500 chars)
## Changed Files (N files, +X/-Y)
<git diff --stat>
## Recent Commits (intent)
<git log --oneline -5>
## Diff Hunks
<diff, truncated to 8000 chars per agent if needed>
=== END CONTEXT ===