Prd Writing

Step 2: Ask Clarifying Questions

Ask 3-5 targeted questions to fill knowledge gaps. Use lettered options (A/B/C) when there are clear choices, and open-ended questions when you need free-text answers. Focus on:

1. Problem — What problem are we solving? Why now?
2. Users — Who are the target users?
3. Scope — What should it NOT do?
4. Success — How do we know it's done?
5. Constraints — Timeline, budget, team size?

Mark unknowns as TBD, not assumptions. See disc-clarifying-questions.

Step 3: Draft the PRD

Use the template from struct-prd-template and fill in all 12 sections:

1. Executive Summary — 1 paragraph: problem, solution, impact
2. Problem Statement — what, who, evidence, why now
3. Goals & Success Metrics — 3-5 measurable KPIs
4. User Personas — primary and secondary with roles/goals/pain points
5. User Stories & Acceptance Criteria — "As a / I want / So that" with checkboxes
6. Functional Requirements — numbered FR-1, FR-2, etc.
7. Non-Functional Requirements — performance, security, accessibility with specific numbers
8. Technical Specifications — data model, auth, routes, integrations
9. Out of Scope — what we're NOT building and why
10. Non-Goals — what we're NOT optimizing for
11. Dependencies & Risks — blockers with owners and mitigations
12. Open Questions — unresolved items with owners and due dates

Key rules to follow while drafting:

• Start with the problem, not the solution (disc-problem-first)
• Replace vague language with numbers (metric-no-vague-language)
• Every requirement must be testable (quality-acceptance-criteria)
• Use Given/When/Then for complex acceptance criteria

Step 4: Present for Review

Show the draft to the user. Ask specifically:

• Does the problem statement match your understanding?
• Are user stories missing any workflows?
• Are the scope boundaries correct?
• Any open questions I should resolve?

Step 5: Revise Based on Feedback

Incorporate feedback, resolve open questions, and update the PRD. Add a review history entry if the PRD will be shared with a team.

Step 6: Save the PRD

Save to docs/prd/{feature-name}.md using kebab-case naming. Include frontmatter:

---