Claude Code 환경에서 더 정밀한 다중 에이전트 기반 코드 리뷰를 제공하는 플러그인입니다. 최대 7개의 병렬 서브 에이전트가 코드를 다각도로 분석하고, 자동 수정-재검토-회귀(Revert) 루프를 통해 안전하게 커밋합니다. 기존 내장 리뷰 대비 오탐지(False Positive)는 줄이고 실제 버그는 더 많이 잡아내며, 대화형 UI를 통해 개발자가 최종 수정 여부를 결정할 수 있는 실용적인 워크플로우를 제공합니다.
번역된 본문
adamsreview: Claude Code를 위한 다단계 코드 리뷰 시스템 — 병렬 서브 에이전트(sub-agent) 탐지, 유효성 검사(Validation) 패스, 지속적인 JSON 상태 관리, 그리고 커밋 전에 재검토 및 회귀(Regressions)를 되돌리는 자동화된 수정 루프를 제공합니다. 저의 PR에서 테스트해 본 결과, Claude Code의 기본 내장 /review 및 /ultrareview, CodeRabbit, Greptile, 그리고 Codex의 기본 리뷰 기능보다 훨씬 더 많은 실제 버그를 포착하는 동시에 오탐지(False positive)는 더 적게 발생했습니다. (개인적인 경험에 기반함)
기본 /review를 모델링하여 6개 명령어 파이프라인으로 확장되었습니다. 일반 Claude Code 구독(Max 플랜 권장)으로 실행되므로, 추가 사용량 풀(Extra Usage pool)이 차감되는 /ultrareview와 다르게 추가 요금 부담이 없습니다.
설치 명령어:
/plugin marketplace add adamjgmiller/adamsreview
/plugin install adamsreview@adamsreview
6가지 핵심 명령어:
/adamsreview:review — 브랜치 또는 PR에 대한 다각도 코드 리뷰입니다. 최대 7개의 병렬 서브 에이전트 렌즈(정확성, 보안, UX 등)가 중복 제거 패스, 가벼운 후 심층적인 유효성 검사 게이트, 그리고 (선택적으로) 전체적인 Opus 교차 분석 패스에 데이터를 제공합니다. 신뢰도가 높은 자동 수정 제안이 사전 계산되므로, :fix 및 :walkthrough에서 한 번의 확인으로 일괄 수락할 수 있습니다. --ensemble 옵션을 추가하면 내부 Claude 렌즈 위에 Codex CLI 패스와 PR 봇 댓글 스크래핑이 추가됩니다.
/adamsreview:codex-review — :review와 동등한 역할을 하는 Codex CLI 전용 리뷰입니다. 동일한 결과물 형태를 가지며 하위 스트림(:fix, :add, :walkthrough, :promote)에 그대로 사용할 수 있습니다. --effort low|medium|high|xhigh (기본값 high)를 통해 리뷰 강도를 조절할 수 있습니다.
/adamsreview:add — 외부 소스의 리뷰 결과(Claude Code 클라우드의 /ultrareview 붙여넣기, Opus 1차 검토, 팀원의 메모 등)를 가장 최근 리뷰 결과물에 주입합니다. 기존 결과와 중복 제거되고 동일한 게이트로 검증된 후 기존 PR 댓글에 다시 게시됩니다.
/adamsreview:walkthrough — :fix 명령이 건너뛰는 항목에 대한 대화형 드라이버입니다. 하네스의 AskUserQuestion UI를 사용하여 불확실하거나 인간의 판단이 필요한 항목들을 하나씩 살펴봅니다. 자동 수정을 원하는 항목은 승인(promote)하고 나머지는 건너뛸 수 있습니다. 사전 계산된 자동 수정 제안은 먼저 일괄 수락되며, 나머지는 개별 항목별 브리핑, 옵션, 권장 사항이 제공됩니다. 결정 로그가 PR에 게시됩니다.
/adamsreview:fix — 자동화된 수정 루프입니다. 수정 그룹별로 서브 에이전트를 병렬로 파견한 다음, Opus를 사용하여 작업을 재검토하고, 회귀(Regressions)가 발생한 부분을 되돌리며(revert), 성공적으로 수정된 항목만 커밋합니다. (기본값: 하나의 결합된 커밋, --granular-commits 옵션 시 그룹별 개별 커밋)
/adamsreview:promote — 필터 및 점수 임계값을 우회하여 단일 발견 사항을 자동 수정 가능 항목으로 강제 승격시키는 수동 재정의 명령입니다.
명령어 파일은 commands/ 디렉터리에, 공유 단계 조각과 프롬프트 참조는 fragments/에, 헬퍼 스크립트와 결과물 스키마는 bin/에 위치합니다. 플러그인 런타임은 로드 시 bin/을 자동으로 $PATH에 추가하므로 심볼릭 링크나 설치 스크립트가 필요 없습니다.
권장 워크플로우:
복잡한 PR의 경우 다음 순서대로 명령어를 사용하는 것이 가장 좋습니다.
리뷰(Review): /adamsreview:review를 실행합니다. (또는 Codex CLI가 설치되어 있고, 내부 Claude 렌즈 위에 Codex 패스와 PR 봇 댓글 스크래핑을 추가하여 풀(Pool)하고 싶다면 토큰 비용이 더 높은 /adamsreview:review --ensemble을 사용하세요. Codex 주도의 피어 리뷰를 원한다면 /adamsreview:codex-review [--effort <수준>]을 사용할 수도 있습니다.)
추가(Add, 선택 사항): /adamsreview:add <붙여넣기...> — 원래 리뷰가 놓친 버그를 발견한 병렬 리뷰(클라우드 /ultrareview, Opus 1차 검토, 수동 스캔 등)를 실행한 경우, 여기에 결과를 붙여넣습니다. 이 발견 사항은 4단계(Phase 4)에서 검증되어 기존 항목과 중복 제거된 후 동일한 결과물에 포함됩니다. 자동 수정 대상에 해당하는 항목은 4단계로 넘어가고, 그렇지 않은 항목은 3단계에서 표시됩니다.
연습(Walkthrough, 선택 사항): /adamsreview:walkthrough [임계값] — 수정 명령이 건너뛰는 발견 사항(수동 심층, 심층 보고서 및 light confirmed_mechanical을 포함한 전체 light 레인)을 단계별로 살펴봅니다. 낮은 신호의 항목이 세션을 채우지 않도록 점수가 $threshold(기본값 60) 이상인 항목으로 제한됩니다. 4.5단계에서는 사전 계산된 자동 수정 제안을 포함하는 모든 발견 사항을 한 번의 확인으로 일괄 수락(빠른 경로)합니다.
adamsreview Multi-stage code review for Claude Code — parallel sub-agent detection, validation passes, persistent JSON state, and an automated fix loop that re-reviews and reverts regressions before committing. On my own PRs, it's been catching dramatically more real bugs than Claude Code's built-in /review , /ultrareview , CodeRabbit, Greptile, and Codex's built-in review — while producing fewer false positives. (Anecdotal, n=me.) Modeled after the built-in /review and extended into a six-command pipeline. Runs against your regular Claude Code subscription (Max plan recommended) — unlike /ultrareview , which charges against your Extra Usage pool. /plugin marketplace add adamjgmiller/adamsreview /plugin install adamsreview@adamsreview The six commands: /adamsreview:review — multi-lens code review of a branch or PR. Up to seven parallel sub-agent lenses (correctness, security, UX, etc.) feed a dedup pass, a cheap-then-deep validation gate, and (optionally) a holistic Opus cross-cutting pass. High-confidence auto-fix proposals are pre-computed so :fix and :walkthrough can batch-accept them in one confirm. --ensemble adds a Codex CLI pass and PR bot-comment scrape on top of the internal Claude lenses. /adamsreview:codex-review — Codex CLI peer to :review . Same artifact shape, drop-in for everything downstream ( :fix , :add , :walkthrough , :promote ). Effort tunable via --effort low|medium|high|xhigh (default high ). /adamsreview:add — inject externally-sourced findings (a Claude Code cloud /ultrareview paste, an Opus once-over, a teammate's note) into the most recent review's artifact. Deduped against what's already there, validated by the same gates, re-published to the existing PR comment. /adamsreview:walkthrough — interactive driver for findings :fix would skip. Uses the harness's AskUserQuestion UI to walk through uncertain or human-judgment items one by one — promote what you want auto-fixed, skip the rest. Pre-computed auto-fix proposals are batch-accepted up front; the remainder get per-finding briefing + options + recommendation. Posts a decisions log to the PR. /adamsreview:fix — automated fix loop. Dispatches per-fix-group sub-agents in parallel, then re-reviews the work with Opus, reverts any regressions, and commits the survivors (one combined commit by default; --granular-commits for one per group). /adamsreview:promote — human override that promotes a single finding to auto-fixable, bypassing the lane filter and score threshold. Command files live at bare-stem paths under commands/ ; shared phase fragments and prompt references live under fragments/ ; helper scripts and the artifact schema live under bin/ . The plugin runtime auto-adds bin/ to $PATH on load — no symlinks, no install script. Recommended flow On a non-trivial PR, the commands work best in this order: Review. /adamsreview:review — or /adamsreview:review --ensemble if you have the Codex CLI installed and want to pool a Codex pass plus a PR bot-comment scrape on top of the internal Claude lenses (higher token cost). Or /adamsreview:codex-review [--effort <level>] for a Codex-driven peer review (drop-in for everything downstream; effort tunable; no --ensemble ). Add. (optional) /adamsreview:add <paste...> — if you ran a parallel review (cloud /ultrareview , Opus once-over, manual scan, etc.) that surfaced bugs the original review missed, paste the result here. The findings are validated by Phase 4 and land in the same artifact, deduped against what's already there. Auto-eligible additions feed step 4; non-eligible ones surface in step 3. Walkthrough. (optional) /adamsreview:walkthrough [threshold] — step through findings the fix command would skip (deep-manual, deep-report, and the entire light lane including light confirmed_mechanical ), restricted to those scoring at or above $threshold (default 60) so low-signal items don't pad the session. Step 4.5 batch-accepts all findings carrying a pre-computed auto-fix proposal in one confirm (the fast path); the rest get per-finding briefing + options + recommendation via the harness's AskUserQuestion UI. Promote the ones you want auto-fixed with tailored fix-hints, skip the rest. Posts a decisions log to the PR for audit. Pass a lower threshold (e.g. /adamsreview:walkthrough 30 ) and pick the Full tier at the preflight prompt to audit Phase-3-demoted below_gate findings too. Fix. /adamsreview:fix — applies every auto-eligible finding (including whatever was added in step 2 and promoted in step 3). Phase 7.5 surfaces any remaining auto-fix proposals (light-lane / manual / report findings) for one-confirm batch-accept before Phase 8 dispatch. Default: one combined commit for all surviving fixes; pass --granular-commits for one commit per fix group. Per-group Phase-9 outcome lands in the commit message either way. Each command is independent — you can go straight from review to fix if you only care about auto-eligible findings, or skip review entirely and run :fix against an existing artifact. Steps 2–4 can land days or weeks after step 1; the review artifact persists under ~/.adams-reviews/<slug>/<branch>/ . /adamsreview:promote <id> remains useful for one-off manual promotions outside the walkthrough flow (e.g. promoting a disproven finding with --force , or conceptually looping over a set of IDs — F003 , F037 , F039 — with --defer-publish on each so only the final invocation re-publishes to the PR). Documents CLAUDE.md — operational guide for Claude Code sessions working in this repo. Self-contained for routine work; read first on a fresh session. docs/state-and-gates.md — finding state model, score gates, deep/light lanes (the normative spec). docs/pipeline.md — phase trees and token-tally semantics for every command. docs/helpers.md — helper-script inventory and the batched-helper pattern. bin/schema-v1.json — JSON Schema for artifact.json (source of truth for artifact shape). docs/archive/ — frozen design + build docs (2026-04-19 onward). DESIGN.md (rev 8) is the original normative spec; BUILD.md is the stage-by-stage journal. Not maintained; consult only for historical rationale. plans/ — per-branch plan files. Active follow-ups live in GitHub issues; historical backlog at plans/old-backlog.md (frozen 2026-05-04). Dependencies Runtime Tool Version Used by Notes uv 0.7+ artifact-patch.py , artifact-render.py brew install uv . Scripts use a PEP 723 inline-script shebang ( #!/usr/bin/env -S uv run --quiet --script ) so uv fetches and caches jsonschema on first run — no venv, no global pip install python3 3.10+ invoked by uv uv will install a matching Python if needed bash 3.2+ all *.sh helpers Helpers are intentionally 3.2-portable (no declare -A , mapfile , ${var,,} ), so macOS's default /bin/bash works as-is. On Windows, Git for Windows ships bash 5+ via Git Bash and Claude Code auto-routes through it jq 1.6+ artifact-read.sh , log helpers brew install jq gh 2.x artifact-publish.sh , external-scrape.sh brew install gh , gh auth login git 2.x everywhere standard Installation macOS / Linux Install deps: brew install uv jq gh git (macOS) or the distro equivalent. (macOS's default /bin/bash 3.2 is fine — helpers are 3.2-portable.) In a Claude Code session: /plugin marketplace add adamjgmiller/adamsreview In the same session: /plugin install adamsreview@adamsreview Windows (native) Install Git for Windows — provides Git Bash (bash 5+) and git , which Claude Code uses internally. Claude Code auto-routes #!/usr/bin/env bash helpers through Git Bash; set CLAUDE_CODE_GIT_BASH_PATH if Git Bash lives in a non-default location (see Troubleshooting ). Install uv , jq , and the GitHub CLI . In a Claude Code session: /plugin marketplace add adamjgmiller/adamsreview and /plugin install adamsreview@adamsreview . Install from a local checkout If you've cloned this repo and prefer running from source — or you want to pin to a specific commit — two paths work without the GitHub marketplace round-trip: Persistent install from a local path. In a Cl