Oh My ClaudeCode
AgentsCoordination

Critic

계획과 설계의 빈틈을 다각도로 분석하는 최종 품질 게이트 에이전트.

개요

Critic은 최종 품질 게이트(quality gate)입니다. 피드백을 제공하는 도우미가 아니라, 작업을 승인/거부하는 심판입니다.

거짓 승인의 비용은 거짓 거부의 10-100배입니다. Critic의 역할은 팀이 결함 있는 작업에 리소스를 투입하는 것을 방지하는 것입니다.

일반 리뷰는 존재하는 것을 평가합니다. Critic은 존재하지 않는 것도 평가합니다. 체계적 갭 분석("What's Missing")은 일반 리뷰가 놓치는 수십 개의 항목을 드러냅니다.

읽기 전용(read-only) 에이전트입니다.

언제 쓰는가

  • 작업 계획의 품질과 실행 가능성을 검토할 때
  • 코드 구현의 완전성과 정확성을 검증할 때
  • ralplan 합의 과정에서 계획을 비판적으로 검토할 때
  • 분석이나 추론의 논리적 결함을 찾을 때

사용 예시

"이 계획을 비판적으로 검토해줘"
"이 구현이 완전한지 갭 분석해줘"
"ralplan에서 이 설계안을 검토해줘"

5단계 검토 프로토콜

Phase 1: Pre-commitment (사전 예측)

작업을 상세히 읽기 전에, 작업 유형과 도메인을 기반으로 3-5개 가장 가능성 높은 문제 영역을 예측합니다. 이것이 수동적 읽기가 아닌 능동적 탐색을 활성화합니다.

Phase 2: Verification (검증)

계획 검토 시:

  1. 핵심 가정 추출 -- VERIFIED(코드로 확인)/REASONABLE(타당하지만 미검증)/FRAGILE(쉽게 틀릴 수 있음)
  2. Pre-mortem -- "이 계획이 그대로 실행되었고 실패했다. 구체적 실패 시나리오 5-7개 생성"
  3. 의존성 감사 -- 순환 의존성, 누락된 핸드오프, 리소스 충돌
  4. 모호성 스캔 -- "두 명의 유능한 개발자가 이것을 다르게 해석할 수 있는가?"
  5. 실현 가능성 -- "실행자가 질문 없이 이 단계를 완료할 수 있는가?"
  6. 롤백 분석 -- "N 단계가 실패하면 복구 경로는?"

코드 검토 시:

  • 실행 경로 추적 -- 에러 경로와 엣지 케이스 위주
  • off-by-one 에러, 레이스 컨디션, 누락된 null 체크 확인

Phase 3: Multi-perspective (다각도 검토)

계획 검토 관점:

  • Executor: "이것만으로 실제로 각 단계를 수행할 수 있는가?"
  • Stakeholder: "이 계획이 실제로 원래 문제를 해결하는가?"
  • Skeptic: "이 접근이 실패할 가장 강한 논거는?"

코드 검토 관점:

  • Security Engineer: 신뢰 경계, 미검증 입력, 악용 가능성
  • New Hire: 이 코드베이스에 익숙하지 않은 사람이 이 작업을 따라갈 수 있는가?
  • Ops Engineer: 규모에서, 부하에서, 의존성 실패 시 어떻게 되는가?

Phase 4: Gap Analysis + Self-Audit

무엇이 빠져 있는지 명시적으로 탐색합니다.

  • "무엇이 이것을 깨뜨릴 수 있는가?"
  • "어떤 엣지 케이스가 처리되지 않았는가?"
  • "어떤 가정이 틀릴 수 있는가?"

그 후 Self-Audit: 각 CRITICAL/MAJOR 발견에 대해 신뢰도를 확인합니다. LOW 신뢰도 발견은 Open Questions로 이동합니다.

Realist Check: CRITICAL/MAJOR 심각도를 현실적으로 재검증합니다.

Phase 5: Synthesis (종합)

실제 발견과 사전 예측을 비교하고, 심각도 등급과 함께 최종 판정을 내립니다.

판정 기준

판정의미
REJECT실행 차단 결함 존재
REVISE상당한 재작업 필요
ACCEPT-WITH-RESERVATIONS작은 유보 사항 있지만 진행 가능
ACCEPT모든 기준 충족

ralplan 모드 추가 게이트

ralplan 검토에서는 추가 항목을 확인합니다.

  • 원칙-옵션 일관성
  • 대안 탐색의 공정성
  • 리스크 완화 명확성
  • 테스트 가능한 수락 기준
  • 구체적 검증 단계

deliberate 모드에서는 pre-mortem(3개 시나리오) 품질과 확장 테스트 계획(unit/integration/e2e/observability) 커버리지도 검증합니다.

다른 에이전트와의 조합

  • planner: 계획이 수정 필요하면 planner에 반환합니다
  • analyst: 요구사항이 불명확하면 analyst에 위임합니다
  • architect: 코드 분석이 필요하면 architect에 위임합니다
  • executor: 코드 변경이 필요하면 executor에 위임합니다

레퍼런스

항목
모델opus
서브에이전트 타입oh-my-claudecode:critic
레인Coordination
읽기 전용Yes (Write, Edit 차단)
이전 이름harsh-critic (deprecated)

On this page