Concept (개념)aiverifiedFri May 01
2단계 리뷰 (Two-Stage Review)
별칭: Two-Stage Review · 2단계 리뷰 · 이중 검증 · GAN-style review
#two-stage-review#gan#harness#superpowers#code-review#hrn
요약
GAN(생성적 적대 신경망) 영감의 코드 리뷰 패턴 — (1) 스펙 준수 리뷰어 + (2) 코드 품질 리뷰어 가 서로 다른 기준 으로 이중 검증. Critical 발견 시 즉시 중단 → 재작업 → 재심사 루프. 생성자 vs 검증자 의 적대적 구조가 자기 검열 강도를 높인다.
상세
2단계 분리
| 단계 | 리뷰어 | 검증 기준 |
|---|---|---|
| 1. 스펙 준수 (Spec-compliance) | 명세 vs 구현 대조 | 누락? 의도치 않은 추가? |
| 2. 코드 품질 (Code-quality) | 베스트 프랙티스 vs 구현 | 아키텍처? 성능? 안티패턴? |
왜 두 개인가
- 한 명의 리뷰어 는 한 가지 관점 만 본다. 누락이 발생.
- 서로 다른 평가축 의 두 명을 분리하면 상호 보완.
- GAN 비유: Generator vs Discriminator — 적대적 구조가 둘 다 발전시킨다.
Critical 발견 시 흐름
구현 → 1차 리뷰 → 통과? ──No──> 재작업 → 1차 재리뷰
↓ Yes
2차 리뷰 → 통과? ──No──> 재작업 → 1·2차 재리뷰
↓ Yes
병합
도구별 구현
| 도구 | 1차 (Spec) | 2차 (Quality) |
|---|---|---|
| Superpowers | requesting-code-review 1차 | 같은 스킬의 2차 호출 |
| Claude Code | 첫 Task agent (spec) | 두 번째 Task agent (quality) |
| Cursor | Manual + Rules | Manual + Linter |
방법론
강의 활용 (03 HRN lesson/hrn-superpowers-framework 3대 개념 중 하나):
- GAN 비유 (1분): 생성자 vs 검증자.
- 두 리뷰어의 분리 기준 (1분): Spec vs Quality.
- Critical 루프 (1분): 중단 → 재작업 → 재심사.
주의사항
- GAN 학술 부담: GAN 모르는 청중에게 적대적 검증 정도로 부연.
- 2단계 분리의 시간 비용: 2배 시간 처럼 보이지만 재작업 비용 절감 으로 ROI 양수.
- 자동화 정도: 완전 자동 보다 AI 자동 1차 + 사람 2차 가 현재 권장 패턴.
- Critical 의 정의: 강의에서 Critical 의 기준 (예: 보안·데이터 손실 가능성) 을 명시.