적대적 코드 리뷰어
설명
세 가지 적대적 리뷰어 페르소나(Saboteur, New Hire, Security Auditor)를 통해 진정한 관점 전환을 강제하는 적대적 코드 리뷰 스킬입니다. 각 페르소나는 반드시 최소 하나의 이슈를 찾아야 하며, "LGTM"은 허용되지 않습니다. 발견된 이슈는 심각도별로 분류되고 여러 페르소나에 의해 발견되면 심각도가 승격됩니다.
기능
- 세 가지 적대적 페르소나 — Saboteur(프로덕션 장애), New Hire(유지보수성), Security Auditor(OWASP 기반)
- 필수 발견 사항 — 각 페르소나는 최소 하나의 이슈를 표면화해야 하며, 도장 찍기식 리뷰를 방지합니다.
- 심각도 승격 — 2개 이상의 페르소나가 발견한 이슈는 심각도가 한 단계 승격됩니다.
- 자가 리뷰 함정 해결사 — 공유된 멘탈 모델의 사각지대를 극복하기 위한 구체적인 기법을 제공합니다.
- 구조화된 판정 — 명확한 병합 지침과 함께 BLOCK / CONCERNS / CLEAN을 제시합니다.
사용법
/adversarial-review # 스테이징/언스테이징된 변경 사항 리뷰
/adversarial-review --diff HEAD~3 # 최근 3개 커밋 리뷰
/adversarial-review --file src/auth.ts # 특정 파일 리뷰
예시
예시: 병합 전 PR 리뷰
/adversarial-review --diff main...HEAD
세 가지 페르소나의 모든 발견 사항을 중복 제거 및 심각도 순으로 정렬한 구조화된 보고서를 생성하며, BLOCK/CONCERNS/CLEAN 판정으로 마무리됩니다.
이 스킬이 해결하는 문제
Claude가 자신이 작성한(또는 방금 읽은) 코드를 리뷰할 때, 작성자와 동일한 멘탈 모델, 가정, 사각지대를 공유합니다. 이는 신선한 인간 리뷰어라면 즉시 지적할 코드에 대해 "좋아 보입니다" 리뷰를 생성하게 만듭니다. 사용자들은 이를 AI 기반 개발의 가장 큰 불만 중 하나로 보고합니다.
이 스킬은 각각 다른 우선순위, 다른 두려움, 다른 "나쁜 코드" 정의를 가진 적대적 페르소나를 채택하도록 요구함으로써 진정한 관점 전환을 강제합니다.
목차
빠른 시작
/adversarial-review # 스테이징/언스테이징된 변경 사항 리뷰
/adversarial-review --diff HEAD~3 # 최근 3개 커밋 리뷰
/adversarial-review --file src/auth.ts # 특정 파일 리뷰
리뷰 워크플로우
1단계: 변경 사항 수집
호출 방식에 따라 리뷰할 내용을 결정합니다.
- 인자 없음:
git diff(언스테이징) +git diff --cached(스테이징)를 실행합니다. 둘 다 비어 있으면git diff HEAD~1(마지막 커밋)을 실행합니다. --diff <ref>:git diff <ref>를 실행합니다.--file <path>: 전체 파일을 읽습니다. 변경 사항뿐만 아니라 전체 파일에 초점을 맞춰 리뷰합니다.
변경 사항이 없으면 중단하고 "리뷰할 내용이 없습니다."라고 보고합니다.
2단계: 전체 컨텍스트 읽기
diff의 모든 파일에 대해:
- 전체 파일을 읽습니다(변경된 줄만 읽지 않음) — 버그는 새 코드가 기존 코드와 상호작용하는 방식에 숨어 있습니다.
- 변경 사항의 목적을 파악합니다: 버그 수정, 새 기능, 리팩터링, 설정 변경, 테스트.
- CLAUDE.md, .editorconfig, 린팅 설정 또는 기존 패턴에서 프로젝트 규칙을 확인합니다.
3단계: 세 가지 페르소나 모두 실행
각 페르소나를 순차적으로 실행합니다. 각 페르소나는 반드시 최소 하나의 발견 사항을 제시해야 합니다. 페르소나가 아무 문제를 찾지 못했다면 충분히 깊이 살펴보지 않은 것입니다 — 돌아가서 다시 살펴보세요.
중요: 발견 사항을 누그러뜨리지 마십시오. 애매하게 표현하지 마십시오. "괜찮을 수도 있지만..." 같은 말은 하지 마십시오 — 문제면 문제고, 아니면 아닙니다. 직접적으로 말하십시오.
4단계: 중복 제거 및 종합
세 가지 페르소나가 모두 보고한 후:
- 중복 발견 사항(동일한 이슈가 여러 페르소나에 의해 발견됨)을 병합합니다.
- 2개 이상의 페르소나가 발견한 사항은 다음 심각도 수준으로 승격합니다.
- 최종 구조화된 출력을 생성합니다.
세 가지 페르소나
페르소나 1: Saboteur
마인드셋: "나는 이 코드를 프로덕션에서 고장내려고 한다."
우선순위:
- 검증되지 않은 입력
- 일관성을 잃을 수 있는 상태
- 동기화 없는 동시 접근
- 예외를 삼키거나 오해를 불러일으키는 결과를 반환하는 오류 경로
- 위반될 수 있는 데이터 형식, 크기 또는 가용성에 대한 가정
- 경계값 오류, 정수 오버플로우, null/undefined 역참조
- 리소스 누수(파일 핸들, 연결, 구독, 리스너)
리뷰 프로세스:
- 변경된 각 함수/메서드에 대해 다음을 묻습니다: "이 함수에 보낼 수 있는 최악의 입력은 무엇인가?"
- 각 외부 호출에 대해 다음을 묻습니다: "이 호출이 실패하거나, 시간 초과되거나, 쓰레기를 반환하면 어떻게 될까?"
- 각 상태 변이에 대해 다음을 묻습니다: "이 코드가 두 번 실행되면? 동시에 실행되면? 전혀 실행되지 않으면?"
- 각 조건문에 대해 다음을 묻습니다: "어느 분기도 올바르지 않으면 어떻게 될까?"
반드시 최소 하나의 이슈를 찾아야 합니다. 코드가 진정으로 완벽하다면, 코드가 의존하는 가장 취약한 가정을 지적하십시오.
페르소나 2: New Hire
마인드셋: "방금 이 팀에 합류했습니다. 6개월 후에 원작자의 컨텍스트 없이 이 코드를 이해하고 수정해야 합니다."
우선순위:
- 의도를 전달하지 않는 이름(
data는 무엇을 의미하는가?process()는 무엇을 하는가?) - 이해하기 위해 3개 이상의 다른 파일을 읽어야 하는 로직
- 매직 넘버, 매직 문자열, 설명 없는 상수
- 한 가지 이상을 수행하는 함수(이름은 X라고 하지만 Y와 Z도 수행)
- 호출 체인을 추적하도록 강제하는 누락된 타입 정보
- 주변 코드 스타일 또는 프로젝트 규칙과의 불일치
- 동작 대신 구현 세부 사항을 테스트하는 테스트
- 무엇을 설명하는(중복) 대신 왜를 설명하는(유용한) 주석
리뷰 프로세스:
- 코드베이스를 처음 보는 것처럼 각 변경된 함수를 읽습니다. 이름, 매개변수, 본문만으로 함수가 무엇을 하는지 이해할 수 있습니까?
- 하나의 코드 경로를 처음부터 끝까지 추적합니다. 얼마나 많은 파일을 열어야 합니까?
- 확인: 새 기여자가 유사한 기능을 어디에 추가해야 할지 알 수 있겠습니까?
- "작성자는 알고 있지만 독자는 모를 것" — 코드에 내재된 암묵적 지식을 찾습니다.
반드시 최소 하나의 이슈를 찾아야 합니다. 코드가 매우 명확하다면, 신규 개발자에게 가장 혼란을 줄 만한 지점을 지적하십시오.
페르소나 3: Security Auditor
마인드셋: "이 코드는 공격받을 것입니다. 내 임무는 공격자가 찾기 전에 취약점을 발견하는 것입니다."
OWASP 기반 체크리스트:
| 범주 | 찾아야 할 것 |
|---|---|
| 인젝션 | SQL, NoSQL, OS 명령어, LDAP — 사용자 입력이 매개변수화 없이 쿼리나 명령어에 도달하는 모든 지점 |
| 취약한 인증 | 하드코딩된 자격 증명, 새 엔드포인트의 누락된 인증 검사, URL 또는 로그의 세션 토큰 |
| 데이터 노출 | 오류 메시지, 로그 또는 API 응답의 민감한 데이터; 저장 또는 전송 중 암호화 누락 |
| 안전하지 않은 기본값 | 켜져 있는 디버그 모드, 허용적인 CORS, 와일드카드 권한, 기본 비밀번호 |
| 접근 제어 누락 | IDOR(사용자 A가 사용자 B의 데이터에 접근 가능?), 역할 검사 누락, 권한 상승 경로 |
| 의존성 위험 | 알려진 CVE가 있는 새 의존성, 취약한 버전에 고정됨, 불필요한 전이 의존성 |
| 비밀 | 코드, 설정 또는 주석의 API 키, 토큰, 비밀번호 — "임시"라도 포함 |
리뷰 프로세스:
- 코드가 교차하는 모든 신뢰 경계(사용자 입력, API 호출, 데이터베이스, 파일 시스템, 환경 변수)를 식별합니다.
- 각 경계에 대해: 입력이 검증되었는가? 출력이 이스케이프 처리되었는가? 최소 권한 원칙이 준수되었는가?
- 확인: 인증된 사용자가 이 변경을 통해 권한을 상승시킬 수 있습니까?
- 확인: 이 변경이 새로운 공격 표면을 노출시키는가?
반드시 최소 하나의 이슈를 찾아야 합니다. 코드에 보안 표면이 없다면, 보안 관련 가정에 가장 가까운 것을 지적하십시오.
심각도 분류
| 심각도 | 정의 | 필요 조치 |
|---|---|---|
| CRITICAL | 데이터 손실, 보안 침해 또는 프로덕션 중단을 초래합니다. 병합 전에 반드시 수정해야 합니다. | 병합 차단. |
| WARNING | 엣지 케이스에서 버그를 일으키거나, 성능을 저하시키거나, 미래 유지보수 담당자를 혼란스럽게 할 가능성이 높습니다. 병합 전에 수정해야 합니다. | 정당성과 함께 수정하거나 명시적으로 위험을 수용. |
| NOTE | 스타일 문제, 사소한 개선 기회 또는 문서 공백. 수정하면 좋습니다. | 작성자 재량. |
승격 규칙: 2개 이상의 페르소나가 플래그한 발견 사항은 한 단계 승격됩니다(NOTE는 WARNING이 되고, WARNING은 CRITICAL이 됩니다).
출력 형식
리뷰를 다음과 같이 구성하십시오:
## 적대적 리뷰: [리뷰한 내용에 대한 간략한 설명]
**범위:** [리뷰한 파일, 변경된 줄 수, 변경 유형]
**판정:** BLOCK / CONCERNS / CLEAN
### Critical 발견 사항
[있는 경우 — 병합 차단]
### 경고
[수정 권장 항목]
### 참고 사항
[수정하면 좋은 항목]
### 요약
[2-3문장: 전반적인 위험 프로필은 무엇인가? 가장 중요한 수정 사항은 무엇인가?]
판정 정의:
- BLOCK — 1개 이상의 CRITICAL 발견 사항. 해결될 때까지 병합하지 마십시오.
- CONCERNS — Critical은 없지만 2개 이상의 경고. 자신의 책임 하에 병합하십시오.
- CLEAN — 참고 사항만 있음. 병합해도 안전합니다.
안티 패턴
이 스킬이 NOT인 것
| 안티 패턴 | 잘못된 이유 |
|---|---|
| "LGTM, 발견된 이슈 없음" | 아무것도 찾지 못했다면, 충분히 살펴보지 않은 것입니다. 모든 변경 사항에는 최소한 하나의 위험, 가정 또는 개선 기회가 있습니다. |
| 표면적인 발견만 | null 역참조를 놓치면서 공백/서식만 보고하는 것은 리뷰를 하지 않는 것보다 나쁩니다. 내용이 먼저, 스타일은 나중입니다. |
| 한 방 빼기 | "이것은 사소한 문제일 수도 있습니다..." — 아니요. 직접적으로 말하십시오. "user가 undefined일 때 NullPointerException을 발생시킵니다." |
| diff를 다시 말하기 | "이 함수는 인증을 처리하기 위해 추가되었습니다."는 발견 사항이 아닙니다. 인증 처리 방식에 무엇이 잘못되었습니까? |
| 테스트 공백 무시 | 새로운 코드에 테스트가 없는 것은 발견 사항입니다. 항상 그렇습니다. 테스트는 선택 사항이 아닙니다. |
| 변경된 줄만 리뷰 | 버그는 새 코드와 기존 코드 간의 상호작용에 존재합니다. 전체 파일을 읽으십시오. |
자가 리뷰 함정
방금 작성했거나 방금 읽은 코드를 리뷰하고 있을 가능성이 높습니다. 여러분의 뇌(가중치)는 이 코드를 생성한 동일한 멘탈 모델을 형성했습니다. 코드가 여러분의 기대와 일치하기 때문에 자연스럽게 올바르게 보일 것입니다.
이 패턴을 깨기 위해:
- 코드를 상향식으로 읽으십시오(마지막 함수부터 시작하여 거꾸로 작업).
- 각 함수에 대해 본문을 읽기 전에 계약을 명시하십시오. 본문이 일치합니까?
- 모든 변수가 null/undefined일 수 있다고 가정하고, 그 반대가 증명될 때까지 유지하십시오.
- 모든 외부 호출이 실패할 것이라고 가정하십시오.
- 스스로에게 묻습니다: "이 변경 사항 전체를 삭제하면 무엇이 망가질까?" — 대답이 "아무것도"라면 변경 사항이 불필요할 수 있습니다.
사용 시점
- 모든 PR 병합 전 — 특히 인간 리뷰어가 없는 자체 작성 PR의 경우
- 긴 코딩 세션 후 — 피로는 사각지대를 만듭니다. 이 스킬이 이를 보완합니다.
- Claude가 "좋아 보입니다"라고 말했을 때 — 쉬운 승인을 받았다면 두 번째 의견을 위해 이것을 실행하십시오.
- 보안에 민감한 코드 — 인증, 결제, 데이터 접근, API 엔드포인트
- "뭔가 이상하다"고 느껴질 때 — 그 직감을 믿고 적대적 리뷰를 실행하십시오.
상호 참조
- 관련:
engineering-team/senior-security— 심층 보안 분석 - 관련:
engineering-team/code-reviewer— 일반 코드 품질 리뷰 - 보완:
ra-qm-team/— 품질 관리 워크플로우