deep-interview

Convert vague development ideas into testable specifications via Socratic interviews.

Updated May 20, 2026
One-click install
npx skills add https://github.com/xdkp/oh-my-claudecode --skill deep-interview-xdkp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/xdkp/oh-my-claudecode/tree/main/skills/deep-interview
Command: npx skills add https://github.com/xdkp/oh-my-claudecode --skill deep-interview-xdkp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep Interview resolves ambiguous product ideas by running a Socratic, ambiguity-scored questioning loop that prevents jumping into implementation before requirements are genuinely clear.

Core Features & Use Cases

  • Socratic clarification with ambiguity gating: asks one targeted question at a time, scores clarity across goal/constraints/success criteria (and context for brownfield), and refuses to proceed until ambiguity is below the configured threshold.
  • Brownfield-aware requirement discovery: uses codebase exploration first, then cites repository evidence when confirming how the new work should fit.
  • Spec crystallization for downstream execution: generates a ready-to-run spec written to .omc/specs/deep-interview-{slug}.md, including acceptance criteria and an ontology convergence summary, then bridges to planning/execution skills.

Quick Start

Use deep interview to clarify your idea by saying: Run a deep interview for my vague project idea so you can produce a clear spec with testable acceptance criteria.

Frequently Asked Questions about deep-interview

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

FAQPage Schema
How do I turn vague product ideas into executable specs with testable acceptance criteria?

To turn vague ideas into executable specs, you can run a Socratic interview workflow that asks targeted questions and mathematically scores ambiguity to generate unambiguous, testable execution specifications with clear acceptance criteria.

What is the best way to clarify requirements for a brownfield codebase before planning new features?

To clarify requirements for a brownfield codebase, use a requirement discovery process that explores the existing repository first and cites codebase evidence to confirm how the new feature should fit before generating a final spec.

How does Socratic questioning prevent premature implementation when defining product requirements?

Socratic questioning prevents premature implementation by asking one question at a time and applying ambiguity gating, refusing to proceed with spec generation until clarity scores for goals, constraints, and success criteria drop below a configured threshold.

Can I generate requirement specifications for greenfield projects without writing code first?

Yes, you can generate requirement specifications for greenfield projects without writing code first by using a Socratic interview to extract ontology, track convergence, and output a ready-to-run spec document to your project directory.

What output format should I expect when crystallizing ambiguous development tasks into specifications?

When crystallizing ambiguous development tasks, the output format is a markdown specification file written to .omc/specs/deep-interview-{slug}.md, which includes structured acceptance criteria and an ontology convergence summary for downstream execution.