spec-clarity

Spec clarity verification orchestration — from Socratic interview to 3-stage evaluation. Use when running the full specification clarity workflow.

Spec Clarity#

한마디로 (비개발자용)#

이 스킬은 "무엇을 만들지"에 대한 요구사항(스펙)이 충분히 명확한지 끝까지 따져 보는 검수 도우미입니다. 마치 집을 짓기 전에 설계도에 빠진 부분이나 애매한 표현이 없는지 꼼꼼히 점검해 주는 감리자와 같습니다. 질문 던지기 → 핵심 스펙 정리 → 애매함 점수 측정 → 반대 의견·단순화 검토 → 최종 합격/불합격 판정까지 한 흐름으로 안내합니다. 덕분에 개발이 시작되기 전에 오해와 누락을 미리 걸러낼 수 있습니다.

무엇을·언제 (비개발자용)#

무엇을 해주나요: 요구사항이 모호하지 않고, 빠진 부분 없이 명확한지 단계별로 검증합니다.
언제 켜지나요: 요구사항을 본격적으로 다듬고 검증하는 전체 과정을 처음부터 끝까지 진행하고 싶을 때 사용합니다.
진행 순서(추천): 소크라테스식 인터뷰로 숨은 가정 끌어내기 → 핵심 스펙(Seed) 만들기 → 애매함 점수 계산 → 반대 관점·단순화 검토 → 3단계 종합 평가 → 최종 통과/불통과(Specification Gate) 판정.
결과물: 인터뷰 정리 리포트, 핵심 스펙 문서, 결정 기록, 평가 결과 리포트가 문서로 남습니다.

핵심 용어 (비개발자용)#

용어	쉬운 설명
Spec (스펙)	무엇을 어떻게 만들지 정리한 요구사항 명세
Socratic Interview (소크라테스식 인터뷰)	꼬리에 꼬리를 무는 질문으로 숨은 가정과 빈틈을 드러내는 방법
Seed Spec (핵심 스펙)	더 이상 흔들리지 않도록 고정한 가장 중요한 기준 스펙
Ambiguity Score (애매함 점수)	요구사항이 얼마나 모호한지 숫자로 나타낸 지표(낮을수록 명확)
Contrarian Review (반대 관점 검토)	일부러 반대 입장에서 가정과 규모를 흔들어 보며 약점을 찾는 검토
Simplifier (단순화)	불필요하게 복잡한 부분을 찾아 더 간단하게 줄이는 작업
Specification Gate (스펙 관문)	스펙이 기준을 통과했는지 합격/불합격을 가르는 최종 관문
Consensus (합의)	여러 검증 단계가 모두 같은 결론에 도달했는지 여부

The main skill orchestrating the entire spec clarity verification flow.

Scope#

Feature	Command
Socratic Deep Interview	`/spec:interview`
Seed Spec Creation	`/spec:seed`
Seed Spec Verification	`/spec:verify`
Seed Spec Evolution	`/spec:evolve`
Ambiguity Score Calculation	`/spec:ambiguity`
3-Stage Integrated Evaluation	`/spec:evaluate`
Contrarian Review	`/spec:challenge`
Simplifier Complexity Reduction	`/spec:simplify`

Quick Start#

# Full flow (recommended)
/spec:interview          # 1. Expose assumptions via Socratic interview
/spec:seed               # 2. Create Seed spec
/spec:ambiguity          # 3. Calculate ambiguity score
/spec:challenge          # 4. Contrarian review (parallelizable)
/spec:simplify           # 5. Simplifier reduction (parallelizable)
/spec:evaluate           # 6. 3-stage integrated evaluation

# Individual use
/spec:verify             # Seed spec structural verification only
/spec:evolve             # Evolve locked Seed spec

Execution Flow#

Socratic Interview → Seed Spec (DRAFT)
  → Ambiguity Score
  → Contrarian + Simplifier (parallel)
  → Apply fixes
  → Seed Spec (LOCKED)
  → 3-Stage Evaluation
  → Specification Gate PASS/FAIL

Quality Gates#

Metric	Criteria	Config File
Ambiguity Score	<= 0.2	`config/thresholds.yaml`
Convergence	>= 0.95	`config/thresholds.yaml`
Consensus	3/3 unanimous	`config/thresholds.yaml`

Output#

File	Location
Socratic Discovery Report	`docs/socratic-discovery-{slug}.md`
Seed Spec	`docs/seed-spec-{slug}.md`
Decision Log	`docs/decision-log-{slug}.md`
Evaluation Result Report	`docs/spec-evaluation-{slug}.md`

references/AMBIGUITY_RUBRIC.md — 5-dimension ambiguity rubric
references/SEED_SPEC_SCHEMA.md — Seed spec schema
references/EVALUATION_PROTOCOL.md — 3-stage evaluation protocol