리뷰 루프은(는) 무엇을 하나요?
단일 세션 내에서 반복적인 작업자-리뷰어 주기입니다. 작업을 수행하고, 리뷰어 하위 에이전트를 생성하여 비판하고, 피드백을 바탕으로 수정하고, 품질 게이트에 도달할 때까지 반복합니다.
핵심 원칙: 첫 번째 초안은 절대 최종본이 아닙니다. 반복적인 비판은 단일 패스보다 더 나은 결과물을 만듭니다.
플랫폼 참고: 이 스킬은 하위 에이전트 생성을 지원하는 에이전트에서 가장 잘 작동합니다. 해당 기능이 없는 플랫폼에서는 새 채팅 컨텍스트를 열고, 작업 결과물만(이전 추론 과정 없이) 붙여넣고, 1~10점 척도로 구체적인 피드백과 함께 점수를 매기도록 요청하여 리뷰어 단계를 시뮬레이션하세요.
빠른 시작
- 다음과 같이 말하세요:
"X 구현해, use review-loop"또는"방금 작성한 파일에 review-loop 실행해줘" - 에이전트가 작업을 수행합니다(또는 기존 작업을 읽습니다)
- 별도의 비평 하위 에이전트가 구체적인 피드백과 함께 1~10점으로 점수를 매깁니다
- 에이전트가 수정하고 점수 >= 8(기본 품질 게이트)에 도달할 때까지 반복합니다
- 최종 결과물과 함께 루프 요약이 제공됩니다
사용 시기
- 사용자가 "use review-loop", "polish this", "iterate on this", "/review-loop"라고 말할 때
- 속도보다 품질이 중요한 복잡한 구현
- 설계 문서, 스펙 또는 기술 문서
- 강건함이 필요한 코드(보안, 데이터 파이프라인, 금융 로직)
- 사용자가 프로세스에 적대적 비평을 포함시키려 할 때
사용하지 말아야 할 때
- 간단한 수정, 빠른 편집, 한 줄 변경
- 테스트가 품질 게이트인 작업(TDD + CI 사용)
- 사용자가 단지 빠르게 완료되기를 원할 때
- 목표가 배포가 아닌 학습인 탐색/스파이크 작업
- 명확한 승인 기준이 없는 작업 — 먼저 기준을 정의한 후 review-loop 사용
기본값
| 설정 | 기본값 |
|---|---|
| 최소 루프 | 2 |
| 최대 루프 | 4 |
| 품질 게이트 | 8/10 |
| 작업자 모델 | (현재 모델) |
| 리뷰어 모델 | (현재 모델 또는 빠르고/균형 잡힌 대안) |
모델 선택
리뷰어 작업은 로직과 제약 조건을 평가합니다. 작업자 작업은 코드를 작성하고 수정합니다. 그에 따라 하위 에이전트 기능을 선택하세요.
중요 규칙: 리뷰어는 항상 작업자와 같거나 더 강력해야 합니다. 리뷰어가 작업자보다 약하면 복잡한 로직을 제대로 비판하거나 미묘한 회귀를 잡아낼 수 없습니다.
| 작업 복잡성 | 작업자 능력 | 리뷰어 능력 | 근거 |
|---|---|---|---|
| 단순/기계적 (CRUD, 포맷팅, 보일러플레이트) | 빠름/경량 | 균형 잡힘 | 경량 작업자는 빠르고, 균형 잡힌 리뷰어가 문제를 쉽게 잡아냅니다 |
| 표준 (기능, 리팩터, 문서) | 균형 잡힘 | 균형 잡힘 | 비용, 속도, 품질의 좋은 조합 |
| 복잡함 (다중 파일, 통합, 설계) | 균형 잡힘 | 고급/추론 | 고급 리뷰어가 미묘한 아키텍처 문제를 잡아내고, 균형 잡힌 작업자가 구현할 수 있습니다 |
| 매우 복잡함 (보안, 퀀트, 분산 시스템) | 고급/추론 | 고급/추론 | 둘 다 전체 컨텍스트와 추론 능력이 필요합니다. 리뷰어는 작업자와 능력이 일치해야 합니다. |
황금률: 작업자는 리뷰어의 피드백에 따라 행동할 수 있을 만큼 똑똑해야 합니다. 리뷰어가 "채널 기반 세마포어로 경쟁 조건을 수정하세요"라고 말했는데 작업자가 동시성에 대해 추론할 수 없다면 루프는 수렴되지 않습니다.
에스컬레이션 신호: 동일한 피드백으로 2회 연속 루프 후에도 점수가 향상되지 않으면 작업자 모델이 너무 약한 것입니다. 에스컬레이션:
- 옵션 A: 사용자에게 더 강력한 모델로 전환하도록 요청
- 옵션 B: 품질 게이트를 일시적으로 낮추고 사용자에게 차이를 알림
- 옵션 C: 작업을 더 작은 하위 작업으로 나누고 각각에 review-loop 실행
기본 동작: 당신(주 에이전트)이 작업자이므로, 작업에 따라 당신의 현재 능력과 같거나 더 높은 리뷰어 하위 에이전트를 생성하세요:
- 대부분의 작업 → 표준/균형 잡힌 리뷰어
- 특수/어려운 작업 → 고급/추론 리뷰어
- 빠른 확인 → 빠름/경량 리뷰어(당신도 경량 작업자 역할을 하는 경우에만)
사용자 재정의
사용자는 요청과 함께 기본값을 인라인으로 재정의할 수 있습니다. 자연스럽게 구문 분석하세요:
"X 구현해, review-loop, quality gate 9, advanced 모델로 리뷰, max 5 loops"
"polish this, 2 loops minimum, gate at 8"
"review-loop 실행해, fast 리뷰어, max 2 loops"
"use review-loop, reasoning 리뷰어, quality gate 9, min 3 max 6"
구문 분석 규칙:
- "quality gate N" 또는 "gate N" → quality_gate = N
- "[모델] reviewer" 또는 "review with [모델]" → 리뷰어 모델 재정의
- "max N loops" → max_loops = N
- "min N loops" → min_loops = N
- 사용자가 지정하지 않으면 기본값 사용
- 사용자가 "thorough" 또는 "strict"라고 말하면 → quality_gate 8, min_loops 2로 해석
- 사용자가 "quick" 또는 "fast"라고 말하면 → max_loops 2, quality_gate 6으로 해석
프로세스
flowchart TD
A[작업 수행] --> B[리뷰어 하위 에이전트 생성]
B --> C{최소 루프 충족?}
C -- 아니오, 계속 진행 --> E[피드백 기반 수정]
C -- 예 --> D{점수 >= 품질 게이트?}
D -- 예 --> F[최종 다듬기 패스]
D -- 아니오 --> G{최대 루프 도달?}
G -- 예, 중단 --> F
G -- 아니오 --> E
E --> B
F --> H([완료])
단계별 가이드
1단계: 작업 수행
평소처럼 작업을 완료하세요. 코드를 작성하고, 스펙을 만들고, 기능을 구현하세요. 망설이지 말고 최선의 첫 번째 시도를 만드세요.
2단계: 리뷰어 하위 에이전트 생성
에이전트 도구를 사용하여 리뷰어를 파견하세요. 리뷰어는 다음을 충족해야 합니다:
- 별도의 하위 에이전트(새로운 컨텍스트, 당신의 추론에 고정되지 않음)
- 작업 결과물(파일, diff)만 수신 — 당신의 사고 과정은 받지 않음
- 구체적이고 실행 가능한 피드백과 함께 1~10점 척도로 점수 매기기
- 기본적으로 균형 잡힌/표준 모델 사용(복잡하거나 특수한 작업의 경우 고급 추론 모델 사용)
리뷰어 프롬프트 템플릿:
당신은 비평적 리뷰어입니다. 다음 작업을 1~10점으로 평가하고 구체적이고 실행 가능한 피드백을 제공하세요.
## 수행된 작업
{작업에 대한 간단한 설명}
## 리뷰 기준
{작업별 기준 — 이 작업에 중요한 것}
잘 작성된 기준의 예:
REST API 엔드포인트의 경우:
- 올바른 HTTP 상태 코드 사용
- 모든 매개변수에 입력 검증 존재
- 인증 적용됨; 인증되지 않은 접근 없음
- N+1 쿼리 패턴 없음
설계 문서의 경우:
- 문제 설명이 명확함
- 트레이드오프와 함께 대안 고려
- 구현 복잡성에 대한 모호한 설명 없음
- 성공 메트릭이 측정 가능함
데이터 파이프라인의 경우:
- 멱등성 — 다시 실행해도 안전함
- 스키마 변경을 우아하게 처리
- 실패 모드 문서화
- PII 처리 해결
## 지침
1. 작업을 주의 깊게 읽으세요
2. 1~10점 척도로 점수를 매기세요:
- 1-3: 근본적으로 손상되었거나 주요 요구 사항 누락
- 4-6: 작동하지만 심각한 문제 있음
- 7-8: 좋음, 사소한 문제만 있음
- 9-10: 훌륭함, 배포 준비 완료
3. 해당되는 경우 file:line 참조와 함께 구체적인 문제를 나열하세요
4. 각 문제에 대해 왜 중요한지(WHY)와 무엇을 수정할지(WHAT) 설명하세요
5. 예의를 갖추지 마세요 — 정직하고 직접적으로 하세요
6. 점수를 "Score: N/10"으로 명확하게 표시하세요
## 리뷰할 파일
{파일 내용을 붙여넣거나 관련 발췌문과 함께 파일 경로 나열}
3단계: 피드백 구문 분석
리뷰어 응답에서 다음을 추출하세요:
- 점수 (숫자)
- 문제점 (치명적 / 중요 / 사소로 분류)
- 구체적인 수정 사항 (변경할 내용)
사용자에게 보고:
루프 {N}/{max}: 점수 {X}/10
- {주요 피드백 요약}
4단계: 중단 조건 확인
다음 순서로:
- 완료된 루프 < 최소 루프 → 계속 (항상)
- 점수 >= 품질 게이트 → 중단, 최종 다듬기로 이동
- 완료된 루프 >= 최대 루프 → 중단, 최종 다듬기로 이동
- 그 외의 경우 → 수정하고 루프 반복
5단계: 수정
리뷰어의 피드백을 반영하세요. 치명적 및 중요 문제를 수정하세요. 사소한 문제는 선택 사항입니다. 그런 다음 2단계로 돌아가세요.
중요: 각 수정은 목표 지향적이어야 합니다. 모든 것을 다시 작성하지 말고 리뷰어가 지적한 부분을 수정하세요. 회귀를 방지하기 위해 이전 모든 피드백을 정신적으로 유지하세요.
6단계: 최종 다듬기
루프가 종료되면(품질 게이트 충족 또는 최대 루프 도달):
- 남은 사소한 문제가 있으면 해결(사소한 경우)
- 최종 결과물이 일관성 있는지 확인(수정 주기로 인한 아티팩트 없음)
- 최종 점수와 루프 횟수를 사용자에게 보고
작업 유형별 리뷰어 기준 조정
| 작업 유형 | 리뷰어가 중점을 둘 부분 |
|---|---|
| 코드 | 정확성, 엣지 케이스, 오류 처리, 가독성, 보안 문제 없음 |
| 스펙/설계 | 완전성, 실현 가능성, 모호함 없음, 구현 가능성 |
| 리팩터 | 동작 변경 없음, 회귀 없음, 이전보다 깔끔함 |
| 문서 | 명확성, 구조, 대상 독자에 적합, 군더더기 없음 |
| 버그 수정 | 근본 원인 해결, 회귀 테스트 존재, 부작용 없음 |
| 인프라/IaC | 멱등성, 최소 권한, 하드코딩된 비밀 없음, 삭제 안전성 |
| 데이터베이스 마이그레이션 | 되돌리기 가능성, 인덱스 전략, 데이터 손실 위험, 대규모 성능 |
| API 설계 | 이전 버전과의 호환성, 인증, 버전 관리, 오류 계약 |
| 테스트 스위트 | 엣지 케이스 커버리지, 테스트 간 의존성 없음, 의미 있는 단언 |
두 가지 작동 모드
모드 A: "수행 및 리뷰" (전체 주기)
사용자가 작업을 제공하고 review-loop 사용을 요청합니다. 작업을 수행하고 리뷰 루프를 실행합니다.
사용자: "캐싱 레이어를 구현해. use review-loop, quality gate 8."
당신:
1. 캐싱 레이어 구현
2. 리뷰어 생성 → 점수 6, 피드백: 제거 정책 누락, TTL 없음
3. 수정: 제거 정책 + TTL 추가
4. 리뷰어 생성 → 점수 8, 피드백: 사소한 네이밍 지적
5. 최종 다듬기, 완료
모드 B: "기존 항목 리뷰" (리뷰만)
사용자가 이미 작업을 수행했거나 당신이 이미 작업을 수행했습니다. 기존 항목에 대해 리뷰 루프만 실행합니다.
사용자: "방금 작성한 인증 모듈에 review-loop 실행해줘"
당신:
1. 인증 모듈 읽기
2. 리뷰어 생성 → 점수 5, 피드백: SQL 인젝션, 속도 제한 없음
3. 수정: 쿼리 매개변수화, 속도 제한기 추가
4. 리뷰어 생성 → 점수 8, 승인
5. 완료
위험 신호
절대 하지 말아야 할 것:
- 하위 에이전트를 생성하는 대신 자체 리뷰(앵커링 편향)
- 정당한 이유 없이 "피드백이 틀렸다"며 수정 주기 건너뛰기
- 자신의 점수 부풀리기("내 생각에 이건 실제로 9점이야")
- 사용자 동의 없이 최대 루프 초과
- 리뷰어를 당신의 전체 추론/이력으로 생성(리뷰어는 당신의 의도가 아닌 작업을 검토해야 함)
리뷰어가 틀렸다면:
- 증거로 반박(피드백을 반증하는 코드/테스트 보여주기)
- 수정 시 해당 특정 사항 건너뛰기
- 사용자에게 보고서에 기록
- 이를 보상하기 위해 품질 기준을 낮추지 마세요
예제 보고서 형식
--- 리뷰 루프: {작업 이름} ---
루프 1/4: 점수 6/10
리뷰어: 입력 검증 누락, 네트워크 타임아웃에 대한 오류 처리 없음,
함수가 너무 김(80줄).
조치: 세 가지 문제 모두 수정 중.
루프 2/4: 점수 8/10
리뷰어: 깔끔함. 사소함: 변수명 `d`를 더 설명적으로 바꾸는 것이 좋겠음.
조치: 품질 게이트 충족(8 >= 8). 최종 다듬기.
결과: 2루프 만에 8/10. 완료.
알려진 제한 사항
- 리뷰어 하위 에이전트는 이전 루프에 대한 메모리가 없으므로 — 이미 해결된 문제가 반복되지 않도록 각 리뷰어 프롬프트에 이전 피드백 컨텍스트를 명시적으로 포함하세요
- 리뷰어 프롬프트 기준이 너무 모호하면 점수 인플레이션이 발생할 수 있습니다 — 구체적이고 측정 가능한 기준을 작성하는 데 시간을 투자하세요
- 이 스킬은 보안에 민감하거나 규정 준수가 필요한 코드에 대한 인간 코드 리뷰를 대체하지 않습니다. 결과물을 강력한 첫 번째 패스로 취급하세요
- 작업이 불완전하게 지정된 경우 루프 수렴이 보장되지 않습니다 — 시작하기 전에 명확한 승인 기준을 정의하세요
비용 및 속도
- 각 루프 = 리뷰어 하위 에이전트 호출 1회
- 전체 3루프 주기에 대해 단일 구현 패스 시간의 약 1~2배 예상
- 이는 버그 투성이 코드를 배포하거나, 모호한 스펙을 작성하거나, 후기 단계 리뷰 주기를 유발하는 것보다 저렴합니다
- 대부분의 리뷰에는 기본/표준 모델을 사용하세요. 특수 도메인(보안 감사, 분산 시스템, 퀀트 금융)에만 고급 추론 모델로 업그레이드하세요
라이선스
MIT — 모든 AI 도구 또는 플랫폼과 함께 자유롭게 사용, 수정, 재배포할 수 있습니다. 출처 표시를 권장합니다. 기여는 환영합니다.