plan-interview
Adaptive interview-driven spec generation. Use when converting rough plans into comprehensive specifications, needing structured requirements gathering, or transforming ideas into implementation-ready documentation.
By secondsky · 355 installs
npx skills add secondsky/claude-skills --skill plan-interview
Source repository · Upstream listing
Plan Interview Skill
Transform rough plans into comprehensive, implementation ready specifications through adaptive, structured interviews.
When to Use
Converting a plan or idea into a detailed specification
Gathering requirements through structured questioning
Transforming rough documentation into implementation ready specs
Ensuring all edge cases, risks, and stakeholders are considered before implementation
Available Components
Command: /plan interview:interview [plan file]
Adaptive interview that calibrates depth based on plan complexity:
Complexity Signals Questions
Simple Single feature, clear scope 10 15
Moderate Multi component, some integrations 18 23
Complex Cross system, many stakeholders 22 28
Usage:
Agent: spec reviewer
Autonomous quality analysis of specifications across 4 dimensions:
Completeness (25 pts) All sections populated?
Consistency (25 pts) No contradictions?
Clarity (25 pts) No ambiguous language?
Edge Cases (25 pts) Error handling defined?
Triggers when you say "review my spec" or "check specification quality".
Interview Phases
1. Foundations & Scope Stakeholders, success criteria, constraints, MVP scope
2. Technical Deep Dive Architecture, data models, scalability, security
3. User Experience Personas, flows, cognitive load, error recovery
4. Risks & Tradeoffs Risk categorization, blast radius, contingency plans
5. Operationalization Testing, deployment, monitoring
6. Wrap Up (optional) Only for complex plans with remaining gaps
Interview Philosophy
Core Principle : Depth over breadth. Better to deeply understand critical aspects than superficially cover everything.
Key Techniques :
Non obvious questions Skip what the plan already answers
Edge probing What happens in unusual cases?
Assumption surfacing Make implicit beliefs explicit
Contradiction detection Flag when answers don't align
Adaptive depth Probe deeper on complex areas, move faster on clear ones
Spec Output Structure
Generated specs include:
Overview (problem, solution, success criteria, stakeholders)
Functional and non functional requirements
Technical design (architecture, data models, APIs, security)
User experience (personas, flows, states, edge cases)
Risks and mitigations (risk register, tradeoffs, contingency plans)
Implementation notes (key decisions, dependencies, migration)
Operationalization (testing, deployment, monitoring)
Open questions and out of scope items
Phasing (MVP vs future)
References
Load these for deeper guidance during interviews:
references/phase 1 clarifications.md Foundations questions and pitfalls
references/phase 2 technical.md Architecture discussion patterns
references/phase 3 ux.md Persona development, UX patterns
references/phase 4 risks.md Risk assessment frameworks
references/interview techniques.md Cross cutting interview skills
references/example spec.md Annotated high quality spec example