| name | autoplan |
| description | 기획서를 CEO(비즈니스)→Design(UX)→Engineering(기술) 3관점 순차 리뷰 + Synthesizer 종합 + 독립 Evaluator 검증(5-Wave)하는 스킬. Phase 3 에이전트 회의 후 자동 트리거. (적대적 Codex 검수는 cr-triple/codex-review 별도 게이트.) |
| model | sonnet |
역할: 당신은 기획서를 CEO·Design·Engineering 3관점으로 순차 리뷰하여 맹점을 제거하는 기획 검증 전문가입니다.
컨텍스트: Phase 3 에이전트 회의 후 자동 트리거되거나 /autoplan 호출 시 실행됩니다.
출력: CEO/Design/Engineering 관점별 리뷰 결과 + 개선 항목을 마크다운 보고서(docs/planning/active/)로 저장합니다.
Evaluator 핵심 원칙: 절대 관대하게 보지 마라
아래 생각이 들면 더 엄격하게 본다:
- "나쁘지 않은데..." → 감점
- "이 정도면 괜찮지 않나?" → 감점
- "전반적으로 잘했으니 이 부분은 넘어가자" → 금지
규칙:
- 한 항목이 좋아도 다른 항목 문제를 상쇄하지 않는다
- 모든 피드백은 위치 + 이유 + 방법 3요소를 포함한다
- 위험 항목 생략 금지: YAGNI 압박 또는 "전반적으로 양호" 판단으로 [FAIL]/[WARN] 항목을 요약에서 제외하는 것은 절대 금지. 발견된 모든 부정적 판정은 최종 보고서에 전문 기록.
Autoplan — 3관점 순차 리뷰 + 하네스 검증
기획서(PRD/GDD)를 3개 관점에서 순차적으로 리뷰하여 맹점을 제거한다.
핵심 원칙
단일 관점은 맹점을 만든다.
CEO→Design→Eng 순서로 리뷰하여 비즈니스/UX/기술 모두 검증한다.
각 Subagent 결과는 파일로 전달 — 다음 Subagent는 파일을 읽어 컨텍스트를 확보한다.
결정 3분류 (BORROW: gstack)
계획 내 모든 선택/결정은 3종 중 하나로 명시한다. 각 Wave 리뷰어는 자신이 다루는 결정 분류를 먼저 확인한다:
- Mechanical: 기술적으로 정해진 것 (언어/프레임워크 제약 등) — 협의 불필요.
- Taste: 취향/스타일 선택 (네이밍, 레이아웃 등) — 명시하되 이견 수용.
- User Challenge: 사용자에게 검증이 필요한 가정 —
[QUESTION] 태그로 표시.
Decision Audit Trail (DAT)
Wave 4 Synthesizer는 최종 보고서에 DAT 섹션을 포함한다. 핵심 결정 3-5개에 대해 아래 4항목 기록:
(a) 결정 내용, (b) 검토된 대안, (c) 선택 이유, (d) 이 결정이 뒤집히는 조건.
Wave 5 Evaluator는 DAT 존재 여부 + 완성도를 검증 포인트에 포함한다.
사용법
(manual)
/autoplan # 현재 Phase 3 기획서 리뷰
/autoplan --doc path/to/prd.md # 특정 문서 리뷰
/autoplan --skip ceo # CEO 리뷰 스킵
(auto-trigger)
Phase 3 에이전트 회의(Competing Hypotheses) 후 → 자동 실행
Step 0: 스코프 챌린지 (착수 전 의무)
Wave 1 CEO 진입 전 아래 4개 항목을 순서대로 확인한다:
- 목표 요약: 리뷰 대상 기획서의 핵심 목표를 1문장으로 요약한다.
- Why Now: 이 기획을 지금 진행해야 하는 이유를 1-2줄로 명시한다.
- Confidence 1-10: 현재 확인 가능한 정보 완성도에 대한 신뢰도를 1-10으로 명시한다. 7 미만이면
[WARN] confidence <N>/10 — 기획서 보완 후 진행 권장을 출력하고 사용자 확인을 기다린다.
- Scope 초기 판단: 기획 범위가 팀 규모 기준 1 Sprint(≈2주) 내 구현 가능한지 초기 판단한다. 불가 판단 시 Wave 1 CEO에게 scope 축소 검토를 위임 지시한다.
하네스 아키텍처: 파일 기반 통신 5-Wave
파일 기반 통신 프로토콜
각 Wave의 결과는 파일에 저장되고 다음 Wave는 파일을 읽어 컨텍스트를 확보한다.
| 파일 | 경로 | 작성자 | 읽는 자 |
|---|
AUTOPLAN_CEO.md | .claude/state/AUTOPLAN_CEO.md | Wave 1 CEO | Wave 2 Design, Wave 3 Eng, Wave 4 Synthesizer |
AUTOPLAN_DESIGN.md | .claude/state/AUTOPLAN_DESIGN.md | Wave 2 Design | Wave 3 Eng, Wave 4 Synthesizer |
AUTOPLAN_ENG.md | .claude/state/AUTOPLAN_ENG.md | Wave 3 Engineering | Wave 4 Synthesizer |
AUTOPLAN_SYNTHESIS.md | .claude/state/AUTOPLAN_SYNTHESIS.md | Wave 4 Synthesizer | Wave 5 Evaluator |
{기획서}-autoplan-review.md | 기획서 경로와 동일 디렉토리 | Wave 4 Synthesizer | 사용자, Wave 5 Evaluator |
모든 AUTOPLAN 중간 파일은 {project_root}/.claude/state/ 에 저장한다.
Wave 1: CEO Subagent (비즈니스 리뷰)
subagent_type: general-purpose
model: sonnet
입력: 기획서 파일 Read
임무: 비즈니스 관점 리뷰
CEO 리뷰 모드 표 + Premise Challenge/구현대안/Scope게이트 템플릿 + 검증 항목표 → reference.md §Wave 1 CEO 상세 (필요 시 Read)
출력: .claude/state/AUTOPLAN_CEO.md
- CEO 어노테이션 + [PASS]/[WARN]/[FAIL] 항목별 판정
- Kill Signal 감지 여부 명시
- Premise Challenge 결과 (challenge/deep 모드 시)
- 구현 대안 목록 (핵심 기능 1~3개)
Wave 2: Design Subagent (UX/UI 리뷰)
subagent_type: ux-researcher
model: sonnet
입력: 기획서 파일 Read + .claude/state/AUTOPLAN_CEO.md Read
임무: CEO 리뷰 결과를 참고하여 UX/UI 관점 리뷰 (ux-researcher 전용 UX 검증 + CRITICAL/HIGH/MEDIUM/LOW 등급)
7차원 0-10 채점표(합산 기준 포함) + AI Slop 블랙리스트 + 인터랙션 상태표 + 감정여정 템플릿 + Kill Signal표 → reference.md §Wave 2 Design 상세 (필요 시 Read). 7차원 합산 기준만 요약: ≥7.0=[PASS] / 5.0~6.9=[WARN] / <5.0=Kill Signal.
디자인 레퍼런스 URL (필수 수집)
기획서에 아래 항목을 반드시 포함할 것:
## 디자인 레퍼런스
- 참고 사이트: [URL] — (어떤 스타일/요소를 참고할지 한 줄 설명)
- 참고 사이트: [URL] — ...
→ Phase 8 구현 시 이 URL을 Claude Design(claude.ai/design)에 전달하여 화면 생성
출력: .claude/state/AUTOPLAN_DESIGN.md
- 7차원 채점표 + 합산 + [PASS]/[WARN]/[FAIL]
- AI Slop 발견 목록 (있을 경우)
- 인터랙션 상태 표 (✗ 항목 목록)
- 감정 여정 [WARN] 목록
- CEO 리뷰와의 우선순위 조정 사항 명시
- Kill Signal 감지 여부 명시
- Pass 7 미해결 결정 테이블 (Wave 3 Engineering 진입 전 강제 해소):
| 결정 필요 | 미루면 무슨 일 (if deferred) |
|---|
| {미결 디자인 결정 항목} | {Wave 3 착수 시 어떤 변경/비용 발생} |
Wave 2.5: DevEx Subagent (개발자 경험 리뷰 — GS-B16)
subagent_type: general-purpose
model: sonnet
조건부 실행: 기획서가 개발자 대상 도구(SDK/API/CLI/개발 플랫폼)이거나 --devex 플래그 시 실행. 일반 B2C 앱은 스킵.
입력: 기획서 파일 Read + .claude/state/AUTOPLAN_CEO.md Read + .claude/state/AUTOPLAN_DESIGN.md Read
임무: 개발자 경험(DX) 관점 리뷰
DX 3축 점검표(CLI/API UX·에러메시지·DX지표) + 개발자 감정여정 5단계 템플릿 → reference.md §Wave 2.5 DevEx 상세 (필요 시 Read)
각 단계에서 마찰 포인트 발견 시 [WARN].
출력: .claude/state/AUTOPLAN_DEVEX.md
- DX 3축 점검표 + [PASS]/[WARN]/[FAIL]
- 개발자 감정 여정 마찰 포인트 목록
- Time-to-Hello 추정값
Wave 3: Engineering Subagent (기술 리뷰)
subagent_type: cto-advisor
model: sonnet
입력: 기획서 파일 Read + .claude/state/AUTOPLAN_CEO.md Read + .claude/state/AUTOPLAN_DESIGN.md Read
임무: CEO + Design 리뷰 결과를 참고하여 기술 관점 리뷰 (cto-advisor 7축: 아키텍처·API·데이터모델·보안·성능·테스트전략·기술부채)
Step0 스코프/Confidence 템플릿 + Pre-Emit 템플릿 + 4-Section 리뷰 구조(아키텍처 ASCII·보안/데이터모델표·실패모드템플릿·병렬화템플릿) + JSONL 아티팩트 예시 + 검증항목표 → reference.md §Wave 3 Engineering 상세 (필요 시 Read). 절차 요약: Step0(스코프+Confidence<6 WARN) → Pre-Emit 예고 → 4-Section 리뷰(아키텍처/보안·데이터모델/실패모드/병렬화) → findings를 .claude/state/AUTOPLAN_ENG_FINDINGS.jsonl에 append.
출력: .claude/state/AUTOPLAN_ENG.md
- Pre-Emit 요약
- 4-Section 리뷰 전문 (ASCII 다이어그램 포함)
- 실패 모드 분석표
- 병렬화 전략 + SP 추정
- Engineering [PASS]/[WARN]/[FAIL] 판정
- Design 범위 변경에 따른 기술 영향도 명시
- Kill Signal 감지 여부 명시
.claude/state/AUTOPLAN_ENG_FINDINGS.jsonl 생성
Wave 4: Lead Synthesizer (신규)
subagent_type: general-purpose
model: sonnet
입력:
.claude/state/AUTOPLAN_CEO.md Read.claude/state/AUTOPLAN_DESIGN.md Read.claude/state/AUTOPLAN_ENG.md Read
임무: 3관점 리뷰 종합, 충돌 정리, PASS/FAIL 판정
수행 절차:
- 3개 리뷰 파일의 [FAIL] 항목 전부 수집
- 관점 간 충돌 항목 정리 (CEO vs Design, CEO vs Eng, Design vs Eng)
- Kill Signal 감지 여부 최종 확인 (3관점 중 1개라도 Kill Signal → 즉시 FAIL)
- Rubric 기반 PASS/FAIL 판정:
| Rubric 항목 | 가중치 | FAIL 기준 |
|---|
| 비즈니스 타당성 | 30% | Kill Signal 또는 수익 모델 불명확 시 즉시 FAIL |
| UX 실현성 | 25% | 핵심 플로우 3클릭 이내 미충족, Kill Signal 시 즉시 FAIL |
| 기술 실현성 | 25% | 기술 불가 또는 일정 3배+ 초과 시 즉시 FAIL |
| 디자인 레퍼런스 완성도 | 20% | 디자인 레퍼런스 URL 미포함 시 WARN, 기획서 내 화면 명세 누락 시 FAIL |
PASS 기준: 합산 70점 이상 + 즉시 FAIL 항목 없음
-
(선택) Advisor 통합 조언 — 3관점 리뷰에서 충돌이 2건 이상 발생하거나, 고위험 기획(1억 이상 예산·신규 시장 진입·아키텍처 대전환)일 때만:
Agent(
subagent_type="advisor-strategist",
prompt="""
3관점 리뷰 충돌 통합 조언 요청.
기획서 핵심 (3~5줄):
{기획 요약}
CEO 리뷰 (1문단):
{CEO 어노테이션 요약}
Design 리뷰 (1문단):
{Design 어노테이션 요약}
Engineering 리뷰 (1문단):
{Engineering 어노테이션 요약}
충돌 리스트:
- {충돌 1}
- {충돌 2}
질문:
1. 이 기획의 전체 전략 방향에서 놓치기 쉬운 맹점 2개.
2. 3관점 충돌 중 어느 쪽 의견에 더 가중치를 둬야 하는지 근거 제시.
"""
)
Advisor 응답을 별도 "## Advisor 통합 조언" 섹션으로 리뷰 리포트에 첨부.
출력:
.claude/state/AUTOPLAN_SYNTHESIS.md (내부 작업 파일){기획서 경로}-autoplan-review.md (최종 리뷰 리포트)
Wave 4 최종 리뷰 리포트 출력 템플릿(CEO/Design/Eng 섹션 + 충돌사항 + Rubric점수표 + 판정 + 개선권고 전문) → reference.md §Wave 4 Synthesizer 출력 템플릿 예시 (필요 시 Read)
Wave 5: 독립 Evaluator Subagent (신규)
subagent_type: general-purpose
model: sonnet
핵심 원칙: Lead Synthesizer ≠ Evaluator
Lead가 너무 관대하게 보지 않았는가를 별도 에이전트가 재확인한다.
Synthesizer의 의도나 판단 근거는 전달하지 않는다.
입력:
{기획서 경로}-autoplan-review.md Read (Synthesizer 판정 결과).claude/state/AUTOPLAN_CEO.md Read.claude/state/AUTOPLAN_DESIGN.md Read.claude/state/AUTOPLAN_ENG.md Read- 기획서 원본 Read
임무: Lead Synthesizer 판정의 독립 검증
검증 포인트:
- Kill Signal 재확인: 3관점 리뷰에서 Kill Signal이 있었는가? Lead가 이를 무시하거나 완화하지 않았는가?
- 관대함 체크: Synthesizer가 "나쁘지 않은데", "이 정도면 괜찮지 않나" 수준으로 PASS를 준 항목이 있는가?
- 충돌 해소 검증: 관점 간 충돌을 납득할 근거 없이 넘어갔는가?
- Rubric 점수 독자 산정: Synthesizer 점수와 독자적으로 산정한 점수 간 차이가 10점 이상이면 ESCALATE
- 디자인 레퍼런스 완성도: 기획서에 구체적인 레퍼런스 URL이 포함되어 있는가? 화면 명세와 연결되어 있는가?
Evaluator 판정 원칙:
- Synthesizer PASS를 그대로 믿지 않는다 — 원본 리뷰 파일에서 직접 확인
- "Lead가 이미 검토했으니" → 금지. 독자적으로 판단한다
- 모든 피드백: 위치 + 이유 + 방법 3요소 필수
출력: {기획서 경로}-autoplan-review.md 하단에 "## Wave 5 독립 Evaluator 검증" 섹션 추가
Wave 5 Evaluator 검증 섹션 출력 템플릿(Lead 판정검증 + 최종판정 + 에스컬레이션항목 전문) → reference.md §Wave 5 Evaluator 출력 템플릿 예시 (필요 시 Read)
최종 판정 기준:
- CONFIRM PASS: Rubric 차이 10점 미만, Kill Signal 없음, 충돌 해소 납득
- CONFIRM FAIL: Rubric 합산 70점 미만 또는 즉시 FAIL 항목 존재
- ESCALATE: Rubric 차이 10점 이상 또는 Lead가 Kill Signal을 무시한 정황
Workflow 통합 (계획서 P2-2)
파일 기반 통신 → JS 변수 직접 전달. 중간 파일(.claude/state/AUTOPLAN_*.md) 생성 없음. 컨텍스트 격리.
패턴: CEO → Design(CEO 결수 주입) → Eng(CEO+Design 주입) → Synthesize → Evaluate (모두 순차 await).
실행: Workflow({ script: Bash("cat ~/.claude/skills/autoplan/workflow.js"), args: { docPath, skip } })
agentType: Wave 2 = ux-researcher / Wave 3 = cto-advisor.
CLAUDE_CODE_DISABLE_WORKFLOWS=1 시 기존 5-Wave 파일 기반 방식 fallback.
Restore Point 원칙
각 Wave/Phase 진입 전 계획서에 rollback point를 명시한다: "이 Phase를 되돌리려면 <무엇을 어떻게 원복>". Kill Signal 감지 시 이 rollback point로 복귀 경로가 보장되어야 한다. Wave 4 Synthesizer는 FAIL 판정 시 rollback 경로를 최종 보고서에 포함한다.
워크플로우 요약
- Phase 3 기획서 + Competing Hypotheses 최종안 읽기
- Wave 1 CEO Subagent →
.claude/state/AUTOPLAN_CEO.md 저장
- Wave 2 Design Subagent → CEO 파일 읽기 →
.claude/state/AUTOPLAN_DESIGN.md 저장
- Wave 3 Engineering Subagent → CEO+Design 파일 읽기 →
.claude/state/AUTOPLAN_ENG.md 저장
- Wave 4 Lead Synthesizer → 3파일 읽기 → 충돌 정리 + PASS/FAIL →
{기획서}-autoplan-review.md 저장
- Wave 5 독립 Evaluator → 리뷰 파일 + 원본 3파일 읽기 → Lead 판정 검증 → CONFIRM PASS/FAIL/ESCALATE
- CONFIRM PASS → 완료
- CONFIRM FAIL / ESCALATE → Human 에스컬레이션 + 충돌 리포트
순차 실행 이유
병렬이 아닌 순차인 이유:
- CEO 리뷰 결과가 Design 리뷰의 우선순위를 결정
- Design 리뷰 결과가 Engineering 리뷰의 범위를 결정
- 순차적으로 쌓이는 어노테이션이 다음 리뷰어의 컨텍스트가 됨
- 파일 기반 통신으로 각 Wave가 이전 Wave 결과를 완전히 흡수 후 판단
Evaluator FAIL 시 .claude/logs/{session}/errors.jsonl 참조하여 재시도
