code-review
Code Review — Multi-Agent Local Review
Overview
Runs narrow-lane reviewer agents in parallel, then a verifier that keeps only findings with real impact, distills the "fix first" shortlist, and suppresses the nit tail — merged into REVIEW.md at the repo root. Core principle: a review is worth reading when it finds wrong answers, not style. The lanes are aimed at correctness and structural soundness; the verifier defaults low-impact findings to DROP so the signal isn't buried. The skill scopes, dispatches, and renders — the reviewers and verifier judge.
Light path. A doc-only diff (prose and comments, no code, config or dependency change) dispatches no lanes; REVIEW.md says **Lanes:** none — doc-only and **Verifier:** not run. A change too small for architecture and testing to judge — a one-line fix, a config value, a dependency bump — dispatches the correctness lane and the verifier, headed **Lanes:** correctness (light path), because a one-line regex behind an alert or a version bump for a CVE still needs a traced input. Anything that adds a branch, a function or a file gets every lane. Pass model: "sonnet" on every lane and verifier call unless the user names a model.
Modes & flags
| Flag | Effect |
|---|---|
(none) / path / --staged / --branch <base> |
Diff-scoped review (default fast path) |
--repo |
Whole-repo review — every source file, not just the diff (conformance pass) |
--blueprint <skill> |
Judge architecture + ui-ux against a named blueprint skill (e.g. local-first-app), not the nearest sibling. Implies --repo unless a diff scope is also given |
--background |
Run detached in a git worktree; keep working while it reviews (see Background mode) |
--nits |
Also surface the suppressed hygiene/nit bucket. Off by default |