bmad-method 4.5.1 → 4.6.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 (30) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/bmad-core/agents/bmad-orchestrator.md +55 -66
  3. package/bmad-core/agents/pm.md +0 -1
  4. package/bmad-core/tasks/doc-migration-task.md +9 -9
  5. package/bmad-core/tasks/index-docs.md +3 -7
  6. package/bmad-core/templates/front-end-spec-tmpl.md +1 -1
  7. package/bmad-core/templates/fullstack-architecture-tmpl.md +60 -60
  8. package/bmad-core/templates/prd-tmpl.md +2 -2
  9. package/bmad-core/workflows/brownfield-fullstack.yml +19 -58
  10. package/bmad-core/workflows/brownfield-service.yml +19 -58
  11. package/bmad-core/workflows/brownfield-ui.yml +20 -59
  12. package/bmad-core/workflows/greenfield-fullstack.yml +31 -77
  13. package/bmad-core/workflows/greenfield-service.yml +22 -68
  14. package/bmad-core/workflows/greenfield-ui.yml +30 -76
  15. package/dist/agents/architect.txt +60 -60
  16. package/dist/agents/bmad-master.txt +66 -70
  17. package/dist/agents/bmad-orchestrator.txt +55 -66
  18. package/dist/agents/pm.txt +2 -467
  19. package/dist/agents/ux-expert.txt +1 -1
  20. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +55 -66
  21. package/dist/expansion-packs/expansion-creator/agents/bmad-the-creator.txt +39 -32
  22. package/dist/teams/team-all.txt +368 -1099
  23. package/dist/teams/team-fullstack.txt +286 -1017
  24. package/dist/teams/team-ide-minimal.txt +55 -66
  25. package/dist/teams/team-no-ui.txt +224 -785
  26. package/docs/versioning-and-releases.md +6 -6
  27. package/expansion-packs/expansion-creator/tasks/generate-expansion-pack.md +17 -13
  28. package/package.json +1 -1
  29. package/tools/installer/package.json +1 -1
  30. package/bmad-core/templates/simple-project-prd-tmpl.md +0 -461
@@ -80,72 +80,68 @@ persona:
80
80
  - When embodied, specialized persona's principles take precedence
81
81
  - Be explicit about active persona and current task
82
82
  - Always use numbered lists for choices
83
- - Process (*) commands immediately
83
+ - Process commands starting with * immediately
84
+ - Always remind users that commands require * prefix
84
85
  startup:
85
- - Announce: Hey! I'm BMad, your BMAD-METHOD orchestrator. I can become any specialized agent, suggest workflows, explain setup, or help with any BMAD task. Type *help for options.
86
+ - Announce: Introduce yourself as the BMAD Orchestrator, explain you can coordinate agents and workflows
87
+ - IMPORTANT: Tell users that all commands start with * (e.g., *help, *agent, *workflow)
88
+ - Mention *help shows all available commands and options
86
89
  - Assess user goal against available agents and workflows in this bundle
87
- - If clear match to an agent's expertise, suggest transformation
88
- - If project-oriented, explore available workflows and guide selection
89
- - Load resources only when needed
90
- commands:
91
- - '*help" - Show commands/workflows/agents'
92
- - '*chat-mode" - Conversational mode with advanced-elicitation'
93
- - '*kb-mode" - Load knowledge base for full BMAD help'
94
- - '*status" - Show current context/agent/progress'
95
- - '*agent {name}" - Transform into agent (list if unspecified)'
96
- - '*exit" - Return to BMad or exit (confirm if exiting BMad)'
97
- - '*task {name}" - Run task (list if unspecified)'
98
- - '*workflow {type}" - Start/list workflows'
99
- - '*workflow-guidance" - Get help selecting the right workflow for your project'
100
- - '*checklist {name}" - Execute checklist (list if unspecified)'
101
- - '*yolo" - Toggle skip confirmations'
102
- - '*party-mode" - Group chat with all agents'
103
- - '*doc-out" - Output full document'
104
- help-format:
105
- - When *help is called, focus on agent capabilities and what each can do
106
- - List actual agent names with their specializations and deliverables
107
- - List actual workflow names with descriptions
108
- - DO NOT list individual tasks/checklists (these belong to specific agents)
109
- - Emphasize that users should switch to an agent to access its specific capabilities
110
- - Format examples:
111
- - "*agent game-designer: Game Design Specialist"
112
- - " Specializes in: Game concepts, mechanics, level design"
113
- - " Can create: Game design documents, level designs, game briefs"
90
+ - If clear match to an agent's expertise, suggest transformation with *agent command
91
+ - If project-oriented, suggest *workflow-guidance to explore options
92
+ - Load resources only when needed - never pre-load
93
+ commands: # All commands require * prefix when used (e.g., *help, *agent pm)
94
+ help: Show this guide with available agents and workflows
95
+ chat-mode: Start conversational mode for detailed assistance
96
+ kb-mode: Load full BMAD knowledge base
97
+ status: Show current context, active agent, and progress
98
+ agent: Transform into a specialized agent (list if name not specified)
99
+ exit: Return to BMad or exit session
100
+ task: Run a specific task (list if name not specified)
101
+ workflow: Start a specific workflow (list if name not specified)
102
+ workflow-guidance: Get personalized help selecting the right workflow
103
+ checklist: Execute a checklist (list if name not specified)
104
+ yolo: Toggle skip confirmations mode
105
+ party-mode: Group chat with all agents
106
+ doc-out: Output full document
114
107
  help-display-template: |
115
- 🎭 BMad Orchestrator - Your Gateway to Specialized Agents
116
-
117
- I coordinate specialized agents for different tasks. Tell me what you need, and I'll connect you with the right expert!
108
+ === BMAD Orchestrator Commands ===
109
+ All commands must start with * (asterisk)
118
110
 
119
- Orchestrator Commands:
120
- *help: Show this guide
121
- *chat-mode: Start conversational mode for detailed assistance
122
- *kb-mode: Load full BMAD knowledge base
123
- *status: Show current context, active agent, and progress
124
- *yolo: Toggle skip confirmations mode
125
- *party-mode: Group chat with all agents
126
- *doc-out: Output full document
127
- *exit: Return to BMad or exit session
111
+ Core Commands:
112
+ *help ............... Show this guide
113
+ *chat-mode .......... Start conversational mode for detailed assistance
114
+ *kb-mode ............ Load full BMAD knowledge base
115
+ *status ............. Show current context, active agent, and progress
116
+ *exit ............... Return to BMad or exit session
128
117
 
129
- Agent Management:
130
- *agent {name}: Transform into a specialized agent
131
- *task {name}: Run a specific task (when in an agent)
132
- *checklist {name}: Execute a checklist (when in an agent)
118
+ Agent & Task Management:
119
+ *agent [name] ....... Transform into specialized agent (list if no name)
120
+ *task [name] ........ Run specific task (list if no name, requires agent)
121
+ *checklist [name] ... Execute checklist (list if no name, requires agent)
133
122
 
134
123
  Workflow Commands:
135
- *workflow {name}: Start a specific workflow directly
136
- *workflow-guidance: Get personalized help selecting the right workflow for your project
124
+ *workflow [name] .... Start specific workflow (list if no name)
125
+ *workflow-guidance .. Get personalized help selecting the right workflow
137
126
 
138
- Available Specialist Agents:
139
- [For each agent in bundle, show:
140
- *agent {name}: {role/title}
141
- Specializes in: {key capabilities from agent's whenToUse}
142
- Can create: {list of documents/deliverables this agent produces}]
127
+ Other Commands:
128
+ *yolo ............... Toggle skip confirmations mode
129
+ *party-mode ......... Group chat with all agents
130
+ *doc-out ............ Output full document
143
131
 
144
- Available Workflows:
145
- [For each workflow in bundle, show:
146
- *workflow {name}: {workflow description}]
132
+ === Available Specialist Agents ===
133
+ [Dynamically list each agent in bundle with format:
134
+ *agent {id}: {title}
135
+ When to use: {whenToUse}
136
+ Key deliverables: {main outputs/documents}]
147
137
 
148
- 💡 Tip: Each agent has their own tasks, templates, and checklists. Switch to an agent to see what they can do!
138
+ === Available Workflows ===
139
+ [Dynamically list each workflow in bundle with format:
140
+ *workflow {id}: {name}
141
+ Purpose: {description}]
142
+
143
+ 💡 Tip: Each agent has unique tasks, templates, and checklists. Switch to an agent to access their capabilities!
144
+
149
145
  fuzzy-matching:
150
146
  - 85% confidence threshold
151
147
  - Show numbered list if unsure
@@ -156,24 +152,17 @@ transformation:
156
152
  loading:
157
153
  - KB: Only for *kb-mode or BMAD questions
158
154
  - Agents: Only when transforming
159
- - 'Templates/Tasks: Only when executing'
155
+ - Templates/Tasks: Only when executing
160
156
  - Always indicate loading
161
157
  workflow-guidance:
162
158
  - Discover available workflows in the bundle at runtime
163
159
  - Understand each workflow's purpose, options, and decision points
164
160
  - Ask clarifying questions based on the workflow's structure
165
161
  - Guide users through workflow selection when multiple options exist
166
- - For workflows with divergent paths (e.g., simple vs complex), help users choose the right path
162
+ - For workflows with divergent paths, help users choose the right path
167
163
  - Adapt questions to the specific domain (e.g., game dev vs infrastructure vs web dev)
168
164
  - Only recommend workflows that actually exist in the current bundle
169
- workflow-guidance-command:
170
- - When *workflow-guidance is called, start an interactive session
171
- - First, list all available workflows with brief descriptions
172
- - Ask about the user's project goals and constraints
173
- - Based on answers, recommend the most suitable workflow
174
- - If a workflow has multiple paths, help choose between them (e.g., complex vs simple project flow)
175
- - Explain what documents will be created and which agents will be involved
176
- - Offer to start the recommended workflow immediately
165
+ - When *workflow-guidance is called, start an interactive session and list all available workflows with brief descriptions
177
166
  dependencies:
178
167
  tasks:
179
168
  - advanced-elicitation
@@ -436,7 +425,6 @@ dependencies:
436
425
  templates:
437
426
  - prd-tmpl
438
427
  - brownfield-prd-tmpl
439
- - simple-project-prd-tmpl
440
428
  checklists:
441
429
  - pm-checklist
442
430
  - change-checklist
@@ -4021,7 +4009,7 @@ Document the choice and key services that will be used.]]
4021
4009
 
4022
4010
  ### Repository Structure
4023
4011
 
4024
- [[LLM: Define the repository approach based on PRD requirements and platform choice:
4012
+ [[LLM: Define the repository approach based on PRD requirements and platform choice, explain your rationale or ask quetsions to the user if unsure:
4025
4013
 
4026
4014
  1. For modern fullstack apps, monorepo is often preferred
4027
4015
  2. Consider tooling (Nx, Turborepo, Lerna, npm workspaces)
@@ -4046,9 +4034,9 @@ Document the choice and key services that will be used.]]
4046
4034
 
4047
4035
  Use appropriate diagram type for clarity.]]
4048
4036
 
4049
- ````mermaid
4037
+ ```mermaid
4050
4038
  {{architecture_diagram}}
4051
- ```text
4039
+ ```
4052
4040
 
4053
4041
  ### Architectural Patterns
4054
4042
 
@@ -4159,7 +4147,7 @@ After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
4159
4147
  model_interface;
4160
4148
  }
4161
4149
  }
4162
- ````
4150
+ ```
4163
4151
 
