reviewlisted

# Review - Multi-Agent 코드 리뷰 3개 전문 에이전트가 **병렬로** 독립 리뷰한 뒤, 오케스트레이터가 중복 제거 + 종합 판정한다. 단일 에이전트 리뷰의 reasoning collapse(자기 수정 반복으로 진짜 이슈 매몰)를 구조적으로 방지한다. ## 왜 멀티 에이전트인가 | 단일 에이전트 | 멀티 에이전트 | |--------------|-------------| | 보안 분석 중 성능으로 넘어가며 맥락 손실 | 각 에이전트가 자기 영역에만 집중 | | 자기 반박 반복 → "결국 문제 없다"로 수렴 | 독립 실행이므로 자기 반박 없음 | | 1개 관점만 존재 | 같은 코드를 3개 관점에서 교차 검증 | | 놓치면 끝 | 한 에이전트가 놓쳐도 다른 에이전트가 발견 | ## 원칙 - 리뷰 범위가 애매하다 → "전체 diff를 볼까요, 특정 파일만 볼까요?" - 기준 브랜치가 불분명하다 → "main 대비로 할까요, 다른 브랜치?" - 변경 크기가 300줄 초과 → "분할할까요, 그대로 리뷰할까요?" ## 사용법 ``` /review # 현재 diff에 대해 멀티 에이전트 리뷰 /review security # 보안 에이전트만 실행 /review packages/api # 특정 경로만 리뷰 ``` --- ## pharos 프로토콜 ```bash source "$HOME/.claude/skills/_shared/pharos-helpers.sh" # 시작 pw set-status phase "REVIEW" --icon "🔍" --color "#EC4899" pw set-progress 0.0 --label "Review: 시작" # 단계별 진행 pw set-progress 0.1 --label "Review/Scope: diff 분석" pw set-progress 0.2 --label "Review/Agents: 3개 전문가 병렬 실행" pw set-progress 0.7 --label "Review/Merge: 결과 병합" pw set-progress 0.9 --label "Review/Verdict: 종합 판정" # 완료 pw set-progress 1.0 --label "Review: 완료" pw set-status phase "REVIEW ✅" --icon "✅" --color "#22C55E" pw notify --title "Review 완료" --body "[결과]" fm_append "### Multi-Agent Review - 변경: [n]줄 ([n]파일) - Security: P0 [n], P1 [n] | Correctness: P0 [n], P1 [n] | Performance: P0 [n], P1 [n] - 중복제거 후: P0 [n]건, P1 [n]건, P2 [n]건 ---" ``` --- ## Phase 1: Scope — 변경 범위 파악 base 브랜치를 자동 감지한다. 우선순위는 (1) 사용자 인자 → (