/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) — 명세가 충분히 명확한지 점수로 검증한 결과

이 명세가 통과되면 다음 단계인 기획(/product:plan) 으로 넘어갑니다.

어떻게 쓰나요#

# 기본
/product:specify  " 커뮤니티 기능 " 

 # 인터뷰 건너뛰기 (이미 정리된 결과가 있을 때)
/product:specify --skip-interview  " 커뮤니티 기능 "

질문을 더 깊게 파고들고 싶으면 --depth(1~5, 기본 5)로 인터뷰 깊이를 조절할 수 있습니다.

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

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

1. 소크라테스식 인터뷰 — "왜요? 그럼 이건요?" 식으로 5단계까지 꼬리 질문을 던져, 말로는 당연해 보였지만 숨어 있던 가정을 끄집어냅니다.
2. 핵심 명세 작성 + 검증 — 인터뷰 결과를 핵심 명세로 바꾸고, 모호함 점수를 매긴 뒤, 반대 의견 검토와 단순화를 거쳐 명세를 못 박습니다.
3. 3단계 평가 — 체크리스트(기계적), 의미(모호함·반대·단순화), 합의(분석가·PM·아키텍트 3인) 세 관문을 모두 통과해야 다음으로 넘어갑니다.

작업이 길어 대화가 늘어났다면 대화를 비우고(/clear) 새로 시작하는 것을 권장합니다 — 결과는 파일에 남아 있어 사라지지 않습니다.

/product:specify  " Community feature " 
 /product:specify --skip-interview     # Skip interview (when existing results available)

✅ 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: /product:plan

**Option 2**: Continue in current context
  Proceed directly to /product:plan