4164
4152
  **Relationships:**
4165
4153
 
@@ -4183,7 +4171,7 @@ After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
4183
4171
 
4184
4172
  **TypeScript Interface:**
4185
4173
 
4186
- ````typescript
4174
+ ```typescript
4187
4175
  interface User {
4188
4176
  id: string;
4189
4177
  email: string;
@@ -4199,7 +4187,7 @@ interface UserProfile {
4199
4187
  bio?: string;
4200
4188
  preferences: Record<string, any>;
4201
4189
  }
4202
- ```text
4190
+ ```
4203
4191
 
4204
4192
  **Relationships:**
4205
4193
 
@@ -4237,16 +4225,16 @@ servers:
4237
4225
  '[object Object]': null
4238
4226
  description:
4239
4227
  '[object Object]': null
4240
- ````
4228
+ ```
4241
4229
 
4242
4230
  ^^/CONDITION: has_rest_api^^
4243
4231
 
4244
4232
  ^^CONDITION: has_graphql_api^^
4245
4233
 
4246
- ````graphql
4234
+ ```graphql
4247
4235
  # GraphQL Schema
4248
4236
  {{graphql_schema}}
4249
- ```text
4237
+ ```
4250
4238
 
4251
4239
  ^^/CONDITION: has_graphql_api^^
4252
4240
 
@@ -4259,7 +4247,7 @@ servers:
4259
4247
  trpc_routers;
4260
4248
  }
4261
4249
  }
4262
- ````
4250
+ ```
4263
4251
 
4264
4252
  ^^/CONDITION: has_trpc_api^^
4265
4253
 
@@ -4404,19 +4392,19 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4404
4392
 
4405
4393
  **Component Organization:**
4406
4394
 
4407
- `````text
4408
- {{component_structure}}
4409
4395
  ```text
4396
+ {{component_structure}}
4397
+ ```
4410
4398
 
4411
4399
  **Component Template:**
4412
4400
 
4413
- ````typescript
4401
+ ```typescript
4414
4402
  {
4415
4403
  {
4416
4404
  component_template;
4417
4405
  }
4418
4406
  }
4419
- ```text
4407
+ ```
4420
4408
 
4421
4409
  ### State Management Architecture
4422
4410
 
@@ -4430,7 +4418,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4430
4418
  state_structure;
4431
4419
  }
4432
4420
  }
4433
- `````
4421
+ ```
4434
4422
 
4435
4423
  **State Management Patterns:**
4436
4424
 
@@ -4445,17 +4433,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4445
4433
 
4446
4434
  ```text
4447
4435
  {{route_structure}}
4448
- ```text
4436
+ ```
4449
4437
 
4450
4438
  **Protected Route Pattern:**
4451
4439
 
4452
- ````typescript
4440
+ ```typescript
4453
4441
  {
4454
4442
  {
4455
4443
  protected_route_example;
4456
4444
  }
4457
4445
  }
4458
- ```text
4446
+ ```
4459
4447
 
4460
4448
  ### Frontend Services Layer
4461
4449
 
@@ -4469,17 +4457,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4469
4457
  api_client_setup;
4470
4458
  }
4471
4459
  }
4472
- ````
4460
+ ```
4473
4461
 
4474
4462
  **Service Example:**
4475
4463
 
4476
- ````typescript
4464
+ ```typescript
4477
4465
  {
4478
4466
  {
4479
4467
  service_example;
4480
4468
  }
4481
4469
  }
4482
- ```text
4470
+ ```
4483
4471
 
4484
4472
  ## Backend Architecture
4485
4473
 
@@ -4494,11 +4482,11 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4494
4482
  ^^CONDITION: serverless^^
4495
4483
  **Function Organization:**
4496
4484
 
4497
- ````
4485
+ ```text
4498
4486
 
4499
4487
  {{function_structure}}
4500
4488
 
4501
- ````text
4489
+ ```
4502
4490
 
4503
4491
  **Function Template:**
4504
4492
 
@@ -4508,26 +4496,26 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4508
4496
  function_template;
4509
4497
  }
4510
4498
  }
4511
- ````
4499
+ ```
4512
4500
 
4513
4501
  ^^/CONDITION: serverless^^
4514
4502
 
4515
4503
  ^^CONDITION: traditional_server^^
4516
4504
  **Controller/Route Organization:**
4517
4505
 
4518
- `````text
4519
- {{controller_structure}}
4520
4506
  ```text
4507
+ {{controller_structure}}
4508
+ ```
4521
4509
 
4522
4510
  **Controller Template:**
4523
4511
 
4524
- ````typescript
4512
+ ```typescript
4525
4513
  {
4526
4514
  {
4527
4515
  controller_template;
4528
4516
  }
4529
4517
  }
4530
- ```text
4518
+ ```
4531
4519
 
4532
4520
  ^^/CONDITION: traditional_server^^
4533
4521
 
@@ -4539,17 +4527,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4539
4527
 
4540
4528
  ```sql
4541
4529
  {{database_schema}}
4542
- `````
4530
+ ```
4543
4531
 
4544
4532
  **Data Access Layer:**
4545
4533
 
4546
- ````typescript
4534
+ ```typescript
4547
4535
  {
4548
4536
  {
4549
4537
  repository_pattern;
4550
4538
  }
4551
4539
  }
4552
- ```text
4540
+ ```
4553
4541
 
4554
4542
  ### Authentication and Authorization
4555
4543
 
@@ -4559,17 +4547,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4559
4547
 
4560
4548
  ```mermaid
4561
4549
  {{auth_flow_diagram}}
4562
- ````
4550
+ ```
4563
4551
 
4564
4552
  **Middleware/Guards:**
4565
4553
 
4566
- ````typescript
4554
+ ```typescript
4567
4555
  {
4568
4556
  {
4569
4557
  auth_middleware;
4570
4558
  }
4571
4559
  }
4572
- ```text
4560
+ ```
4573
4561
 
4574
4562
  ## Unified Project Structure
4575
4563
 
@@ -4629,7 +4617,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4629
4617
  ├── package.json # Root package.json
4630
4618
  ├── {{monorepo_config}} # Monorepo configuration
4631
4619
  └── README.md
4632
- ````
4620
+ ```
4633
4621
 
4634
4622
  @{example: vercel_structure}
4635
4623
  apps/
@@ -4651,19 +4639,19 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4651
4639
 
4652
4640
  **Prerequisites:**
4653
4641
 
4654
- ````bash
4642
+ ```bash
4655
4643
  {{prerequisites_commands}}
4656
- ```text
4644
+ ```
4657
4645
 
4658
4646
  **Initial Setup:**
4659
4647
 
4660
4648
  ```bash
4661
4649
  {{setup_commands}}
4662
- ````
4650
+ ```
4663
4651
 
4664
4652
  **Development Commands:**
4665
4653
 
4666
- ````bash
4654
+ ```bash
4667
4655
  # Start all services
4668
4656
  {{start_all_command}}
4669
4657
 
@@ -4675,7 +4663,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4675
4663
 
4676
4664
  # Run tests
4677
4665
  {{test_commands}}
4678
- ```text
4666
+ ```
4679
4667
 
4680
4668
  ### Environment Configuration
4681
4669
 
@@ -4690,7 +4678,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4690
4678
 
4691
4679
  # Shared
4692
4680
  {{shared_env_vars}}
4693
- ````
4681
+ ```
4694
4682
 
4695
4683
  ## Deployment Architecture
4696
4684
 
@@ -4713,9 +4701,9 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4713
4701
 
4714
4702
  ### CI/CD Pipeline
4715
4703
 
4716
- ````yaml
4704
+ ```yaml
4717
4705
  '[object Object]': null
4718
- ```text
4706
+ ```
4719
4707
 
4720
4708
  ### Environments
4721
4709
 
@@ -4773,7 +4761,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4773
4761
 
4774
4762
  ### Testing Pyramid
4775
4763
 
4776
- ````
4764
+ ```text
4777
4765
 
4778
4766
  E2E Tests
4779
4767
  / \
@@ -4782,17 +4770,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4782
4770
  / \
4783
4771
  Frontend Unit Backend Unit
4784
4772
 
4785
- ```text
4773
+ ```
4786
4774
 
4787
4775
  ### Test Organization
4788
4776
 
4789
4777
  **Frontend Tests:**
4790
4778
 
4791
- ```
4779
+ ```text
4792
4780
 
4793
4781
  {{frontend_test_structure}}
4794
4782
 
4795
- ````text
4783
+ ```
4796
4784
 
4797
4785
  **Backend Tests:**
4798
4786
 
@@ -4800,15 +4788,15 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4800
4788
 
4801
4789
  {{backend_test_structure}}
4802
4790
 
4803
- ```text
4791
+ ```
4804
4792
 
4805
4793
  **E2E Tests:**
4806
4794
 
4807
- ````
4795
+ ```text
4808
4796
 
4809
4797
  {{e2e_test_structure}}
4810
4798
 
4811
- ````text
4799
+ ```
4812
4800
 
4813
4801
  ### Test Examples
4814
4802
 
@@ -4820,17 +4808,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4820
4808
  frontend_test_example;
4821
4809
  }
4822
4810
  }
4823
- ````
4811
+ ```
4824
4812
 
4825
4813
  **Backend API Test:**
4826
4814
 
4827
- ````typescript
4815
+ ```typescript
4828
4816
  {
4829
4817
  {
4830
4818
  backend_test_example;
4831
4819
  }
4832
4820
  }
4833
- ```text
4821
+ ```
4834
4822
 
4835
4823
  **E2E Test:**
4836
4824
 
@@ -4840,7 +4828,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4840
4828
  e2e_test_example;
4841
4829
  }
4842
4830
  }
4843
- ````
4831
+ ```
4844
4832
 
4845
4833
  ## Coding Standards
4846
4834
 
@@ -4881,9 +4869,9 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
4881
4869
 
4882
4870
  ### Error Flow
4883
4871
 
4884
- ````mermaid
4872
+ ```mermaid
4885
4873
  {{error_flow_diagram}}
4886
- ```text
4874
+ ```
4887
4875
 
4888
4876
  ### Error Response Format
4889
4877
 
@@ -4897,17 +4885,17 @@ interface ApiError {
4897
4885
  requestId: string;
4898
4886
  };
4899
4887
  }
4900
- ````
4888
+ ```
4901
4889
 
4902
4890
  ### Frontend Error Handling
4903
4891
 
4904
- ````typescript
4892
+ ```typescript
4905
4893
  {
4906
4894
  {
4907
4895
  frontend_error_handler;
4908
4896
  }
4909
4897
  }
4910
- ```text
4898
+ ```
4911
4899
 
4912
4900
  ### Backend Error Handling
4913
4901
 
@@ -4917,7 +4905,7 @@ interface ApiError {
4917
4905
  backend_error_handler;
4918
4906
  }
4919
4907
  }
4920
- ````
4908
+ ```
4921
4909
 
4922
4910
  ## Monitoring and Observability
4923
4911
 
@@ -6738,7 +6726,7 @@ Document sharded successfully:
6738
6726
  CRITICAL: Epics MUST be logically sequential following agile best practices:
6739
6727
 
6740
6728
  - Each epic should deliver a significant, end-to-end, fully deployable increment of testable functionality
