deep-interview

Convert vague ideas into testable specifications through Socratic questioning.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/Pryma-Tech/iris --skill deep-interview-pryma-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/Pryma-Tech/iris/tree/main/cli/skills/deep-interview
Command: npx skills add https://github.com/Pryma-Tech/iris --skill deep-interview-pryma-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep Interview addresses the challenge of turning vague user ideas into precise, actionable specifications by applying Socratic questioning and structured ambiguity scoring to gate autonomous execution.

Core Features & Use Cases

  • One-question-at-a-time interview loop with targeted questioning
  • Quantitative ambiguity scoring using a formal scoring model
  • Brownfield codebase grounding with prior exploration context
  • Ontology extraction and convergence tracking across rounds
  • Phase-based execution gating: deep-interview → omc-plan → autopilot
  • Optional challenge modes (Contrarian, Simplifier, Ontologist)
  • Persistent interview state for resume and session recovery
  • Spec crystallization to .omc/specs for downstream execution
  • Flexible execution bridge to ralplan and autopilot workflows

Quick Start

Describe your vague idea and I will ask one focused question at a time to reduce ambiguity until the spec is ready.

Frequently Asked Questions about deep-interview

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

FAQPage Schema
How do I convert vague product ideas into concrete testable specifications?

To convert vague ideas into testable specifications, use a Socratic questioning loop that asks one targeted question at a time. This process applies quantitative ambiguity scoring to reduce uncertainty until the requirements converge into a structured spec output.

What is Socratic questioning for requirements gathering and how does it work?

Socratic questioning for requirements gathering is a structured interview method that extracts ontology and reduces ambiguity through focused, single-question rounds. It gates autonomous execution by scoring ambiguity until a precise specification is achieved for downstream automation.

Can I use structured ambiguity scoring for brownfield codebase planning?

Yes, structured ambiguity scoring applies to brownfield codebase planning by grounding the interview with prior exploration context. It extracts existing ontology and converges requirements across multiple rounds to gate downstream execution reliably.

How do I start a multi-round interview to extract requirements from a vague concept?

Start a multi-round interview by describing your vague idea; the system then asks one question at a time to extract ontology and track convergence. It uses persistent state to resume sessions and crystallizes the final output to a specs directory for downstream workflows.

What are the limitations of automated Socratic interviewing for ideation?

Automated Socratic interviewing requires multiple rounds to reduce ambiguity sufficiently for execution gating and focuses on precise specification rather than rapid prototyping. It may not suit projects needing immediate code generation without structured requirements.

Does phase-based execution gating work with downstream planning and autopilot workflows?

Yes, phase-based execution gating bridges directly to downstream planning and autopilot workflows. Once the Socratic interview reduces ambiguity to acceptable levels, it crystallizes the spec to enable autonomous execution.