deep-interview
Socratic deep interview with mathematical ambiguity gating before execution
Best for Requirements gatheringWorks with GitHubLow risk
⌘source
- author
@Yeachan-Heo- language
- TypeScript
★24kstars
2kforks
Apr 19, 2026
✦overview.md
Key Features
- ·Socratic questioning loop to clarify vague ideas
- ·Gates execution until requirements are clear
- ·Produces execution-ready specifications
- ·Targets intent clarity before implementation
- ·Asks about scope boundaries and tradeoffs
Use Cases
- →When a developer has a vague feature idea but hasn't defined acceptance criteria
- →Before handing off work to planning or implementation tools to prevent misalignment
- →When a request lacks concrete file targets or clear scope boundaries
Best for
- ✓Requirements gathering
- ✓Ambiguous feature requests
Not ideal for
- !Requests with clear acceptance criteria
- !When users explicitly want immediate execution
- !Lightweight brainstorming sessions
FAQs
name
deep-interview
description
Socratic deep interview with mathematical ambiguity gating before execution
argument-hint:[--quick|--standard|--deep] [--autoresearch] <idea or vague description>
<Purpose>
Deep Interview is an intent-first Socratic clarification loop before planning or implementation. It turns vague ideas into execution-ready specifications by asking targeted questions about why the user wants a change, how far it should go, what should stay out of scope, and what OMX may decide without confirmation.
</Purpose>
...<Use_When>
- The request is broad, ambiguous, or missing concrete acceptance criteria
- The user says "deep interview", "interview me", "ask me everything", "don't assume", or "ouroboros"
- The user wants to avoid misaligned implementation from underspecified requirements
- You need a requirements artifact before handing off to
ralplan,autopilot,ralph, orteam</Use_When>
<Do_Not_Use_When>
- The request already has concrete file/symbol targets and clear acceptance criteria
- The user explicitly asks to skip planning/interview and execute immediately
- The user asks for lightweight brainstorming only (use
planinstead) - A complete PRD/plan already exists and execution should start </Do_Not_Use_When>
<Why_This_Exists>
$install
1-click copynpx skills add Yeachan-Heo/oh-my-codex --skill deep-interviewSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.