/cc-product:specify — 무엇을 만들지 "확정"하는 단계#
| 항목 | 내용 |
|---|---|
| 실행 명령 | /cc-product:specify |
| 분류 | 파이프라인 |
| 난이도 | ●●● 높음 |
파이프라인 2단계(Specification). "무엇을 만들지"를 누가 봐도 똑같이 이해되도록, 숨은 가정을 캐묻고 모호함을 없애 구현 가능한 수준의 명세로 못 박습니다.
한마디로#
만들 것을 **"애매하지 않게 글로 못 박는 단계"**입니다. 집을 짓기 전에 "방은 몇 개, 창문은 어디, 화장실은 몇 칸"을 도면 한 장에 확정해서 누가 봐도 똑같이 짓게 만드는 것과 같아요.
누가·언제 쓰나요#
- 만들 방향은 정해졌는데 "정확히 무엇을, 어디까지" 만들지 아직 흐릿한 경우
- 요구사항에 숨어 있는 가정을 드러내고, 명세 품질을 점수로 확인하고 싶을 때
- 시점으로는 조사(Discovery)를 끝낸 뒤, 기획(Planning)에 들어가기 직전
👉 건너뛰어도 되는 경우: 이미 확정(LOCKED)된 핵심 명세(Seed spec)가 있고, 모호함 점수가 충분히 낮으며(≤ 0.2), 3단계 평가를 이미 통과한 경우.
무엇을 해주나요#
docs/ 폴더에 명세 문서 네 개가 만들어집니다. ((프로젝트이름) 자리에는 실제 프로젝트 이름이 들어갑니다.)
-
소크라테스식 발굴 보고서 (
docs/socratic-discovery-(프로젝트이름).md) — 꼬리에 꼬리를 무는 질문으로 드러낸 숨은 가정 정리 - 핵심 명세 (
docs/seed-spec-(프로젝트이름).md) — 못 박은 "무엇을 만들지"의 확정본 - 의사결정 기록 (
docs/decision-log-(프로젝트이름).md) — 무엇을 왜 그렇게 정했는지 기록 - 평가 결과 (
docs/spec-evaluation-(프로젝트이름).md) — 명세가 충분히 명확한지 점수로 검증한 결과
이 명세가 통과되면 다음 단계인 기획(/cc-product:plan) 으로 넘어갑니다.
어떻게 쓰나요#
# 기본
/cc-product:specify " 커뮤니티 기능 "
# 인터뷰 건너뛰기 (이미 정리된 결과가 있을 때)
/cc-product:specify --skip-interview " 커뮤니티 기능 "
질문을 더 깊게 파고들고 싶으면 --depth(1~5, 기본 5)로 인터뷰 깊이를 조절할 수 있습니다.
안에서 무슨 일이 벌어지나요#
크게 세 단계로 진행하며, 매번 모호함을 줄여 명세를 확정해 갑니다.
- 소크라테스식 인터뷰 — "왜요? 그럼 이건요?" 식으로 5단계까지 꼬리 질문을 던져, 말로는 당연해 보였지만 숨어 있던 가정을 끄집어냅니다.
- 핵심 명세 작성 + 검증 — 인터뷰 결과를 핵심 명세로 바꾸고, 모호함 점수를 매긴 뒤, 반대 의견 검토와 단순화를 거쳐 명세를 못 박습니다.
- 3단계 평가 — 체크리스트(기계적), 의미(모호함·반대·단순화), 합의(분석가·PM·아키텍트 3인) 세 관문을 모두 통과해야 다음으로 넘어갑니다.
작업이 길어 대화가 늘어났다면 대화를 비우고(/clear) 새로 시작하는 것을 권장합니다 — 결과는 파일에 남아 있어 사라지지 않습니다.
⚙️ 상세 옵션·실행 명세 (개발자 / AI 에이전트용)
Triggers#
- After Discovery completion, before Planning
- When hidden assumptions in requirements need to be exposed
- When spec quality needs to be quantitatively verified
Usage#
/cc-product:specify " Community feature "
/cc-product:specify --skip-interview # Skip interview (when existing results available)Parameters#
| Parameter | Required | Description | Example |
|---|---|---|---|
description | ✅ | Spec target description | "Community feature" |
Options#
| Option | Default | Description |
|---|---|---|
--skip-interview | false | Skip Socratic interview |
--depth | 5 | Socratic interview depth (1-5) |
Skip Conditions#
This stage can be skipped in the following cases:
- A LOCKED Seed spec already exists
- Ambiguity score ≤ 0.2 confirmed
- 3-stage evaluation PASS confirmed
Execution Flow#
Phase 1: Socratic Interview#
Source: cc-spec → /cc-spec:interview
- 5-stage recursive questioning to expose hidden assumptions
- Artifacts:
docs/socratic-discovery-{slug}.md
Phase 2: Seed Spec + Verification#
Source: cc-spec → /cc-spec:seed, /cc-spec:score
- Convert Socratic results to Seed spec
- 5-dimension ambiguity score calculation
- Contrarian review + Simplifier simplification (parallel)
- Apply corrections and lock Seed spec
Phase 3: 3-Stage Evaluation#
Source: cc-spec → /cc-spec:evaluate
- Mechanical verification (10-item checklist)
- Semantic verification (ambiguity + Contrarian + Simplifier)
- Consensus verification (Analyst + PM + Architect panel)
Gate: Specification Gate#
| Condition | Criteria |
|---|---|
| Ambiguity score | ≤ 0.2 |
| Convergence | ≥ 0.95 |
| Contrarian unresolved Critical | 0 |
| Consensus | 3/3 unanimous |
Pass → Proceed to /cc-product:plan (Planning stage)
Fail → Revise flagged items and re-evaluate
Artifacts#
| File | Path |
|---|---|
| Socratic discovery report | docs/socratic-discovery-{slug}.md |
| Seed spec | docs/seed-spec-{slug}.md |
| Decision log | docs/decision-log-{slug}.md |
| Evaluation result | docs/spec-evaluation-{slug}.md |
After Completion#
- Update specification status to
completedin.pipeline/{slug}.yaml - Record artifact paths
- Present context-clear handoff:
✅ Specification stage complete (Gate PASSED). Artifacts saved:
- docs/seed-spec-{slug}.md
- docs/socratic-discovery-{slug}.md
- docs/decision-log-{slug}.md
- docs/spec-evaluation-{slug}.md
**Option 1 (Recommended)**: Clear context and continue to Planning
/clear
Then run: /cc-product:plan
**Option 2**: Continue in current context
Proceed directly to /cc-product:planRelated Commands#
/cc-product:discover— Previous stage (Discovery)/cc-product:plan— Next stage (Planning)