deep-interview

Guide Socratic interviews to convert vague requests into executable specifications.

24|2|Updated Mar 12, 2025
One-click install
npx skills add https://github.com/Orinks/AccessiWeather --skill deep-interview-orinks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/Orinks/AccessiWeather/tree/main/.codex/skills/deep-interview
Command: npx skills add https://github.com/Orinks/AccessiWeather --skill deep-interview-orinks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts ambiguous user requests into explicit, testable specifications by guiding a Socratic interview that probes intent, boundaries, and acceptance criteria.

Core Features & Use Cases

  • Guided, one-question-at-a-time interview rounds to elicit intent, outcomes, scope, constraints, and non-goals.
  • Automatic generation of artifacts: a transcript under .omx/interviews and a formal spec under .omx/specs, with contextual references for brownfield projects.
  • Supports readiness gates, multiple depth profiles, and escalation modes to stress-test assumptions.
  • Reuses context snapshots to preserve traceability for downstream handoffs to planning/execution stages.
  • Optional autoresearch domain (if invoked with autoresearch) to tailor the interview toward mission clarity and research artifacts.

Quick Start

Provide your initial idea and constraints, then run the deep-interview to generate a clear, testable spec.

Frequently Asked Questions about deep-interview

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

FAQPage Schema
How do I clarify vague product requirements into executable specifications?▼

To clarify vague product requirements into executable specifications, a guided Socratic interview probes intent, scope, constraints, and acceptance criteria. This method extracts explicit, testable boundaries from ambiguous initial requests.

What is the best way to define non-goals and decision boundaries for a new feature?▼

Defining non-goals and decision boundaries is best achieved through structured clarification interviews that stress-test assumptions. This ensures explicit scope limits are documented before downstream planning and execution stages begin.

Can I use a Socratic interview to preserve context for brownfield projects?▼

Yes, you can use a Socratic interview to preserve brownfield context. It reuses context snapshots and generates formal specs with contextual references, ensuring traceability for downstream handoffs in existing codebases.

How do I generate traceable artifacts for downstream planning and execution?▼

Generate traceable artifacts by running a structured clarification process that outputs a transcript under .omx/interviews and a formal spec under .omx/specs. These artifacts store explicit scope and acceptance criteria for handoff.

Does the specification interview process support escalation modes to test assumptions?▼

Yes, the specification interview process supports escalation modes to stress-test assumptions. It also features readiness gates and multiple depth profiles to ensure vague ideas are fully solidified into formal specifications.