Claude Code 팀의 검증 절차 공개: REVIEW.md 브랜치 보호 조건 확인하기
실제 앱 실행과 검사 규칙 분리로 코드를 검증하는 Claude Code 팀의 절차를 살펴본다. REVIEW.md를 읽는 브랜치와 스킬 참조 조건도 공식 문서로 확인했다.

Anthropic의 Claude Code 팀이 2026년 11월 16일 검증 절차를 공개했다. 에이전트가 만든 코드를 실제 앱에서 실행하고 검사 규칙을 변경 코드와 분리하는 방식이다. 제품 전체에 새 검증 기능을 일괄 출시했다는 공지는 아니다. 공식 기술 글에 담긴 팀의 운영 경험이다.
실행 결과로 확인하는 절차
팀은 사용자 흐름을 끝까지 실행하는 E2E 테스트를 권한다. 속성 테스트는 여러 입력에서도 지켜야 할 조건을 확인한다. 차등 테스트는 같은 입력을 기존 시스템과 새 시스템에 넣어 결과를 비교한다.
코드 소유자가 검사를 만들고 실패 이유를 설명한다. 에이전트가 세 차례 수정을 시도해도 검사가 실패하면 사람이 검토한다. 커밋에는 검증 방법을 기록하며 미검증 상태도 none으로 남긴다. 이는 팀이 설명한 절차이며 독립적으로 재현한 성능 결과는 없다.
REVIEW.md를 읽는 브랜치의 조건
Code Review 공식 문서는 PR 자체의 변경분에서 REVIEW.md를 읽지 않는다고 명시한다. 규칙 변경을 적용하려면 먼저 해당 규칙을 병합해야 한다.
보호된 기본 브랜치가 있고 PR 대상이 그 브랜치 또는 ruleset으로 보호되지 않은 브랜치라면 기본 브랜치의 규칙을 읽는다. PR이 ruleset으로 보호된 다른 브랜치를 대상으로 하면 그 대상 브랜치의 규칙을 읽는다. 기본 브랜치가 보호되지 않고 대상 브랜치에도 보호 규칙이 없으면 기본 브랜치의 루트 파일만 읽는다. 보호 설정을 확인하지 못하면 규칙 파일을 읽지 않는다. 기본 브랜치에는 classic 보호 규칙도 인정하지만 다른 브랜치에는 ruleset만 인정한다.
검증 스킬과 Code Review의 스킬 참조도 구분해야 한다. 팀은 앱 실행 절차를 .claude/skills/의 verify 스킬에 적도록 권한다. Code Review가 REVIEW.md에서 참조한 스킬은 본문 지침만 읽으며 스크립트나 명령어를 실행하지 않는다. 스킬 참조에는 보호된 브랜치 조건도 붙는다.
저장소에 적용하기 전
자기 저장소에 적용한다면 실제 사용자 흐름의 검사와 규칙을 읽는 브랜치를 함께 확인할 필요가 있다. 이는 위 문서에서 도출한 운영 제안이다. 이번 확인에서는 계정별 Code Review 동작이나 훅 실행을 시험하지 않았다.



Discussion
No comments yet