deep-interview

Interview vague project ideas into precise specifications with ambiguity scoring.

70|42|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/tranhieutt/software_development_department --skill deep-interview-tranhieutt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/tranhieutt/software_development_department/tree/main/.claude/skills/deep-interview
Command: npx skills add https://github.com/tranhieutt/software_development_department --skill deep-interview-tranhieutt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep Interview protects autonomous execution from misalignment by turning vague ideas into rigorous specifications through structured Socratic questioning, ambiguity scoring, and gating before any build phase.

Core Features & Use Cases

  • Socratic questioning loop targets the weakest clarity dimension each round, demands one question at a time, and highlights assumptions that must be settled before moving forward.
  • Mathematical ambiguity scoring combines goal, constraint, and success criteria clarity (plus context for brownfield) to calculate a threshold (default 20%) that must be met, with ontology tracking to show convergence.
  • Pipeline-ready delivery persists interview state, writes crystalized specs, and hands off to omc-plan → autopilot pipelines or autoresearch when prompted, so a CTO-level workflow yields reliable requirements; for example, use it when a stakeholder only offers a high-level vision and you need a precise spec before coding.

Quick Start

Ask Claude to start a deep interview on your idea so it can question assumptions, score clarity, and produce a spec before execution.

Frequently Asked Questions about deep-interview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a vague project idea into a precise specification before coding?

To turn a vague project idea into a precise specification, you can use a Socratic questioning loop that targets your weakest clarity dimensions, settling assumptions one question at a time until a mathematical ambiguity threshold is met.

What is Socratic ambiguity gating in requirements gathering?

Socratic ambiguity gating is a requirements-gathering process that mathematically scores goal, constraint, and success criteria clarity, blocking pipeline handoff until ambiguity drops below a defined threshold like 20%.

How do I score ambiguity to prevent building misaligned product features?

You score ambiguity by combining goal, constraint, and success criteria clarity into a calculated threshold, using ontology tracking to show convergence and gate execution until specifications reach sufficient precision.

Can I hand off crystallized specifications directly to an automation pipeline?

Yes, after the interview state is persisted and specifications are crystallized, the output can be handed off directly to downstream planning and autopilot pipelines or autoresearch when prompted.

Does this requirements-gathering approach work for brownfield engineering requests?

Yes, the mathematical ambiguity scoring applies to brownfield engineering requests by adding context clarity to the goal, constraint, and success criteria dimensions to ensure thorough requirements before automation proceeds.

When should I not use Socratic questioning for requirement specifications?

You should avoid Socratic questioning for requirement specifications if your project idea is already well-defined, as the ambiguity gating threshold is designed to reduce vague assumptions rather than process precise inputs.