deep-interview

Runs Socratic interview rounds with weighted ambiguity scoring to produce execution-ready requirement specs.

Updated Feb 1, 2024
One-click install
npx skills add https://github.com/ogiboy/portfolio-app --skill deep-interview-ogiboy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/ogiboy/portfolio-app/tree/main/.codex/skills/deep-interview
Command: npx skills add https://github.com/ogiboy/portfolio-app --skill deep-interview-ogiboy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Vague or underspecified requests lead to misaligned implementations. This Skill turns broad ideas into explicit, testable specifications by interviewing the user one question at a time, scoring ambiguity quantitatively, and refusing to hand off to execution until clarity thresholds and readiness gates are met. ## Core Features & Use Cases - Socratic Interview Loop: Asks one targeted question per round, pressure-tests answers with evidence, assumption, and tradeoff follow-ups, and re-scores weighted ambiguity after each answer. - Depth Profiles & Gating: Supports --quick, --standard, and --deep profiles with distinct ambiguity thresholds and round caps, plus mandatory Non-goals and Decision Boundaries readiness gates. - Spec Crystallization & Handoff: Writes interview transcripts to .omx/interviews/ and execution-ready specs to .omx/specs/ for downstream planning and execution modes, with a specialized --autoresearch intake mode. - Use Case: A user says "improve the portfolio site performance." The Skill inspects repo docs, asks intent and scope questions across several rounds, then produces a spec with acceptance criteria, non-goals, and decision boundaries ready for a planning workflow. ## Quick Start Ask the AI to run a deep interview on your vague feature idea, for example by saying "deep interview me on adding a dark mode toggle to the site" and answer each question until the spec is crystallized.

Frequently Asked Questions about deep-interview

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

FAQPage Schema
How do I turn a vague feature idea into a clear specification?

Run a structured interview that asks one targeted question per round about intent, outcome, scope, and constraints. Each answer is scored on weighted clarity dimensions, and the loop stops only when ambiguity falls below the profile threshold and readiness gates pass.

What is ambiguity scoring in requirements gathering?

Ambiguity scoring assigns 0.0-1.0 clarity values to dimensions like intent, outcome, scope, constraints, and success criteria, then combines them with weights. Greenfield and brownfield tasks use different weight formulas, and interviewing stops when the score meets the profile threshold.

When should I use quick vs standard vs deep interview profiles?

Use quick for fast pre-PRD passes with a 0.30 threshold and 5-round cap, standard for full requirement interviews at 0.20 with 12 rounds, and deep for high-rigor exploration at 0.15 with up to 20 rounds. Standard is the default when no flag is given.

When should I skip the interview and execute directly?

Skip it when the request already has concrete file or symbol targets and clear acceptance criteria, when a complete PRD or plan exists, or when the user explicitly asks to bypass planning. It is designed for ambiguous requests, not well-specified tasks.

Can the interview handle brownfield codebases with existing docs?

Yes. Brownfield mode runs a preflight intake that inspects AGENTS.md files, READMEs, docs, ADRs, and existing context snapshots before questioning. It cross-checks user claims against code and flags doc/code conflicts as confirmation questions.