| name | cr-multi |
| description | Multi-worker 검수 스킬 (Codex + Gemini Double / Opus + Codex + Gemini Triple). 단일 Codex 검수 대비 100% 보완 카테고리 커버. 트리거: /cr-multi, /cr-double, /cr-triple, plan/spec 저장 후 자동(CR_MULTI_AUTO=on), plateau 3회 자동 승격. |
/cr-multi
Codex + Gemini (Double) 또는 Opus + Codex + Gemini (Triple) 병렬 리뷰 + Triage 합산 verdict.
인자 정본 = .claude/commands/cr-multi.md. 실행(Workflow 스폰)은 이 파일이 하지만,
인자 스펙(--mode / --stage / --cr on|degrade|off / --no-codex / --fable)은 커맨드가 정본이다.
2026-07-14 실측: 이 스킬에 --fable·--degrade 설명이 누락돼 있어, 스킬 경로로 들어오면
존재하는 인자를 모르는 상태였다. 인자 추가 시 양쪽을 함께 고친다.
--cr degrade / --no-codex → Codex 레그 제외 (Opus + Gemini 2-worker)--fable → Human 수동 전용. Claude 레그를 Fable 5로 승격 (Codex·Gemini 불변). 자동 발동 금지.
Quick Start
/cr-double ${FORGE_OUTPUTS:-$HOME/forge-outputs}/11-platform/pipelines/plans/my-plan.md
/cr-triple ${FORGE_OUTPUTS:-$HOME/forge-outputs}/02-product/forge-platform/specs/my-spec.md
Phase 0.5 — 과거 리뷰 회상 (advisory, fail-open — 2026-07-10)
워커 스폰 전 1회, 대상 파일명·도메인 키워드로 내부 지식을 회상한다:
/rag-search "{대상 slug} {도메인 키워드}" --top-k 5
- 히트 중
docs/reviews/ 원문·wiki 노트가 있으면 과거 지적 요약 3줄 이내를 각 워커 프롬프트에 "이전 리뷰에서 지적된 패턴(재발 검사 대상)"으로 주입 — 같은 결함의 재발을 리뷰어가 우선 확인.
- 결과 없음/rag 미가용 = 그대로 진행(fail-open, 비차단). 회상이 리뷰 범위를 좁히는 데 쓰여선 안 됨 — 추가 렌즈일 뿐.
모드
| 모드 | Worker | 합산 |
|---|
| Double | Codex + Gemini | codex×0.6 + gemini×0.4 |
| Triple | Opus + Codex + Gemini | opus×0.35 + codex×0.35 + gemini×0.3 |
산출물
${FORGE_OUTPUTS:-$HOME/forge-outputs}/docs/reviews/{stage}/{slug}-cr-multi.json
AD-90 증거 JSON 포맷: {verdict, score, issues[], mode, slug, degraded, evidence_tier}
degraded 표기 의무 (Batch 3 증거등급 정직화): degraded=true(worker 정족수 미달 — 외부 워커 Codex/Gemini 미가용으로 동일 모델 대체 등)면 사람이 보는 최종 결과(Workflow 반환값·AD-90 JSON)에 degradedBanner("⚠️ DEGRADED: N/M worker 생존 — 근거등급 낮음") 필드가 additive로 포함된다. 이 검수 결과를 인용·보고할 때 배너를 함께 표기할 것 — "3-LLM 적대 검수"로 재현하지 않는다.
evidence_tier (증거등급, Batch 3-2): 기존 degraded·워커 생존 수에서 순수 파생되는 필드(신규 판정 로직 아님).
| tier | 의미 |
|---|
full | 정족수 충족 — 전 레그 참여, 가중합산 |
degraded | 일부 워커 생존(2/3) — 균등평균으로 강등 계산. 3-LLM 합의 아님 |
unverified | 단일 워커 이하 — 근거등급 최하 |
tier가 full이 아니면 WARN + 고지한다. [STOP] 게이트가 아니다 — 흐름은 계속하되, 점수만 보고 "3-LLM 검수 통과"로 오독하는 것을 막는 것이 목적이다. 이 검수를 인용할 때 tier를 함께 표기하라.
집계 자가대조 (Batch 3-3): 리포트 헤더·요약의 집계 숫자는 본문 항목표에서 기계 도출(grep -c 등)하거나 작성 직후 자가 대조한다. 헤더 숫자는 그 자체가 검증 대상이다 — 눈으로 센 값을 쓰지 마라. (목록형 산출물의 헤더 집계 오류 4회 실증. 이 세션에서도 harness-diet가 skills_count: -97이라는 허구 수치를 보고했다.)
보안
- Secret 사전 스캔 (전송 전 차단)
CR_MULTI_AUTO=off 기본 (명시 opt-in 필요)- 감사 로그:
${FORGE_OUTPUTS:-$HOME/forge-outputs}/.claude/audit/cr-multi-calls.jsonl
Cache Stats 로깅 (AD-105 H2)
cr-multi 실행 후 usage 데이터 기록:
bash ~/.claude/scripts/cache-stats-logger.sh cr-multi "$MODEL" "$CACHE_READ" "$CACHE_CREATION" "$RAW_INPUT" cr-review
usage 필드는 Anthropic SDK response.usage 에서 추출. 미지원 시 0 기본값 사용.
Workflow 실행 (계획서 P0-4)
mcp__codex__ 토큰 = Phase -1 자동 발행 내장 (외부 선발행 불필요).
Workflow({
script: Bash("cat ~/.claude/skills/cr-multi/workflow.js"),
args: { slug: SLUG, targetPath: TARGET, mode: 'triple', stage: STAGE }
})
Agent Teams fallback: CLAUDE_CODE_DISABLE_WORKFLOWS=1 시 기존 Agent 패턴.
참조
- 명령:
~/forge/.claude/commands/cr-multi.md
- 룰:
~/.claude/rules-on-demand/multi-gate-review.md
- Triage:
~/forge/shared/scripts/cr-multi-triage.py
- Plateau:
~/forge/shared/scripts/cr-multi-plateau-guard.py
Evaluator (Wave 2.5)
독립 Evaluator subagent가 산출물 품질을 검증합니다.
Evaluator 역할: 산출물 독립 검증
모델: claude-haiku-4-5 (경량, 편향 최소화)
격리: 메인 컨텍스트 오염 방지
판정 기준:
- PASS: 모든 핵심 기준 충족, 즉시 사용 가능
- WARN: 사용 가능하나 개선 권장, 사용자 확인 후 진행
- FAIL: 핵심 기준 미충족, 재실행 필요
eval_cases.jsonl에 결과 자동 누적.
Plateau 조기 감지 (AD-118 SkillOps)
연속 2라운드 score 진전 <5점 = plateau 신호. 즉시 4 옵션 제시 (A 추가 라운드 / B AD-50 override(게이트 격하 1회 면제, Human 승인 필수 — pipeline.md AD-50) / C 폐기 / D 극단 단순화). D 우선 권고 (over-engineering 거부 — enforcement-theater-prevention 정합).
연속 실행 원칙 (No-Pause)
cr-multi 실행 중 중간 확인 요청 금지:
- 오케스트레이터는 Codex → Gemini → Opus 레그를 중간 Human 확인 없이 연속 실행한다.
- 각 레그 결과가 반환되면 즉시 다음 레그를 스폰한다 (중간 출력 보고 금지).
- BLOCKED 판정이 반환되면 그 시점에만 [STOP] Human 에스컬레이션. 나머지는 자동 진행.
금지 행동
cr-multi 워크플로 및 각 검수 레그가 반드시 준수해야 할 금지 사항:
① 점수 조작 목적의 이슈 추가 금지 — 점수를 올리거나 내리기 위해 근거 없는 이슈를 생성하지 않는다.
② 이전 라운드와 동일 이슈 재제기 금지 — plateau 라운드에서 같은 이슈를 새 언어로 반복하는 것은 찾은 척(fabrication). 새 근거 없으면 해소된 것으로 간주.
③ Spec 범위 외 enterprise 기능 요구 금지 — SME(중소규모)·MVP 스코프에서 분산 트랜잭션·HA·다중 테넌시 등 미요구 기능을 critical로 요구하는 것은 over-spec.
④ 구현 의도 무시한 전면 재설계 요구 금지 — 작성자의 설계 방향을 이해하지 않고 아키텍처 전면 변경을 BLOCK 조건으로 내거는 것은 금지.
⑤ 플래그 없는 외부 소스 코드 복사 권장 금지 — 라이선스·출처 미확인 코드 그대로 붙여넣기를 권고하지 않는다.
리뷰 요청자 행동 규칙
cr-multi를 호출하는 requester(오케스트레이터·Human)가 준수해야 할 규칙:
⑥ "간단한 변경이라" 리뷰 생략 금지 — 변경 크기와 무관하게 리뷰 단계 준수.
⑦ Critical 이슈 무시 후 진행 금지 — Critical 미수정 = FAIL verdict 자동 발행 (기계 차단). 수동 override 시 Human 승인 필수 (AD-50).
⑧ High severity 이슈 잔존 시 검토 의무 — verdict=WARN 수신 시 high 이슈 목록 확인 후 진입 여부 결정 (자동 차단 없음, 검토 의무 — prose rule).
⑨ 유효한 기술 피드백 무비판 동의 금지 — 피드백 내용을 실제로 검토 후 수용/거부 판단.
