Deep Interview Skill | Agent Skills

Deep Interview

A structured interview process for gathering requirements and making design decisions on complex features.

Input

$ARGUMENTS can be:

| Format | Example | Description | | ------------------- | ---------------------------------- | ------------------------------ | | Issue number | #531 or 531 | GitHub issue to research first | | PRD path | docs/feature-spec.md | Existing PRD to validate | | Feature description | "user authentication flow" | Free-form description | | Nothing | (empty) | Ask what we're planning |

Interview Process

Phase 1: Context Gathering (Before Questions)

Silently research the topic before asking any questions:

If an issue number is provided, read the issue and its comments
Search for related documentation and existing code
Identify existing patterns that could be reused, and gaps between planned and current state

Summarize findings to the user before starting questions:

"I've reviewed [issue/PRD/code]. Here's what I found: [current state, planned state, key gaps]. Let me ask some questions to clarify the approach..."

Phase 2: Scope Definition

First question — establish boundaries:

Question: "What does [goal] mean to you? What's your target scope?"
Header: "Scope"
Options:
  - Minimal: [simplest version, automatic, no new UI]
  - Medium: [adds user interaction after completion]
  - Full: [mid-process interaction, complete workflow]
  - Other: (always available)

Options should represent increasing complexity, not different features.

Phase 3: Approach Selection

Second question — choose implementation strategy:

Question: "Which approach do you prefer for [main mechanism]?"
Header: "Approach"
Options:
  - Option A: [simpler, faster to build]
  - Option B (Recommended): [better UX, more robust]
  - Hybrid: [combine best of both]

Listen for: If stakeholder suggests something different ("we could do X because Y already exists"), probe deeper — they have context about existing patterns.

Phase 4: Priority Ranking

Third question — identify most valuable improvements:

Question: "What's the most valuable improvement for users right now?"
Header: "Priority"
multiSelect: true
Options:
  - [Capability A]: [benefit description]
  - [Capability B]: [benefit description]
  - [Capability C]: [benefit description]

Phase 5: Implementation Details

Drill into specifics for each selected priority. Ask about context/data flow, UI/UX patterns, and behavior on triggers — adapting questions to the feature at hand.

Phase 6: Technical Decisions

Architectural choices — new implementation vs reusing existing patterns, and why.

Listen for: "We could reuse X" — stakeholder knows about existing infrastructure you should leverage.

Phase 7: Timeline & Scope Confirmation

Final questions: timeline expectation (quick win / full feature / polish) and any additional ideas or concerns.

Output: PRD Generation

After completing the interview, generate a PRD covering:

Executive Summary — what we're building and why
Design Decisions — table of each decision, choice, and rationale
Architecture Overview — current state and target state
Data Model Changes — new and modified entities
API Changes — new and modified endpoints
Frontend Changes — new and modified components
Implementation Checklist — phased tasks (foundation, core feature, polish)
Rollback Plan — how to disable if issues arise
Open Questions — unresolved items

Save the PRD to an appropriate location (e.g., prds/[date]-[feature-name].md or as specified).

Gotchas

Start broad (scope), then narrow (details) — never ask about timeline first
Present tradeoffs, not just options. Mark recommended options with "(Recommended)"
Don't present more than 4 options per question
Probe when stakeholder mentions existing patterns — they have context you don't
Summarize decisions before moving to next phase
Use multiSelect: true when options aren't mutually exclusive

$ARGUMENTS

Agent Skills: Deep Interview

Install this agent skill to your local

Skill Files