6741
- - Epic 1 must establish foundational project infrastructure (app setup, Git, CI/CD, core services) unless we are adding new functionality to an existing app, while also delivering an initial piece of functionality, even as simple as a health-check route or display of a simple canary page
6729
+ - Epic 1 must establish foundational project infrastructure (app setup, Git, CI/CD, core services) unless we are adding new functionality to an existing app, while also delivering an initial piece of functionality, even as simple as a health-check route or display of a simple canary page - remember this when we produce the stories for the first epic!
6742
6730
  - Each subsequent epic builds upon previous epics' functionality delivering major blocks of functionality that provide tangible value to users or business when deployed
6743
6731
  - Not every project needs multiple epics, an epic needs to deliver value. For example, an API completed can deliver value even if a UI is not complete and planned for a separate epic.
6744
6732
  - Err on the side of less epics, but let the user know your rationale and offer options for splitting them if it seems some are too large or focused on disparate things.
@@ -6770,7 +6758,7 @@ CRITICAL: Epics MUST be logically sequential following agile best practices:
6770
6758
  [[LLM: CRITICAL STORY SEQUENCING REQUIREMENTS:
6771
6759
 
6772
6760
  - Stories within each epic MUST be logically sequential
6773
- - Each story should be a "vertical slice" delivering complete functionality
6761
+ - Each story should be a "vertical slice" delivering complete functionality aside from early enabler stories for project foundation
6774
6762
  - No story should depend on work from a later story or epic
6775
6763
  - Identify and note any direct prerequisite stories
6776
6764
  - Focus on "what" and "why" not "how" (leave technical implementation to Architect) yet be precise enough to support a logical sequential order of operations from story to story.
@@ -7065,621 +7053,157 @@ so that {{benefit}}.
7065
7053
  <</REPEAT>>
7066
7054
  ==================== END: templates#brownfield-prd-tmpl ====================
7067
7055
 
7068
- ==================== START: templates#simple-project-prd-tmpl ====================
7069
- # {{Project Name}} Product Requirements Document (PRD)
7070
-
7071
- [[LLM: If available, review any provided document or ask if any are optionally available: Project Brief]]
7056
+ ==================== START: checklists#pm-checklist ====================
7057
+ # Product Manager (PM) Requirements Checklist
7072
7058
 
7073
- ## Goals and Background Context
7059
+ 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.
7074
7060
 
7075
- [[LLM: Populate the 2 child sections based on what we have received from user description or the provided brief. Allow user to review the 2 sections and offer changes before proceeding]]
7061
+ [[LLM: INITIALIZATION INSTRUCTIONS - PM CHECKLIST
7076
7062
 
7077
- ### Goals
7063
+ Before proceeding with this checklist, ensure you have access to:
7078
7064
 
7079
- [[LLM: Bullet list of 1 line desired outcomes the PRD will deliver if successful - user and project desires]]
7065
+ 1. prd.md - The Product Requirements Document (check docs/prd.md)
7066
+ 2. Any user research, market analysis, or competitive analysis documents
7067
+ 3. Business goals and strategy documents
7068
+ 4. Any existing epic definitions or user stories
7080
7069
 
7081
- ### Background Context
7070
+ IMPORTANT: If the PRD is missing, immediately ask the user for its location or content before proceeding.
7082
7071
 
7083
- [[LLM: 1-2 short paragraphs summarizing the background context, such as what we learned in the brief without being redundant with the goals, what and why this solves a problem, what the current landscape or need is etc...]]
7072
+ VALIDATION APPROACH:
7084
7073
 
7085
- ### Change Log
7074
+ 1. User-Centric - Every requirement should tie back to user value
7075
+ 2. MVP Focus - Ensure scope is truly minimal while viable
7076
+ 3. Clarity - Requirements should be unambiguous and testable
7077
+ 4. Completeness - All aspects of the product vision are covered
7078
+ 5. Feasibility - Requirements are technically achievable
7086
7079
 
7087
- [[LLM: Track document versions and changes]]
7080
+ EXECUTION MODE:
7081
+ Ask the user if they want to work through the checklist:
7088
7082
 
7089
- | Date | Version | Description | Author |
7090
- | :--- | :------ | :---------- | :----- |
7083
+ - Section by section (interactive mode) - Review each section, present findings, get confirmation before proceeding
7084
+ - All at once (comprehensive mode) - Complete full analysis and present comprehensive report at end]]
7091
7085
 
7092
- ## Requirements
7086
+ ## 1. PROBLEM DEFINITION & CONTEXT
7093
7087
 
7094
- [[LLM: Draft the list of functional and non functional requirements under the two child sections, and immediately execute tasks#advanced-elicitation display]]
7088
+ [[LLM: The foundation of any product is a clear problem statement. As you review this section:
7095
7089
 
7096
- ### Functional
7090
+ 1. Verify the problem is real and worth solving
7091
+ 2. Check that the target audience is specific, not "everyone"
7092
+ 3. Ensure success metrics are measurable, not vague aspirations
7093
+ 4. Look for evidence of user research, not just assumptions
7094
+ 5. Confirm the problem-solution fit is logical]]
7097
7095
 
7098
- [[LLM: Each Requirement will be a bullet markdown and an identifier sequence starting with FR`.]]
7099
- @{example: - FR6: The Todo List uses AI to detect and warn against adding potentially duplicate todo items that are worded differently.}
7096
+ ### 1.1 Problem Statement
7100
7097
 
7101
- ### Non Functional
7098
+ - [ ] Clear articulation of the problem being solved
7099
+ - [ ] Identification of who experiences the problem
7100
+ - [ ] Explanation of why solving this problem matters
7101
+ - [ ] Quantification of problem impact (if possible)
7102
+ - [ ] Differentiation from existing solutions
7102
7103
 
7103
- [[LLM: Each Requirement will be a bullet markdown and an identifier sequence starting with NFR`.]]
7104
- @{example: - NFR1: AWS service usage **must** aim to stay within free-tier limits where feasible.}
7104
+ ### 1.2 Business Goals & Success Metrics
7105
7105
 
7106
- ^^CONDITION: has_ui^^
7106
+ - [ ] Specific, measurable business objectives defined
7107
+ - [ ] Clear success metrics and KPIs established
7108
+ - [ ] Metrics are tied to user and business value
7109
+ - [ ] Baseline measurements identified (if applicable)
7110
+ - [ ] Timeframe for achieving goals specified
7107
7111
 
7108
- ## User Interface Design Goals
7112
+ ### 1.3 User Research & Insights
7109
7113
 
7110
- [[LLM: Capture high-level UI/UX vision to inform story creation and also generate a prompt for Lovable or V0 if the user would like either. Steps:
7114
+ - [ ] Target user personas clearly defined
7115
+ - [ ] User needs and pain points documented
7116
+ - [ ] User research findings summarized (if available)
7117
+ - [ ] Competitive analysis included
7118
+ - [ ] Market context provided
7111
7119
 
7112
- 1. Pre-fill all subsections with educated guesses based on project context
7113
- 2. Present the complete rendered section to user
7114
- 3. Clearly let the user know where assumptions were made
7115
- 4. Ask targeted questions for unclear/missing elements or areas needing more specification
7116
- 5. This is NOT detailed UI spec - focus on product vision and user goals
7117
- 6. After section completion, immediately apply `tasks#advanced-elicitation` protocol]]
7120
+ ## 2. MVP SCOPE DEFINITION
7118
7121
 
7119
- ### Overall UX Vision
7122
+ [[LLM: MVP scope is critical - too much and you waste resources, too little and you can't validate. Check:
7120
7123
 
7121
- ### Key Interaction Paradigms
7124
+ 1. Is this truly minimal? Challenge every feature
7125
+ 2. Does each feature directly address the core problem?
7126
+ 3. Are "nice-to-haves" clearly separated from "must-haves"?
7127
+ 4. Is the rationale for inclusion/exclusion documented?
7128
+ 5. Can you ship this in the target timeframe?]]
7122
7129
 
7123
- ### Core Screens and Views
7130
+ ### 2.1 Core Functionality
7124
7131
 
7125
- [[LLM: From a product perspective, what are the most critical screens or views necessary to deliver the the PRD values and goals? This is meant to be Conceptual High Level to Drive Rough Epic or User Stories]]
7132
+ - [ ] Essential features clearly distinguished from nice-to-haves
7133
+ - [ ] Features directly address defined problem statement
7134
+ - [ ] Each Epic ties back to specific user needs
7135
+ - [ ] Features and Stories are described from user perspective
7136
+ - [ ] Minimum requirements for success defined
7126
7137
 
7127
- @{example}
7138
+ ### 2.2 Scope Boundaries
7128
7139
 
7129
- - Login Screen
7130
- - Main Dashboard
7131
- - Item Detail Page
7132
- - Settings Page
7133
- @{/example}
7140
+ - [ ] Clear articulation of what is OUT of scope
7141
+ - [ ] Future enhancements section included
7142
+ - [ ] Rationale for scope decisions documented
7143
+ - [ ] MVP minimizes functionality while maximizing learning
7144
+ - [ ] Scope has been reviewed and refined multiple times
7134
7145
 
7135
- ### Accessibility: { None, WCAG, etc }
7146
+ ### 2.3 MVP Validation Approach
7136
7147
 
7137
- ### Branding
7148
+ - [ ] Method for testing MVP success defined
7149
+ - [ ] Initial user feedback mechanisms planned
7150
+ - [ ] Criteria for moving beyond MVP specified
7151
+ - [ ] Learning goals for MVP articulated
7152
+ - [ ] Timeline expectations set
7138
7153
 
7139
- [[LLM: Any known branding elements or style guides that must be incorporated?]]
7154
+ ## 3. USER EXPERIENCE REQUIREMENTS
7140
7155
 
7141
- @{example}
7156
+ [[LLM: UX requirements bridge user needs and technical implementation. Validate:
7142
7157
 
7143
- - Replicate the look and feel of early 1900s black and white cinema, including animated effects replicating film damage or projector glitches during page or state transitions.
7144
- - Attached is the full color pallet and tokens for our corporate branding.
7145
- @{/example}
7158
+ 1. User flows cover the primary use cases completely
7159
+ 2. Edge cases are identified (even if deferred)
7160
+ 3. Accessibility isn't an afterthought
7161
+ 4. Performance expectations are realistic
7162
+ 5. Error states and recovery are planned]]
7146
7163
 
7147
- ### Target Device and Platforms
7164
+ ### 3.1 User Journeys & Flows
7148
7165
 
7149
- @{example}
7150
- "Web Responsive, and all mobile platforms", "IPhone Only", "ASCII Windows Desktop"
7151
- @{/example}
7166
+ - [ ] Primary user flows documented
7167
+ - [ ] Entry and exit points for each flow identified
7168
+ - [ ] Decision points and branches mapped
7169
+ - [ ] Critical path highlighted
7170
+ - [ ] Edge cases considered
7152
7171
 
7153
- ^^/CONDITION: has_ui^^
7172
+ ### 3.2 Usability Requirements
7154
7173
 
7155
- ## Technical Assumptions
7174
+ - [ ] Accessibility considerations documented
7175
+ - [ ] Platform/device compatibility specified
7176
+ - [ ] Performance expectations from user perspective defined
7177
+ - [ ] Error handling and recovery approaches outlined
7178
+ - [ ] User feedback mechanisms identified
7156
7179
 
7157
- [[LLM: Gather technical decisions that will be used for this simple technical PRD that includes architecture decisions. Steps:
7180
+ ### 3.3 UI Requirements
7158
7181
 
7159
- 1. Check if `data#technical-preferences` or an attached `technical-preferences` file exists - use it to pre-populate choices
7160
- 2. Ask user about: languages, frameworks, starter templates, libraries, APIs, deployment targets
7161
- 3. For unknowns, offer guidance based on project goals and MVP scope
7162
- 4. Document ALL technical choices with rationale (why this choice fits the project)
7163
- 5. These become constraints for the Architect - be specific and complete
7164
- 6. After section completion, apply `tasks#advanced-elicitation` protocol.]]
7182
+ - [ ] Information architecture outlined
7183
+ - [ ] Critical UI components identified
7184
+ - [ ] Visual design guidelines referenced (if applicable)
7185
+ - [ ] Content requirements specified
7186
+ - [ ] High-level navigation structure defined
7165
7187
 
7166
- ### Repository Structure: { Monorepo, Polyrepo, etc...}
7188
+ ## 4. FUNCTIONAL REQUIREMENTS
7167
7189
 
7168
- ### Service Architecture
7190
+ [[LLM: Functional requirements must be clear enough for implementation. Check:
7169
7191
 
7170
- [[LLM: CRITICAL DECISION - Document the high-level service architecture (e.g., Monolith, Microservices, Serverless functions within a Monorepo).]]
7192
+ 1. Requirements focus on WHAT not HOW (no implementation details)
7193
+ 2. Each requirement is testable (how would QA verify it?)
7194
+ 3. Dependencies are explicit (what needs to be built first?)
7195
+ 4. Requirements use consistent terminology
7196
+ 5. Complex features are broken into manageable pieces]]
7171
7197
 
7172
- ## Testing requirements
7198
+ ### 4.1 Feature Completeness
7173
7199
 
7174
- [[LLM: CRITICAL DECISION - Document the testing requirements, unit only, integration, e2e, manual, need for manual testing convenience methods).]]
7200
+ - [ ] All required features for MVP documented
7201
+ - [ ] Features have clear, user-focused descriptions
7202
+ - [ ] Feature priority/criticality indicated
7203
+ - [ ] Requirements are testable and verifiable
7204
+ - [ ] Dependencies between features identified
7175
7205
 
7176
- ### Additional Technical Assumptions and Requests
7177
-
7178
- [[LLM: Throughout the entire process of drafting this document, if any other technical assumptions are raised or discovered appropriate for the architect, add them here as additional bulleted items]]
7179
-
7180
- ## Data Models
7181
-
7182
- [[LLM: Define the core data models/entities that will be used in the front end (if there is one), core application or back end, and if both, shared between frontend and backend:
7183
-
7184
- 1. Review PRD requirements and identify key business entities
7185
- 2. For each model, explain its purpose and relationships
7186
- 3. Include key attributes and data types
7187
- 4. Show relationships between models
7188
- 5. Create TypeScript interfaces that can be shared
7189
- 6. Discuss design decisions with user
7190
-
7191
- Create a clear conceptual model before moving to database schema.
7192
-
7193
- After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
7194
-
7195
- <<REPEAT: data_model>>
7196
-
7197
- ### {{model_name}}
7198
-
7199
- **Purpose:** {{model_purpose}}
7200
-
7201
- **Key Attributes:**
7202
-
7203
- - {{attribute_1}}: {{type_1}} - {{description_1}}
7204
- - {{attribute_2}}: {{type_2}} - {{description_2}}
7205
-
7206
- **TypeScript Interface:**
7207
-
7208
- ````typescript
7209
- {
7210
- {
7211
- model_interface;
7212
- }
7213
- }
7214
- ```text
7215
-
7216
- **Relationships:**
7217
-
7218
- - {{relationship_1}}
7219
- - {{relationship_2}}
7220
- <</REPEAT>>
7221
-
7222
- @{example: data_model}
7223
-
7224
- ### User
7225
-
7226
- **Purpose:** Represents authenticated users in the system
7227
-
7228
- **Key Attributes:**
7229
-
7230
- - id: string - Unique identifier
7231
- - email: string - User's email address
7232
- - name: string - Display name
7233
- - role: enum - User permission level
7234
- - timestamps: Date - Created and updated times
7235
-
7236
- **TypeScript Interface:**
7237
-
7238
- ```typescript
7239
- interface User {
7240
- id: string;
7241
- email: string;
7242
- name: string;
7243
- role: "admin" | "user" | "guest";
7244
- createdAt: Date;
7245
- updatedAt: Date;
7246
- profile?: UserProfile;
7247
- }
7248
-
7249
- interface UserProfile {
7250
- avatarUrl?: string;
7251
- bio?: string;
7252
- preferences: Record<string, any>;
7253
- }
7254
- ````
7255
-
7256
- **Relationships:**
7257
-
7258
- - Has many Posts (1:n)
7259
- - Has one Profile (1:1)
7260
- @{/example}
7261
-
7262
- ## REST API Spec
7263
-
7264
- [[LLM: Based on the chosen API style from Tech Stack:
7265
-
7266
- 1. If REST API, create an OpenAPI 3.0 specification
7267
- 2. If GraphQL, provide the GraphQL schema
7268
- 3. If tRPC, show router definitions
7269
- 4. Include all endpoints from epics/stories
7270
- 5. Define request/response schemas based on data models
7271
- 6. Document authentication requirements
7272
- 7. Include example requests/responses
7273
-
7274
- Use appropriate format for the chosen API style. If no API (e.g., static site), skip this section.]]
7275
-
7276
- ^^CONDITION: has_rest_api^^
7277
-
7278
- ````yml
7279
- openapi: 3.0.0
7280
- info:
7281
- title:
7282
- '[object Object]': null
7283
- version:
7284
- '[object Object]': null
7285
- description:
7286
- '[object Object]': null
7287
- servers:
7288
- - url:
7289
- '[object Object]': null
7290
- description:
7291
- '[object Object]': null
7292
- ```text
7293
-
7294
- ^^/CONDITION: has_rest_api^^
7295
-
7296
- ^^CONDITION: has_graphql_api^^
7297
-
7298
- ```graphql
7299
- # GraphQL Schema
7300
- {{graphql_schema}}
7301
- ````
7302
-
7303
- ^^/CONDITION: has_graphql_api^^
7304
-
7305
- ^^CONDITION: has_trpc_api^^
7306
-
7307
- ```typescript
7308
- // tRPC Router Definitions
7309
- {
7310
- {
7311
- trpc_routers;
7312
- }
7313
- }
7314
- ```
7315
-
7316
- ^^/CONDITION: has_trpc_api^^
7317
-
7318
- [[LLM: After presenting the API spec (or noting its absence if not applicable), apply `tasks#advanced-elicitation` protocol]]
7319
-
7320
- ## Components
7321
-
7322
- [[LLM: Based on the architectural patterns, tech stack, and data models from above:
7323
-
7324
- 1. Identify major logical components/services across the fullstack
7325
- 2. Consider both frontend and backend components
7326
- 3. Define clear boundaries and interfaces between components
7327
- 4. For each component, specify:
7328
-
7329
- - Primary responsibility
7330
- - Key interfaces/APIs exposed
7331
- - Dependencies on other components
7332
- - Technology specifics based on tech stack choices
7333
-
7334
- 5. Create component diagrams where helpful
7335
- 6. After presenting all components, apply `tasks#advanced-elicitation` protocol]]
7336
-
7337
- <<REPEAT: component>>
7338
-
7339
- ### {{component_name}}
7340
-
7341
- **Responsibility:** {{component_description}}
7342
-
7343
- **Key Interfaces:**
7344
-
7345
- - {{interface_1}}
7346
- - {{interface_2}}
7347
-
7348
- **Dependencies:** {{dependencies}}
7349
-
7350
- **Technology Stack:** {{component_tech_details}}
7351
- <</REPEAT>>
7352
-
7353
- ### Component Diagrams
7354
-
7355
- [[LLM: Create Mermaid diagrams to visualize component relationships. Options:
7356
-
7357
- - C4 Container diagram for high-level view
7358
- - Component diagram for detailed internal structure
7359
- - Sequence diagrams for complex interactions
7360
- Choose the most appropriate for clarity
7361
-
7362
- After presenting the diagrams, apply `tasks#advanced-elicitation` protocol]]
7363
-
7364
- ## External APIs
7365
-
7366
- [[LLM: For each external service integration:
7367
-
7368
- 1. Identify APIs needed based on PRD requirements and component design
7369
- 2. If documentation URLs are unknown, ask user for specifics
7370
- 3. Document authentication methods and security considerations
7371
- 4. List specific endpoints that will be used
7372
- 5. Note any rate limits or usage constraints
7373
-
7374
- If no external APIs are needed, state this explicitly and skip to next section.]]
7375
-
7376
- ^^CONDITION: has_external_apis^^
7377
-
7378
- <<REPEAT: external_api>>
7379
-
7380
- ### {{api_name}} API
7381
-
7382
- - **Purpose:** {{api_purpose}}
7383
- - **Documentation:** {{api_docs_url}}
7384
- - **Base URL(s):** {{api_base_url}}
7385
- - **Authentication:** {{auth_method}}
7386
- - **Rate Limits:** {{rate_limits}}
7387
-
7388
- **Key Endpoints Used:**
7389
- <<REPEAT: endpoint>>
7390
-
7391
- - `{{method}} {{endpoint_path}}` - {{endpoint_purpose}}
7392
- <</REPEAT>>
7393
-
7394
- **Integration Notes:** {{integration_considerations}}
7395
- <</REPEAT>>
7396
-
7397
- @{example: external_api}
7398
-
7399
- ### Stripe API
7400
-
7401
- - **Purpose:** Payment processing and subscription management
7402
- - **Documentation:** https://stripe.com/docs/api
7403
- - **Base URL(s):** `https://api.stripe.com/v1`
7404
- - **Authentication:** Bearer token with secret key
7405
- - **Rate Limits:** 100 requests per second
7406
-
7407
- **Key Endpoints Used:**
7408
-
7409
- - `POST /customers` - Create customer profiles
7410
- - `POST /payment_intents` - Process payments
7411
- - `POST /subscriptions` - Manage subscriptions
7412
- @{/example}
7413
-
7414
- ^^/CONDITION: has_external_apis^^
7415
-
7416
- [[LLM: After presenting external APIs (or noting their absence), apply `tasks#advanced-elicitation` protocol]]
7417
-
7418
- ## Coding Standards
7419
-
7420
- [[LLM: Define MINIMAL but CRITICAL standards for AI agents. Focus only on project-specific rules that prevent common mistakes. These will be used by dev agents.
7421
-
7422
- After presenting this section, apply `tasks#advanced-elicitation` protocol]]
7423
-
7424
- ### Critical Fullstack Rules
7425
-
7426
- <<REPEAT: critical_rule>>
7427
-
7428
- - **{{rule_name}}:** {{rule_description}}
7429
- <</REPEAT>>
7430
-
7431
- @{example: critical_rules}
7432
-
7433
- - **Type Sharing:** Always define types in packages/shared and import from there
7434
- - **API Calls:** Never make direct HTTP calls - use the service layer
7435
- - **Environment Variables:** Access only through config objects, never process.env directly
7436
- - **Error Handling:** All API routes must use the standard error handler
7437
- - **State Updates:** Never mutate state directly - use proper state management patterns
7438
- @{/example}
7439
-
7440
- ### Naming Conventions
7441
-
7442
- | Element | Frontend | Backend | Example |
7443
- | :-------------- | :------------------- | :--------- | :------------------ |
7444
- | Components | PascalCase | - | `UserProfile.tsx` |
7445
- | Hooks | camelCase with 'use' | - | `useAuth.ts` |
7446
- | API Routes | - | kebab-case | `/api/user-profile` |
7447
- | Database Tables | - | snake_case | `user_profiles` |
7448
-
7449
- ## Epics
7450
-
7451
- [[LLM: First, present a high-level list of all epics for user approval, the epic_list and immediately execute tasks#advanced-elicitation display. Each epic should have a title and a short (1 sentence) goal statement. This allows the user to review the overall structure before diving into details.
7452
-
7453
- CRITICAL: Epics MUST be logically sequential following agile best practices:
7454
-
7455
- - Each epic should deliver a significant, end-to-end, fully deployable increment of testable functionality
7456
- - Epic 1 must establish foundational project infrastructure (app setup, Git, CI/CD, core services) unless we are adding new functionality to an existing app, while also delivering an initial piece of functionality, even as simple as a health-check route or display of a simple canary page
7457
- - Each subsequent epic builds upon previous epics' functionality delivering major blocks of functionality that provide tangible value to users or business when deployed
7458
- - Not every project needs multiple epics, an epic needs to deliver value. For example, an API completed can deliver value even if a UI is not complete and planned for a separate epic.
7459
- - Err on the side of less epics, but let the user know your rationale and offer options for splitting them if it seems some are too large or focused on disparate things.
7460
- - Cross Cutting Concerns should flow through epics and stories and not be final stories. For example, adding a logging framework as a last story of an epic, or at the end of a project as a final epic or story would be terrible as we would not have logging from the beginning.]]
7461
-
7462
- <<REPEAT: epic_list>>
7463
-
7464
- - Epic{{epic_number}} {{epic_title}}: {{short_goal}}
7465
-
7466
- <</REPEAT>>
7467
-
7468
- @{example: epic_list}
7469
-
7470
- 1. Foundation & Core Infrastructure: Establish project setup, authentication, and basic user management
7471
- 2. Core Business Entities: Create and manage primary domain objects with CRUD operations
7472
- 3. User Workflows & Interactions: Enable key user journeys and business processes
7473
- 4. Reporting & Analytics: Provide insights and data visualization for users
7474
-
7475
- @{/example}
7476
-
7477
- [[LLM: After the epic list is approved, present each `epic_details` with all its stories and acceptance criteria as a complete review unit and immediately execute tasks#advanced-elicitation display, before moving on to the next epic.]]
7478
-
7479
- <<REPEAT: epic_details>>
7480
-
7481
- ## Epic {{epic_number}} {{epic_title}}
7482
-
7483
- {{epic_goal}} [[LLM: Expanded goal - 2-3 sentences describing the objective and value all the stories will achieve]]
7484
-
7485
- [[LLM: CRITICAL STORY SEQUENCING REQUIREMENTS:
7486
-
7487
- - Stories within each epic MUST be logically sequential
7488
- - Each story should be a "vertical slice" delivering complete functionality
7489
- - No story should depend on work from a later story or epic
7490
- - Identify and note any direct prerequisite stories
7491
- - Focus on "what" and "why" not "how" (leave technical implementation to Architect) yet be precise enough to support a logical sequential order of operations from story to story.
7492
- - Ensure each story delivers clear user or business value, try to avoid enablers and build them into stories that deliver value.
7493
- - Size stories for AI agent execution: Each story must be completable by a single AI agent in one focused session without context overflow
7494
- - Think "junior developer working for 2-4 hours" - stories must be small, focused, and self-contained
7495
- - If a story seems complex, break it down further as long as it can deliver a vertical slice
7496
- - Each story should result in working, testable code before the agent's context window fills]]
7497
-
7498
- <<REPEAT: story>>
7499
-
7500
- ### Story {{epic_number}}.{{story_number}} {{story_title}}
7501
-
7502
- As a {{user_type}},
7503
- I want {{action}},
7504
- so that {{benefit}}.
7505
-
7506
- #### Acceptance Criteria
7507
-
7508
- [[LLM: Define clear, comprehensive, and testable acceptance criteria that:
7509
-
7510
- - Precisely define what "done" means from a functional perspective
7511
- - Are unambiguous and serve as basis for verification
7512
- - Include any critical non-functional requirements from the PRD
7513
- - Consider local testability for backend/data components
7514
- - Specify UI/UX requirements and framework adherence where applicable
7515
- - Avoid cross-cutting concerns that should be in other stories or PRD sections]]
7516
-
7517
- <<REPEAT: criteria>>
7518
-
7519
- - {{criterion number}}: {{criteria}}
7520
-
7521
- <</REPEAT>>
7522
- <</REPEAT>>
7523
- <</REPEAT>>
7524
-
7525
- ## Next Steps
7526
-
7527
- ### Design Architect Prompt
7528
-
7529
- [[LLM: This section will contain the prompt for the Design Architect, keep it short and to the point to initiate create architecture mode using this document as input.]]
7530
- ==================== END: templates#simple-project-prd-tmpl ====================
7531
-
7532
- ==================== START: checklists#pm-checklist ====================
7533
- # Product Manager (PM) Requirements Checklist
7534
-
7535
- 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.
7536
-
7537
- [[LLM: INITIALIZATION INSTRUCTIONS - PM CHECKLIST
7538
-
7539
- Before proceeding with this checklist, ensure you have access to:
7540
-
7541
- 1. prd.md - The Product Requirements Document (check docs/prd.md)
7542
- 2. Any user research, market analysis, or competitive analysis documents
7543
- 3. Business goals and strategy documents
7544
- 4. Any existing epic definitions or user stories
7545
-
7546
- IMPORTANT: If the PRD is missing, immediately ask the user for its location or content before proceeding.
7547
-
7548
- VALIDATION APPROACH:
7549
-
7550
- 1. User-Centric - Every requirement should tie back to user value
7551
- 2. MVP Focus - Ensure scope is truly minimal while viable
7552
- 3. Clarity - Requirements should be unambiguous and testable
7553
- 4. Completeness - All aspects of the product vision are covered
7554
- 5. Feasibility - Requirements are technically achievable
7555
-
7556
- EXECUTION MODE:
7557
- Ask the user if they want to work through the checklist:
7558
-
7559
- - Section by section (interactive mode) - Review each section, present findings, get confirmation before proceeding
7560
- - All at once (comprehensive mode) - Complete full analysis and present comprehensive report at end]]
7561
-
7562
- ## 1. PROBLEM DEFINITION & CONTEXT
7563
-
7564
- [[LLM: The foundation of any product is a clear problem statement. As you review this section:
7565
-
7566
- 1. Verify the problem is real and worth solving
7567
- 2. Check that the target audience is specific, not "everyone"
7568
- 3. Ensure success metrics are measurable, not vague aspirations
7569
- 4. Look for evidence of user research, not just assumptions
7570
- 5. Confirm the problem-solution fit is logical]]
7571
-
7572
- ### 1.1 Problem Statement
7573
-
7574
- - [ ] Clear articulation of the problem being solved
7575
- - [ ] Identification of who experiences the problem
7576
- - [ ] Explanation of why solving this problem matters
7577
- - [ ] Quantification of problem impact (if possible)
7578
- - [ ] Differentiation from existing solutions
7579
-
7580
- ### 1.2 Business Goals & Success Metrics
7581
-
7582
- - [ ] Specific, measurable business objectives defined
7583
- - [ ] Clear success metrics and KPIs established
7584
- - [ ] Metrics are tied to user and business value
7585
- - [ ] Baseline measurements identified (if applicable)
7586
- - [ ] Timeframe for achieving goals specified
7587
-
7588
- ### 1.3 User Research & Insights
7589
-
7590
- - [ ] Target user personas clearly defined
7591
- - [ ] User needs and pain points documented
7592
- - [ ] User research findings summarized (if available)
7593
- - [ ] Competitive analysis included
7594
- - [ ] Market context provided
7595
-
7596
- ## 2. MVP SCOPE DEFINITION
7597
-
7598
- [[LLM: MVP scope is critical - too much and you waste resources, too little and you can't validate. Check:
7599
-
7600
- 1. Is this truly minimal? Challenge every feature
7601
- 2. Does each feature directly address the core problem?
7602
- 3. Are "nice-to-haves" clearly separated from "must-haves"?
7603
- 4. Is the rationale for inclusion/exclusion documented?
7604
- 5. Can you ship this in the target timeframe?]]
7605
-
7606
- ### 2.1 Core Functionality
7607
-
7608
- - [ ] Essential features clearly distinguished from nice-to-haves
7609
- - [ ] Features directly address defined problem statement
7610
- - [ ] Each Epic ties back to specific user needs
7611
- - [ ] Features and Stories are described from user perspective
7612
- - [ ] Minimum requirements for success defined
7613
-
7614
- ### 2.2 Scope Boundaries
7615
-
7616
- - [ ] Clear articulation of what is OUT of scope
7617
- - [ ] Future enhancements section included
7618
- - [ ] Rationale for scope decisions documented
7619
- - [ ] MVP minimizes functionality while maximizing learning
7620
- - [ ] Scope has been reviewed and refined multiple times
7621
-
7622
- ### 2.3 MVP Validation Approach
7623
-
7624
- - [ ] Method for testing MVP success defined
7625
- - [ ] Initial user feedback mechanisms planned
7626
- - [ ] Criteria for moving beyond MVP specified
7627
- - [ ] Learning goals for MVP articulated
7628
- - [ ] Timeline expectations set
7629
-
7630
- ## 3. USER EXPERIENCE REQUIREMENTS
7631
-
7632
- [[LLM: UX requirements bridge user needs and technical implementation. Validate:
7633
-
7634
- 1. User flows cover the primary use cases completely
7635
- 2. Edge cases are identified (even if deferred)
7636
- 3. Accessibility isn't an afterthought
7637
- 4. Performance expectations are realistic
7638
- 5. Error states and recovery are planned]]
7639
-
7640
- ### 3.1 User Journeys & Flows
7641
-
7642
- - [ ] Primary user flows documented
7643
- - [ ] Entry and exit points for each flow identified
7644
- - [ ] Decision points and branches mapped
7645
- - [ ] Critical path highlighted
7646
- - [ ] Edge cases considered
7647
-
7648
- ### 3.2 Usability Requirements
7649
-
7650
- - [ ] Accessibility considerations documented
7651
- - [ ] Platform/device compatibility specified
7652
- - [ ] Performance expectations from user perspective defined
7653
- - [ ] Error handling and recovery approaches outlined
7654
- - [ ] User feedback mechanisms identified
7655
-
7656
- ### 3.3 UI Requirements
7657
-
7658
- - [ ] Information architecture outlined
7659
- - [ ] Critical UI components identified
7660
- - [ ] Visual design guidelines referenced (if applicable)
7661
- - [ ] Content requirements specified
7662
- - [ ] High-level navigation structure defined
7663
-
7664
- ## 4. FUNCTIONAL REQUIREMENTS
7665
-
7666
- [[LLM: Functional requirements must be clear enough for implementation. Check:
7667
-
7668
- 1. Requirements focus on WHAT not HOW (no implementation details)
7669
- 2. Each requirement is testable (how would QA verify it?)
7670
- 3. Dependencies are explicit (what needs to be built first?)
7671
- 4. Requirements use consistent terminology
7672
- 5. Complex features are broken into manageable pieces]]
7673
-
7674
- ### 4.1 Feature Completeness
7675
-
7676
- - [ ] All required features for MVP documented
7677
- - [ ] Features have clear, user-focused descriptions
7678
- - [ ] Feature priority/criticality indicated
7679
- - [ ] Requirements are testable and verifiable
7680
- - [ ] Dependencies between features identified
7681
-
7682
- ### 4.2 Requirements Quality
7206
+ ### 4.2 Requirements Quality
7683
7207
 
7684
7208
  - [ ] Requirements are specific and unambiguous
7685
7209
  - [ ] Requirements focus on WHAT not HOW
@@ -9156,7 +8680,7 @@ Create subsections for each major flow. After presenting all flows, apply `tasks
9156
8680
 
9157
8681
  ```mermaid
9158
8682
  {{flow_diagram}}
9159
- ```text
8683
+ ```
9160
8684
 
9161
8685
  **Edge Cases & Error Handling:**
9162
8686
 
@@ -9450,16 +8974,11 @@ workflow:
9450
8974
  - modernization
9451
8975
  - integration-enhancement
9452
8976
 
9453
- # For Complex Enhancements (Multiple Stories, Architectural Changes)
9454
- complex_enhancement_sequence:
9455
- - step: scope_assessment
9456
- agent: any
9457
- action: assess complexity
9458
- notes: "First, assess if this is a simple change (use simple_enhancement_sequence) or complex enhancement requiring full planning."
9459
-
8977
+ sequence:
9460
8978
  - step: project_analysis
9461
- agent: analyst
9462
- action: analyze existing project
8979
+ agent: architect
8980
+ action: analyze existing project and use task document-project
8981
+ creates: multiple documents per the document-project template
9463
8982
  notes: "Review existing documentation, codebase structure, and identify integration points. Document current system understanding before proceeding."
9464
8983
 
9465
8984
  - agent: pm
@@ -9488,71 +9007,37 @@ workflow:
9488
9007
  action: move_to_ide
9489
9008
  notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
9490
9009
 
9491
- # For Simple Enhancements (1-3 Stories, Following Existing Patterns)
9492
- simple_enhancement_sequence:
9493
- - step: enhancement_type
9494
- action: choose approach
9495
- notes: "Choose between creating single story (very small change) or epic (1-3 related stories)."
9496
-
9497
- - agent: pm|po|sm
9498
- creates: brownfield_epic OR brownfield_story
9499
- uses: brownfield-create-epic OR brownfield-create-story
9500
- notes: "Create focused enhancement with existing system integration. Choose agent based on team preference and context."
9501
-
9502
- - workflow_end:
9503
- action: move_to_ide
9504
- notes: "Enhancement defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
9505
-
9506
9010
  flow_diagram: |
9507
9011
  ```mermaid
9508
9012
  graph TD
9509
- A[Start: Brownfield Enhancement] --> B{Enhancement Complexity?}
9510
- B -->|Complex/Significant| C[analyst: analyze existing project]
9511
- B -->|Simple| D{1 Story or 2-3 Stories?}
9512
-
9513
- C --> E[pm: brownfield-prd.md]
9514
- E --> F[architect: brownfield-architecture.md]
9515
- F --> G[po: validate with po-master-checklist]
9516
- G --> H{PO finds issues?}
9517
- H -->|Yes| I[Return to relevant agent for fixes]
9518
- H -->|No| J[Move to IDE Environment]
9519
- I --> G
9520
-
9521
- D -->|1 Story| K[pm/po/sm: brownfield-create-story]
9522
- D -->|2-3 Stories| L[pm/po/sm: brownfield-create-epic]
9523
- K --> M[Move to IDE Environment]
9524
- L --> M
9525
-
9526
- style J fill:#90EE90
9527
- style M fill:#90EE90
9528
- style E fill:#FFE4B5
9529
- style F fill:#FFE4B5
9530
- style K fill:#FFB6C1
9531
- style L fill:#FFB6C1
9013
+ A[Start: Brownfield Enhancement] --> B[analyst: analyze existing project]
9014
+ B --> C[pm: brownfield-prd.md]
9015
+ C --> D[architect: brownfield-architecture.md]
9016
+ D --> E[po: validate with po-master-checklist]
9017
+ E --> F{PO finds issues?}
9018
+ F -->|Yes| G[Return to relevant agent for fixes]
9019
+ F -->|No| H[Move to IDE Environment]
9020
+ G --> E
9021
+
9022
+ style H fill:#90EE90
9023
+ style C fill:#FFE4B5
9024
+ style D fill:#FFE4B5
9532
9025
  ```
9533
9026
 
9534
9027
  decision_guidance:
9535
- use_complex_sequence_when:
9536
- - Enhancement requires multiple coordinated stories (4+)
9028
+ when_to_use:
9029
+ - Enhancement requires coordinated stories
9537
9030
  - Architectural changes are needed
9538
9031
  - Significant integration work required
9539
9032
  - Risk assessment and mitigation planning necessary
9540
9033
  - Multiple team members will work on related changes
9541
9034
 
9542
- use_simple_sequence_when:
9543
- - Enhancement can be completed in 1-3 stories
9544
- - Follows existing project patterns
9545
- - Integration complexity is minimal
9546
- - Risk to existing system is low
9547
- - Change is isolated with clear boundaries
9548
-
9549
9035
  handoff_prompts:
9550
9036
  analyst_to_pm: "Existing project analysis complete. Create comprehensive brownfield PRD with integration strategy."
9551
9037
  pm_to_architect: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the integration architecture."
9552
9038
  architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for integration safety."
9553
9039
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
9554
- simple_to_ide: "Enhancement defined with existing system integration. Move to IDE environment to begin development."
9555
- complex_complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9040
+ complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9556
9041
  ==================== END: workflows#brownfield-fullstack ====================
9557
9042
 
9558
9043
  ==================== START: workflows#brownfield-service ====================
@@ -9570,16 +9055,11 @@ workflow:
9570
9055
  - performance-optimization
9571
9056
  - integration-enhancement
9572
9057
 
9573
- # For Complex Service Enhancements (Multiple Stories, Architectural Changes)
9574
- complex_enhancement_sequence:
9575
- - step: scope_assessment
9576
- agent: any
9577
- action: assess complexity
9578
- notes: "First, assess if this is a simple service change (use simple_enhancement_sequence) or complex enhancement requiring full planning."
9579
-
9058
+ sequence:
9580
9059
  - step: service_analysis
9581
- agent: analyst
9582
- action: analyze existing service
9060
+ agent: architect
9061
+ action: analyze existing project and use task document-project
9062
+ creates: multiple documents per the document-project template
9583
9063
  notes: "Review existing service documentation, codebase, performance metrics, and identify integration dependencies."
9584
9064
 
9585
9065
  - agent: pm
@@ -9608,71 +9088,37 @@ workflow:
9608
9088
  action: move_to_ide
9609
9089
  notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
9610
9090
 
9611
- # For Simple Service Enhancements (1-3 Stories, Following Existing Patterns)
9612
- simple_enhancement_sequence:
9613
- - step: enhancement_type
9614
- action: choose approach
9615
- notes: "Choose between creating single story (simple API endpoint) or epic (1-3 related service changes)."
9616
-
9617
- - agent: pm|po|sm
9618
- creates: brownfield_epic OR brownfield_story
9619
- uses: brownfield-create-epic OR brownfield-create-story
9620
- notes: "Create focused service enhancement with existing API integration. Choose agent based on team preference and context."
9621
-
9622
- - workflow_end:
9623
- action: move_to_ide
9624
- notes: "Service enhancement defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
9625
-
9626
9091
  flow_diagram: |
9627
9092
  ```mermaid
9628
9093
  graph TD
9629
- A[Start: Service Enhancement] --> B{Enhancement Complexity?}
9630
- B -->|Complex/Significant| C[analyst: analyze existing service]
9631
- B -->|Simple| D{1 Story or 2-3 Stories?}
9632
-
9633
- C --> E[pm: brownfield-prd.md]
9634
- E --> F[architect: brownfield-architecture.md]
9635
- F --> G[po: validate with po-master-checklist]
9636
- G --> H{PO finds issues?}
9637
- H -->|Yes| I[Return to relevant agent for fixes]
9638
- H -->|No| J[Move to IDE Environment]
9639
- I --> G
9640
-
9641
- D -->|1 Story| K[pm/po/sm: brownfield-create-story]
9642
- D -->|2-3 Stories| L[pm/po/sm: brownfield-create-epic]
9643
- K --> M[Move to IDE Environment]
9644
- L --> M
9645
-
9646
- style J fill:#90EE90
9647
- style M fill:#90EE90
9648
- style E fill:#FFE4B5
9649
- style F fill:#FFE4B5
9650
- style K fill:#FFB6C1
9651
- style L fill:#FFB6C1
9094
+ A[Start: Service Enhancement] --> B[analyst: analyze existing service]
9095
+ B --> C[pm: brownfield-prd.md]
9096
+ C --> D[architect: brownfield-architecture.md]
9097
+ D --> E[po: validate with po-master-checklist]
9098
+ E --> F{PO finds issues?}
9099
+ F -->|Yes| G[Return to relevant agent for fixes]
9100
+ F -->|No| H[Move to IDE Environment]
9101
+ G --> E
9102
+
9103
+ style H fill:#90EE90
9104
+ style C fill:#FFE4B5
9105
+ style D fill:#FFE4B5
9652
9106
  ```
9653
9107
 
9654
9108
  decision_guidance:
9655
- use_complex_sequence_when:
9656
- - Service enhancement requires multiple coordinated stories (4+)
9109
+ when_to_use:
9110
+ - Service enhancement requires coordinated stories
9657
9111
  - API versioning or breaking changes needed
9658
9112
  - Database schema changes required
9659
9113
  - Performance or scalability improvements needed
9660
9114
  - Multiple integration points affected
9661
9115
 
9662
- use_simple_sequence_when:
9663
- - Adding simple endpoints or modifying existing ones
9664
- - Enhancement follows existing service patterns
9665
- - API compatibility maintained
9666
- - Risk to existing service is low
9667
- - Change is isolated with clear boundaries
9668
-
9669
9116
  handoff_prompts:
9670
9117
  analyst_to_pm: "Service analysis complete. Create comprehensive brownfield PRD with service integration strategy."
9671
9118
  pm_to_architect: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the service architecture."
9672
9119
  architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for service integration safety."
9673
9120
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
9674
- simple_to_ide: "Service enhancement defined with existing API integration. Move to IDE environment to begin development."
9675
- complex_complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9121
+ complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9676
9122
  ==================== END: workflows#brownfield-service ====================
9677
9123
 
9678
9124
  ==================== START: workflows#brownfield-ui ====================
@@ -9689,16 +9135,11 @@ workflow:
9689
9135
  - design-refresh
9690
9136
  - frontend-enhancement
9691
9137
 
9692
- # For Complex UI Enhancements (Multiple Stories, Design Changes)
9693
- complex_enhancement_sequence:
9694
- - step: scope_assessment
9695
- agent: any
9696
- action: assess complexity
9697
- notes: "First, assess if this is a simple UI change (use simple_enhancement_sequence) or complex enhancement requiring full planning."
9698
-
9138
+ sequence:
9699
9139
  - step: ui_analysis
9700
- agent: analyst
9701
- action: analyze existing UI
9140
+ agent: architect
9141
+ action: analyze existing project and use task document-project
9142
+ creates: multiple documents per the document-project template
9702
9143
  notes: "Review existing frontend application, user feedback, analytics data, and identify improvement areas."
9703
9144
 
9704
9145
  - agent: pm
@@ -9735,74 +9176,40 @@ workflow:
9735
9176
  action: move_to_ide
9736
9177
  notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
9737
9178
 
9738
- # For Simple UI Enhancements (1-3 Stories, Following Existing Design)
9739
- simple_enhancement_sequence:
9740
- - step: enhancement_type
9741
- action: choose approach
9742
- notes: "Choose between creating single story (simple component change) or epic (1-3 related UI changes)."
9743
-
9744
- - agent: pm|po|sm
9745
- creates: brownfield_epic OR brownfield_story
9746
- uses: brownfield-create-epic OR brownfield-create-story
9747
- notes: "Create focused UI enhancement with existing design system integration. Choose agent based on team preference and context."
9748
-
9749
- - workflow_end:
9750
- action: move_to_ide
9751
- notes: "UI enhancement defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
9752
-
9753
9179
  flow_diagram: |
9754
9180
  ```mermaid
9755
9181
  graph TD
9756
- A[Start: UI Enhancement] --> B{Enhancement Complexity?}
9757
- B -->|Complex/Significant| C[analyst: analyze existing UI]
9758
- B -->|Simple| D{1 Story or 2-3 Stories?}
9759
-
9760
- C --> E[pm: brownfield-prd.md]
9761
- E --> F[ux-expert: front-end-spec.md]
9762
- F --> G[architect: brownfield-architecture.md]
9763
- G --> H[po: validate with po-master-checklist]
9764
- H --> I{PO finds issues?}
9765
- I -->|Yes| J[Return to relevant agent for fixes]
9766
- I -->|No| K[Move to IDE Environment]
9767
- J --> H
9768
-
9769
- D -->|1 Story| L[pm/po/sm: brownfield-create-story]
9770
- D -->|2-3 Stories| M[pm/po/sm: brownfield-create-epic]
9771
- L --> N[Move to IDE Environment]
9772
- M --> N
9773
-
9774
- style K fill:#90EE90
9775
- style N fill:#90EE90
9182
+ A[Start: UI Enhancement] --> B[analyst: analyze existing UI]
9183
+ B --> C[pm: brownfield-prd.md]
9184
+ C --> D[ux-expert: front-end-spec.md]
9185
+ D --> E[architect: brownfield-architecture.md]
9186
+ E --> F[po: validate with po-master-checklist]
9187
+ F --> G{PO finds issues?}
9188
+ G -->|Yes| H[Return to relevant agent for fixes]
9189
+ G -->|No| I[Move to IDE Environment]
9190
+ H --> F
9191
+
9192
+ style I fill:#90EE90
9193
+ style C fill:#FFE4B5
9194
+ style D fill:#FFE4B5
9776
9195
  style E fill:#FFE4B5
9777
- style F fill:#FFE4B5
9778
- style G fill:#FFE4B5
9779
- style L fill:#FFB6C1
9780
- style M fill:#FFB6C1
9781
9196
  ```
9782
9197
 
9783
9198
  decision_guidance:
9784
- use_complex_sequence_when:
9785
- - UI enhancement requires multiple coordinated stories (4+)
9199
+ when_to_use:
9200
+ - UI enhancement requires coordinated stories
9786
9201
  - Design system changes needed
9787
9202
  - New component patterns required
9788
9203
  - User research and testing needed
9789
9204
  - Multiple team members will work on related changes
9790
9205
 
9791
- use_simple_sequence_when:
9792
- - Enhancement can be completed in 1-3 stories
9793
- - Follows existing design patterns exactly
9794
- - Component changes are isolated
9795
- - Risk to existing UI is low
9796
- - Change maintains current user experience
9797
-
9798
9206
  handoff_prompts:
9799
9207
  analyst_to_pm: "UI analysis complete. Create comprehensive brownfield PRD with UI integration strategy."
9800
9208
  pm_to_ux: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the UI/UX specification."
9801
9209
  ux_to_architect: "UI/UX spec complete. Save it as docs/front-end-spec.md, then create the frontend architecture."
9802
9210
  architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for UI integration safety."
9803
9211
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
9804
- simple_to_ide: "UI enhancement defined with existing design integration. Move to IDE environment to begin development."
9805
- complex_complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9212
+ complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9806
9213
  ==================== END: workflows#brownfield-ui ====================
9807
9214
 
9808
9215
  ==================== START: workflows#greenfield-fullstack ====================
@@ -9820,8 +9227,7 @@ workflow:
9820
9227
  - prototype
9821
9228
  - mvp
9822
9229
 
9823
- # For Complex Projects (Production-Ready, Multiple Features)
9824
- complex_project_sequence:
9230
+ sequence:
9825
9231
  - agent: analyst
9826
9232
  creates: project-brief.md
9827
9233
  optional_steps:
@@ -9886,91 +9292,50 @@ workflow:
9886
9292
  action: move_to_ide
9887
9293
  notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
9888
9294
 
9889
- # For Simple Projects (Prototypes, MVPs, Quick Experiments)
9890
- simple_project_sequence:
9891
- - step: project_scope
9892
- action: assess complexity
9893
- notes: "First, assess if this needs full planning (use complex_project_sequence) or can be a simple prototype/MVP."
9894
-
9895
- - agent: analyst
9896
- creates: project-brief.md
9897
- optional_steps:
9898
- - brainstorming_session
9899
- notes: "Creates focused project brief for simple project. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
9900
-
9901
- - agent: pm
9902
- creates: simple-project-prd.md
9903
- uses: create doc simple-project-prd OR create-epic OR create-story
9904
- requires: project-brief.md
9905
- notes: "Create simple prd, simple epic or story instead of full PRD for rapid development. Choose based on scope."
9906
-
9907
- - workflow_end:
9908
- action: move_to_ide
9909
- notes: "Simple project defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
9910
-
9911
9295
  flow_diagram: |
9912
9296
  ```mermaid
9913
9297
  graph TD
9914
- A[Start: Greenfield Project] --> B{Project Complexity?}
9915
- B -->|Complex/Production| C[analyst: project-brief.md]
9916
- B -->|Simple/Prototype| D[analyst: focused project-brief.md]
9917
-
9918
- C --> E[pm: prd.md]
9919
- E --> F[ux-expert: front-end-spec.md]
9920
- F --> F2{Generate v0 prompt?}
9921
- F2 -->|Yes| F3[ux-expert: create v0 prompt]
9922
- F2 -->|No| G[architect: fullstack-architecture.md]
9923
- F3 --> F4[User: generate UI in v0/Lovable]
9924
- F4 --> G
9925
- G --> H{Architecture suggests PRD changes?}
9926
- H -->|Yes| I[pm: update prd.md]
9927
- H -->|No| J[po: validate all artifacts]
9928
- I --> J
9929
- J --> K{PO finds issues?}
9930
- K -->|Yes| L[Return to relevant agent for fixes]
9931
- K -->|No| M[Move to IDE Environment]
9932
- L --> J
9933
-
9934
- D --> N[pm: simple epic or story]
9935
- N --> O[Move to IDE Environment]
9936
-
9937
- C -.-> C1[Optional: brainstorming]
9938
- C -.-> C2[Optional: market research]
9939
- F -.-> F1[Optional: user research]
9940
- G -.-> G1[Optional: technical research]
9941
- D -.-> D1[Optional: brainstorming]
9942
-
9943
- style M fill:#90EE90
9944
- style O fill:#90EE90
9945
- style F3 fill:#E6E6FA
9946
- style F4 fill:#E6E6FA
9298
+ A[Start: Greenfield Project] --> B[analyst: project-brief.md]
9299
+ B --> C[pm: prd.md]
9300
+ C --> D[ux-expert: front-end-spec.md]
9301
+ D --> D2{Generate v0 prompt?}
9302
+ D2 -->|Yes| D3[ux-expert: create v0 prompt]
9303
+ D2 -->|No| E[architect: fullstack-architecture.md]
9304
+ D3 --> D4[User: generate UI in v0/Lovable]
9305
+ D4 --> E
9306
+ E --> F{Architecture suggests PRD changes?}
9307
+ F -->|Yes| G[pm: update prd.md]
9308
+ F -->|No| H[po: validate all artifacts]
9309
+ G --> H
9310
+ H --> I{PO finds issues?}
9311
+ I -->|Yes| J[Return to relevant agent for fixes]
9312
+ I -->|No| K[Move to IDE Environment]
9313
+ J --> H
9314
+
9315
+ B -.-> B1[Optional: brainstorming]
9316
+ B -.-> B2[Optional: market research]
9317
+ D -.-> D1[Optional: user research]
9318
+ E -.-> E1[Optional: technical research]
9319
+
9320
+ style K fill:#90EE90
9321
+ style D3 fill:#E6E6FA
9322
+ style D4 fill:#E6E6FA
9323
+ style B fill:#FFE4B5
9947
9324
  style C fill:#FFE4B5
9325
+ style D fill:#FFE4B5
9948
9326
  style E fill:#FFE4B5
9949
- style F fill:#FFE4B5
9950
- style G fill:#FFE4B5
9951
- style D fill:#FFB6C1
9952
- style N fill:#FFB6C1
9953
9327
  ```
9954
9328
 
9955
9329
  decision_guidance:
9956
- use_complex_sequence_when:
9330
+ when_to_use:
9957
9331
  - Building production-ready applications
9958
9332
  - Multiple team members will be involved
9959
- - Complex feature requirements (4+ stories)
9333
+ - Complex feature requirements
9960
9334
  - Need comprehensive documentation
9961
9335
  - Long-term maintenance expected
9962
9336
  - Enterprise or customer-facing applications
9963
9337
 
9964
- use_simple_sequence_when:
9965
- - Building prototypes or MVPs
9966
- - Solo developer or small team
9967
- - Simple requirements (1-3 stories)
9968
- - Quick experiments or proof-of-concepts
9969
- - Short-term or throwaway projects
9970
- - Learning or educational projects
9971
-
9972
9338
  handoff_prompts:
9973
- # Complex sequence prompts
9974
9339
  analyst_to_pm: "Project brief is complete. Save it as docs/project-brief.md in your project, then create the PRD."
9975
9340
  pm_to_ux: "PRD is ready. Save it as docs/prd.md in your project, then create the UI/UX specification."
9976
9341
  ux_to_architect: "UI/UX spec complete. Save it as docs/front-end-spec.md in your project, then create the fullstack architecture."
@@ -9978,11 +9343,7 @@ workflow:
9978
9343
  architect_to_pm: "Please update the PRD with the suggested story changes, then re-export the complete prd.md to docs/."
9979
9344
  updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
9980
9345
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
9981
- complex_complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9982
-
9983
- # Simple sequence prompts
9984
- simple_analyst_to_pm: "Focused project brief complete. Save it as docs/project-brief.md, then create simple epic or story for rapid development."
9985
- simple_complete: "Simple project defined. Move to IDE environment to begin development."
9346
+ complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
9986
9347
  ==================== END: workflows#greenfield-fullstack ====================
9987
9348
 
9988
9349
  ==================== START: workflows#greenfield-service ====================
@@ -10001,8 +9362,7 @@ workflow:
10001
9362
  - api-prototype
10002
9363
  - simple-service
10003
9364
 
10004
- # For Complex Services (Production APIs, Multiple Endpoints)
10005
- complex_service_sequence:
9365
+ sequence:
10006
9366
  - agent: analyst
10007
9367
  creates: project-brief.md
10008
9368
  optional_steps:
@@ -10042,65 +9402,33 @@ workflow:
10042
9402
  action: move_to_ide
10043
9403
  notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
10044
9404
 
10045
- # For Simple Services (Simple APIs, Single Purpose Services)
10046
- simple_service_sequence:
10047
- - step: service_scope
10048
- action: assess complexity
10049
- notes: "First, assess if this needs full planning (use complex_service_sequence) or can be a simple API/service."
10050
-
10051
- - agent: analyst
10052
- creates: project-brief.md
10053
- optional_steps:
10054
- - brainstorming_session
10055
- notes: "Creates focused project brief for simple service. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
10056
-
10057
- - agent: pm
10058
- creates: simple_epic OR single_story
10059
- uses: create-epic OR create-story
10060
- requires: project-brief.md
10061
- notes: "Create simple epic or story for API endpoints instead of full PRD for rapid development."
10062
-
10063
- - workflow_end:
10064
- action: move_to_ide
10065
- notes: "Simple service defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
10066
-
10067
9405
  flow_diagram: |
10068
9406
  ```mermaid
10069
9407
  graph TD
10070
- A[Start: Service Development] --> B{Service Complexity?}
10071
- B -->|Complex/Production| C[analyst: project-brief.md]
10072
- B -->|Simple/Prototype| D[analyst: focused project-brief.md]
10073
-
10074
- C --> E[pm: prd.md]
10075
- E --> F[architect: architecture.md]
10076
- F --> G{Architecture suggests PRD changes?}
10077
- G -->|Yes| H[pm: update prd.md]
10078
- G -->|No| I[po: validate all artifacts]
10079
- H --> I
10080
- I --> J{PO finds issues?}
10081
- J -->|Yes| K[Return to relevant agent for fixes]
10082
- J -->|No| L[Move to IDE Environment]
10083
- K --> I
10084
-
10085
- D --> M[pm: simple epic or story]
10086
- M --> N[Move to IDE Environment]
10087
-
10088
- C -.-> C1[Optional: brainstorming]
10089
- C -.-> C2[Optional: market research]
10090
- F -.-> F1[Optional: technical research]
10091
- D -.-> D1[Optional: brainstorming]
10092
-
10093
- style L fill:#90EE90
10094
- style N fill:#90EE90
9408
+ A[Start: Service Development] --> B[analyst: project-brief.md]
9409
+ B --> C[pm: prd.md]
9410
+ C --> D[architect: architecture.md]
9411
+ D --> E{Architecture suggests PRD changes?}
9412
+ E -->|Yes| F[pm: update prd.md]
9413
+ E -->|No| G[po: validate all artifacts]
9414
+ F --> G
9415
+ G --> H{PO finds issues?}
9416
+ H -->|Yes| I[Return to relevant agent for fixes]
9417
+ H -->|No| J[Move to IDE Environment]
9418
+ I --> G
9419
+
9420
+ B -.-> B1[Optional: brainstorming]
9421
+ B -.-> B2[Optional: market research]
9422
+ D -.-> D1[Optional: technical research]
9423
+
9424
+ style J fill:#90EE90
9425
+ style B fill:#FFE4B5
10095
9426
  style C fill:#FFE4B5
10096
- style E fill:#FFE4B5
10097
- style F fill:#FFE4B5
10098
- style D fill:#FFB6C1
10099
- style M fill:#FFB6C1
9427
+ style D fill:#FFE4B5
10100
9428
  ```
10101
9429
 
10102
9430
  decision_guidance:
10103
- use_complex_sequence_when:
9431
+ when_to_use:
10104
9432
  - Building production APIs or microservices
10105
9433
  - Multiple endpoints and complex business logic
10106
9434
  - Need comprehensive documentation and testing
@@ -10108,27 +9436,14 @@ workflow:
10108
9436
  - Long-term maintenance expected
10109
9437
  - Enterprise or external-facing APIs
10110
9438
 
10111
- use_simple_sequence_when:
10112
- - Building simple APIs or single-purpose services
10113
- - Few endpoints with straightforward logic
10114
- - Prototyping or proof-of-concept APIs
10115
- - Solo developer or small team
10116
- - Internal tools or utilities
10117
- - Learning or experimental projects
10118
-
10119
9439
  handoff_prompts:
10120
- # Complex sequence prompts
10121
9440
  analyst_to_pm: "Project brief is complete. Save it as docs/project-brief.md in your project, then create the PRD."
10122
9441
  pm_to_architect: "PRD is ready. Save it as docs/prd.md in your project, then create the service architecture."
10123
9442
  architect_review: "Architecture complete. Save it as docs/architecture.md. Do you suggest any changes to the PRD stories or need new stories added?"
10124
9443
  architect_to_pm: "Please update the PRD with the suggested story changes, then re-export the complete prd.md to docs/."
10125
9444
  updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
10126
9445
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
10127
- complex_complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
10128
-
10129
- # Simple sequence prompts
10130
- simple_analyst_to_pm: "Focused project brief complete. Save it as docs/project-brief.md, then create simple epic or story for API development."
10131
- simple_complete: "Simple service defined. Move to IDE environment to begin development."
9446
+ complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
10132
9447
  ==================== END: workflows#greenfield-service ====================
10133
9448
 
10134
9449
  ==================== START: workflows#greenfield-ui ====================
@@ -10147,8 +9462,7 @@ workflow:
10147
9462
  - ui-prototype
10148
9463
  - simple-interface
10149
9464
 
10150
- # For Complex UIs (Production Apps, Multiple Views)
10151
- complex_ui_sequence:
9465
+ sequence:
10152
9466
  - agent: analyst
10153
9467
  creates: project-brief.md
10154
9468
  optional_steps:
@@ -10207,74 +9521,42 @@ workflow:
10207
9521
  action: move_to_ide
10208
9522
  notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
10209
9523
 
10210
- # For Simple UIs (Simple Interfaces, Few Components)
10211
- simple_ui_sequence:
10212
- - step: ui_scope
10213
- action: assess complexity
10214
- notes: "First, assess if this needs full planning (use complex_ui_sequence) or can be a simple interface."
10215
-
10216
- - agent: analyst
10217
- creates: project-brief.md
10218
- optional_steps:
10219
- - brainstorming_session
10220
- notes: "Creates focused project brief for simple UI. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
10221
-
10222
- - agent: ux-expert
10223
- creates: simple_wireframes OR quick_spec
10224
- uses: create-epic OR create-story
10225
- requires: project-brief.md
10226
- notes: "Create simple wireframes and component list instead of full UI/UX spec for rapid development."
10227
-
10228
- - workflow_end:
10229
- action: move_to_ide
10230
- notes: "Simple UI defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
10231
-
10232
9524
  flow_diagram: |
10233
9525
  ```mermaid
10234
9526
  graph TD
10235
- A[Start: UI Development] --> B{UI Complexity?}
10236
- B -->|Complex/Production| C[analyst: project-brief.md]
10237
- B -->|Simple/Prototype| D[analyst: focused project-brief.md]
10238
-
10239
- C --> E[pm: prd.md]
10240
- E --> F[ux-expert: front-end-spec.md]
10241
- F --> F2{Generate v0 prompt?}
10242
- F2 -->|Yes| F3[ux-expert: create v0 prompt]
10243
- F2 -->|No| G[architect: front-end-architecture.md]
10244
- F3 --> F4[User: generate UI in v0/Lovable]
10245
- F4 --> G
10246
- G --> H{Architecture suggests PRD changes?}
10247
- H -->|Yes| I[pm: update prd.md]
10248
- H -->|No| J[po: validate all artifacts]
10249
- I --> J
10250
- J --> K{PO finds issues?}
10251
- K -->|Yes| L[Return to relevant agent for fixes]
10252
- K -->|No| M[Move to IDE Environment]
10253
- L --> J
10254
-
10255
- D --> N[ux-expert: simple wireframes]
10256
- N --> O[Move to IDE Environment]
10257
-
10258
- C -.-> C1[Optional: brainstorming]
10259
- C -.-> C2[Optional: market research]
10260
- F -.-> F1[Optional: user research]
10261
- G -.-> G1[Optional: technical research]
10262
- D -.-> D1[Optional: brainstorming]
10263
-
10264
- style M fill:#90EE90
10265
- style O fill:#90EE90
10266
- style F3 fill:#E6E6FA
10267
- style F4 fill:#E6E6FA
9527
+ A[Start: UI Development] --> B[analyst: project-brief.md]
9528
+ B --> C[pm: prd.md]
9529
+ C --> D[ux-expert: front-end-spec.md]
9530
+ D --> D2{Generate v0 prompt?}
9531
+ D2 -->|Yes| D3[ux-expert: create v0 prompt]
9532
+ D2 -->|No| E[architect: front-end-architecture.md]
9533
+ D3 --> D4[User: generate UI in v0/Lovable]
9534
+ D4 --> E
9535
+ E --> F{Architecture suggests PRD changes?}
9536
+ F -->|Yes| G[pm: update prd.md]
9537
+ F -->|No| H[po: validate all artifacts]
9538
+ G --> H
9539
+ H --> I{PO finds issues?}
9540
+ I -->|Yes| J[Return to relevant agent for fixes]
9541
+ I -->|No| K[Move to IDE Environment]
9542
+ J --> H
9543
+
9544
+ B -.-> B1[Optional: brainstorming]
9545
+ B -.-> B2[Optional: market research]
9546
+ D -.-> D1[Optional: user research]
9547
+ E -.-> E1[Optional: technical research]
9548
+
9549
+ style K fill:#90EE90
9550
+ style D3 fill:#E6E6FA
9551
+ style D4 fill:#E6E6FA
9552
+ style B fill:#FFE4B5
10268
9553
  style C fill:#FFE4B5
9554
+ style D fill:#FFE4B5
10269
9555
  style E fill:#FFE4B5
10270
- style F fill:#FFE4B5
10271
- style G fill:#FFE4B5
10272
- style D fill:#FFB6C1
10273
- style N fill:#FFB6C1
10274
9556
  ```
10275
9557
 
10276
9558
  decision_guidance:
10277
- use_complex_sequence_when:
9559
+ when_to_use:
10278
9560
  - Building production frontend applications
10279
9561
  - Multiple views/pages with complex interactions
10280
9562
  - Need comprehensive UI/UX design and testing
@@ -10282,16 +9564,7 @@ workflow:
10282
9564
  - Long-term maintenance expected
10283
9565
  - Customer-facing applications
10284
9566
 
10285
- use_simple_sequence_when:
10286
- - Building simple interfaces or prototypes
10287
- - Few views with straightforward interactions
10288
- - Internal tools or admin interfaces
10289
- - Solo developer or small team
10290
- - Quick experiments or proof-of-concepts
10291
- - Learning or educational projects
10292
-
10293
9567
  handoff_prompts:
10294
- # Complex sequence prompts
10295
9568
  analyst_to_pm: "Project brief is complete. Save it as docs/project-brief.md in your project, then create the PRD."
10296
9569
  pm_to_ux: "PRD is ready. Save it as docs/prd.md in your project, then create the UI/UX specification."
10297
9570
  ux_to_architect: "UI/UX spec complete. Save it as docs/front-end-spec.md in your project, then create the frontend architecture."
@@ -10299,9 +9572,5 @@ workflow:
10299
9572
  architect_to_pm: "Please update the PRD with the suggested story changes, then re-export the complete prd.md to docs/."
10300
9573
  updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
10301
9574
  po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
10302
- complex_complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
10303
-
10304
- # Simple sequence prompts
10305
- simple_analyst_to_ux: "Focused project brief complete. Save it as docs/project-brief.md, then create simple wireframes for rapid development."
10306
- simple_complete: "Simple UI defined. Move to IDE environment to begin development."
9575
+ complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
10307
9576
  ==================== END: workflows#greenfield-ui ====================