| name | review |
| description | 최종 독립 검증 — 4단계 정합성, FOCUS 커버리지, COVERS·게이트 규칙 ID 역참조, 3시나리오 수치 일관성, Ownership 전환 실행 가능성 |
| type | orchestrator |
| user-invocable | true |
Review
[REVIEW 활성화]
목표
4단계 파이프라인(WHY→Inform→Optimize→Operate) 전체 산출물에 대해 독립 검증을 수행함. FOCUS Mandatory 15종 + AI 확장 5종 커버리지, COVERS·게이트 규칙 ID 역참조, 3시나리오 수치 일관성, Ownership별 전환 실행 가능성을 객관적으로 감사하여 최종 APPROVED/REJECTED 판정을 산출함.
활성화 조건
다음 중 하나 이상 해당 시 활성화됨:
@review 멘션
- "최종 검증", "정합성 감사" 키워드 포함
/finops:review 직접 호출
에이전트 호출 규칙
FQN 테이블
| 에이전트 | FQN | 티어 |
|---|
| reviewer | finops:reviewer:reviewer | HIGH |
프롬프트 조립
resources/guides/combine-prompt.md에 따라 AGENT.md + agentcard.yaml + tools.yaml 합치기
Agent(subagent_type=FQN, model=tier_mapping 결과, prompt=조립된 프롬프트) 호출
- tier → 모델 매핑은
gateway/runtime-mapping.yaml 참조
서브 에이전트 호출
워크플로우 단계에 Agent: {agent-name}이 명시된 경우,
메인 에이전트는 해당 단계를 직접 수행하지 않고,
반드시 위 프롬프트 조립 규칙에 따라 해당 에이전트를 호출하여 결과를 받아야 함.
서브에이전트 호출 없이 메인 에이전트가 해당 산출물을 직접 작성하면
스킬 미준수로 간주함.
워크플로우
Phase 1: 전체 산출물 로드 (ulw 활용)
다음 파일 존재 여부를 확인함:
핵심 산출물:
out/why-statement.md
out/focus-normalized.csv
out/dashboard.html
out/rightsize-plan.md
out/commit-strategy.md
out/review-runbook.md
out/step1/ (1-drivers.md · 2-maturity-diagnosis.md · 3-covers-roadmap.md)
out/step2/ (FOCUS 정규화 관련 산출물)
out/step3/ (Right-sizing · 약정 관련 산출물)
out/step4/ (1-unit-economics.md · 2-automation-pipeline.md · 4-maturity-transition.md)
규칙 파일:
resources/rulebook/covers-principles.yaml
resources/rulebook/gate-criteria.yaml
resources/rulebook/focus-v1.yaml (또는 동등 파일)
파일 누락 시 사용자에게 누락 목록을 안내하고, 해당 단계의 스킬(/finops:why-finops, /finops:inform, /finops:optimize, /finops:operate) 선행 실행을 권장함.
Phase 2: 독립 검증 → Agent: reviewer (/oh-my-claudecode:ralph 활용)
→ Agent: reviewer
- TASK: 4단계(WHY→Inform→Optimize→Operate) 정합성 감사 및 체크리스트 전항목 검증 수행. 독립 컨텍스트에서 원본 산출물을 수정 없이 객관 평가하여 APPROVED 또는 REJECTED 판정 산출
- EXPECTED OUTCOME:
out/review-report.md — 최종 검증 보고서
- 판정: APPROVED 또는 REJECTED (사유 포함)
- 4단계 정합성 체크리스트 (WHY→Inform→Optimize→Operate 연결 추적)
- FOCUS Mandatory 15종 + AI 확장 5종 커버리지 매트릭스
- COVERS 규칙 ID 역참조 목록 (규칙 ID → 산출물 위치)
- 게이트 기준 6종 역참조 목록 (기준 ID → 런북 위치)
- 3시나리오 수치 일관성 검증 결과 (시나리오별 절감 수치 교차 확인)
- Ownership별 전환 실행 가능성 평가 (재무·엔지니어링·경영진)
- 체크리스트 정량 통과율 (예: 38/40 항목 통과)
- MUST DO:
- 독립 컨텍스트에서 객관 검증 수행 (이전 단계 산출물 작성자와 분리된 관점 유지)
- 모든 검증 결과를 규칙 ID(COVERS-*-##, GATE-##)로 역추적 가능하게 기술
- APPROVED 시 통과 근거 명시, REJECTED 시 수정 필요 항목·책임 에이전트·재실행 스킬 명시
- 체크리스트 정량 통과율(분모/분자) 명시
- MUST NOT DO:
- 원본 산출물 수정 금지
- 분석 본인이 만든 산출물에 대한 자기 검증 금지
- 검증 기준 임의 완화 금지 (gate-criteria.yaml·covers-principles.yaml 기준 준수)
- 수치 미일치 항목을 "허용 오차" 처리하여 통과 처리 금지
- CONTEXT:
out/ 하위 전체 산출물 (위 Phase 1 목록)
resources/rulebook/covers-principles.yaml
resources/rulebook/gate-criteria.yaml
resources/rulebook/focus-v1.yaml
Phase 3: 승인/반려 사용자 안내 (/oh-my-claudecode:verify 활용)
out/review-report.md 내 판정(APPROVED/REJECTED) 확인 후 다음 안내를 수행함:
APPROVED 시:
REJECTED 시:
완료 조건
검증 프로토콜
- reviewer AGENT.md의 검증 섹션 체크박스 전항목 통과
out/review-report.md 파일 존재 확인 — 0바이트 초과
- "APPROVED" 또는 "REJECTED" 문자열 정규표현식으로 스캔
- COVERS-*-## 패턴 역참조 항목 수 확인 (최소 6건)
- 체크리스트 통과율 수치(N/M 형식) 존재 확인
상태 정리
임시 상태 파일 미사용. 산출물은 out/review-report.md 경로에 영구 저장됨.
취소
cancelomc 입력 시 현재 Phase 중단 및 스킬 종료.
재개
out/review-report.md 존재 여부로 완료 Phase를 판단함. 파일 미존재 시 Phase 1부터 재시작, 존재 시 Phase 3(사용자 안내)부터 재개함.
출력 형식
사용자 보고 형식 (권장)
## Review 최종 검증 결과
### 판정
**[APPROVED | REJECTED]**
### 체크리스트 통과율
- 전체: N/M 항목 통과 (통과율 X%)
- 4단계 정합성: N/4 통과
- FOCUS 커버리지: N/20 통과 (Mandatory 15종 + AI 확장 5종)
- COVERS 역참조: N건 확인
- 게이트 기준: N/6 통과
- 시나리오 수치 일관성: [일치/불일치]
- Ownership 전환 가능성: [가능/보완 필요]
### [APPROVED 시] 다음 단계
→ `/finops:ppt-writer` 로 발표 자료를 작성하세요.
### [REJECTED 시] 수정 필요 항목
| # | 항목 | 책임 에이전트 | 재실행 스킬 |
|---|---|---|---|
| 1 | ... | ... | /finops:... |