차단하는 리뷰와 차단하지 않는 리뷰
로컬 diff, 클라우드 멀티에이전트, PR 인라인 리뷰의 배치 기준
리뷰 도구 선택은 더 좋은 하나를 고르는 문제가 아니라 어디에 무엇을 배치할지의 문제입니다. 로컬 /code-review는 지금 diff에서 correctness bug와 reuse·simplification 정리를 함께 잡고, /code-review ultra는 클라우드 샌드박스에서 여러 에이전트를 병렬로 돌려 발견 항목을 독립적으로 재현·검증합니다. CI에서는 같은 리뷰를 claude ultrareview 서브커맨드로 부르고 종료 코드 0과 1로 게이팅합니다. 반면 Claude Code Review는 PR에 인라인으로 붙지만 체크런이 항상 neutral로 끝나 머지를 막지 않습니다. 그리고 -p 헤드리스에서는 슬래시 명령이 아예 동작하지 않으므로, CI는 대화형 편의 기능을 흉내 내는 대신 서브커맨드와 셸 단계로 풀어 써야 합니다.
| 리뷰 수단 | 실행 위치 | 머지 차단력 |
|---|---|---|
/review | 로컬 세션, 단일 패스 | 없음 · 빠른 1차 훑기 |
/code-review [--fix] | 로컬 diff, 번들 스킬 | 없음 · 워킹 트리에 바로 적용 |
claude ultrareview | 클라우드 샌드박스 멀티에이전트 | 종료 코드 0/1로 CI 게이팅 |
| Claude Code Review | Anthropic 인프라, PR 인라인 | 체크런 neutral · 파싱해야 게이팅 |
/autofix-pr | Claude Code on the web 세션 | 차단이 아니라 수정과 푸시 |
- 등급 나누기PR을 일상 변경·고위험 변경·릴리스 브랜치 세 등급으로 먼저 나눕니다.
- 수단 배치일상은 로컬
/code-review로 받고, 고위험과 릴리스 직전만claude ultrareview로 올립니다. - 게이트 만들기체크런 Details의
normal카운트를gh와jq로 파싱해 required 체크를 실패시킵니다. - 기준 문서화무엇을 Important로 볼지와 보고하지 않을 항목을
REVIEW.md에 직접 적습니다.