deep-interview

Clarify vague requests through a Socratic interview to generate execution-ready specifications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep Interview provides an intent-first Socratic clarification loop that converts vague ideas into execution-ready specifications by asking targeted questions about purpose, scope, and boundaries before planning or implementation.

Core Features & Use Cases

  • Socratic clarification loop to uncover intent, scope, and acceptance criteria.
  • Ambiguity scoring with configurable depth profiles and escalation to advanced modes.
  • Automated artifact generation including transcripts and formal specs for handoff.
  • Handoff contracts to planning/execution tools (ralplan, autopilot, ralph, team) for disciplined execution.
  • Works for both greenfield ideas and brownfield contexts with context grounding.

Quick Start

Provide an initial idea and constraints to begin the Socratic clarification loop.

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 execution-ready specifications?

Socratic clarification resolves ambiguity in under-specified requests by asking targeted questions about intent, scope, and acceptance criteria. It scores ambiguity to ensure vague ideas are fully crystallized before any planning begins.

Can I use this Socratic interview process for brownfield feature planning?

Yes, you can use this Socratic interview process for brownfield feature planning. It applies context grounding to evaluate existing systems, ensuring new specifications align with your current product architecture and established boundaries.

What is the best way to clarify ambiguous requirements before development?

The best way to clarify ambiguous requirements is through a phase-based interview that scores ambiguity and escalates to advanced modes when needed. This generates formal transcripts and structured specs for disciplined execution.

How do I hand off clarified specifications to planning and execution tools?

You hand off clarified specifications using structured handoff contracts designed for planning and execution tools like ralplan, autopilot, ralph, and team. This ensures the generated specs transition smoothly into disciplined development.

Does this specification generation approach work for greenfield product design?

Yes, this specification generation approach works for greenfield product design. It applies an intent-first Socratic loop to uncover acceptance criteria and scope, converting entirely new ideas into structured, execution-ready specifications.