Show HN: adamsreview – better multi-agent PR reviews for Claude Code

개요

adamsreview는 Claude Code의 코드 리뷰 과정을 개선하기 위해 설계된 오픈소스 플러그인으로, 다단계 코드 검토, 병렬 하위 에이전트 활용, 자동 수정 루프 기능을 제공하여 기존 Claude Code의 기능보다 더 많은 실제 버그를 탐지하고 거짓 양성(false positive)을 줄이는 것을 목표로 합니다.

주요 내용

* 다단계 및 병렬 코드 검토: adamsreview는 최대 7개의 병렬 하위 에이전트(정확성, 보안, UX 등)를 활용하여 코드를 다각적으로 검토합니다. 이 검토는 중복 제거(dedup pass) 및 검증 단계(validation passes)를 거칩니다.
* 자동 수정 루프: 코드를 수정한 후 발생하는 회귀(regression)를 탐지하고 수정하기 위한 자동 수정 루프를 제공합니다. 수정 사항을 검토하고, 회귀가 감지되면 되돌린 후 커밋하는 과정을 자동화합니다.
* 다양한 명령어 제공:
* /adamsreview:review: 다중 렌즈 코드 리뷰를 수행하며, --ensemble 옵션을 통해 Codex CLI 및 PR 봇 댓글 스크랩을 통합할 수 있습니다.
* /adamsreview:codex-review: Codex CLI를 사용한 피어 리뷰를 제공하며, --effort 옵션으로 작업 강도를 조절할 수 있습니다.
* /adamsreview:add: 외부에서 얻은 코드 리뷰 결과를 기존 리뷰 결과에 통합합니다.
* /adamsreview:walkthrough: 자동 수정이 어려운 항목에 대해 사용자와 상호작용하며 수정 여부를 결정합니다.
* /adamsreview:fix: 자동 수정이 가능한 모든 제안을 적용하는 루프입니다.
* /adamsreview:promote: 단일 발견 사항을 자동 수정 가능으로 수동 승격시킵니다.
* 상태 지속성: 리뷰 아티팩트는 ~/.adams-reviews/<slug>/<branch>/<review_id>/ 경로에 영구적으로 저장되어, 리뷰 세션 간의 연속성을 보장합니다.
* 설치 및 의존성: Claude Code 플러그인 마켓플레이스를 통해 설치되며, uv, python3, bash, jq, gh, git 등을 의존성으로 가집니다. Windows 환경에서는 Git Bash를 활용합니다.
* 토큰 카운트: 하위 에이전트 토큰과 오케스트레이터 토큰(Claude Code 세션 스크립트 기반)을 측정하여 리뷰 및 수정 과정에서의 비용을 추정합니다. 오케스트레이터 토큰은 macOS의 보안 설정으로 인해 기본적으로 비활성화될 수 있습니다.

시사점

adamsreview는 LLM 기반 코드 리뷰의 한계를 극복하고 실질적인 버그 탐지율을 높이는 데 기여하며, 개발 워크플로우의 효율성과 코드 품질 향상에 잠재적인 영향을 미칠 수 있습니다.