deep-interview

Refines vague software requirements into clear specifications via scored ambiguity gating and iterative Socratic questioning.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/mingshi2333/resumable-agent-workflow --skill deep-interview-mingshi2333
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/mingshi2333/resumable-agent-workflow/tree/main/claude/skills/deep-interview
Command: npx skills add https://github.com/mingshi2333/resumable-agent-workflow --skill deep-interview-mingshi2333

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill tackles the challenge of vague user requirements by employing Socratic questioning to systematically uncover assumptions, clarify goals, and define precise specifications before any code is written.

Core Features & Use Cases

  • Socratic Questioning: Iteratively asks targeted questions to expose hidden assumptions and ambiguities.
  • Mathematical Ambiguity Gating: Assigns a clarity score and refuses to proceed until ambiguity drops below a set threshold (default 20%).
  • Use Case: When a user says "I have a vague idea for an app," this Skill will engage them in a rigorous interview to transform that idea into a crystal-clear, actionable specification, preventing costly misunderstandings later in the development process.

Quick Start

Use the deep-interview skill to clarify your idea for a new project.

Frequently Asked Questions about deep-interview

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

FAQPage Schema
How do I clarify vague software requirements before starting development?

Clarify vague software requirements by conducting a Socratic interview that iteratively exposes hidden assumptions. This questioning refines undefined initial scope into a clear, actionable specification by scoring ambiguity across goal, context, and success criteria dimensions.

What is the Socratic method for requirements gathering?

The Socratic method for requirements gathering uses targeted questioning to mathematically gate ambiguity. It assigns a clarity score across constraints and goals, refusing to proceed with planning until ambiguity drops below a set threshold to prevent costly misunderstandings.

How do I measure and reduce ambiguity in complex project specifications?

Measure ambiguity in project specifications by scoring clarity across goal, constraints, success criteria, and context dimensions. Reduce this score through iterative questioning that challenges assumptions until the mathematical ambiguity drops below the default 20% threshold.

Does this requirements gathering approach work for undefined project scope?

Yes, requirements gathering via Socratic questioning is specifically designed for undefined initial project scope. It applies optional challenge agents to rigorously test ideas, ensuring robust, unambiguous outputs before proceeding to execution planning.

What is the best way to turn a vague app idea into an actionable specification?

The best way to turn a vague app idea into an actionable specification is through a rigorous deep interview. It mathematically gates ambiguity by scoring dimensions like goals and constraints, guaranteeing a crystal-clear output before development begins.

Why use mathematical ambiguity gating for software requirements gathering?

Mathematical ambiguity gating prevents premature planning by scoring specification clarity across dimensions like context and goals. It enforces iterative questioning until ambiguity falls below 20%, ensuring the final requirements are completely unambiguous.