interview
Interview
Conduct a thorough, in-depth interview to produce a comprehensive specification document.
Process
- Understand the scope from the provided arguments/instructions
- Interview iteratively using AskUserQuestion - continue until all aspects are covered
- Write the spec to a file when complete
Interview Guidelines
Question Depth
Ask non-obvious questions. Skip surface-level questions the user has likely already considered. Dig into:
- Edge cases and failure modes
- Constraints and non-functional requirements
- User personas and their specific needs
- Highest-value outcome and consequence of delay
- Integration points and dependencies
- Security, privacy, and compliance implications
- Scalability and performance expectations
- Migration and backwards compatibility
- Rollback and recovery strategies
- Observability and debugging needs
- First visible step and likely bottleneck
- Trade-offs the user is willing to make
Question Style
- Ask 1-2 focused questions at a time (use AskUserQuestion with options when choices are clear)
- Follow up on vague answers - push for specifics
- Challenge assumptions politely
- Surface implicit requirements the user hasn't stated
- Explore "what if" scenarios
Areas to Cover
Adapt based on context, but consider:
Technical: Architecture, data models, APIs, storage, caching, auth, error handling UX: User flows, states, feedback, accessibility, edge case UI Operational: Deployment, monitoring, alerts, on-call, maintenance Business: Success metrics, timelines, dependencies, stakeholders, budget constraints, consequence of delay Risk: What could go wrong? What's the blast radius? What's the mitigation? Execution: What should happen first, and what bottleneck most likely slows this down?
Output
When the interview is complete, write a structured spec to a file (e.g., spec.md or docs/<topic>-spec.md).
The spec should include:
- Overview and goals
- Requirements (functional and non-functional)
- Technical approach
- Open questions (if any remain)
- Out of scope items
Instructions
$ARGUMENTS
More from montagao/skills
library-ebooks
>-
56plane-api
Internal helper for creating/listing/updating Plane work items.
42llm-seo
Optimize websites and content for AI/LLM discoverability (AIO - AI Optimization). Use when asked to "optimize for AI", "improve AI discoverability", "add LLM SEO", "make site AI-friendly", "help LLMs understand my site", or when implementing llms.txt files, JSON-LD structured data, or AI-focused content strategies.
20clean-history
Reimplement the current branch on a new branch with a clean, narrative-quality git commit history suitable for reviewer comprehension. Use when the user wants to clean up messy commit history before opening a PR.
18supernote-upload
Upload PDF and EPUB files to Supernote Cloud. Use this skill when the user wants to send documents to their Supernote device.
16todo
Create a Plane task in Plane. By default, use the interview skill first to flesh out the issue before creating it; only skip the interview when the user clearly wants a minimal quick capture.
15