spec-first-interview

What problem does it solve?

Converts ambiguous or underspecified requests into a clear, machine-readable specification to prevent wasted implementation effort, reduce misalignment across personas, and enforce acceptance criteria before development begins.

Core Features & Use Cases

• Socratic Interviewing: Conduct a structured question-driven interview that isolates goals, constraints, and success criteria while always probing with follow-up questions.
• Ambiguity Scoring & Gating: Quantify goal, constraint, and success clarity into an ambiguity score and gate seed generation until clarity thresholds are met.
• Seed Generation & Ontology: Produce an immutable YAML seed containing goal, constraints, acceptance criteria, ontology, evaluation principles, and exit conditions; optionally run an ontologist lens and post-implementation gap audit.
• Use Case: Use before building a new feature, multi-agent workflow, or cross-team integration to ensure requirements are explicit and testable.

Quick Start

Run a Socratic interview to clarify "Build a webhook retry system" and generate a seed YAML with goal, constraints, ontology, and acceptance criteria.