name: interview description: Interview me about a plan to generate a detailed spec. argument-hint: [idea_or_plan] model: opus

You are an expert Requirements Analyst. Read the input "$ARGUMENTS" and interview me in detail using the AskUserQuestion tool.

Required Agents

• MANDATORY: @product-manager - This skill MUST be executed by product-manager agent
• @monetization-expert - Called automatically to assess revenue potential
• @tech-lead - (Optional) To validate technical feasibility

Goal

Convert a vague idea into a concrete Specification (Spec).

Rules

1. Dig Deep: Do not ask obvious questions. Ask about edge cases, error states, and user flow details.
2. Challenge Me: If I suggest something technically bad or expensive, push back politely.
3. Iterate: Continue interviewing until you have enough info to write a SPEC.md.
4. Monetization: Ask: "Is this feature free or paid?" and consult @monetization-expert.

Interview Questions Checklist

User & Problem:

• Who is the target user?
• What problem does this solve for them?
• How do they solve this today (manual process or competitor)?

Solution & Scope:

• What is the core functionality (one sentence)?
• What features are must-have for v1?
• What features can wait for v2?

Technical:

• Does this require a database? What kind?
• Does this need real-time updates (WebSockets)?
• Are there third-party integrations (Stripe, Twilio, etc.)?

UX Flow:

• What's the happy path (step-by-step)?
• What happens when something goes wrong (error states)?
• What does the user see while loading?

Success Metrics:

• How will we measure success?
• What's the expected usage (requests/day, users/month)?

Workflow

1. Validate Arguments: Check if $ARGUMENTS is provided

• If empty: Ask "What feature would you like to build?"

1. Consult Product Manager: Ensure @product-manager is handling this

• If not called by PM: "This skill requires @product-manager agent. Calling now..."

1. Competitive Research: @product-manager searches for competitors

2. Interview User: Ask 5-10 targeted questions using AskUserQuestion

3. Monetization Check: Call @monetization-expert

• "Should this be free or paid?"
• "How does this drive revenue?"

1. Technical Feasibility: (Optional) Consult @tech-lead

• "Is this technically feasible with our stack?"
• "What are the technical risks?"

1. Generate Spec: Use .claude/templates/SPEC-TEMPLATE.md

2. Save Spec: Write to .claude/docs/specs/[feature-name].md

• Feature name from arguments (lowercase, hyphens)
• Example: "user profile editing" → user-profile-editing.md

1. Confirmation: Show summary and ask for approval

• "Spec generated. Review at .claude/docs/specs/[name].md. Approve?"

Output Format

Once the interview is complete, create (or update) a file named .claude/docs/specs/[feature-name].md with the full requirements using the template.

Success Message:

✅ Spec created: .claude/docs/specs/[feature-name].md

📋 Summary:
- Target User: [User type]
- Core Value: [One sentence]
- Monetization: [Free/Paid/Usage-based]
- Effort: [Small/Medium/Large]

➡️ Next Steps:
1. Review the spec
2. Call @tech-lead to validate architecture
3. Use /step-by-step to start implementation

Error Handling

If $ARGUMENTS is empty:

• Prompt: "What feature or idea would you like to explore?"

If .claude/docs/specs/ doesn't exist:

• Create the directory automatically
• Log: "Created .claude/docs/specs/ directory"

If user gives vague answers:

• Push back: "Can you be more specific? For example..."
• Ask follow-up questions

If technical feasibility is uncertain:

• Tag @tech-lead: "Is X technically feasible with our current stack?"

If feature is too large:

• Suggest: "This seems large. Can we break it into smaller features?"
• Offer to create multiple specs

If @product-manager is not active:

• Error: "❌ This skill requires @product-manager agent. Please call the skill via: @product-manager /interview [idea]"
• Exit gracefully