Interview Skill
This skill conducts in-depth interviews with users to create detailed specification documents.
Purpose
The interview skill helps users:
- •Clarify requirements: Ask probing questions about technical implementation
- •Explore UI/UX: Gather detailed user experience requirements
- •Identify concerns: Uncover potential issues and tradeoffs
- •Document decisions: Create comprehensive specification files
Workflow
This skill is designed to integrate with a multi-stage development workflow:
- •Interview (this skill) → Create detailed spec through Q&A
- •Plan Mode → Generate implementation plan from spec
- •Implementation → Execute plan with coding agent
Instructions
Phase 1: Receive Instructions
- •Accept user-provided instructions through
$ARGUMENTSparameter - •Parse and understand the scope of the specification needed
- •Identify key areas that require clarification
Phase 2: Conduct In-Depth Interview
Interview Guidelines:
- •
Use AskUserQuestion tool for every clarification needed
- •
Ask non-obvious questions - Don't ask things that are already clear
- •
Cover all critical areas:
- •Technical implementation details
- •Architecture and design patterns
- •UI/UX requirements and user flows
- •Performance and scalability concerns
- •Security considerations
- •Error handling strategies
- •Testing approach
- •Deployment and maintenance
- •Edge cases and tradeoffs
- •
Continue iteratively until all aspects are thoroughly explored
- •
Dig deeper when answers are vague or incomplete
- •
Challenge assumptions to uncover hidden requirements
Question Quality:
- •✅ "사용자가 로그인 실패 3회 후에는 어떻게 처리할까요? 계정 잠금? 대기 시간?"
- •✅ "API 응답 시간 SLA는? 타임아웃 전략은?"
- •❌ "로그인 기능이 필요한가요?" (너무 명확한 질문)
Phase 3: Create Specification Document
Once the interview is complete:
- •
Synthesize all gathered information
- •
Write comprehensive spec file using the Write tool
- •
Structure the document with clear sections:
- •Overview/Purpose
- •Requirements (Functional & Non-functional)
- •Technical Architecture
- •UI/UX Design
- •Data Models
- •API Specifications
- •Error Handling
- •Security Considerations
- •Performance Requirements
- •Testing Strategy
- •Deployment Plan
- •Open Questions/Future Considerations
- •
Include context from interview - Reference user's answers
- •
Highlight tradeoffs and decisions made during discussion
- •
Suggest file name:
spec-{feature-name}-{date}.md
Example Usage
User Request:
인터뷰해줘. 새로운 사용자 인증 시스템을 만들려고 해.
Interview Flow:
- •Ask about authentication method (OAuth, JWT, session-based?)
- •Ask about password requirements and security policy
- •Ask about MFA requirements
- •Ask about session management and timeout strategy
- •Ask about error handling (failed login, expired tokens)
- •Ask about user flows (signup, login, logout, password reset)
- •Ask about integration points (existing systems, APIs)
- •Ask about performance requirements (concurrent users, response time)
- •Ask about monitoring and logging needs
- •... (continue until complete)
Output:
- •Detailed spec file:
spec-user-authentication-2026-02-01.md
Tips for Effective Interviews
For Users
- •Be specific: Provide context and constraints upfront
- •Think ahead: Consider edge cases when answering
- •Ask back: If unsure, ask Claude to explain the question
- •Iterate: Don't expect perfection in first draft
For Claude
- •Be thorough: Don't skip obvious areas just because they seem standard
- •Be persistent: Keep asking until answers are clear
- •Be practical: Focus on actionable requirements
- •Be structured: Group related questions together
- •Confirm understanding: Summarize key points before moving to next area
Language Policy
- •Questions: Use the same language as user's request (Korean ↔ Korean, English ↔ English)
- •Spec document: Default to user's language unless specified otherwise
- •Technical terms: Use industry-standard English terms even in Korean docs
Integration with Other Skills
This skill works best when combined with:
- •Plan Mode: Use generated spec to create detailed implementation plan
- •commit: Commit the spec file with proper message
- •review: Review generated spec for completeness
See Also
- •Planning workflow - How to use specs in development process
- •Documentation standards - Spec writing best practices