siesa-agents 2.1.2 → 2.1.3-dev.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 (114) hide show
  1. package/README.md +83 -83
  2. package/bin/install.js +400 -400
  3. package/bin/prepare-publish.js +26 -26
  4. package/bin/restore-folders.js +26 -26
  5. package/bmad-core/agent-teams/team-all.yaml +15 -15
  6. package/bmad-core/agent-teams/team-fullstack.yaml +19 -19
  7. package/bmad-core/agent-teams/team-ide-minimal.yaml +11 -11
  8. package/bmad-core/agent-teams/team-no-ui.yaml +14 -14
  9. package/bmad-core/agents/analyst.md +84 -84
  10. package/bmad-core/agents/architect.md +94 -94
  11. package/bmad-core/agents/backend-agent.md +189 -189
  12. package/bmad-core/agents/bmad-master.md +110 -110
  13. package/bmad-core/agents/bmad-orchestrator.md +147 -147
  14. package/bmad-core/agents/dev.md +81 -81
  15. package/bmad-core/agents/frontend-agent.md +168 -168
  16. package/bmad-core/agents/pm.md +84 -84
  17. package/bmad-core/agents/po.md +79 -79
  18. package/bmad-core/agents/qa.md +91 -91
  19. package/bmad-core/agents/sm.md +65 -65
  20. package/bmad-core/agents/ux-expert.md +69 -69
  21. package/bmad-core/checklists/architect-checklist.md +440 -440
  22. package/bmad-core/checklists/backend-checklist.md +142 -142
  23. package/bmad-core/checklists/change-checklist.md +184 -184
  24. package/bmad-core/checklists/frontend-checklist.md +105 -105
  25. package/bmad-core/checklists/pm-checklist.md +372 -372
  26. package/bmad-core/checklists/po-master-checklist.md +434 -434
  27. package/bmad-core/checklists/story-dod-checklist.md +96 -96
  28. package/bmad-core/checklists/story-draft-checklist.md +155 -155
  29. package/bmad-core/core-config.yaml +22 -22
  30. package/bmad-core/data/backend-standards.md +439 -439
  31. package/bmad-core/data/bmad-kb.md +809 -809
  32. package/bmad-core/data/brainstorming-techniques.md +38 -38
  33. package/bmad-core/data/elicitation-methods.md +156 -156
  34. package/bmad-core/data/frontend-standards.md +323 -323
  35. package/bmad-core/data/technical-preferences.md +5 -5
  36. package/bmad-core/data/test-levels-framework.md +148 -148
  37. package/bmad-core/data/test-priorities-matrix.md +174 -174
  38. package/bmad-core/enhanced-ide-development-workflow.md +248 -248
  39. package/bmad-core/install-manifest.yaml +230 -230
  40. package/bmad-core/tasks/advanced-elicitation.md +119 -119
  41. package/bmad-core/tasks/apply-qa-fixes.md +150 -150
  42. package/bmad-core/tasks/brownfield-create-epic.md +162 -162
  43. package/bmad-core/tasks/brownfield-create-story.md +149 -149
  44. package/bmad-core/tasks/correct-course.md +72 -72
  45. package/bmad-core/tasks/create-brownfield-story.md +314 -314
  46. package/bmad-core/tasks/create-component.md +102 -102
  47. package/bmad-core/tasks/create-deep-research-prompt.md +280 -280
  48. package/bmad-core/tasks/create-doc.md +103 -103
  49. package/bmad-core/tasks/create-entity.md +132 -132
  50. package/bmad-core/tasks/create-feature.md +90 -90
  51. package/bmad-core/tasks/create-next-story.md +114 -114
  52. package/bmad-core/tasks/create-service.md +117 -117
  53. package/bmad-core/tasks/create-use-case.md +140 -140
  54. package/bmad-core/tasks/document-project.md +345 -345
  55. package/bmad-core/tasks/execute-checklist.md +88 -88
  56. package/bmad-core/tasks/facilitate-brainstorming-session.md +138 -138
  57. package/bmad-core/tasks/generate-ai-frontend-prompt.md +53 -53
  58. package/bmad-core/tasks/index-docs.md +175 -175
  59. package/bmad-core/tasks/kb-mode-interaction.md +77 -77
  60. package/bmad-core/tasks/nfr-assess.md +345 -345
  61. package/bmad-core/tasks/qa-gate.md +163 -163
  62. package/bmad-core/tasks/review-story.md +316 -316
  63. package/bmad-core/tasks/risk-profile.md +355 -355
  64. package/bmad-core/tasks/scaffold-backend.md +110 -110
  65. package/bmad-core/tasks/scaffold-frontend.md +78 -78
  66. package/bmad-core/tasks/shard-doc.md +187 -187
  67. package/bmad-core/tasks/test-design.md +176 -176
  68. package/bmad-core/tasks/trace-requirements.md +266 -266
  69. package/bmad-core/tasks/validate-next-story.md +136 -136
  70. package/bmad-core/templates/architecture-tmpl.yaml +662 -662
  71. package/bmad-core/templates/brainstorming-output-tmpl.yaml +156 -156
  72. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +477 -477
  73. package/bmad-core/templates/brownfield-prd-tmpl.yaml +281 -281
  74. package/bmad-core/templates/competitor-analysis-tmpl.yaml +307 -307
  75. package/bmad-core/templates/front-end-architecture-tmpl.yaml +258 -258
  76. package/bmad-core/templates/front-end-spec-tmpl.yaml +350 -350
  77. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +824 -824
  78. package/bmad-core/templates/market-research-tmpl.yaml +253 -253
  79. package/bmad-core/templates/prd-tmpl.yaml +203 -203
  80. package/bmad-core/templates/project-brief-tmpl.yaml +222 -222
  81. package/bmad-core/templates/qa-gate-tmpl.yaml +103 -103
  82. package/bmad-core/templates/story-tmpl.yaml +138 -138
  83. package/bmad-core/user-guide.md +530 -530
  84. package/bmad-core/utils/bmad-doc-template.md +327 -327
  85. package/bmad-core/utils/workflow-management.md +71 -71
  86. package/bmad-core/workflows/brownfield-fullstack.yaml +298 -298
  87. package/bmad-core/workflows/brownfield-service.yaml +188 -188
  88. package/bmad-core/workflows/brownfield-ui.yaml +198 -198
  89. package/bmad-core/workflows/greenfield-fullstack.yaml +241 -241
  90. package/bmad-core/workflows/greenfield-service.yaml +207 -207
  91. package/bmad-core/workflows/greenfield-ui.yaml +236 -236
  92. package/bmad-core/working-in-the-brownfield.md +606 -606
  93. package/claude/commands/BMad/agents/backend.md +187 -187
  94. package/claude/commands/BMad/agents/frontend.md +150 -150
  95. package/claude/hooks/file-restriction-hook.py +51 -0
  96. package/claude/hooks/track-agent.py +67 -0
  97. package/claude/settings.local.json +37 -1
  98. package/github/b-mad-expert.md +742 -742
  99. package/github/chatmodes/analyst.chatmode.md +89 -89
  100. package/github/chatmodes/architect.chatmode.md +97 -97
  101. package/github/chatmodes/backend.chatmode.md +194 -194
  102. package/github/chatmodes/bmad-master.chatmode.md +115 -115
  103. package/github/chatmodes/bmad-orchestrator.chatmode.md +152 -152
  104. package/github/chatmodes/dev.chatmode.md +86 -86
  105. package/github/chatmodes/frontend.chatmode.md +157 -157
  106. package/github/chatmodes/pm.chatmode.md +89 -89
  107. package/github/chatmodes/po.chatmode.md +84 -84
  108. package/github/chatmodes/qa.chatmode.md +96 -96
  109. package/github/chatmodes/sm.chatmode.md +70 -70
  110. package/github/chatmodes/ux-expert.chatmode.md +74 -74
  111. package/index.js +9 -9
  112. package/package.json +37 -37
  113. package/vscode/mcp.json +11 -11
  114. package/vscode/settings.json +12 -12
