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.