dev-deep-interview

Transform vague development briefs into testable specifications through Socratic questioning.

520|175|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/EvolutionAPI/evo-nexus --skill dev-deep-interview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-deep-interview
Source: https://github.com/EvolutionAPI/evo-nexus/tree/main/.claude/skills/dev-deep-interview
Command: npx skills add https://github.com/EvolutionAPI/evo-nexus --skill dev-deep-interview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Dev Deep Interview converts vague or high-level development requests into concrete, testable specifications by driving down ambiguity through focused Socratic questioning and refusing to proceed until clarity is sufficient for implementation.

Core Features & Use Cases

  • Ambiguity assessment: Scores domain clarity, scope, success criteria, constraints, and stakeholders to decide whether to proceed or launch an interview loop.
  • Socratic interview loop: Asks one targeted question at a time with 2–4 selectable options, focuses on the weakest dimension, and stops after eight questions or once clarity thresholds are met.
  • Spec generation and handoff: Always writes a persisted spec file to workspace/projects/specs with context, in-scope/out-of-scope items, success criteria, constraints, open questions, and a recommended next step (e.g., dev-autopilot or dev-plan).

Quick Start

Use dev-deep-interview to interview the requester and produce a testable spec for the vague brief "improve checkout latency".

Frequently Asked Questions about dev-deep-interview

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

FAQPage Schema
How do I turn a vague development brief into a testable specification?

To turn a vague development brief into a testable specification, use Socratic questioning to assess ambiguity across domain, scope, success criteria, constraints, and stakeholders. This structured interview approach forces clarity before implementation begins.

What is Socratic questioning in software requirements gathering?

Socratic questioning in requirements gathering is a focused method to reduce ambiguity by asking one targeted question at a time. It sequentially addresses weak clarity dimensions until thresholds are met or a maximum of eight questions are reached.

How do I scope ambiguous feature requests before coding?

To scope ambiguous feature requests before coding, run a structured interview that scores clarity across domain, scope, and constraints. This process identifies in-scope and out-of-scope items, producing a persisted spec file ready for development planning.

Can I use an automated interview to generate a project spec file?

Yes, you can use an automated interview to generate a project spec file. The process presents 2–4 selectable options per question, scores clarity across five dimensions, and writes a persisted specification file with success criteria and recommended next steps.

When should I use Socratic questioning for development planning?

Use Socratic questioning for development planning during early-stage briefs, ambiguous feature requests, pre-implementation reviews, and high-stakes tasks. It is necessary when initial requirements lack the clarity required to define testable success criteria.

What are the limitations of automated requirements scoping interviews?

Limitations of automated requirements scoping interviews include a strict stop condition after eight questions. If clarity thresholds are not met within this limit, the interview terminates, potentially leaving open questions in the resulting specification file.