菜单
기획서를 CEO(비즈니스)→Design(UX)→Engineering(기술) 3관점 순차 리뷰 + Synthesizer 종합 + 독립 Evaluator 검증(5-Wave)하는 스킬. Phase 3 에이전트 회의 후 자동 트리거. (적대적 Codex 검수는 cr-triple/codex-review 별도 게이트.)
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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/)로 저장합니다.
아래 생각이 들면 더 엄격하게 본다:
기획서(PRD/GDD)를 3개 관점에서 순차적으로 리뷰하여 맹점을 제거한다.
단일 관점은 맹점을 만든다. CEO→Design→Eng 순서로 리뷰하여 비즈니스/UX/기술 모두 검증한다. 각 Subagent 결과는 파일로 전달 — 다음 Subagent는 파일을 읽어 컨텍스트를 확보한다.
계획 내 모든 선택/결정은 3종 중 하나로 명시한다. 각 Wave 리뷰어는 자신이 다루는 결정 분류를 먼저 확인한다:
[QUESTION] 태그로 표시.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) 후 → 자동 실행
Wave 1 CEO 진입 전 아래 4개 항목을 순서대로 확인한다:
[WARN] confidence <N>/10 — 기획서 보완 후 진행 권장을 출력하고 사용자 확인을 기다린다.각 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/ 에 저장한다.
subagent_type: general-purpose
model: sonnet
입력: 기획서 파일 Read 임무: 비즈니스 관점 리뷰
CEO 리뷰 모드 표 + Premise Challenge/구현대안/Scope게이트 템플릿 + 검증 항목표 →
reference.md §Wave 1 CEO 상세(필요 시 Read)
출력: .claude/state/AUTOPLAN_CEO.md
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
| 결정 필요 | 미루면 무슨 일 (if deferred) |
|---|---|
| {미결 디자인 결정 항목} | {Wave 3 착수 시 어떤 변경/비용 발생} |
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
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
.claude/state/AUTOPLAN_ENG_FINDINGS.jsonl 생성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 판정
수행 절차:
| 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)
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임무: Lead Synthesizer 판정의 독립 검증
검증 포인트:
Evaluator 판정 원칙:
출력: {기획서 경로}-autoplan-review.md 하단에 "## Wave 5 독립 Evaluator 검증" 섹션 추가
Wave 5 Evaluator 검증 섹션 출력 템플릿(Lead 판정검증 + 최종판정 + 에스컬레이션항목 전문) →
reference.md §Wave 5 Evaluator 출력 템플릿 예시(필요 시 Read)
최종 판정 기준:
파일 기반 통신 → 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.
각 Wave/Phase 진입 전 계획서에 rollback point를 명시한다: "이 Phase를 되돌리려면 <무엇을 어떻게 원복>". Kill Signal 감지 시 이 rollback point로 복귀 경로가 보장되어야 한다. Wave 4 Synthesizer는 FAIL 판정 시 rollback 경로를 최종 보고서에 포함한다.
.claude/state/AUTOPLAN_CEO.md 저장.claude/state/AUTOPLAN_DESIGN.md 저장.claude/state/AUTOPLAN_ENG.md 저장{기획서}-autoplan-review.md 저장병렬이 아닌 순차인 이유:
Evaluator FAIL 시
.claude/logs/{session}/errors.jsonl참조하여 재시도
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회 자동 승격.
Forge 하네스 읽기전용 레거시 감사: 낡은룰/중복/과대 전역컨텍스트/넓은 Skill/불필요 Hook·MCP/제품중복 분류. 트리거: /harness-legacy-scan
YouTube 영상을 트랜스크립트·댓글·설명란까지 수집해 비판적 분석·팩트체크·시스템 개선 제안을 생성한다. 사용자가 YouTube URL을 보내거나 영상 분석을 요청할 때 사용한다.
REST API 엔드포인트 HTTP 레벨 E2E 자동 테스트. Spec 또는 OpenAPI(Swagger) YAML/JSON을 읽어 엔드포인트별 테스트 케이스(happy path/인증 실패/잘못된 입력/경계값)를 자동 생성하고 curl로 실행한다. 응답 스키마를 OpenAPI 스펙과 대조해 드리프트를 감지한다. /qa 스킬이 서버/API 프로젝트 감지 시 자동 트리거. 직접 호출: /api-e2e <spec-path> [--base-url http://localhost:3000]
PR 생성 전 develop 대비 feature 브랜치의 성능을 비교하는 스킬. 번들 크기, 테스트 시간, API 응답 시간을 측정. P7 PR 생성 전 자동 트리거.
웹앱 LNB 전체 메뉴를 자동 순회하며 기능 오류·레이아웃 이슈를 탐지하고 bug-report 표준 포맷(BUG-NNN, 6하원칙, INDEX.md)으로 저장. 트리거: 'QA 해줘', '버그 찾아줘', '메뉴 돌아봐줘', URL+로그인 정보 주면서 탐색 요청, 레이아웃 확인 요청.