클로드 코드 리뷰가 지적할 것과 넘길 것을 REVIEW.md로 정하는 법
클로드 코드(Claude Code) 팀이 10월 26일 자기 팀의 코드 리뷰 방식을 공개했다. 모든 PR을 클로드가 먼저 리뷰하고, 무엇을 지적하고 무엇을 넘길지는 저장소 루트의 REVIEW.md에 적어 둔다. 이 파일을 읽는 건 코드 리뷰(Code Review) 서비스이고, Team·Enterprise 요금제에서 쓸 수 있다.
- 저장소 루트에 REVIEW.md를 만든다. 형식 없는 마크다운이다. 리뷰 댓글 모양은 그대로 두고 무엇을 찾아 보고할지만 바꾼다.
# Review instructions
## What Important means here
Reserve Important for findings that would break behavior, leak data,
or block a rollback. Style, naming, and refactoring suggestions are Nit
at most.
## Cap the nits
Report at most five Nits per review.
## Do not report
- Anything CI already enforces: lint, formatting, type errors
- Generated files under `src/gen/` and any `*.lock` file
## Always check
- New API routes have an integration test
- Log lines don't include email addresses, user IDs, or request bodies
-
기본 브랜치에 머지하고 그 브랜치를 보호한다. 리뷰는 PR의 변경분이 아니라 대상 브랜치나 기본 브랜치의 REVIEW.md를 읽으므로 규칙을 바꿀 때도 먼저 머지해야 한다. 심각도 낮추기, 경로 제외, 닛 개수 제한은 보호된 기본 브랜치에 있는 REVIEW.md일 때만 따른다. 기본 브랜치라면 클래식 브랜치 보호 규칙과 룰셋 모두 보호로 인정된다.
-
규칙이 길어지면 파일을 나눠 루트 REVIEW.md에서
@파일명한 줄로 불러온다. 불러올 파일은 REVIEW.md 옆에 두고 8개까지, REVIEW.md와 합쳐 150,000바이트 아래로 맞춘다. 보호되지 않은 브랜치에서 읽으면@줄은 그냥 글자로 남는다.
# Review instructions
Report at most five Nits per review.
@review-security.md
@review-api.md
하위 폴더에 REVIEW.md를 하나 더 두면 그 경로의 변경에만 검사 항목이 더해진다. 틀린 지적이 잦을 때는 "동작에 관한 주장은 이름으로 추측하지 말고 소스의 file:line을 댈 것" 같은 증거 요구를 넣는다.
내 컴퓨터에서 돌리는 /code-review 명령은 CLAUDE.md만 읽는다. 양쪽에 다 적용할 규칙은 CLAUDE.md에 두고 REVIEW.md에는 PR 리뷰 전용 규칙만 남긴다. 클로드 코드 팀은 리뷰가 같은 지적을 되풀이하면 스킬이나 린트 규칙, CLAUDE.md, REVIEW.md 중 한 곳에서 원인을 고친다고 했다.
출처