Loading...
Loading...
Interactive interview to create comprehensive Product Requirements Documents with User Stories and Use Cases, starting with the problem, not the solution
npx skill4agent add johanspannare/awesome-claude-extensions prd-interviewRead PRD.mdAs a [role]
I want [feature/capability]
So that [benefit/value]As a customer
I want to filter products by price range
So that I can find items within my budgetGiven I'm on the product listing page
When I set price range to $50-$100
Then I see only products in that range
And the count updates to show X products foundUse Case: Purchase Product
Actor: Customer
Preconditions: Customer is logged in, has items in cart
Main Flow:
1. Customer clicks "Checkout"
2. System displays order summary
3. Customer selects payment method
4. Customer confirms purchase
5. System processes payment
6. System shows confirmation page
7. System sends email receipt
Alternative Flows:
4a. Payment fails → Show error, allow retry
5a. Item out of stock → Notify user, update cart
Postconditions:
- Order created
- Payment processed
- Inventory decremented
- Email sentpragmatic-tddpragmatic-tddQ: What problem are you trying to solve?
A: Team wastes 2h/day manually syncing data between 5 systems
Q: Who has this problem?
A: Operations team (12 people)
Q: How solving today?
A: Copy-paste between Excel, Salesforce, custom DB
Q: Why important now?
A: Hiring 10 more people next month, won't scale
Q: Success looks like?
A: Automatic sync, no manual work, always consistentQ: What type of solution?
A: Backend API (NOW we have context why!)
Q: Alternatives considered?
A: Zapier too expensive at our scale
Q: Constraints?
A: Must integrate Salesforce, must be secure (customer data)Q: Tech stack?
A: Must use Python (org requirement)
Q: Database?
A: Postgres + Redis
Q: Performance?
A: 1000 req/sec# [Project Name]
## Problem Statement
[What problem, who has it, why now]
## Current Situation
[How people solve it today, why that's inadequate]
## Proposed Solution
[High-level approach, why this solution]
## Goals & Success Criteria
[MVP vs complete, how to measure success]
## User Stories
### Story 1: [Story Name]
**As a** [role]
**I want** [feature/capability]
**So that** [benefit/value]
**Acceptance Criteria:**
- Given [context]
- When [action]
- Then [expected result]
**Priority:** Must Have | Should Have | Could Have
### Story 2: [Story Name]
[Repeat format]
## Use Cases
### Use Case 1: [Use Case Name]
**Primary Actor:** [Who initiates this]
**Preconditions:**
- [Condition 1]
- [Condition 2]
**Main Success Scenario:**
1. Actor does X
2. System responds with Y
3. Actor confirms Z
4. System completes action
**Alternative Flows:**
- 2a. If validation fails → Show error, return to step 1
- 3a. If user cancels → Discard changes, exit flow
**Postconditions:**
- [Result 1]
- [Result 2]
### Use Case 2: [Use Case Name]
[Repeat format]
## Technical Requirements
### Stack
[Technologies and WHY each was chosen]
### Architecture
[System design, scalability approach]
### Performance
[Specific requirements with numbers]
### Security
[Auth, data sensitivity, compliance]
## User Experience
[UI type, key flows, design requirements]
## Testing Strategy
### Approach
[TDD vs tests-after, test types, coverage goals]
### TDD Philosophy (if applicable)
[If using TDD: Test via primary ports, mock only adapters, verify business flows]
[Reference: Use `pragmatic-tdd` skill for TDD guidance]
### Quality Gates
[Tests must pass, code review, benchmarks, etc.]
### CI/CD
[Automation plan]
## Risks & Mitigation
| Risk | Impact | Probability | Mitigation |
|------|--------|-------------|------------|
## Trade-offs
[Decisions made and why]
## Out of Scope
[What's NOT included]
## Documentation
[What docs needed, for whom]
## Success Metrics
[How we'll know this worked]
## Next Steps
1. [Immediate action]
2. [Followup action]