design-protocol 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +225 -0
  3. package/agents/dp-researcher.md +239 -0
  4. package/agents/dp-verifier.md +207 -0
  5. package/bin/install.js +464 -0
  6. package/commands/dp-back.md +221 -0
  7. package/commands/dp-discuss.md +257 -0
  8. package/commands/dp-execute.md +513 -0
  9. package/commands/dp-journey.md +85 -0
  10. package/commands/dp-progress.md +178 -0
  11. package/commands/dp-roadmap.md +83 -0
  12. package/commands/dp-skip.md +186 -0
  13. package/commands/dp-start.md +510 -0
  14. package/commands/dp-storytell.md +94 -0
  15. package/commands/dp-verify.md +207 -0
  16. package/package.json +59 -0
  17. package/skills/dp-color/SKILL.md +214 -0
  18. package/skills/dp-color/export_tokens.py +297 -0
  19. package/skills/dp-color/references/apca-contrast.md +87 -0
  20. package/skills/dp-color/references/hue-emotions.md +109 -0
  21. package/skills/dp-color/references/oklch-gamut.md +79 -0
  22. package/skills/dp-color/references/pitfalls.md +171 -0
  23. package/skills/dp-color/references/scale-patterns.md +206 -0
  24. package/skills/dp-color/references/tool-workflows.md +200 -0
  25. package/skills/dp-discovery/SKILL.md +480 -0
  26. package/skills/dp-eng_review/SKILL.md +471 -0
  27. package/skills/dp-eng_review/references/code-review-checklist.md +385 -0
  28. package/skills/dp-eng_review/references/react-patterns.md +512 -0
  29. package/skills/dp-eng_review/references/shadcn-patterns.md +510 -0
  30. package/skills/dp-eng_review/references/tailwind-conventions.md +351 -0
  31. package/skills/dp-journey/SKILL.md +682 -0
  32. package/skills/dp-journey/references/journey-types.md +97 -0
  33. package/skills/dp-journey/references/map-structures.md +177 -0
  34. package/skills/dp-journey/references/omnichannel-patterns.md +208 -0
  35. package/skills/dp-journey/references/research-methods.md +125 -0
  36. package/skills/dp-prd/SKILL.md +201 -0
  37. package/skills/dp-prd/references/claude-code-spec.md +107 -0
  38. package/skills/dp-prd/references/interview-questions.md +158 -0
  39. package/skills/dp-prd/references/section-templates.md +231 -0
  40. package/skills/dp-research/SKILL.md +540 -0
  41. package/skills/dp-research/references/facilitation-guide.md +291 -0
  42. package/skills/dp-research/references/interview-guide-template.md +190 -0
  43. package/skills/dp-research/references/method-selection.md +195 -0
  44. package/skills/dp-research/references/question-writing.md +244 -0
  45. package/skills/dp-research/references/research-report-template.md +363 -0
  46. package/skills/dp-research/references/synthesis-methods.md +289 -0
  47. package/skills/dp-research/references/usability-test-template.md +260 -0
  48. package/skills/dp-roadmap/SKILL.md +648 -0
  49. package/skills/dp-roadmap/references/prioritization-frameworks.md +312 -0
  50. package/skills/dp-roadmap/references/roadmap-structures.md +179 -0
  51. package/skills/dp-roadmap/references/roadmap-workshops.md +264 -0
  52. package/skills/dp-roadmap/references/theme-development.md +168 -0
  53. package/skills/dp-storytell/SKILL.md +645 -0
  54. package/skills/dp-storytell/references/audience-playbooks.md +260 -0
  55. package/skills/dp-storytell/references/content-type-templates.md +310 -0
  56. package/skills/dp-storytell/references/delivery-tactics.md +228 -0
  57. package/skills/dp-storytell/references/narrative-frameworks.md +259 -0
  58. package/skills/dp-ui/SKILL.md +503 -0
  59. package/skills/dp-ui/references/b2b-enterprise-patterns.md +319 -0
  60. package/skills/dp-ui/references/data-visualization.md +304 -0
  61. package/skills/dp-ui/references/visual-design-principles.md +237 -0
  62. package/skills/dp-ux/SKILL.md +414 -0
  63. package/skills/dp-ux/references/accessibility-checklist.md +128 -0
  64. package/skills/dp-ux/references/product-excellence.md +149 -0
  65. package/skills/dp-ux/references/usability-principles.md +140 -0
  66. package/skills/dp-ux/references/ux-patterns.md +221 -0
  67. package/templates/config.json +55 -0
  68. package/templates/context.md +96 -0
  69. package/templates/project.md +83 -0
  70. package/templates/requirements.md +137 -0
  71. package/templates/roadmap.md +168 -0
  72. package/templates/state.md +107 -0
