deep-interview

Clarify vague ideas into testable specifications through structured Socratic interviews.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep Interview provides a structured, Socratic process to convert vague ideas into explicit, testable specifications by surfacing hidden assumptions and measuring ambiguity across dimensions before execution.

Core Features & Use Cases

  • One-question-at-a-time interview to identify the weakest clarity dimension and drive targeted questioning
  • Ambiguity scoring across dimensions with transparent gaps and progress tracking
  • Ontology tracking to stabilize core concepts across rounds and detect convergence
  • Integrated execution pathway via omc-plan and autopilot with optional challenge modes
  • State persistence to resume interviews after interruptions and enable safe handoffs

Quick Start

Provide a vague idea to begin the deep interview and let the system guide you with one focused question at a time until ambiguity falls below 20%.

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 ideas into testable specifications before execution?

To convert vague ideas into testable specifications, you use a structured Socratic interview that asks one question at a time to surface hidden assumptions. This process scores ambiguity across dimensions until it falls below 20%, producing a formal markdown spec for downstream planning.

What is the Socratic method for requirements gathering?

The Socratic method for requirements gathering is a structured interview process that identifies the weakest clarity dimension and drives targeted questioning. It tracks ontology to stabilize core concepts and persists state to safely resume interviews after interruptions.

Can I anchor requirements gathering to an existing codebase?

Yes, you can anchor requirements gathering to an existing codebase. The interview operates in both greenfield and brownfield contexts, using your available codebase to ground the Socratic questioning and produce more accurate testable specifications.

How do I measure ambiguity during specification planning?

You measure ambiguity during specification planning through transparent ambiguity scoring across multiple dimensions. The interview process tracks gaps and progress, continuing targeted questioning until overall ambiguity drops below 20%.

Does the deep interview process integrate with execution and planning tools?

Yes, the deep interview process integrates with execution and planning tools via omc-plan and autopilot pathways. It outputs a formal specification markdown file that serves as direct input for downstream planning, with optional challenge modes available.

What are the limitations of using a Socratic interview for requirements gathering?

A limitation of using a Socratic interview for requirements gathering is that it requires sustained interaction to reduce ambiguity below 20%. While state persistence allows resuming after interruptions, the process needs sufficient rounds to detect concept convergence and stabilize the ontology.