@@ -1,372 +1,372 @@
1
- <!-- Powered by BMAD™ Core -->
2
-
3
- # Product Manager (PM) Requirements Checklist
4
-
5
- This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process.
6
-
7
- [[LLM: INITIALIZATION INSTRUCTIONS - PM CHECKLIST
8
-
9
- Before proceeding with this checklist, ensure you have access to:
10
-
11
- 1. prd.md - The Product Requirements Document (check docs/prd.md)
12
- 2. Any user research, market analysis, or competitive analysis documents
13
- 3. Business goals and strategy documents
14
- 4. Any existing epic definitions or user stories
15
-
16
- IMPORTANT: If the PRD is missing, immediately ask the user for its location or content before proceeding.
17
-
18
- VALIDATION APPROACH:
19
-
20
- 1. User-Centric - Every requirement should tie back to user value
21
- 2. MVP Focus - Ensure scope is truly minimal while viable
22
- 3. Clarity - Requirements should be unambiguous and testable
23
- 4. Completeness - All aspects of the product vision are covered
24
- 5. Feasibility - Requirements are technically achievable
25
-
26
- EXECUTION MODE:
27
- Ask the user if they want to work through the checklist:
28
-
29
- - Section by section (interactive mode) - Review each section, present findings, get confirmation before proceeding
30
- - All at once (comprehensive mode) - Complete full analysis and present comprehensive report at end]]
31
-
32
- ## 1. PROBLEM DEFINITION & CONTEXT
33
-
34
- [[LLM: The foundation of any product is a clear problem statement. As you review this section:
35
-
36
- 1. Verify the problem is real and worth solving
37
- 2. Check that the target audience is specific, not "everyone"
38
- 3. Ensure success metrics are measurable, not vague aspirations
39
- 4. Look for evidence of user research, not just assumptions
40
- 5. Confirm the problem-solution fit is logical]]
41
-
42
- ### 1.1 Problem Statement
43
-
44
- - [ ] Clear articulation of the problem being solved
45
- - [ ] Identification of who experiences the problem
46
- - [ ] Explanation of why solving this problem matters
47
- - [ ] Quantification of problem impact (if possible)
48
- - [ ] Differentiation from existing solutions
49
-
50
- ### 1.2 Business Goals & Success Metrics
51
-
52
- - [ ] Specific, measurable business objectives defined
53
- - [ ] Clear success metrics and KPIs established
54
- - [ ] Metrics are tied to user and business value
55
- - [ ] Baseline measurements identified (if applicable)
56
- - [ ] Timeframe for achieving goals specified
57
-
58
- ### 1.3 User Research & Insights
59
-
60
- - [ ] Target user personas clearly defined
61
- - [ ] User needs and pain points documented
62
- - [ ] User research findings summarized (if available)
63
- - [ ] Competitive analysis included
64
- - [ ] Market context provided
65
-
66
- ## 2. MVP SCOPE DEFINITION
67
-
68
- [[LLM: MVP scope is critical - too much and you waste resources, too little and you can't validate. Check:
69
-
70
- 1. Is this truly minimal? Challenge every feature
71
- 2. Does each feature directly address the core problem?
72
- 3. Are "nice-to-haves" clearly separated from "must-haves"?
73
- 4. Is the rationale for inclusion/exclusion documented?
74
- 5. Can you ship this in the target timeframe?]]
75
-
76
- ### 2.1 Core Functionality
77
-
78
- - [ ] Essential features clearly distinguished from nice-to-haves
79
- - [ ] Features directly address defined problem statement
80
- - [ ] Each Epic ties back to specific user needs
81
- - [ ] Features and Stories are described from user perspective
82
- - [ ] Minimum requirements for success defined
83
-
84
- ### 2.2 Scope Boundaries
85
-
86
- - [ ] Clear articulation of what is OUT of scope
87
- - [ ] Future enhancements section included
88
- - [ ] Rationale for scope decisions documented
89
- - [ ] MVP minimizes functionality while maximizing learning
90
- - [ ] Scope has been reviewed and refined multiple times
91
-
92
- ### 2.3 MVP Validation Approach
93
-
94
- - [ ] Method for testing MVP success defined
95
- - [ ] Initial user feedback mechanisms planned
96
- - [ ] Criteria for moving beyond MVP specified
97
- - [ ] Learning goals for MVP articulated
98
- - [ ] Timeline expectations set
99
-
100
- ## 3. USER EXPERIENCE REQUIREMENTS
101
-
102
- [[LLM: UX requirements bridge user needs and technical implementation. Validate:
103
-
104
- 1. User flows cover the primary use cases completely
105
- 2. Edge cases are identified (even if deferred)
106
- 3. Accessibility isn't an afterthought
107
- 4. Performance expectations are realistic
108
- 5. Error states and recovery are planned]]
109
-
110
- ### 3.1 User Journeys & Flows
111
-
112
- - [ ] Primary user flows documented
113
- - [ ] Entry and exit points for each flow identified
114
- - [ ] Decision points and branches mapped
115
- - [ ] Critical path highlighted
116
- - [ ] Edge cases considered
117
-
118
- ### 3.2 Usability Requirements
119
-
120
- - [ ] Accessibility considerations documented
121
- - [ ] Platform/device compatibility specified
122
- - [ ] Performance expectations from user perspective defined
123
- - [ ] Error handling and recovery approaches outlined
124
- - [ ] User feedback mechanisms identified
125
-
126
- ### 3.3 UI Requirements
127
-
128
- - [ ] Information architecture outlined
129
- - [ ] Critical UI components identified
130
- - [ ] Visual design guidelines referenced (if applicable)
131
- - [ ] Content requirements specified
132
- - [ ] High-level navigation structure defined
133
-
134
- ## 4. FUNCTIONAL REQUIREMENTS
135
-
136
- [[LLM: Functional requirements must be clear enough for implementation. Check:
137
-
138
- 1. Requirements focus on WHAT not HOW (no implementation details)
139
- 2. Each requirement is testable (how would QA verify it?)
140
- 3. Dependencies are explicit (what needs to be built first?)
141
- 4. Requirements use consistent terminology
142
- 5. Complex features are broken into manageable pieces]]
143
-
144
- ### 4.1 Feature Completeness
145
-
146
- - [ ] All required features for MVP documented
147
- - [ ] Features have clear, user-focused descriptions
148
- - [ ] Feature priority/criticality indicated
149
- - [ ] Requirements are testable and verifiable
150
- - [ ] Dependencies between features identified
151
-
152
- ### 4.2 Requirements Quality
153
-
154
- - [ ] Requirements are specific and unambiguous
155
- - [ ] Requirements focus on WHAT not HOW
156
- - [ ] Requirements use consistent terminology
157
- - [ ] Complex requirements broken into simpler parts
158
- - [ ] Technical jargon minimized or explained
159
-
160
- ### 4.3 User Stories & Acceptance Criteria
161
-
162
- - [ ] Stories follow consistent format
163
- - [ ] Acceptance criteria are testable
164
- - [ ] Stories are sized appropriately (not too large)
165
- - [ ] Stories are independent where possible
166
- - [ ] Stories include necessary context
167
- - [ ] Local testability requirements (e.g., via CLI) defined in ACs for relevant backend/data stories
168
-
169
- ## 5. NON-FUNCTIONAL REQUIREMENTS
170
-
171
- ### 5.1 Performance Requirements
172
-
173
- - [ ] Response time expectations defined
174
- - [ ] Throughput/capacity requirements specified
175
- - [ ] Scalability needs documented
176
- - [ ] Resource utilization constraints identified
177
- - [ ] Load handling expectations set
178
-
179
- ### 5.2 Security & Compliance
180
-
181
- - [ ] Data protection requirements specified
182
- - [ ] Authentication/authorization needs defined
183
- - [ ] Compliance requirements documented
184
- - [ ] Security testing requirements outlined
185
- - [ ] Privacy considerations addressed
186
-
187
- ### 5.3 Reliability & Resilience
188
-
189
- - [ ] Availability requirements defined
190
- - [ ] Backup and recovery needs documented
191
- - [ ] Fault tolerance expectations set
192
- - [ ] Error handling requirements specified
193
- - [ ] Maintenance and support considerations included
194
-
195
- ### 5.4 Technical Constraints
196
-
197
- - [ ] Platform/technology constraints documented
198
- - [ ] Integration requirements outlined
199
- - [ ] Third-party service dependencies identified
200
- - [ ] Infrastructure requirements specified
201
- - [ ] Development environment needs identified
202
-
203
- ## 6. EPIC & STORY STRUCTURE
204
-
205
- ### 6.1 Epic Definition
206
-
207
- - [ ] Epics represent cohesive units of functionality
208
- - [ ] Epics focus on user/business value delivery
209
- - [ ] Epic goals clearly articulated
210
- - [ ] Epics are sized appropriately for incremental delivery
211
- - [ ] Epic sequence and dependencies identified
212
-
213
- ### 6.2 Story Breakdown
214
-
215
- - [ ] Stories are broken down to appropriate size
216
- - [ ] Stories have clear, independent value
217
- - [ ] Stories include appropriate acceptance criteria
218
- - [ ] Story dependencies and sequence documented
219
- - [ ] Stories aligned with epic goals
220
-
221
- ### 6.3 First Epic Completeness
222
-
223
- - [ ] First epic includes all necessary setup steps
224
- - [ ] Project scaffolding and initialization addressed
225
- - [ ] Core infrastructure setup included
226
- - [ ] Development environment setup addressed
227
- - [ ] Local testability established early
228
-
229
- ## 7. TECHNICAL GUIDANCE
230
-
231
- ### 7.1 Architecture Guidance
232
-
233
- - [ ] Initial architecture direction provided
234
- - [ ] Technical constraints clearly communicated
235
- - [ ] Integration points identified
236
- - [ ] Performance considerations highlighted
237
- - [ ] Security requirements articulated
238
- - [ ] Known areas of high complexity or technical risk flagged for architectural deep-dive
239
-
240
- ### 7.2 Technical Decision Framework
241
-
242
- - [ ] Decision criteria for technical choices provided
243
- - [ ] Trade-offs articulated for key decisions
244
- - [ ] Rationale for selecting primary approach over considered alternatives documented (for key design/feature choices)
245
- - [ ] Non-negotiable technical requirements highlighted
246
- - [ ] Areas requiring technical investigation identified
247
- - [ ] Guidance on technical debt approach provided
248
-
249
- ### 7.3 Implementation Considerations
250
-
251
- - [ ] Development approach guidance provided
252
- - [ ] Testing requirements articulated
253
- - [ ] Deployment expectations set
254
- - [ ] Monitoring needs identified
255
- - [ ] Documentation requirements specified
256
-
257
- ## 8. CROSS-FUNCTIONAL REQUIREMENTS
258
-
259
- ### 8.1 Data Requirements
260
-
261
- - [ ] Data entities and relationships identified
262
- - [ ] Data storage requirements specified
263
- - [ ] Data quality requirements defined
264
- - [ ] Data retention policies identified
265
- - [ ] Data migration needs addressed (if applicable)
266
- - [ ] Schema changes planned iteratively, tied to stories requiring them
267
-
268
- ### 8.2 Integration Requirements
269
-
270
- - [ ] External system integrations identified
271
- - [ ] API requirements documented
272
- - [ ] Authentication for integrations specified
273
- - [ ] Data exchange formats defined
274
- - [ ] Integration testing requirements outlined
275
-
276
- ### 8.3 Operational Requirements
277
-
278
- - [ ] Deployment frequency expectations set
279
- - [ ] Environment requirements defined
280
- - [ ] Monitoring and alerting needs identified
281
- - [ ] Support requirements documented
282
- - [ ] Performance monitoring approach specified
283
-
284
- ## 9. CLARITY & COMMUNICATION
285
-
286
- ### 9.1 Documentation Quality
287
-
288
- - [ ] Documents use clear, consistent language
289
- - [ ] Documents are well-structured and organized
290
- - [ ] Technical terms are defined where necessary
291
- - [ ] Diagrams/visuals included where helpful
292
- - [ ] Documentation is versioned appropriately
293
-
294
- ### 9.2 Stakeholder Alignment
295
-
296
- - [ ] Key stakeholders identified
297
- - [ ] Stakeholder input incorporated
298
- - [ ] Potential areas of disagreement addressed
299
- - [ ] Communication plan for updates established
300
- - [ ] Approval process defined
301
-
302
- ## PRD & EPIC VALIDATION SUMMARY
303
-
304
- [[LLM: FINAL PM CHECKLIST REPORT GENERATION
305
-
306
- Create a comprehensive validation report that includes:
307
-
308
- 1. Executive Summary
309
- - Overall PRD completeness (percentage)
310
- - MVP scope appropriateness (Too Large/Just Right/Too Small)
311
- - Readiness for architecture phase (Ready/Nearly Ready/Not Ready)
312
- - Most critical gaps or concerns
313
-
314
- 2. Category Analysis Table
315
- Fill in the actual table with:
316
- - Status: PASS (90%+ complete), PARTIAL (60-89%), FAIL (<60%)
317
- - Critical Issues: Specific problems that block progress
318
-
319
- 3. Top Issues by Priority
320
- - BLOCKERS: Must fix before architect can proceed
321
- - HIGH: Should fix for quality
322
- - MEDIUM: Would improve clarity
323
- - LOW: Nice to have
324
-
325
- 4. MVP Scope Assessment
326
- - Features that might be cut for true MVP
327
- - Missing features that are essential
328
- - Complexity concerns
329
- - Timeline realism
330
-
331
- 5. Technical Readiness
332
- - Clarity of technical constraints
333
- - Identified technical risks
334
- - Areas needing architect investigation
335
-
336
- 6. Recommendations
337
- - Specific actions to address each blocker
338
- - Suggested improvements
339
- - Next steps
340
-
341
- After presenting the report, ask if the user wants:
342
-
343
- - Detailed analysis of any failed sections
344
- - Suggestions for improving specific areas
345
- - Help with refining MVP scope]]
346
-
347
- ### Category Statuses
348
-
349
- | Category | Status | Critical Issues |
350
- | -------------------------------- | ------ | --------------- |
351
- | 1. Problem Definition & Context | _TBD_ | |
352
- | 2. MVP Scope Definition | _TBD_ | |
353
- | 3. User Experience Requirements | _TBD_ | |
354
- | 4. Functional Requirements | _TBD_ | |
355
- | 5. Non-Functional Requirements | _TBD_ | |
356
- | 6. Epic & Story Structure | _TBD_ | |
357
- | 7. Technical Guidance | _TBD_ | |
358
- | 8. Cross-Functional Requirements | _TBD_ | |
359
- | 9. Clarity & Communication | _TBD_ | |
360
-
361
- ### Critical Deficiencies
362
-
363
- (To be populated during validation)
364
-
365
- ### Recommendations
366
-
367
- (To be populated during validation)
368
-
369
- ### Final Decision
370
-
371
- - **READY FOR ARCHITECT**: The PRD and epics are comprehensive, properly structured, and ready for architectural design.
372
- - **NEEDS REFINEMENT**: The requirements documentation requires additional work to address the identified deficiencies.
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # Product Manager (PM) Requirements Checklist
4
+
5
+ This checklist serves as a comprehensive framework to ensure the Product Requirements Document (PRD) and Epic definitions are complete, well-structured, and appropriately scoped for MVP development. The PM should systematically work through each item during the product definition process.
6
+
7
+ [[LLM: INITIALIZATION INSTRUCTIONS - PM CHECKLIST
8
+
9
+ Before proceeding with this checklist, ensure you have access to:
10
+
11
+ 1. prd.md - The Product Requirements Document (check docs/prd.md)
12
+ 2. Any user research, market analysis, or competitive analysis documents
13
+ 3. Business goals and strategy documents
14
+ 4. Any existing epic definitions or user stories
15
+
16
+ IMPORTANT: If the PRD is missing, immediately ask the user for its location or content before proceeding.
17
+
18
+ VALIDATION APPROACH:
19
+
20
+ 1. User-Centric - Every requirement should tie back to user value
21
+ 2. MVP Focus - Ensure scope is truly minimal while viable
22
+ 3. Clarity - Requirements should be unambiguous and testable
23
+ 4. Completeness - All aspects of the product vision are covered
24
+ 5. Feasibility - Requirements are technically achievable
25
+
26
+ EXECUTION MODE:
27
+ Ask the user if they want to work through the checklist:
28
+
29
+ - Section by section (interactive mode) - Review each section, present findings, get confirmation before proceeding
30
+ - All at once (comprehensive mode) - Complete full analysis and present comprehensive report at end]]
31
+
32
+ ## 1. PROBLEM DEFINITION & CONTEXT
33
+
34
+ [[LLM: The foundation of any product is a clear problem statement. As you review this section:
35
+
36
+ 1. Verify the problem is real and worth solving
37
+ 2. Check that the target audience is specific, not "everyone"
38
+ 3. Ensure success metrics are measurable, not vague aspirations
39
+ 4. Look for evidence of user research, not just assumptions
40
+ 5. Confirm the problem-solution fit is logical]]
41
+
42
+ ### 1.1 Problem Statement
43
+
44
+ - [ ] Clear articulation of the problem being solved
45
+ - [ ] Identification of who experiences the problem
46
+ - [ ] Explanation of why solving this problem matters
47
+ - [ ] Quantification of problem impact (if possible)
48
+ - [ ] Differentiation from existing solutions
49
+
50
+ ### 1.2 Business Goals & Success Metrics
51
+
52
+ - [ ] Specific, measurable business objectives defined
53
+ - [ ] Clear success metrics and KPIs established
54
+ - [ ] Metrics are tied to user and business value
55
+ - [ ] Baseline measurements identified (if applicable)
56
+ - [ ] Timeframe for achieving goals specified
57
+
58
+ ### 1.3 User Research & Insights
59
+
60
+ - [ ] Target user personas clearly defined
61
+ - [ ] User needs and pain points documented
62
+ - [ ] User research findings summarized (if available)
63
+ - [ ] Competitive analysis included
64
+ - [ ] Market context provided
65
+
66
+ ## 2. MVP SCOPE DEFINITION
67
+
68
+ [[LLM: MVP scope is critical - too much and you waste resources, too little and you can't validate. Check:
69
+
70
+ 1. Is this truly minimal? Challenge every feature
71
+ 2. Does each feature directly address the core problem?
72
+ 3. Are "nice-to-haves" clearly separated from "must-haves"?
73
+ 4. Is the rationale for inclusion/exclusion documented?
74
+ 5. Can you ship this in the target timeframe?]]
75
+
76
+ ### 2.1 Core Functionality
77
+
78
+ - [ ] Essential features clearly distinguished from nice-to-haves
79
+ - [ ] Features directly address defined problem statement
80
+ - [ ] Each Epic ties back to specific user needs
81
+ - [ ] Features and Stories are described from user perspective
82
+ - [ ] Minimum requirements for success defined
83
+
84
+ ### 2.2 Scope Boundaries
85
+
86
+ - [ ] Clear articulation of what is OUT of scope
87
+ - [ ] Future enhancements section included
88
+ - [ ] Rationale for scope decisions documented
89
+ - [ ] MVP minimizes functionality while maximizing learning
90
+ - [ ] Scope has been reviewed and refined multiple times
91
+
92
+ ### 2.3 MVP Validation Approach
93
+
94
+ - [ ] Method for testing MVP success defined
95
+ - [ ] Initial user feedback mechanisms planned
96
+ - [ ] Criteria for moving beyond MVP specified
97
+ - [ ] Learning goals for MVP articulated
98
+ - [ ] Timeline expectations set
99
+
100
+ ## 3. USER EXPERIENCE REQUIREMENTS
101
+
102
+ [[LLM: UX requirements bridge user needs and technical implementation. Validate:
103
+
104
+ 1. User flows cover the primary use cases completely
105
+ 2. Edge cases are identified (even if deferred)
106
+ 3. Accessibility isn't an afterthought
107
+ 4. Performance expectations are realistic
108
+ 5. Error states and recovery are planned]]
109
+
110
+ ### 3.1 User Journeys & Flows
111
+
112
+ - [ ] Primary user flows documented
113
+ - [ ] Entry and exit points for each flow identified
114
+ - [ ] Decision points and branches mapped
115
+ - [ ] Critical path highlighted
116
+ - [ ] Edge cases considered
117
+
118
+ ### 3.2 Usability Requirements
119
+
120
+ - [ ] Accessibility considerations documented
121
+ - [ ] Platform/device compatibility specified
122
+ - [ ] Performance expectations from user perspective defined
123
+ - [ ] Error handling and recovery approaches outlined
124
+ - [ ] User feedback mechanisms identified
125
+
126
+ ### 3.3 UI Requirements
127
+
128
+ - [ ] Information architecture outlined
129
+ - [ ] Critical UI components identified
130
+ - [ ] Visual design guidelines referenced (if applicable)
131
+ - [ ] Content requirements specified
132
+ - [ ] High-level navigation structure defined
133
+
134
+ ## 4. FUNCTIONAL REQUIREMENTS
135
+
136
+ [[LLM: Functional requirements must be clear enough for implementation. Check:
137
+
138
+ 1. Requirements focus on WHAT not HOW (no implementation details)
139
+ 2. Each requirement is testable (how would QA verify it?)
140
+ 3. Dependencies are explicit (what needs to be built first?)
141
+ 4. Requirements use consistent terminology
142
+ 5. Complex features are broken into manageable pieces]]
143
+
144
+ ### 4.1 Feature Completeness
145
+
146
+ - [ ] All required features for MVP documented
147
+ - [ ] Features have clear, user-focused descriptions
148
+ - [ ] Feature priority/criticality indicated
149
+ - [ ] Requirements are testable and verifiable
150
+ - [ ] Dependencies between features identified
151
+
152
+ ### 4.2 Requirements Quality
153
+
154
+ - [ ] Requirements are specific and unambiguous
155
+ - [ ] Requirements focus on WHAT not HOW
156
+ - [ ] Requirements use consistent terminology
157
+ - [ ] Complex requirements broken into simpler parts
158
+ - [ ] Technical jargon minimized or explained
159
+
160
+ ### 4.3 User Stories & Acceptance Criteria
161
+
162
+ - [ ] Stories follow consistent format
163
+ - [ ] Acceptance criteria are testable
164
+ - [ ] Stories are sized appropriately (not too large)
165
+ - [ ] Stories are independent where possible
166
+ - [ ] Stories include necessary context
167
+ - [ ] Local testability requirements (e.g., via CLI) defined in ACs for relevant backend/data stories
168
+
169
+ ## 5. NON-FUNCTIONAL REQUIREMENTS
170
+
171
+ ### 5.1 Performance Requirements
172
+
173
+ - [ ] Response time expectations defined
174
+ - [ ] Throughput/capacity requirements specified
175
+ - [ ] Scalability needs documented
176
+ - [ ] Resource utilization constraints identified
177
+ - [ ] Load handling expectations set
178
+
179
+ ### 5.2 Security & Compliance
180
+
181
+ - [ ] Data protection requirements specified
182
+ - [ ] Authentication/authorization needs defined
183
+ - [ ] Compliance requirements documented
184
+ - [ ] Security testing requirements outlined
185
+ - [ ] Privacy considerations addressed
186
+
187
+ ### 5.3 Reliability & Resilience
188
+
189
+ - [ ] Availability requirements defined
190
+ - [ ] Backup and recovery needs documented
191
+ - [ ] Fault tolerance expectations set
192
+ - [ ] Error handling requirements specified
193
+ - [ ] Maintenance and support considerations included
194
+
195
+ ### 5.4 Technical Constraints
196
+
197
+ - [ ] Platform/technology constraints documented
198
+ - [ ] Integration requirements outlined
199
+ - [ ] Third-party service dependencies identified
200
+ - [ ] Infrastructure requirements specified
201
+ - [ ] Development environment needs identified
202
+
203
+ ## 6. EPIC & STORY STRUCTURE
204
+
205
+ ### 6.1 Epic Definition
206
+
207
+ - [ ] Epics represent cohesive units of functionality
208
+ - [ ] Epics focus on user/business value delivery
209
+ - [ ] Epic goals clearly articulated
210
+ - [ ] Epics are sized appropriately for incremental delivery
211
+ - [ ] Epic sequence and dependencies identified
212
+
213
+ ### 6.2 Story Breakdown
214
+
215
+ - [ ] Stories are broken down to appropriate size
216
+ - [ ] Stories have clear, independent value
217
+ - [ ] Stories include appropriate acceptance criteria
218
+ - [ ] Story dependencies and sequence documented
219
+ - [ ] Stories aligned with epic goals
220
+
221
+ ### 6.3 First Epic Completeness
222
+
223
+ - [ ] First epic includes all necessary setup steps
224
+ - [ ] Project scaffolding and initialization addressed
225
+ - [ ] Core infrastructure setup included
226
+ - [ ] Development environment setup addressed
227
+ - [ ] Local testability established early
228
+
229
+ ## 7. TECHNICAL GUIDANCE
230
+
231
+ ### 7.1 Architecture Guidance
232
+
233
+ - [ ] Initial architecture direction provided
234
+ - [ ] Technical constraints clearly communicated
235
+ - [ ] Integration points identified
236
+ - [ ] Performance considerations highlighted
237
+ - [ ] Security requirements articulated
238
+ - [ ] Known areas of high complexity or technical risk flagged for architectural deep-dive
239
+
240
+ ### 7.2 Technical Decision Framework
241
+
242
+ - [ ] Decision criteria for technical choices provided
243
+ - [ ] Trade-offs articulated for key decisions
244
+ - [ ] Rationale for selecting primary approach over considered alternatives documented (for key design/feature choices)
245
+ - [ ] Non-negotiable technical requirements highlighted
246
+ - [ ] Areas requiring technical investigation identified
247
+ - [ ] Guidance on technical debt approach provided
248
+
249
+ ### 7.3 Implementation Considerations
250
+
251
+ - [ ] Development approach guidance provided
252
+ - [ ] Testing requirements articulated
253
+ - [ ] Deployment expectations set
254
+ - [ ] Monitoring needs identified
255
+ - [ ] Documentation requirements specified
256
+
257
+ ## 8. CROSS-FUNCTIONAL REQUIREMENTS
258
+
259
+ ### 8.1 Data Requirements
260
+
261
+ - [ ] Data entities and relationships identified
262
+ - [ ] Data storage requirements specified
263
+ - [ ] Data quality requirements defined
264
+ - [ ] Data retention policies identified
265
+ - [ ] Data migration needs addressed (if applicable)
266
+ - [ ] Schema changes planned iteratively, tied to stories requiring them
267
+
268
+ ### 8.2 Integration Requirements
269
+
270
+ - [ ] External system integrations identified
271
+ - [ ] API requirements documented
272
+ - [ ] Authentication for integrations specified
273
+ - [ ] Data exchange formats defined
274
+ - [ ] Integration testing requirements outlined
275
+
276
+ ### 8.3 Operational Requirements
277
+
278
+ - [ ] Deployment frequency expectations set
279
+ - [ ] Environment requirements defined
280
+ - [ ] Monitoring and alerting needs identified
281
+ - [ ] Support requirements documented
282
+ - [ ] Performance monitoring approach specified
283
+
284
+ ## 9. CLARITY & COMMUNICATION
285
+
286
+ ### 9.1 Documentation Quality
287
+
288
+ - [ ] Documents use clear, consistent language
289
+ - [ ] Documents are well-structured and organized
290
+ - [ ] Technical terms are defined where necessary
291
+ - [ ] Diagrams/visuals included where helpful
292
+ - [ ] Documentation is versioned appropriately
293
+
294
+ ### 9.2 Stakeholder Alignment
295
+
296
+ - [ ] Key stakeholders identified
297
+ - [ ] Stakeholder input incorporated
298
+ - [ ] Potential areas of disagreement addressed
299
+ - [ ] Communication plan for updates established
300
+ - [ ] Approval process defined
301
+
302
+ ## PRD & EPIC VALIDATION SUMMARY
303
+
304
+ [[LLM: FINAL PM CHECKLIST REPORT GENERATION
305
+
306
+ Create a comprehensive validation report that includes:
307
+
308
+ 1. Executive Summary
309
+ - Overall PRD completeness (percentage)
310
+ - MVP scope appropriateness (Too Large/Just Right/Too Small)
311
+ - Readiness for architecture phase (Ready/Nearly Ready/Not Ready)
312
+ - Most critical gaps or concerns
313
+
314
+ 2. Category Analysis Table
315
+ Fill in the actual table with:
316
+ - Status: PASS (90%+ complete), PARTIAL (60-89%), FAIL (<60%)
317
+ - Critical Issues: Specific problems that block progress
318
+
319
+ 3. Top Issues by Priority
320
+ - BLOCKERS: Must fix before architect can proceed
321
+ - HIGH: Should fix for quality
322
+ - MEDIUM: Would improve clarity
323
+ - LOW: Nice to have
324
+
325
+ 4. MVP Scope Assessment
326
+ - Features that might be cut for true MVP
327
+ - Missing features that are essential
328
+ - Complexity concerns
329
+ - Timeline realism
330
+
331
+ 5. Technical Readiness
332
+ - Clarity of technical constraints
333
+ - Identified technical risks
334
+ - Areas needing architect investigation
335
+
336
+ 6. Recommendations
337
+ - Specific actions to address each blocker
338
+ - Suggested improvements
339
+ - Next steps
340
+
341
+ After presenting the report, ask if the user wants:
342
+
343
+ - Detailed analysis of any failed sections
344
+ - Suggestions for improving specific areas
345
+ - Help with refining MVP scope]]
346
+
347
+ ### Category Statuses
348
+
349
+ | Category | Status | Critical Issues |
350
+ | -------------------------------- | ------ | --------------- |
351
+ | 1. Problem Definition & Context | _TBD_ | |
352
+ | 2. MVP Scope Definition | _TBD_ | |
353
+ | 3. User Experience Requirements | _TBD_ | |
354
+ | 4. Functional Requirements | _TBD_ | |
355
+ | 5. Non-Functional Requirements | _TBD_ | |
356
+ | 6. Epic & Story Structure | _TBD_ | |
357
+ | 7. Technical Guidance | _TBD_ | |
358
+ | 8. Cross-Functional Requirements | _TBD_ | |
359
+ | 9. Clarity & Communication | _TBD_ | |
360
+
361
+ ### Critical Deficiencies
362
+
363
+ (To be populated during validation)
364
+
365
+ ### Recommendations
366
+
367
+ (To be populated during validation)
368
+
369
+ ### Final Decision
370
+
371
+ - **READY FOR ARCHITECT**: The PRD and epics are comprehensive, properly structured, and ready for architectural design.
372
+ - **NEEDS REFINEMENT**: The requirements documentation requires additional work to address the identified deficiencies.