bmad-method 4.5.1 → 4.6.1
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.
- package/CHANGELOG.md +19 -0
- package/bmad-core/agents/bmad-orchestrator.md +55 -66
- package/bmad-core/agents/pm.md +0 -1
- package/bmad-core/tasks/doc-migration-task.md +9 -9
- package/bmad-core/tasks/index-docs.md +3 -7
- package/bmad-core/templates/architecture-tmpl.md +2 -0
- package/bmad-core/templates/brownfield-architecture-tmpl.md +2 -0
- package/bmad-core/templates/brownfield-prd-tmpl.md +2 -0
- package/bmad-core/templates/competitor-analysis-tmpl.md +2 -0
- package/bmad-core/templates/front-end-architecture-tmpl.md +2 -0
- package/bmad-core/templates/front-end-spec-tmpl.md +3 -1
- package/bmad-core/templates/fullstack-architecture-tmpl.md +62 -60
- package/bmad-core/templates/market-research-tmpl.md +2 -0
- package/bmad-core/templates/prd-tmpl.md +4 -2
- package/bmad-core/templates/project-brief-tmpl.md +2 -0
- package/bmad-core/workflows/brownfield-fullstack.yml +19 -58
- package/bmad-core/workflows/brownfield-service.yml +19 -58
- package/bmad-core/workflows/brownfield-ui.yml +20 -59
- package/bmad-core/workflows/greenfield-fullstack.yml +31 -77
- package/bmad-core/workflows/greenfield-service.yml +22 -68
- package/bmad-core/workflows/greenfield-ui.yml +30 -76
- package/dist/agents/architect.txt +60 -60
- package/dist/agents/bmad-master.txt +66 -70
- package/dist/agents/bmad-orchestrator.txt +55 -66
- package/dist/agents/pm.txt +2 -467
- package/dist/agents/ux-expert.txt +1 -1
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +481 -0
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +100 -0
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +100 -0
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +4757 -2941
- package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +35 -0
- package/dist/expansion-packs/expansion-creator/agents/bmad-the-creator.txt +438 -32
- package/dist/teams/team-all.txt +368 -1099
- package/dist/teams/team-fullstack.txt +286 -1017
- package/dist/teams/team-ide-minimal.txt +55 -66
- package/dist/teams/team-no-ui.txt +224 -785
- package/docs/versioning-and-releases.md +6 -6
- package/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yml +1 -0
- package/expansion-packs/expansion-creator/tasks/generate-expansion-pack.md +17 -13
- package/package.json +1 -1
- package/tools/builders/web-builder.js +189 -20
- package/tools/installer/package.json +1 -1
- package/bmad-core/templates/simple-project-prd-tmpl.md +0 -461
package/dist/teams/team-all.txt
CHANGED
|
@@ -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
|
|
83
|
+
- Process commands starting with * immediately
|
|
84
|
+
- Always remind users that commands require * prefix
|
|
84
85
|
startup:
|
|
85
|
-
- Announce:
|
|
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,
|
|
89
|
-
- Load resources only when needed
|
|
90
|
-
commands:
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
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
|
-
|
|
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
|
-
|
|
120
|
-
*help
|
|
121
|
-
*chat-mode
|
|
122
|
-
*kb-mode
|
|
123
|
-
*status
|
|
124
|
-
*
|
|
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
|
|
131
|
-
*task
|
|
132
|
-
*checklist
|
|
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
|
|
136
|
-
*workflow-guidance
|
|
124
|
+
*workflow [name] .... Start specific workflow (list if no name)
|
|
125
|
+
*workflow-guidance .. Get personalized help selecting the right workflow
|
|
137
126
|
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
*
|
|
141
|
-
|
|
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
|
|
145
|
-
[
|
|
146
|
-
*
|
|
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
|
-
|
|
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
|
-
-
|
|
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
|
|
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
|
|
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
|
-
|
|
4037
|
+
```mermaid
|
|
4050
4038
|
{{architecture_diagram}}
|
|
4051
|
-
```
|
|
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
|
-
|
|
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
|
-
```
|
|
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
|
-
|
|
4234
|
+
```graphql
|
|
4247
4235
|
# GraphQL Schema
|
|
4248
4236
|
{{graphql_schema}}
|
|
4249
|
-
```
|
|
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
|
-
|
|
4401
|
+
```typescript
|
|
4414
4402
|
{
|
|
4415
4403
|
{
|
|
4416
4404
|
component_template;
|
|
4417
4405
|
}
|
|
4418
4406
|
}
|
|
4419
|
-
```
|
|
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
|
-
```
|
|
4436
|
+
```
|
|
4449
4437
|
|
|
4450
4438
|
**Protected Route Pattern:**
|
|
4451
4439
|
|
|
4452
|
-
|
|
4440
|
+
```typescript
|
|
4453
4441
|
{
|
|
4454
4442
|
{
|
|
4455
4443
|
protected_route_example;
|
|
4456
4444
|
}
|
|
4457
4445
|
}
|
|
4458
|
-
```
|
|
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
|
-
|
|
4464
|
+
```typescript
|
|
4477
4465
|
{
|
|
4478
4466
|
{
|
|
4479
4467
|
service_example;
|
|
4480
4468
|
}
|
|
4481
4469
|
}
|
|
4482
|
-
```
|
|
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
|
-
|
|
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
|
-
|
|
4512
|
+
```typescript
|
|
4525
4513
|
{
|
|
4526
4514
|
{
|
|
4527
4515
|
controller_template;
|
|
4528
4516
|
}
|
|
4529
4517
|
}
|
|
4530
|
-
```
|
|
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
|
-
|
|
4534
|
+
```typescript
|
|
4547
4535
|
{
|
|
4548
4536
|
{
|
|
4549
4537
|
repository_pattern;
|
|
4550
4538
|
}
|
|
4551
4539
|
}
|
|
4552
|
-
```
|
|
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
|
-
|
|
4554
|
+
```typescript
|
|
4567
4555
|
{
|
|
4568
4556
|
{
|
|
4569
4557
|
auth_middleware;
|
|
4570
4558
|
}
|
|
4571
4559
|
}
|
|
4572
|
-
```
|
|
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
|
-
|
|
4642
|
+
```bash
|
|
4655
4643
|
{{prerequisites_commands}}
|
|
4656
|
-
```
|
|
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
|
-
|
|
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
|
-
```
|
|
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
|
-
|
|
4704
|
+
```yaml
|
|
4717
4705
|
'[object Object]': null
|
|
4718
|
-
```
|
|
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
|
-
```
|
|
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
|
-
|
|
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
|
-
```
|
|
4791
|
+
```
|
|
4804
4792
|
|
|
4805
4793
|
**E2E Tests:**
|
|
4806
4794
|
|
|
4807
|
-
|
|
4795
|
+
```text
|
|
4808
4796
|
|
|
4809
4797
|
{{e2e_test_structure}}
|
|
4810
4798
|
|
|
4811
|
-
|
|
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
|
-
|
|
4815
|
+
```typescript
|
|
4828
4816
|
{
|
|
4829
4817
|
{
|
|
4830
4818
|
backend_test_example;
|
|
4831
4819
|
}
|
|
4832
4820
|
}
|
|
4833
|
-
```
|
|
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
|
-
|
|
4872
|
+
```mermaid
|
|
4885
4873
|
{{error_flow_diagram}}
|
|
4886
|
-
```
|
|
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
|
-
|
|
4892
|
+
```typescript
|
|
4905
4893
|
{
|
|
4906
4894
|
{
|
|
4907
4895
|
frontend_error_handler;
|
|
4908
4896
|
}
|
|
4909
4897
|
}
|
|
4910
|
-
```
|
|
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:
|
|
7069
|
-
#
|
|
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
|
-
|
|
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:
|
|
7061
|
+
[[LLM: INITIALIZATION INSTRUCTIONS - PM CHECKLIST
|
|
7076
7062
|
|
|
7077
|
-
|
|
7063
|
+
Before proceeding with this checklist, ensure you have access to:
|
|
7078
7064
|
|
|
7079
|
-
|
|
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
|
-
|
|
7070
|
+
IMPORTANT: If the PRD is missing, immediately ask the user for its location or content before proceeding.
|
|
7082
7071
|
|
|
7083
|
-
|
|
7072
|
+
VALIDATION APPROACH:
|
|
7084
7073
|
|
|
7085
|
-
|
|
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
|
-
|
|
7080
|
+
EXECUTION MODE:
|
|
7081
|
+
Ask the user if they want to work through the checklist:
|
|
7088
7082
|
|
|
7089
|
-
|
|
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
|
-
##
|
|
7086
|
+
## 1. PROBLEM DEFINITION & CONTEXT
|
|
7093
7087
|
|
|
7094
|
-
[[LLM:
|
|
7088
|
+
[[LLM: The foundation of any product is a clear problem statement. As you review this section:
|
|
7095
7089
|
|
|
7096
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
7112
|
+
### 1.3 User Research & Insights
|
|
7109
7113
|
|
|
7110
|
-
|
|
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
|
-
|
|
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
|
-
|
|
7122
|
+
[[LLM: MVP scope is critical - too much and you waste resources, too little and you can't validate. Check:
|
|
7120
7123
|
|
|
7121
|
-
|
|
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
|
|
7130
|
+
### 2.1 Core Functionality
|
|
7124
7131
|
|
|
7125
|
-
[
|
|
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
|
-
|
|
7138
|
+
### 2.2 Scope Boundaries
|
|
7128
7139
|
|
|
7129
|
-
-
|
|
7130
|
-
-
|
|
7131
|
-
-
|
|
7132
|
-
-
|
|
7133
|
-
|
|
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
|
-
###
|
|
7146
|
+
### 2.3 MVP Validation Approach
|
|
7136
7147
|
|
|
7137
|
-
|
|
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
|
-
|
|
7154
|
+
## 3. USER EXPERIENCE REQUIREMENTS
|
|
7140
7155
|
|
|
7141
|
-
|
|
7156
|
+
[[LLM: UX requirements bridge user needs and technical implementation. Validate:
|
|
7142
7157
|
|
|
7143
|
-
|
|
7144
|
-
|
|
7145
|
-
|
|
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
|
-
###
|
|
7164
|
+
### 3.1 User Journeys & Flows
|
|
7148
7165
|
|
|
7149
|
-
|
|
7150
|
-
|
|
7151
|
-
|
|
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
|
-
|
|
7172
|
+
### 3.2 Usability Requirements
|
|
7154
7173
|
|
|
7155
|
-
|
|
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
|
-
|
|
7180
|
+
### 3.3 UI Requirements
|
|
7158
7181
|
|
|
7159
|
-
|
|
7160
|
-
|
|
7161
|
-
|
|
7162
|
-
|
|
7163
|
-
|
|
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
|
-
|
|
7188
|
+
## 4. FUNCTIONAL REQUIREMENTS
|
|
7167
7189
|
|
|
7168
|
-
|
|
7190
|
+
[[LLM: Functional requirements must be clear enough for implementation. Check:
|
|
7169
7191
|
|
|
7170
|
-
|
|
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
|
-
|
|
7198
|
+
### 4.1 Feature Completeness
|
|
7173
7199
|
|
|
7174
|
-
|
|
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
|
-
###
|
|
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
|
-
```
|
|
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
|
-
|
|
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:
|
|
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
|
|
9510
|
-
B
|
|
9511
|
-
|
|
9512
|
-
|
|
9513
|
-
|
|
9514
|
-
|
|
9515
|
-
F
|
|
9516
|
-
G -->
|
|
9517
|
-
|
|
9518
|
-
H
|
|
9519
|
-
|
|
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
|
-
|
|
9536
|
-
- Enhancement requires
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
9582
|
-
action: analyze existing
|
|
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
|
|
9630
|
-
B
|
|
9631
|
-
|
|
9632
|
-
|
|
9633
|
-
|
|
9634
|
-
|
|
9635
|
-
F
|
|
9636
|
-
G -->
|
|
9637
|
-
|
|
9638
|
-
H
|
|
9639
|
-
|
|
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
|
-
|
|
9656
|
-
- Service enhancement requires
|
|
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
|
-
|
|
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
|
-
|
|
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:
|
|
9701
|
-
action: analyze existing
|
|
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
|
|
9757
|
-
B
|
|
9758
|
-
|
|
9759
|
-
|
|
9760
|
-
|
|
9761
|
-
|
|
9762
|
-
|
|
9763
|
-
G
|
|
9764
|
-
H -->
|
|
9765
|
-
|
|
9766
|
-
I
|
|
9767
|
-
|
|
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
|
-
|
|
9785
|
-
- UI enhancement requires
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
9915
|
-
B
|
|
9916
|
-
|
|
9917
|
-
|
|
9918
|
-
|
|
9919
|
-
|
|
9920
|
-
|
|
9921
|
-
|
|
9922
|
-
|
|
9923
|
-
|
|
9924
|
-
|
|
9925
|
-
G --> H
|
|
9926
|
-
H
|
|
9927
|
-
|
|
9928
|
-
I
|
|
9929
|
-
J -->
|
|
9930
|
-
|
|
9931
|
-
|
|
9932
|
-
|
|
9933
|
-
|
|
9934
|
-
|
|
9935
|
-
|
|
9936
|
-
|
|
9937
|
-
|
|
9938
|
-
|
|
9939
|
-
|
|
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
|
-
|
|
9330
|
+
when_to_use:
|
|
9957
9331
|
- Building production-ready applications
|
|
9958
9332
|
- Multiple team members will be involved
|
|
9959
|
-
- Complex feature requirements
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
10071
|
-
B
|
|
10072
|
-
|
|
10073
|
-
|
|
10074
|
-
|
|
10075
|
-
E
|
|
10076
|
-
F --> G
|
|
10077
|
-
G
|
|
10078
|
-
|
|
10079
|
-
H
|
|
10080
|
-
I -->
|
|
10081
|
-
|
|
10082
|
-
|
|
10083
|
-
|
|
10084
|
-
|
|
10085
|
-
|
|
10086
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
10236
|
-
B
|
|
10237
|
-
|
|
10238
|
-
|
|
10239
|
-
|
|
10240
|
-
|
|
10241
|
-
|
|
10242
|
-
|
|
10243
|
-
|
|
10244
|
-
|
|
10245
|
-
|
|
10246
|
-
G --> H
|
|
10247
|
-
H
|
|
10248
|
-
|
|
10249
|
-
I
|
|
10250
|
-
J -->
|
|
10251
|
-
|
|
10252
|
-
|
|
10253
|
-
|
|
10254
|
-
|
|
10255
|
-
|
|
10256
|
-
|
|
10257
|
-
|
|
10258
|
-
|
|
10259
|
-
|
|
10260
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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 ====================
|