deep-interview

Run Socratic interviews with ambiguity scoring to crystallize requirements into structured specs.

Updated May 5, 2026
One-click install
npx skills add https://github.com/HyperionBurn/searchv1beta --skill deep-interview-hyperionburn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/HyperionBurn/searchv1beta/tree/main/.github/skills/deep-interview
Command: npx skills add https://github.com/HyperionBurn/searchv1beta --skill deep-interview-hyperionburn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents wasted build cycles by guiding users to replace vague product or technical ideas with crystal-clear requirements through Socratic, ambiguity-aware questioning.

Core Features & Use Cases

  • Socratic deep questioning with ambiguity scoring: Iteratively targets the weakest clarity dimension (goal, constraints, success criteria, and context when applicable).
  • Brownfield-aware onboarding: Performs a quick codebase exploration and maps relevant areas before interviewing so questions match the existing system.
  • Specification crystallization: Produces a structured spec (goal, constraints, non-goals, acceptance criteria, exposed/resolved assumptions, ontology, and transcript) and then confirms readiness.
  • Execution bridge selection: Routes the final, crystallized spec into downstream workflows such as ralplan → omg-autopilot or alternative execution paths.

Quick Start

Ask for a deep interview when you have a vague idea and want the AI to ask one targeted question at a time until your specification is clear enough to proceed.

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, this Skill applies a Socratic interview loop with ambiguity scoring that iteratively targets the weakest clarity dimensions until a structured spec is crystallized. It prevents wasted build cycles by uncovering hidden assumptions before execution begins.

What is the best way to gather requirements for an existing codebase without missing context?

The best way to gather requirements for an existing codebase is to use brownfield-aware onboarding that explores the codebase and maps relevant areas before interviewing. This ensures Socratic questioning matches the existing system architecture and surfaces hidden assumptions specific to the current environment.

How does ambiguity scoring work in product discovery interviews?

Ambiguity scoring in product discovery interviews works by iteratively evaluating clarity across goal, constraints, success criteria, and context dimensions. The Socratic loop targets the weakest dimension with structured questioning until ambiguity falls below a threshold, triggering spec crystallization and gated execution-bridge selection.

How do I transition a finalized specification into an execution plan?

To transition a finalized specification into an execution plan, use execution bridge selection to route the crystallized spec into downstream workflows like ralplan or omg-autopilot. This gated handoff only triggers once ambiguity scoring falls below the required threshold, ensuring execution readiness.

When should I not use automated Socratic questioning for requirement gathering?

You should not use automated Socratic questioning for requirement gathering when your success does not depend on uncovering hidden assumptions before execution, or when dealing with scenarios outside product, engineering, and workflow definition that lack the need for mathematically clear specifications.