/project:specify#

Stage 2: Specification — Secures implementation-quality specifications through spec clarity verification.

Triggers#

• After Discovery completion, before Planning
• When hidden assumptions in requirements need to be exposed
• When spec quality needs to be quantitatively verified

Usage#

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

Parameters#

Options#

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-clarity → /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-clarity → /spec:seed, /spec:ambiguity

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-clarity → /spec:evaluate

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

Gate: Specification Gate#

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

Artifacts#

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: /project:plan

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

Related Commands#

• /project:discover — Previous stage (Discovery)
• /project:plan — Next stage (Planning)