PRD: [Feature Name]¶
Overview¶
Status: Draft | In Review | Approved
Author: [Name]
Date: [YYYY-MM-DD]
Version: [1.0]
Tracking: [docs/tracking.md row / issue link or N/A]
PR-FAQ: [Link to approved PR-FAQ - required for new initiatives]
Stakeholders: [List]
Problem Statement¶
[What problem are we solving? Who has this problem? Why does it matter?]
Evidence¶
Great PRDs prove problems exist with evidence. Include both types:
Quantitative Evidence (numbers that demonstrate impact):
- [Financial metric: e.g., "$X lost per month due to..."]
- [Behavioral data: e.g., "Y% of users abandon at step Z"]
- [Volume indicator: e.g., "N support tickets/week about..."]
Qualitative Evidence (insights that explain the human side):
- [User quote: "Direct feedback from user research..."]
- [Support insight: "Common complaint pattern..."]
- [Observation: "During usability testing, we saw..."]
Goals & Success Metrics¶
| Goal | Metric | Target |
|---|---|---|
| [Goal 1] | [Metric] | [Target value] |
| [Goal 2] | [Metric] | [Target value] |
User Stories¶
[Persona 1]¶
- As a [persona], I want [capability] so that [benefit]
- Acceptance: [Testable criteria]
- As a [persona], I want [capability] so that [benefit]
- Acceptance: [Testable criteria]
[Persona 2]¶
- As a [persona], I want [capability] so that [benefit]
- Acceptance: [Testable criteria]
Requirements¶
Functional Requirements¶
| ID | Requirement | Priority | Notes |
|---|---|---|---|
| FR-1 | [Requirement] | Must Have | |
| FR-2 | [Requirement] | Should Have | |
| FR-3 | [Requirement] | Nice to Have |
Non-Functional Requirements¶
| ID | Requirement | Target |
|---|---|---|
| NFR-1 | Performance | [e.g., < 200ms response time] |
| NFR-2 | Availability | [e.g., 99.9% uptime] |
| NFR-3 | Security | [e.g., SOC 2 compliant] |
Scope¶
In Scope¶
- [Feature/capability 1]
- [Feature/capability 2]
Out of Scope¶
- [Explicitly excluded item 1]
- [Explicitly excluded item 2]
Dependencies¶
| Dependency | Owner | Status | Risk |
|---|---|---|---|
| [Dependency 1] | [Team/Person] | [Status] | [Low/Med/High] |
Risks & Mitigations¶
| Risk | Likelihood | Impact | Mitigation |
|---|---|---|---|
| [Risk 1] | [L/M/H] | [L/M/H] | [Strategy] |
Open Questions¶
- [ ] [Question 1]
- [ ] [Question 2]
Appendix¶
Mockups/Wireframes¶
[Link or embed]
Research¶
[Link to user research, competitive analysis, etc.]
Approval¶
| Role | Name | Date | Status |
|---|---|---|---|
| Product | Pending | ||
| Engineering | Pending | ||
| Design | Pending |
Next Steps & Handoffs¶
After PRD approval:
-
[ ] Architect Review: Technical feasibility assessment
- Trigger:
/architect - Output: ADR (
docs/adr/NNNN-<topic>.md)
- Trigger:
-
[ ] UI/UX Designer: Visual design and wireframes
- Trigger:
/ui-ux-designer - Output: Design Spec (
docs/specs/design-spec-<component>.md)
- Trigger:
-
[ ] Engineering Estimate: Effort estimation and decomposition
- Trigger:
/builderor/architect - Output: Implementation Plan (
docs/plans/plan-<feature>.md)
- Trigger:
-
[ ] Track it: add the feature row to
docs/tracking.md- Then decompose:
/swarm-plan <spec or PRD path>
- Then decompose:
Related Artifacts:
- ADR: [Link after architect review]
- Design Spec: [Link after designer review]
- Implementation Plan: [Link after decomposition]
Version History¶
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0 | [Date] | [Name] | Initial draft |