LogoSkills

spec-clarity

Spec Clarity Verification Orchestration — From Socratic interview to 3-stage evaluation

Spec Clarity#

The main skill orchestrating the entire spec clarity verification flow.

Scope#

FeatureCommand
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#

MetricCriteriaConfig File
Ambiguity Score<= 0.2config/thresholds.yaml
Convergence>= 0.95config/thresholds.yaml
Consensus3/3 unanimousconfig/thresholds.yaml

Output#

FileLocation
Socratic Discovery Reportdocs/socratic-discovery-{slug}.md
Seed Specdocs/seed-spec-{slug}.md
Decision Logdocs/decision-log-{slug}.md
Evaluation Result Reportdocs/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