deep-interview

Guide users through Socratic questioning with ambiguity scoring to clarify requirements.

1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Hyeonjun0527/yeon --skill deep-interview-hyeonjun0527
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/Hyeonjun0527/yeon/tree/main/.codex/skills/deep-interview
Command: npx skills add https://github.com/Hyeonjun0527/yeon --skill deep-interview-hyeonjun0527

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep Interview helps convert vague ideas into crystal-clear specifications by applying Socratic questioning and a mathematical ambiguity gate, preventing premature autonomous execution and reducing misalignment.

Core Features & Use Cases

  • Socratic questioning to surface hidden assumptions and progressively clarify requirements
  • One-question-at-a-time interview loop with weakest-dimension targeting
  • Ambiguity scoring and ontology tracking to measure convergence
  • Brownfield support by mapping existing codebase context when available
  • Optional Autoresearch mode to drive mission proof and evaluation

Quick Start

Start by stating your vague idea and I will ask one focused question at a time until ambiguity falls below 20% and a clear spec is produced.

Frequently Asked Questions about deep-interview

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

FAQPage Schema
How do I reduce ambiguity in software requirements before execution?▼

Socratic questioning reduces ambiguity in software requirements by surfacing hidden assumptions through a one-question-at-a-time interview loop until an ambiguity score falls below 20%, yielding a clear specification.

What is Socratic requirement gathering and how does it work?▼

Socratic requirement gathering is an interview technique that uses progressively targeted questions to surface hidden assumptions. It tracks ontology and uses round-based ambiguity scoring to gate readiness before producing a specification.

Can I use Socratic questioning for brownfield codebase planning?▼

Yes, Socratic questioning supports brownfield planning by mapping existing codebase context when available. It integrates this existing environment context to target questions and clarify requirements accurately.

How do I convert a vague product idea into a clear specification?▼

To convert a vague product idea into a clear specification, state your idea to trigger a focused interview loop. Weakest-dimension targeting progressively clarifies requirements until ambiguity converges below 20%.

Does autoresearch mode help with requirement gathering and evaluation?▼

Autoresearch mode helps with requirement gathering by optionally driving mission proof and evaluation. It complements the Socratic questioning process to ensure specifications are validated before autonomous execution.