LogoSkills

/cc-product:specify — 무엇을 만들지 "확정"하는 단계

2단계: Specification — Socratic interview, Seed spec, 모호성 평가, contrarian/simplification, 3단계 검증

/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)로 인터뷰 깊이를 조절할 수 있습니다.

안에서 무슨 일이 벌어지나요#

크게 세 단계로 진행하며, 매번 모호함을 줄여 명세를 확정해 갑니다.

  1. 소크라테스식 인터뷰 — "왜요? 그럼 이건요?" 식으로 5단계까지 꼬리 질문을 던져, 말로는 당연해 보였지만 숨어 있던 가정을 끄집어냅니다.
  2. 핵심 명세 작성 + 검증 — 인터뷰 결과를 핵심 명세로 바꾸고, 모호함 점수를 매긴 뒤, 반대 의견 검토와 단순화를 거쳐 명세를 못 박습니다.
  3. 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#

ParameterRequiredDescriptionExample
descriptionSpec target description"Community feature"

Options#

OptionDefaultDescription
--skip-interviewfalseSkip Socratic interview
--depth5Socratic 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

  1. 5-stage recursive questioning to expose hidden assumptions
  2. Artifacts: docs/socratic-discovery-{slug}.md

Phase 2: Seed Spec + Verification#

Source: cc-spec/cc-spec:seed, /cc-spec:score

  1. Convert Socratic results to Seed spec
  2. 5-dimension ambiguity score calculation
  3. Contrarian review + Simplifier simplification (parallel)
  4. Apply corrections and lock Seed spec

Phase 3: 3-Stage Evaluation#

Source: cc-spec/cc-spec:evaluate

  1. Mechanical verification (10-item checklist)
  2. Semantic verification (ambiguity + Contrarian + Simplifier)
  3. Consensus verification (Analyst + PM + Architect panel)

Gate: Specification Gate#

ConditionCriteria
Ambiguity score≤ 0.2
Convergence≥ 0.95
Contrarian unresolved Critical0
Consensus3/3 unanimous

Pass → Proceed to /cc-product:plan (Planning stage) Fail → Revise flagged items and re-evaluate

Artifacts#

FilePath
Socratic discovery reportdocs/socratic-discovery-{slug}.md
Seed specdocs/seed-spec-{slug}.md
Decision logdocs/decision-log-{slug}.md
Evaluation resultdocs/spec-evaluation-{slug}.md

After Completion#

  • Update specification status to completed in .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:plan
  • /cc-product:discover — Previous stage (Discovery)
  • /cc-product:plan — Next stage (Planning)