@@ -0,0 +1,201 @@
1
+ ---
2
+ name: dp-prd
3
+ description: >
4
+ Generate industry-standard PRDs for product managers and designers. Trigger when someone mentions
5
+ writing, creating, updating, or improving a PRD, product spec, requirements, or feature brief.
6
+ Also trigger for PM phrases: "document this feature", "write up a product spec", "create requirements
7
+ for X", "spec out a new feature". Also trigger for designer phrases: "document this component/screen/
8
+ flow/pattern", "spec out this interaction", "formalise this design", "write up requirements for this
9
+ design". Also trigger immediately when the user types /prd or /dp:prd — jump straight to
10
+ Phase 1 initiation. Supports new PRDs, updates to existing ones, stakeholder-ready output and
11
+ Claude Code-ready specs. Always use this skill — don't generate a PRD without it.
12
+ ---
13
+
14
+ # PRD Generator Skill
15
+
16
+ A guided, interview-driven skill for creating complete, industry-standard Product Requirements Documents.
17
+ Supports new creation, updates to existing PRDs, multiple output formats, optional competitive research,
18
+ and dual-audience output (stakeholder-ready or Claude Code-ready).
19
+
20
+ ---
21
+
22
+ ## Phase 1 — Initiation
23
+
24
+ When the skill is triggered, run through the initiation checklist in a **single, conversational message**.
25
+ Do NOT ask these one by one in separate turns. Group them naturally.
26
+
27
+ ### 1.1 Detect mode
28
+
29
+ First, check whether the user is:
30
+ - **Creating a new PRD** from scratch
31
+ - **Updating an existing PRD** (they paste or upload an existing doc)
32
+
33
+ If updating, ask them to share the existing PRD content before proceeding.
34
+ Then identify which sections need adding, revising, or expanding, and only interview for those gaps.
35
+
36
+ ### 1.2 Initiation questions (ask all at once)
37
+
38
+ Ask the following in one friendly, well-structured message:
39
+
40
+ **A. User persona**
41
+ Who are you?
42
+ - Product Manager
43
+ - Designer / UX Lead
44
+ - Both / cross-functional team
45
+ - Other (ask them to describe)
46
+
47
+ This determines which interview questions are asked and how deep design considerations go.
48
+
49
+ **B. Output format**
50
+ What format do you need?
51
+ - Word document (.docx) — for sharing with stakeholders
52
+ - HTML artifact — rendered beautifully in Claude, shareable as link
53
+ - Markdown — for Notion, Confluence, GitHub, or copy-paste
54
+ - Claude Code–ready spec — structured for direct use as a Claude Code prompt/spec file
55
+
56
+ Note: the user can request multiple formats. Generate all requested.
57
+
58
+ **C. Primary audience**
59
+ Who is this PRD primarily written for?
60
+ - Executive / leadership stakeholders
61
+ - Engineering team
62
+ - Design team
63
+ - Claude Code (AI-assisted implementation)
64
+ - Mixed audience (ask them to specify)
65
+
66
+ If **Claude Code** is selected (or is one of the audiences), enable the technical spec layer —
67
+ see `references/claude-code-spec.md` for requirements.
68
+
69
+ **D. Tone & voice**
70
+ What tone should the document use?
71
+ - Formal / enterprise
72
+ - Startup / direct
73
+ - Ask Claude to match the company's existing documentation style (they can paste an example)
74
+
75
+ **E. Competitive research**
76
+ Do you want competitive/market research included?
77
+ - No research needed
78
+ - Light scan (3–5 competitors, quick feature comparison)
79
+ - Deep dive (positioning, pricing, differentiators, SWOT, market signals)
80
+
81
+ If yes to either research option, Claude will run web searches before generating the PRD.
82
+
83
+ **F. PRD type**
84
+ What kind of PRD is this?
85
+ - New product / v1
86
+ - New feature on existing product
87
+ - Improvement / iteration on existing feature
88
+ - Discovery / exploratory (hypothesis-driven, less defined)
89
+
90
+ ---
91
+
92
+ ## Phase 2 — Interview
93
+
94
+ Once initiation is complete, conduct a structured interview to gather content for each PRD section.
95
+ Read `references/interview-questions.md` to get the full question bank.
96
+
97
+ ### Pre-generation mandatory checks
98
+
99
+ Before proceeding to Phase 4 (draft generation), verify:
100
+
101
+ **Check A — Component inventory (if Designer persona + Claude Code audience):**
102
+ Has the user provided a component list with Figma names mapped to CSS token names?
103
+ If not: pause and ask before generating. The spec will be unusable without it.
104
+
105
+ **Check B — Sharing strategy (if any requirement involves sharing/exporting):**
106
+ Has the user confirmed how sharing should work (public link / password / expiring / internal / none)?
107
+ If not: ask before generating. Never assume a sharing approach.
108
+
109
+ Both checks can be done in a single follow-up message if needed — don't make it feel like a blocker, just frame it as "two quick things before I generate."
110
+
111
+ ### Interview rules
112
+
113
+ - Group questions by section cluster — don't ask section by section rigidly
114
+ - Keep the tone conversational, not form-like
115
+ - If user persona is **Designer**, go deeper on design considerations, component references, and accessibility
116
+ - If user persona is **PM**, go deeper on goals, metrics, constraints, and stakeholder alignment
117
+ - If audience is **Claude Code**, go deeper on acceptance criteria, technical constraints, API/component contracts
118
+ - Always allow the user to say "skip this section" or "I don't know yet" — mark skipped sections as `[TBD — to be completed]`
119
+ - After the interview, summarise what you've captured and ask for confirmation before generating
120
+
121
+ ### Interview clusters
122
+
123
+ Run these clusters in order, but merge naturally if answers overlap:
124
+
125
+ 1. **Context cluster** — product name, owner, team, stakeholders, target date, PRD type
126
+ 2. **Problem cluster** — problem statement, why now, who's affected, evidence/data
127
+ 3. **User cluster** — target users, personas, JTBD, pain points, user research available
128
+ 4. **Goals cluster** — objectives, success metrics, KPIs/OKRs, SMART goals
129
+ 5. **Requirements cluster** — functional requirements, user stories, non-functional requirements
130
+ 6. **Design cluster** — UX considerations, Figma links, accessibility requirements, design principles, component references
131
+ 7. **Scope cluster** — what's in scope, what's explicitly out of scope, MoSCoW prioritisation if needed
132
+ 8. **Risk cluster** — assumptions, constraints, dependencies, known risks, open questions
133
+ 9. **Release cluster** — release criteria, rollout plan, phasing, comms plan
134
+
135
+ ---
136
+
137
+ ## Phase 3 — Research (if opted in)
138
+
139
+ If the user requested competitive or market research in initiation:
140
+
141
+ 1. Use `web_search` to find competitors, similar products, and market signals
142
+ 2. Search for: `[product category] competitors 2025`, `[feature name] industry benchmark`, `[product name] vs [competitor]`
143
+ 3. Compile findings into a **Competitive Landscape** section with:
144
+ - Competitor table (name, key features, positioning, pricing if available)
145
+ - Feature gap analysis (what competitors do that this PRD does or doesn't address)
146
+ - Market signals (trends, customer expectations, industry direction)
147
+ - SWOT summary (if deep dive was selected)
148
+ 4. Insert this section after the Problem Statement in the final PRD
149
+
150
+ ---
151
+
152
+ ## Phase 4 — Draft Generation
153
+
154
+ Generate the full PRD based on interview answers and research.
155
+ Read `references/section-templates.md` for the exact structure and formatting of each section.
156
+
157
+ ### Format rules
158
+
159
+ **For .docx output:** Read `/mnt/skills/public/docx/SKILL.md` before generating.
160
+ **For HTML artifact:** Produce a beautifully formatted, self-contained HTML page with a sidebar TOC, clean typography, and section anchors.
161
+ **For Markdown:** Use clean heading hierarchy (H1 title, H2 sections, H3 subsections). Compatible with Notion, Confluence, and GitHub.
162
+ **For Claude Code spec:** Read `references/claude-code-spec.md` and produce the structured spec variant. This is a separate file/section, not a replacement for the full PRD.
163
+
164
+ ### Quality checklist before outputting
165
+
166
+ Before finalising the draft, verify:
167
+ - [ ] Every section has content or is explicitly marked `[TBD]`
168
+ - [ ] Success metrics are measurable (not vague like "improve user experience")
169
+ - [ ] Functional requirements are written as user-facing outcomes, not implementation details
170
+ - [ ] If Claude Code audience: acceptance criteria are present and testable
171
+ - [ ] Scope section explicitly lists at least 2–3 out-of-scope items
172
+ - [ ] At least one open question is captured
173
+ - [ ] Tone matches the user's choice from initiation
174
+
175
+ ---
176
+
177
+ ## Phase 5 — Refinement Loop
178
+
179
+ After generating the draft, explicitly invite the user to refine it.
180
+
181
+ Say something like:
182
+ > "Here's your PRD draft. You can ask me to:
183
+ > - **Expand** any section with more detail
184
+ > - **Rewrite** a section in a different tone or structure
185
+ > - **Add** a section that's missing
186
+ > - **Convert** to a different format (e.g. 'give me the Claude Code spec version')
187
+ > - **Update** with new information you have
188
+ > - **Run research** on a specific competitor or feature area
189
+ > - **Score** requirements using RICE or MoSCoW prioritisation"
190
+
191
+ Support all of these refinement actions without restarting the full interview.
192
+
193
+ ---
194
+
195
+ ## Reference files
196
+
197
+ Read these when needed — do not load all at once:
198
+
199
+ - `references/interview-questions.md` — Full question bank per section, per persona
200
+ - `references/section-templates.md` — Exact structure and formatting for each PRD section
201
+ - `references/claude-code-spec.md` — Instructions for generating the Claude Code–ready spec variant
@@ -0,0 +1,107 @@
1
+ # Claude Code–Ready Spec Format
2
+
3
+ When the user selects "Claude Code" as a primary audience, generate a **separate structured spec file**
4
+ alongside (or instead of) the full stakeholder PRD. This spec is designed to be used as a prompt
5
+ or context file fed directly into Claude Code.
6
+
7
+ ---
8
+
9
+ ## What makes a spec Claude Code–ready
10
+
11
+ Claude Code works best when given:
12
+ 1. **Precise functional scope** — what to build, not how to build it
13
+ 2. **Acceptance criteria** — testable conditions in Given/When/Then format
14
+ 3. **Component/API contracts** — what exists, what needs to be created
15
+ 4. **Design system references** — exact token names, component names, Figma links
16
+ 5. **Technical constraints** — stack, libraries, patterns to follow
17
+ 6. **File/folder structure hints** — where new code should live
18
+ 7. **Example inputs/outputs** — concrete examples reduce ambiguity
19
+
20
+ ---
21
+
22
+ ## Claude Code Spec Template
23
+
24
+ ```markdown
25
+ # [Feature Name] — Implementation Spec
26
+ Generated from PRD v[X.X] | [Date]
27
+
28
+ ## Overview
29
+ [2–3 sentences: what to build and why. Keep it tight.]
30
+
31
+ ## Stack & Constraints
32
+ - Framework: Next.js (latest stable)
33
+ - Styling: Tailwind CSS + CSS custom properties (design tokens)
34
+ - Design system: Custom designOS — tokens follow `--[component]-[variant]-[modifier]` convention (e.g. `--button-primary`, `--color-brand-500`)
35
+ - State management: [confirm per feature — React Context / Zustand]
36
+ - Key libraries already in use: [list any additional]
37
+ - DO NOT use: inline styles, hardcoded colour values, non-token references
38
+
39
+ ## Design References
40
+ - Figma file: [URL — paste from Figma]
41
+ - Component names to use: [exact Figma component names — ask designer to list]
42
+ - Token references: CSS custom properties e.g. `--button-primary`, `--color-surface`, `--spacing-md`
43
+ - Responsive breakpoints: Tailwind defaults unless overridden in config
44
+
45
+ ## Features to Implement
46
+
47
+ ### Feature 1: [Name]
48
+ **Description:** [What this feature does]
49
+ **Location:** [File path or component to create/modify]
50
+
51
+ **Acceptance Criteria:**
52
+ - Given [user is on X screen], when [they do Y], then [Z happens]
53
+ - Given [edge case], when [action], then [expected behaviour]
54
+ - Given [error state], when [it occurs], then [error is handled by...]
55
+
56
+ **Inputs:** [Props, API params, user inputs]
57
+ **Outputs:** [Return values, UI changes, side effects]
58
+ **API / Data:** [Endpoint, payload shape, response shape]
59
+
60
+ ### Feature 2: [Name]
61
+ [Same structure]
62
+
63
+ ## Components to Create
64
+
65
+ | Component Name | File Path | Props | Notes |
66
+ |----------------|-----------|-------|-------|
67
+ | [Name] | [path] | [prop: type] | |
68
+
69
+ ## API Contracts
70
+
71
+ ### [Endpoint name]
72
+ - Method: [GET / POST / PUT / DELETE]
73
+ - Path: [/api/...]
74
+ - Request body: [shape]
75
+ - Response: [shape]
76
+ - Error states: [400, 401, 404, 500 — expected handling]
77
+
78
+ ## State Shape (if applicable)
79
+ ```typescript
80
+ interface [FeatureName]State {
81
+ [field]: [type];
82
+ }
83
+ ```
84
+
85
+ ## Test Cases to Write
86
+ - Unit: [what to unit test]
87
+ - Integration: [what integration scenarios to cover]
88
+ - E2E: [what user flows to test end-to-end]
89
+
90
+ ## Out of Scope for This Implementation
91
+ [Explicit list — prevents Claude Code from over-building]
92
+
93
+ ## Open Technical Questions
94
+ [Anything unresolved that the developer or Claude Code should flag before proceeding]
95
+ ```
96
+
97
+ ---
98
+
99
+ ## Instructions for Claude when generating this spec
100
+
101
+ 1. **Be explicit about file paths** — Claude Code works better with concrete locations
102
+ 2. **Use TypeScript types** if the codebase uses TypeScript
103
+ 3. **Reference exact component/token names** from the design system — don't describe visually
104
+ 4. **Write acceptance criteria in Given/When/Then** — this maps to test generation
105
+ 5. **Include error states and edge cases** explicitly — they're often missed in PRDs
106
+ 6. **Mark genuinely unknown things as `[TBD — ask before implementing]`** rather than guessing
107
+ 7. **Keep the spec focused** — include only what Claude Code needs, not stakeholder context
@@ -0,0 +1,158 @@
1
+ # PRD Interview Question Bank
2
+
3
+ This file contains the full question bank, organised by section cluster and user persona.
4
+ Claude should select questions contextually — not ask every question — and adapt based on answers given.
5
+
6
+ ---
7
+
8
+ ## Cluster 1 — Context
9
+
10
+ Ask everyone:
11
+ - What is the name of the product or feature you're building?
12
+ - Who is the PM / owner of this PRD?
13
+ - Who are the key stakeholders who need to sign off?
14
+ - What is the target release date or timeline?
15
+ - Is this a new product, new feature, improvement, or discovery?
16
+ - Are there any related PRDs, specs, or documents I should be aware of?
17
+
18
+ ---
19
+
20
+ ## Cluster 2 — Problem Statement
21
+
22
+ Core questions (everyone):
23
+ - What problem are you solving? Describe it in 2–3 sentences.
24
+ - Who is experiencing this problem?
25
+ - What evidence do you have that this is a real problem? (data, research, complaints, metrics)
26
+ - Why is this problem worth solving now?
27
+ - What happens if you don't solve it?
28
+
29
+ Deeper for PM persona:
30
+ - What is the business cost of this problem today?
31
+ - Is this problem growing, stable, or declining in frequency?
32
+ - Have you tried to solve this before? What happened?
33
+
34
+ ---
35
+
36
+ ## Cluster 3 — Target Users & Personas
37
+
38
+ Core questions (everyone):
39
+ - Who are the primary users of this product/feature?
40
+ - Can you describe 1–2 key personas? (role, goal, pain point)
41
+ - What is the user trying to accomplish? (job-to-be-done)
42
+ - What does success look like from the user's perspective?
43
+ - Do you have any existing user research, interviews, or data to reference?
44
+
45
+ Deeper for Designer persona:
46
+ - Are there different user skill levels to account for? (novice vs power user)
47
+ - Are there accessibility requirements for specific user groups?
48
+ - What devices or contexts will users be in when using this?
49
+ - Are there any emotional states or stress scenarios to design for?
50
+
51
+ ---
52
+
53
+ ## Cluster 4 — Goals & Success Metrics
54
+
55
+ Core questions (everyone):
56
+ - What are the top 2–3 goals for this initiative?
57
+ - How will you know if this is successful? What does "done well" look like?
58
+ - What metrics will you track? (e.g. conversion rate, task completion time, NPS, retention)
59
+ - Do you have OKRs or KPIs this initiative is tied to?
60
+ - What does failure look like, and what's the threshold that would cause you to pivot?
61
+
62
+ For PM persona:
63
+ - Are there business metrics (revenue, cost, efficiency) this needs to move?
64
+ - What is the target improvement you're aiming for, and over what timeframe?
65
+ - How will you measure the metric before and after? Do you have a baseline?
66
+
67
+ ---
68
+
69
+ ## Cluster 5 — Functional Requirements
70
+
71
+ Core questions (everyone):
72
+ - What are the core features or capabilities this product/feature must have?
73
+ - Walk me through how a user would interact with this feature from start to finish.
74
+ - What are the must-have requirements vs. nice-to-haves?
75
+ - Are there any specific user actions, workflows, or states the feature needs to support?
76
+ - Are there edge cases or error states you need to handle?
77
+
78
+ For Claude Code audience (technical spec layer):
79
+ - What are the acceptance criteria for each requirement? (Given/When/Then format preferred)
80
+ - What APIs, services, or data sources does this need to integrate with?
81
+ - Are there specific components, libraries, or design system elements to use?
82
+ - What are the input/output contracts for key interactions?
83
+ - Are there state management or data persistence requirements?
84
+ - What error handling behaviour is expected?
85
+ - **Sharing & collaboration:** If this feature involves sharing content or outputs with other users, how should sharing work? Choose one:
86
+ - Public link (anyone with the link can view — no auth required)
87
+ - Password-protected link
88
+ - Expiring link (define TTL: 24h / 7 days / 30 days)
89
+ - Internal only (requires login to the same account/org)
90
+ - No sharing needed
91
+
92
+ Note for Claude: Never default silently to a sharing approach. If sharing is part of any requirement, this question is mandatory before spec generation.
93
+
94
+ ---
95
+
96
+ ## Cluster 6 — Non-Functional Requirements
97
+
98
+ Core questions (everyone):
99
+ - Are there performance requirements? (load time, response time, throughput)
100
+ - Are there accessibility standards to meet? (WCAG 2.1 AA, APCA, etc.)
101
+ - Are there security or privacy requirements? (auth, data handling, compliance)
102
+ - Are there scalability requirements? (user volume, data volume)
103
+ - Are there browser/device/OS compatibility requirements?
104
+ - Are there internationalisation or localisation requirements?
105
+
106
+ ---
107
+
108
+ ## Cluster 7 — Design Considerations
109
+
110
+ Ask if user persona is Designer or Mixed:
111
+ - Do you have Figma files, prototypes, or mockups to reference? (paste links)
112
+ - What design system or component library should be used?
113
+ - Are there specific design principles or brand guidelines to follow?
114
+ - Are there interaction patterns or animations to consider?
115
+ - What are the key screens or flows that need to be designed?
116
+ - Are there existing patterns in the product this should align with or intentionally diverge from?
117
+ - Are there responsive/adaptive design requirements?
118
+
119
+ Ask if audience includes Claude Code:
120
+ - **Component inventory (required):** Please list every component from your design system that this feature will use. For each, provide the exact Figma component name and its CSS custom property token (e.g. `Button/Primary` → `--button-primary`, `Card/Surface` → `--color-surface`). Claude will use these exact names in the spec — no placeholders.
121
+ - Are there any net-new components that don't exist in the design system yet and need to be created for this feature?
122
+ - Are there specific Tailwind utility classes that pair with these components?
123
+ - Is there a design handoff format preference? (e.g. annotated Figma, Storybook, component spec)
124
+
125
+ Note for Claude: If the user is a Designer persona and the audience includes Claude Code, this component inventory question is MANDATORY — do not proceed to draft generation without it. If the user skips it, remind them that without exact component names the spec will contain placeholders that Claude Code cannot act on.
126
+
127
+ ---
128
+
129
+ ## Cluster 8 — Scope
130
+
131
+ Core questions (everyone):
132
+ - What is explicitly in scope for this release?
133
+ - What is explicitly out of scope? (be specific — this prevents scope creep)
134
+ - Are there related features or improvements you're intentionally deferring?
135
+ - Is there a phased delivery plan? What goes in v1 vs. later?
136
+ - Do you want to apply MoSCoW prioritisation? (Must have / Should have / Could have / Won't have)
137
+
138
+ ---
139
+
140
+ ## Cluster 9 — Risks, Assumptions & Dependencies
141
+
142
+ Core questions (everyone):
143
+ - What assumptions are you making that could turn out to be wrong?
144
+ - What are the biggest risks to delivering this successfully?
145
+ - What are the dependencies? (other teams, APIs, infrastructure, legal, third-party services)
146
+ - What are the known constraints? (budget, timeline, technical debt, compliance)
147
+ - What open questions still need to be answered before or during development?
148
+
149
+ ---
150
+
151
+ ## Cluster 10 — Release & Rollout
152
+
153
+ Core questions (everyone):
154
+ - What are the release criteria? (what must be true before you ship?)
155
+ - Do you plan a phased rollout? (beta, limited release, full launch)
156
+ - Who needs to be notified or involved at launch? (comms, sales, support, legal)
157
+ - Is there a rollback plan if something goes wrong?
158
+ - Are there launch dependencies? (marketing, legal approval, partner readiness)
@@ -0,0 +1,231 @@
1
+ # PRD Section Templates
2
+
3
+ This file defines the structure and formatting for each section of the generated PRD.
4
+ Use these as the canonical output format across all delivery formats (docx, HTML, markdown).
5
+
6
+ ---
7
+
8
+ ## Document Header
9
+
10
+ ```
11
+ [Product/Feature Name] — Product Requirements Document
12
+ Version: [1.0 / 2.0 / etc.]
13
+ Status: [Draft / In Review / Approved]
14
+ Owner: [Name, Role]
15
+ Last Updated: [Date]
16
+ Stakeholders: [Names and roles]
17
+ ```
18
+
19
+ ---
20
+
21
+ ## Section 1 — Overview
22
+
23
+ Short executive summary (3–5 sentences max). Answer:
24
+ - What is this?
25
+ - Why are we building it?
26
+ - Who is it for?
27
+ - When is it expected to ship?
28
+
29
+ ---
30
+
31
+ ## Section 2 — Problem Statement
32
+
33
+ **The Problem**
34
+ [2–4 sentences describing the problem clearly]
35
+
36
+ **Why Now**
37
+ [Why is this the right time to solve it? Market signal, business pressure, user demand?]
38
+
39
+ **Evidence**
40
+ [Data, research, quotes, or signals that validate the problem exists]
41
+
42
+ **Impact of Not Solving**
43
+ [What happens if we don't address this?]
44
+
45
+ ---
46
+
47
+ ## Section 3 — Target Users & Personas
48
+
49
+ For each persona, use this structure:
50
+
51
+ **Persona Name** *(e.g. "The Enterprise Account Manager")*
52
+ - Role: [job title / description]
53
+ - Goal: [what they're trying to accomplish]
54
+ - Pain Point: [what frustrates them today]
55
+ - Job-to-be-done: [When I ______, I want to ______, so I can ______]
56
+
57
+ ---
58
+
59
+ ## Section 4 — Goals & Success Metrics
60
+
61
+ **Objectives**
62
+ [List 2–4 clear objectives this initiative must achieve]
63
+
64
+ **Success Metrics**
65
+
66
+ | Metric | Baseline | Target | Timeframe |
67
+ |--------|----------|--------|-----------|
68
+ | [metric name] | [current value] | [goal] | [when] |
69
+
70
+ **Connected OKRs / KPIs**
71
+ [Link to parent OKR or business KPI if applicable]
72
+
73
+ **Definition of Failure**
74
+ [What threshold would trigger a pivot or stop?]
75
+
76
+ ---
77
+
78
+ ## Section 5 — Functional Requirements
79
+
80
+ For each requirement:
81
+
82
+ **REQ-[N]: [Short Title]**
83
+ - Description: [What the feature does, written from the user's perspective]
84
+ - Priority: [Must Have / Should Have / Could Have / Won't Have]
85
+ - User Story: As a [persona], I want to [action], so that [outcome]
86
+ - Acceptance Criteria:
87
+ - Given [context], when [action], then [result]
88
+ - Given [context], when [action], then [result]
89
+ - Notes: [edge cases, dependencies, open questions]
90
+
91
+ ---
92
+
93
+ ## Section 6 — Non-Functional Requirements
94
+
95
+ **Performance**
96
+ [Load time, response time, throughput targets]
97
+
98
+ **Accessibility**
99
+ [WCAG level, APCA targets, specific requirements]
100
+
101
+ **Security & Privacy**
102
+ [Auth requirements, data handling, compliance (GDPR, CCPA, etc.)]
103
+
104
+ **Scalability**
105
+ [User volume, data volume, concurrency]
106
+
107
+ **Compatibility**
108
+ [Browsers, devices, OS, screen sizes]
109
+
110
+ **Localisation**
111
+ [Languages, date/currency formats, RTL support if needed]
112
+
113
+ ---
114
+
115
+ ## Section 7 — Design Considerations
116
+
117
+ **Design System / Component Library**
118
+ [Name of design system, version, link to Figma]
119
+
120
+ **Key Screens / Flows**
121
+ [List of screens or flows that need design work, with Figma links where available]
122
+
123
+ **Design Principles to Apply**
124
+ [List 2–4 principles relevant to this feature]
125
+
126
+ **Accessibility Requirements**
127
+ [Specific design-level accessibility requirements: colour contrast ratios, focus states, touch targets, etc.]
128
+
129
+ **Responsive Behaviour**
130
+ [How the feature adapts across breakpoints]
131
+
132
+ **Open Design Questions**
133
+ [Unresolved design decisions that need exploration]
134
+
135
+ ---
136
+
137
+ ## Section 8 — Scope
138
+
139
+ **In Scope**
140
+ - [Item 1]
141
+ - [Item 2]
142
+ - [Item 3]
143
+
144
+ **Out of Scope**
145
+ - [Item 1 — and why if useful]
146
+ - [Item 2]
147
+
148
+ **Deferred to Later**
149
+ - [Item 1 — target milestone/version]
150
+
151
+ **MoSCoW Summary** *(if applicable)*
152
+
153
+ | Must Have | Should Have | Could Have | Won't Have (this release) |
154
+ |-----------|-------------|------------|--------------------------|
155
+ | [req] | [req] | [req] | [req] |
156
+
157
+ ---
158
+
159
+ ## Section 9 — Competitive Landscape *(if research was requested)*
160
+
161
+ **Overview**
162
+ [2–3 sentence market context]
163
+
164
+ **Competitor Comparison**
165
+
166
+ | Competitor | Key Features | Positioning | Pricing | Notable Gap |
167
+ |------------|-------------|-------------|---------|-------------|
168
+ | [name] | [features] | [positioning] | [pricing] | [gap] |
169
+
170
+ **Feature Gap Analysis**
171
+ [What do competitors do that this PRD addresses? What do they do that we're not addressing?]
172
+
173
+ **SWOT Summary** *(if deep dive was selected)*
174
+
175
+ | Strengths | Weaknesses | Opportunities | Threats |
176
+ |-----------|-----------|---------------|---------|
177
+ | | | | |
178
+
179
+ ---
180
+
181
+ ## Section 10 — Risks, Assumptions & Dependencies
182
+
183
+ **Assumptions**
184
+ - [Assumption 1 — what would need to be true for this to succeed]
185
+
186
+ **Known Risks**
187
+
188
+ | Risk | Likelihood | Impact | Mitigation |
189
+ |------|-----------|--------|------------|
190
+ | [risk] | High/Med/Low | High/Med/Low | [mitigation] |
191
+
192
+ **Dependencies**
193
+
194
+ | Dependency | Owner | Status | Notes |
195
+ |------------|-------|--------|-------|
196
+ | [dep name] | [team/person] | [status] | |
197
+
198
+ **Open Questions**
199
+
200
+ | # | Question | Owner | Due |
201
+ |---|----------|-------|-----|
202
+ | 1 | [question] | [name] | [date] |
203
+
204
+ ---
205
+
206
+ ## Section 11 — Release Criteria & Rollout
207
+
208
+ **Release Criteria**
209
+ The following must be true before shipping:
210
+ - [ ] [Criterion 1]
211
+ - [ ] [Criterion 2]
212
+ - [ ] [Criterion 3]
213
+
214
+ **Rollout Plan**
215
+ - Phase 1: [description, audience, timeline]
216
+ - Phase 2: [description, audience, timeline]
217
+ - Full release: [timeline]
218
+
219
+ **Launch Dependencies**
220
+ [Anything that must happen before or alongside launch: legal sign-off, marketing assets, support docs, etc.]
221
+
222
+ **Rollback Plan**
223
+ [How to revert if something goes wrong post-launch]
224
+
225
+ ---
226
+
227
+ ## Appendix — Revision History
228
+
229
+ | Version | Date | Author | Changes |
230
+ |---------|------|--------|---------|
231
+ | 1.0 | [date] | [name] | Initial draft |