Spec Interview

Refine draft specs and design docs into complete technical documents through deep, probing questions.

When This Runs

• Automatically after brainstorming produces a design doc (user can skip)
• Manually when user says "help me refine this plan/spec" or "ask me about the project"
• When a draft spec or plan.md is missing critical details

The Process

Read target doc → Identify gaps → Ask deep questions (AskUserQuestion) → Iterate → Update doc

Step 1: Read and Analyze

Read the design doc (from brainstorming) or user-specified document. If no target doc is named, or the file is missing or empty, ask which document to refine (offer brainstorming-first as an option) instead of interviewing against nothing.