deep-interview

Clarify vague product ideas into testable specifications via Socratic interviews.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/nichobbs/lyric-lang --skill deep-interview-nichobbs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/nichobbs/lyric-lang/tree/main/.claude/skills/deep-interview
Command: npx skills add https://github.com/nichobbs/lyric-lang --skill deep-interview-nichobbs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep Interview prevents wasted build cycles by converting vague goals into crystal-clear requirements using Socratic questioning and ambiguity gating.

Core Features & Use Cases

  • Socratic deep requirements gathering that targets hidden assumptions rather than collecting feature lists.
  • Mathematical ambiguity scoring across goal, constraints, and success criteria (and context for brownfield scenarios), with transparent progress after every answer.
  • Readiness gating before execution: it refuses to proceed until ambiguity is below the resolved threshold for the run.
  • Spec crystallization and handoff into a downstream 3-stage pipeline that refines the spec and then executes.

Quick Start

Start a deep interview by telling the AI to interview you deeply about your idea (for example: “deep interview, [--standard] Build a clear spec for my project idea: <describe it>”).

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 precise engineering specifications?

To turn vague product ideas into precise engineering specifications, use a Socratic interview process that asks one question at a time to uncover hidden assumptions and applies mathematical ambiguity scoring to gate execution readiness.

What is ambiguity scoring in requirements gathering and how does it work?

Ambiguity scoring in requirements gathering mathematically measures unresolved uncertainty across goals, constraints, and success criteria. It updates transparently after every interview answer to track progress toward a required readiness threshold.

How do I analyze brownfield repository context before modifying existing software?

To analyze brownfield repository context before modifying existing software, a Socratic interview explores the existing repo structure and logic, requiring user confirmation before proceeding to ensure modifications align with current system constraints.

Can I gate autonomous execution until requirements are fully validated?

Yes, you can gate autonomous execution by implementing a threshold-based policy that persists interview state and refuses to proceed with planning or execution until the ambiguity score drops below the resolved threshold for the run.

What is the best way to prevent wasted build cycles caused by unclear requirements?

The best way to prevent wasted build cycles caused by unclear requirements is to crystallize a testable spec file through deep Socratic questioning, ensuring the scope is well-defined before bridging safely into downstream planning and execution pipelines.

How do I start a Socratic interview to scope a new software project?

To start a Socratic interview for scoping a new software project, instruct the AI to interview you deeply about your idea, providing a brief description of the goal so it can begin asking targeted one-question-at-a-time queries.