bmad-method 4.16.0 → 4.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +14 -0
- package/package.json +1 -1
- package/tools/installer/lib/ide-setup.js +3 -0
- package/tools/installer/package.json +1 -1
- package/.bmad-core/agent-teams/team-all.yml +0 -14
- package/.bmad-core/agent-teams/team-fullstack.yml +0 -18
- package/.bmad-core/agent-teams/team-ide-minimal.yml +0 -10
- package/.bmad-core/agent-teams/team-no-ui.yml +0 -13
- package/.bmad-core/agents/analyst.md +0 -64
- package/.bmad-core/agents/architect.md +0 -64
- package/.bmad-core/agents/bmad-master.md +0 -101
- package/.bmad-core/agents/bmad-orchestrator.md +0 -126
- package/.bmad-core/agents/dev.md +0 -65
- package/.bmad-core/agents/pm.md +0 -61
- package/.bmad-core/agents/po.md +0 -63
- package/.bmad-core/agents/qa.md +0 -50
- package/.bmad-core/agents/sm.md +0 -51
- package/.bmad-core/agents/ux-expert.md +0 -63
- package/.bmad-core/checklists/architect-checklist.md +0 -443
- package/.bmad-core/checklists/change-checklist.md +0 -182
- package/.bmad-core/checklists/pm-checklist.md +0 -375
- package/.bmad-core/checklists/po-master-checklist.md +0 -441
- package/.bmad-core/checklists/story-dod-checklist.md +0 -101
- package/.bmad-core/checklists/story-draft-checklist.md +0 -156
- package/.bmad-core/core-config.yml +0 -20
- package/.bmad-core/data/bmad-kb.md +0 -814
- package/.bmad-core/data/technical-preferences.md +0 -3
- package/.bmad-core/install-manifest.yml +0 -196
- package/.bmad-core/tasks/advanced-elicitation.md +0 -92
- package/.bmad-core/tasks/brainstorming-techniques.md +0 -238
- package/.bmad-core/tasks/brownfield-create-epic.md +0 -160
- package/.bmad-core/tasks/brownfield-create-story.md +0 -147
- package/.bmad-core/tasks/core-dump.md +0 -74
- package/.bmad-core/tasks/correct-course.md +0 -73
- package/.bmad-core/tasks/create-deep-research-prompt.md +0 -301
- package/.bmad-core/tasks/create-doc.md +0 -74
- package/.bmad-core/tasks/create-next-story.md +0 -242
- package/.bmad-core/tasks/doc-migration-task.md +0 -151
- package/.bmad-core/tasks/document-project.md +0 -350
- package/.bmad-core/tasks/execute-checklist.md +0 -97
- package/.bmad-core/tasks/generate-ai-frontend-prompt.md +0 -51
- package/.bmad-core/tasks/index-docs.md +0 -178
- package/.bmad-core/tasks/kb-mode-interaction.md +0 -77
- package/.bmad-core/tasks/review-story.md +0 -153
- package/.bmad-core/tasks/shard-doc.md +0 -191
- package/.bmad-core/templates/architecture-tmpl.md +0 -776
- package/.bmad-core/templates/brownfield-architecture-tmpl.md +0 -544
- package/.bmad-core/templates/brownfield-prd-tmpl.md +0 -242
- package/.bmad-core/templates/competitor-analysis-tmpl.md +0 -291
- package/.bmad-core/templates/front-end-architecture-tmpl.md +0 -175
- package/.bmad-core/templates/front-end-spec-tmpl.md +0 -413
- package/.bmad-core/templates/fullstack-architecture-tmpl.md +0 -1018
- package/.bmad-core/templates/market-research-tmpl.md +0 -263
- package/.bmad-core/templates/prd-tmpl.md +0 -202
- package/.bmad-core/templates/project-brief-tmpl.md +0 -230
- package/.bmad-core/templates/story-tmpl.md +0 -69
- package/.bmad-core/utils/file-resolution-context.md +0 -10
- package/.bmad-core/utils/template-format.md +0 -26
- package/.bmad-core/utils/web-agent-startup-instructions.md +0 -39
- package/.bmad-core/utils/workflow-management.md +0 -223
- package/.bmad-core/workflows/brownfield-fullstack.yml +0 -112
- package/.bmad-core/workflows/brownfield-service.yml +0 -113
- package/.bmad-core/workflows/brownfield-ui.yml +0 -123
- package/.bmad-core/workflows/greenfield-fullstack.yml +0 -166
- package/.bmad-core/workflows/greenfield-service.yml +0 -132
- package/.bmad-core/workflows/greenfield-ui.yml +0 -161
|
@@ -1,123 +0,0 @@
|
|
|
1
|
-
workflow:
|
|
2
|
-
id: brownfield-ui
|
|
3
|
-
name: Brownfield UI/Frontend Enhancement
|
|
4
|
-
description: >-
|
|
5
|
-
Agent workflow for enhancing existing frontend applications with new features,
|
|
6
|
-
modernization, or design improvements. Handles existing UI analysis and safe integration.
|
|
7
|
-
type: brownfield
|
|
8
|
-
project_types:
|
|
9
|
-
- ui-modernization
|
|
10
|
-
- framework-migration
|
|
11
|
-
- design-refresh
|
|
12
|
-
- frontend-enhancement
|
|
13
|
-
|
|
14
|
-
sequence:
|
|
15
|
-
- step: ui_analysis
|
|
16
|
-
agent: architect
|
|
17
|
-
action: analyze existing project and use task document-project
|
|
18
|
-
creates: multiple documents per the document-project template
|
|
19
|
-
notes: "Review existing frontend application, user feedback, analytics data, and identify improvement areas."
|
|
20
|
-
|
|
21
|
-
- agent: pm
|
|
22
|
-
creates: brownfield-prd.md
|
|
23
|
-
uses: brownfield-prd-tmpl
|
|
24
|
-
requires: existing_ui_analysis
|
|
25
|
-
notes: "Creates comprehensive brownfield PRD focused on UI enhancement with existing system analysis. SAVE OUTPUT: Copy final brownfield-prd.md to your project's docs/ folder."
|
|
26
|
-
|
|
27
|
-
- agent: ux-expert
|
|
28
|
-
creates: front-end-spec.md
|
|
29
|
-
uses: front-end-spec-tmpl
|
|
30
|
-
requires: brownfield-prd.md
|
|
31
|
-
notes: "Creates UI/UX specification for brownfield enhancement that integrates with existing design patterns. SAVE OUTPUT: Copy final front-end-spec.md to your project's docs/ folder."
|
|
32
|
-
|
|
33
|
-
- agent: architect
|
|
34
|
-
creates: brownfield-architecture.md
|
|
35
|
-
uses: brownfield-architecture-tmpl
|
|
36
|
-
requires:
|
|
37
|
-
- brownfield-prd.md
|
|
38
|
-
- front-end-spec.md
|
|
39
|
-
notes: "Creates brownfield frontend architecture with component integration strategy and migration planning. SAVE OUTPUT: Copy final brownfield-architecture.md to your project's docs/ folder."
|
|
40
|
-
|
|
41
|
-
- agent: po
|
|
42
|
-
validates: all_artifacts
|
|
43
|
-
uses: po-master-checklist
|
|
44
|
-
notes: "Validates all brownfield documents for UI integration safety and design consistency. May require updates to any document."
|
|
45
|
-
|
|
46
|
-
- agent: various
|
|
47
|
-
updates: any_flagged_documents
|
|
48
|
-
condition: po_checklist_issues
|
|
49
|
-
notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
|
|
50
|
-
|
|
51
|
-
- workflow_end:
|
|
52
|
-
action: move_to_ide
|
|
53
|
-
notes: |
|
|
54
|
-
Planning phase complete! Now transition to IDE Development:
|
|
55
|
-
|
|
56
|
-
1. ENSURE DOCUMENTS ARE IN PROJECT:
|
|
57
|
-
- Copy final prd.md to project's docs/prd.md
|
|
58
|
-
- Copy final architecture.md to project's docs/architecture.md
|
|
59
|
-
- All documents must be in the project before proceeding
|
|
60
|
-
|
|
61
|
-
2. SHARD DOCUMENTS (in IDE):
|
|
62
|
-
- Option A: Use PO agent to shard: @po then ask to shard docs/prd.md
|
|
63
|
-
- Option B: Manual: Drag shard-doc task + docs/prd.md into chat
|
|
64
|
-
- This creates docs/prd/ and docs/architecture/ folders with sharded content
|
|
65
|
-
|
|
66
|
-
3. START DEVELOPMENT CYCLE:
|
|
67
|
-
a. SM Agent (New Chat): @sm → *create
|
|
68
|
-
- Creates next story from sharded docs
|
|
69
|
-
- Review and approve story (Draft → Approved)
|
|
70
|
-
|
|
71
|
-
b. Dev Agent (New Chat): @dev
|
|
72
|
-
- Implements approved story
|
|
73
|
-
- Updates File List with all changes
|
|
74
|
-
- Marks story as "Review" when complete
|
|
75
|
-
|
|
76
|
-
c. QA Agent (New Chat): @qa → review-story
|
|
77
|
-
- Senior dev review with refactoring ability
|
|
78
|
-
- Fixes small issues directly
|
|
79
|
-
- Leaves checklist for remaining items
|
|
80
|
-
- Updates story status (Review → Done or stays Review)
|
|
81
|
-
|
|
82
|
-
d. If QA left unchecked items:
|
|
83
|
-
- Dev Agent (New Chat): Address remaining items
|
|
84
|
-
- Return to QA for final approval
|
|
85
|
-
|
|
86
|
-
4. REPEAT: Continue cycle for all epic stories
|
|
87
|
-
|
|
88
|
-
Reference: data#bmad-kb:IDE Development Workflow
|
|
89
|
-
|
|
90
|
-
flow_diagram: |
|
|
91
|
-
```mermaid
|
|
92
|
-
graph TD
|
|
93
|
-
A[Start: UI Enhancement] --> B[analyst: analyze existing UI]
|
|
94
|
-
B --> C[pm: brownfield-prd.md]
|
|
95
|
-
C --> D[ux-expert: front-end-spec.md]
|
|
96
|
-
D --> E[architect: brownfield-architecture.md]
|
|
97
|
-
E --> F[po: validate with po-master-checklist]
|
|
98
|
-
F --> G{PO finds issues?}
|
|
99
|
-
G -->|Yes| H[Return to relevant agent for fixes]
|
|
100
|
-
G -->|No| I[Move to IDE Environment]
|
|
101
|
-
H --> F
|
|
102
|
-
|
|
103
|
-
style I fill:#90EE90
|
|
104
|
-
style C fill:#FFE4B5
|
|
105
|
-
style D fill:#FFE4B5
|
|
106
|
-
style E fill:#FFE4B5
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
decision_guidance:
|
|
110
|
-
when_to_use:
|
|
111
|
-
- UI enhancement requires coordinated stories
|
|
112
|
-
- Design system changes needed
|
|
113
|
-
- New component patterns required
|
|
114
|
-
- User research and testing needed
|
|
115
|
-
- Multiple team members will work on related changes
|
|
116
|
-
|
|
117
|
-
handoff_prompts:
|
|
118
|
-
analyst_to_pm: "UI analysis complete. Create comprehensive brownfield PRD with UI integration strategy."
|
|
119
|
-
pm_to_ux: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the UI/UX specification."
|
|
120
|
-
ux_to_architect: "UI/UX spec complete. Save it as docs/front-end-spec.md, then create the frontend architecture."
|
|
121
|
-
architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for UI integration safety."
|
|
122
|
-
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
|
|
123
|
-
complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
|
|
@@ -1,166 +0,0 @@
|
|
|
1
|
-
workflow:
|
|
2
|
-
id: greenfield-fullstack
|
|
3
|
-
name: Greenfield Full-Stack Application Development
|
|
4
|
-
description: >-
|
|
5
|
-
Agent workflow for building full-stack applications from concept to development.
|
|
6
|
-
Supports both comprehensive planning for complex projects and rapid prototyping for simple ones.
|
|
7
|
-
type: greenfield
|
|
8
|
-
project_types:
|
|
9
|
-
- web-app
|
|
10
|
-
- saas
|
|
11
|
-
- enterprise-app
|
|
12
|
-
- prototype
|
|
13
|
-
- mvp
|
|
14
|
-
|
|
15
|
-
sequence:
|
|
16
|
-
- agent: analyst
|
|
17
|
-
creates: project-brief.md
|
|
18
|
-
optional_steps:
|
|
19
|
-
- brainstorming_session
|
|
20
|
-
- market_research_prompt
|
|
21
|
-
notes: "Can do brainstorming first, then optional deep research before creating project brief. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
|
|
22
|
-
|
|
23
|
-
- agent: pm
|
|
24
|
-
creates: prd.md
|
|
25
|
-
requires: project-brief.md
|
|
26
|
-
notes: "Creates PRD from project brief using prd-tmpl. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
|
|
27
|
-
|
|
28
|
-
- agent: ux-expert
|
|
29
|
-
creates: front-end-spec.md
|
|
30
|
-
requires: prd.md
|
|
31
|
-
optional_steps:
|
|
32
|
-
- user_research_prompt
|
|
33
|
-
notes: "Creates UI/UX specification using front-end-spec-tmpl. SAVE OUTPUT: Copy final front-end-spec.md to your project's docs/ folder."
|
|
34
|
-
|
|
35
|
-
- agent: ux-expert
|
|
36
|
-
creates: v0_prompt (optional)
|
|
37
|
-
requires: front-end-spec.md
|
|
38
|
-
condition: user_wants_ai_generation
|
|
39
|
-
notes: "OPTIONAL BUT RECOMMENDED: Generate AI UI prompt for tools like v0, Lovable, etc. Use the generate-ai-frontend-prompt task. User can then generate UI in external tool and download project structure."
|
|
40
|
-
|
|
41
|
-
- agent: architect
|
|
42
|
-
creates: fullstack-architecture.md
|
|
43
|
-
requires:
|
|
44
|
-
- prd.md
|
|
45
|
-
- front-end-spec.md
|
|
46
|
-
optional_steps:
|
|
47
|
-
- technical_research_prompt
|
|
48
|
-
- review_generated_ui_structure
|
|
49
|
-
notes: "Creates comprehensive architecture using fullstack-architecture-tmpl. If user generated UI with v0/Lovable, can incorporate the project structure into architecture. May suggest changes to PRD stories or new stories. SAVE OUTPUT: Copy final fullstack-architecture.md to your project's docs/ folder."
|
|
50
|
-
|
|
51
|
-
- agent: pm
|
|
52
|
-
updates: prd.md (if needed)
|
|
53
|
-
requires: fullstack-architecture.md
|
|
54
|
-
condition: architecture_suggests_prd_changes
|
|
55
|
-
notes: "If architect suggests story changes, update PRD and re-export the complete unredacted prd.md to docs/ folder."
|
|
56
|
-
|
|
57
|
-
- agent: po
|
|
58
|
-
validates: all_artifacts
|
|
59
|
-
uses: po-master-checklist
|
|
60
|
-
notes: "Validates all documents for consistency and completeness. May require updates to any document."
|
|
61
|
-
|
|
62
|
-
- agent: various
|
|
63
|
-
updates: any_flagged_documents
|
|
64
|
-
condition: po_checklist_issues
|
|
65
|
-
notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
|
|
66
|
-
|
|
67
|
-
- project_setup_guidance:
|
|
68
|
-
action: guide_project_structure
|
|
69
|
-
condition: user_has_generated_ui
|
|
70
|
-
notes: "If user generated UI with v0/Lovable: For polyrepo setup, place downloaded project in separate frontend repo alongside backend repo. For monorepo, place in apps/web or packages/frontend directory. Review architecture document for specific guidance."
|
|
71
|
-
|
|
72
|
-
- development_order_guidance:
|
|
73
|
-
action: guide_development_sequence
|
|
74
|
-
notes: "Based on PRD stories: If stories are frontend-heavy, start with frontend project/directory first. If backend-heavy or API-first, start with backend. For tightly coupled features, follow story sequence in monorepo setup. Reference sharded PRD epics for development order."
|
|
75
|
-
|
|
76
|
-
- workflow_end:
|
|
77
|
-
action: move_to_ide
|
|
78
|
-
notes: |
|
|
79
|
-
Planning phase complete! Now transition to IDE Development:
|
|
80
|
-
|
|
81
|
-
1. ENSURE DOCUMENTS ARE IN PROJECT:
|
|
82
|
-
- Copy final prd.md to project's docs/prd.md
|
|
83
|
-
- Copy final architecture.md to project's docs/architecture.md
|
|
84
|
-
- All documents must be in the project before proceeding
|
|
85
|
-
|
|
86
|
-
2. SHARD DOCUMENTS (in IDE):
|
|
87
|
-
- Option A: Use PO agent to shard: @po then ask to shard docs/prd.md
|
|
88
|
-
- Option B: Manual: Drag shard-doc task + docs/prd.md into chat
|
|
89
|
-
- This creates docs/prd/ and docs/architecture/ folders with sharded content
|
|
90
|
-
|
|
91
|
-
3. START DEVELOPMENT CYCLE:
|
|
92
|
-
a. SM Agent (New Chat): @sm → *create
|
|
93
|
-
- Creates next story from sharded docs
|
|
94
|
-
- Review and approve story (Draft → Approved)
|
|
95
|
-
|
|
96
|
-
b. Dev Agent (New Chat): @dev
|
|
97
|
-
- Implements approved story
|
|
98
|
-
- Updates File List with all changes
|
|
99
|
-
- Marks story as "Review" when complete
|
|
100
|
-
|
|
101
|
-
c. QA Agent (New Chat): @qa → review-story
|
|
102
|
-
- Senior dev review with refactoring ability
|
|
103
|
-
- Fixes small issues directly
|
|
104
|
-
- Leaves checklist for remaining items
|
|
105
|
-
- Updates story status (Review → Done or stays Review)
|
|
106
|
-
|
|
107
|
-
d. If QA left unchecked items:
|
|
108
|
-
- Dev Agent (New Chat): Address remaining items
|
|
109
|
-
- Return to QA for final approval
|
|
110
|
-
|
|
111
|
-
4. REPEAT: Continue cycle for all epic stories
|
|
112
|
-
|
|
113
|
-
Reference: data#bmad-kb:IDE Development Workflow
|
|
114
|
-
|
|
115
|
-
flow_diagram: |
|
|
116
|
-
```mermaid
|
|
117
|
-
graph TD
|
|
118
|
-
A[Start: Greenfield Project] --> B[analyst: project-brief.md]
|
|
119
|
-
B --> C[pm: prd.md]
|
|
120
|
-
C --> D[ux-expert: front-end-spec.md]
|
|
121
|
-
D --> D2{Generate v0 prompt?}
|
|
122
|
-
D2 -->|Yes| D3[ux-expert: create v0 prompt]
|
|
123
|
-
D2 -->|No| E[architect: fullstack-architecture.md]
|
|
124
|
-
D3 --> D4[User: generate UI in v0/Lovable]
|
|
125
|
-
D4 --> E
|
|
126
|
-
E --> F{Architecture suggests PRD changes?}
|
|
127
|
-
F -->|Yes| G[pm: update prd.md]
|
|
128
|
-
F -->|No| H[po: validate all artifacts]
|
|
129
|
-
G --> H
|
|
130
|
-
H --> I{PO finds issues?}
|
|
131
|
-
I -->|Yes| J[Return to relevant agent for fixes]
|
|
132
|
-
I -->|No| K[Move to IDE Environment]
|
|
133
|
-
J --> H
|
|
134
|
-
|
|
135
|
-
B -.-> B1[Optional: brainstorming]
|
|
136
|
-
B -.-> B2[Optional: market research]
|
|
137
|
-
D -.-> D1[Optional: user research]
|
|
138
|
-
E -.-> E1[Optional: technical research]
|
|
139
|
-
|
|
140
|
-
style K fill:#90EE90
|
|
141
|
-
style D3 fill:#E6E6FA
|
|
142
|
-
style D4 fill:#E6E6FA
|
|
143
|
-
style B fill:#FFE4B5
|
|
144
|
-
style C fill:#FFE4B5
|
|
145
|
-
style D fill:#FFE4B5
|
|
146
|
-
style E fill:#FFE4B5
|
|
147
|
-
```
|
|
148
|
-
|
|
149
|
-
decision_guidance:
|
|
150
|
-
when_to_use:
|
|
151
|
-
- Building production-ready applications
|
|
152
|
-
- Multiple team members will be involved
|
|
153
|
-
- Complex feature requirements
|
|
154
|
-
- Need comprehensive documentation
|
|
155
|
-
- Long-term maintenance expected
|
|
156
|
-
- Enterprise or customer-facing applications
|
|
157
|
-
|
|
158
|
-
handoff_prompts:
|
|
159
|
-
analyst_to_pm: "Project brief is complete. Save it as docs/project-brief.md in your project, then create the PRD."
|
|
160
|
-
pm_to_ux: "PRD is ready. Save it as docs/prd.md in your project, then create the UI/UX specification."
|
|
161
|
-
ux_to_architect: "UI/UX spec complete. Save it as docs/front-end-spec.md in your project, then create the fullstack architecture."
|
|
162
|
-
architect_review: "Architecture complete. Save it as docs/fullstack-architecture.md. Do you suggest any changes to the PRD stories or need new stories added?"
|
|
163
|
-
architect_to_pm: "Please update the PRD with the suggested story changes, then re-export the complete prd.md to docs/."
|
|
164
|
-
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
|
|
165
|
-
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
|
|
166
|
-
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
|
|
@@ -1,132 +0,0 @@
|
|
|
1
|
-
workflow:
|
|
2
|
-
id: greenfield-service
|
|
3
|
-
name: Greenfield Service/API Development
|
|
4
|
-
description: >-
|
|
5
|
-
Agent workflow for building backend services from concept to development.
|
|
6
|
-
Supports both comprehensive planning for complex services and rapid prototyping for simple APIs.
|
|
7
|
-
type: greenfield
|
|
8
|
-
project_types:
|
|
9
|
-
- rest-api
|
|
10
|
-
- graphql-api
|
|
11
|
-
- microservice
|
|
12
|
-
- backend-service
|
|
13
|
-
- api-prototype
|
|
14
|
-
- simple-service
|
|
15
|
-
|
|
16
|
-
sequence:
|
|
17
|
-
- agent: analyst
|
|
18
|
-
creates: project-brief.md
|
|
19
|
-
optional_steps:
|
|
20
|
-
- brainstorming_session
|
|
21
|
-
- market_research_prompt
|
|
22
|
-
notes: "Can do brainstorming first, then optional deep research before creating project brief. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
|
|
23
|
-
|
|
24
|
-
- agent: pm
|
|
25
|
-
creates: prd.md
|
|
26
|
-
requires: project-brief.md
|
|
27
|
-
notes: "Creates PRD from project brief using prd-tmpl, focused on API/service requirements. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
|
|
28
|
-
|
|
29
|
-
- agent: architect
|
|
30
|
-
creates: architecture.md
|
|
31
|
-
requires: prd.md
|
|
32
|
-
optional_steps:
|
|
33
|
-
- technical_research_prompt
|
|
34
|
-
notes: "Creates backend/service architecture using architecture-tmpl. May suggest changes to PRD stories or new stories. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
|
|
35
|
-
|
|
36
|
-
- agent: pm
|
|
37
|
-
updates: prd.md (if needed)
|
|
38
|
-
requires: architecture.md
|
|
39
|
-
condition: architecture_suggests_prd_changes
|
|
40
|
-
notes: "If architect suggests story changes, update PRD and re-export the complete unredacted prd.md to docs/ folder."
|
|
41
|
-
|
|
42
|
-
- agent: po
|
|
43
|
-
validates: all_artifacts
|
|
44
|
-
uses: po-master-checklist
|
|
45
|
-
notes: "Validates all documents for consistency and completeness. May require updates to any document."
|
|
46
|
-
|
|
47
|
-
- agent: various
|
|
48
|
-
updates: any_flagged_documents
|
|
49
|
-
condition: po_checklist_issues
|
|
50
|
-
notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
|
|
51
|
-
|
|
52
|
-
- workflow_end:
|
|
53
|
-
action: move_to_ide
|
|
54
|
-
notes: |
|
|
55
|
-
Planning phase complete! Now transition to IDE Development:
|
|
56
|
-
|
|
57
|
-
1. ENSURE DOCUMENTS ARE IN PROJECT:
|
|
58
|
-
- Copy final prd.md to project's docs/prd.md
|
|
59
|
-
- Copy final architecture.md to project's docs/architecture.md
|
|
60
|
-
- All documents must be in the project before proceeding
|
|
61
|
-
|
|
62
|
-
2. SHARD DOCUMENTS (in IDE):
|
|
63
|
-
- Option A: Use PO agent to shard: @po then ask to shard docs/prd.md
|
|
64
|
-
- Option B: Manual: Drag shard-doc task + docs/prd.md into chat
|
|
65
|
-
- This creates docs/prd/ and docs/architecture/ folders with sharded content
|
|
66
|
-
|
|
67
|
-
3. START DEVELOPMENT CYCLE:
|
|
68
|
-
a. SM Agent (New Chat): @sm → *create
|
|
69
|
-
- Creates next story from sharded docs
|
|
70
|
-
- Review and approve story (Draft → Approved)
|
|
71
|
-
|
|
72
|
-
b. Dev Agent (New Chat): @dev
|
|
73
|
-
- Implements approved story
|
|
74
|
-
- Updates File List with all changes
|
|
75
|
-
- Marks story as "Review" when complete
|
|
76
|
-
|
|
77
|
-
c. QA Agent (New Chat): @qa → review-story
|
|
78
|
-
- Senior dev review with refactoring ability
|
|
79
|
-
- Fixes small issues directly
|
|
80
|
-
- Leaves checklist for remaining items
|
|
81
|
-
- Updates story status (Review → Done or stays Review)
|
|
82
|
-
|
|
83
|
-
d. If QA left unchecked items:
|
|
84
|
-
- Dev Agent (New Chat): Address remaining items
|
|
85
|
-
- Return to QA for final approval
|
|
86
|
-
|
|
87
|
-
4. REPEAT: Continue cycle for all epic stories
|
|
88
|
-
|
|
89
|
-
Reference: data#bmad-kb:IDE Development Workflow
|
|
90
|
-
|
|
91
|
-
flow_diagram: |
|
|
92
|
-
```mermaid
|
|
93
|
-
graph TD
|
|
94
|
-
A[Start: Service Development] --> B[analyst: project-brief.md]
|
|
95
|
-
B --> C[pm: prd.md]
|
|
96
|
-
C --> D[architect: architecture.md]
|
|
97
|
-
D --> E{Architecture suggests PRD changes?}
|
|
98
|
-
E -->|Yes| F[pm: update prd.md]
|
|
99
|
-
E -->|No| G[po: validate all artifacts]
|
|
100
|
-
F --> G
|
|
101
|
-
G --> H{PO finds issues?}
|
|
102
|
-
H -->|Yes| I[Return to relevant agent for fixes]
|
|
103
|
-
H -->|No| J[Move to IDE Environment]
|
|
104
|
-
I --> G
|
|
105
|
-
|
|
106
|
-
B -.-> B1[Optional: brainstorming]
|
|
107
|
-
B -.-> B2[Optional: market research]
|
|
108
|
-
D -.-> D1[Optional: technical research]
|
|
109
|
-
|
|
110
|
-
style J fill:#90EE90
|
|
111
|
-
style B fill:#FFE4B5
|
|
112
|
-
style C fill:#FFE4B5
|
|
113
|
-
style D fill:#FFE4B5
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
decision_guidance:
|
|
117
|
-
when_to_use:
|
|
118
|
-
- Building production APIs or microservices
|
|
119
|
-
- Multiple endpoints and complex business logic
|
|
120
|
-
- Need comprehensive documentation and testing
|
|
121
|
-
- Multiple team members will be involved
|
|
122
|
-
- Long-term maintenance expected
|
|
123
|
-
- Enterprise or external-facing APIs
|
|
124
|
-
|
|
125
|
-
handoff_prompts:
|
|
126
|
-
analyst_to_pm: "Project brief is complete. Save it as docs/project-brief.md in your project, then create the PRD."
|
|
127
|
-
pm_to_architect: "PRD is ready. Save it as docs/prd.md in your project, then create the service architecture."
|
|
128
|
-
architect_review: "Architecture complete. Save it as docs/architecture.md. Do you suggest any changes to the PRD stories or need new stories added?"
|
|
129
|
-
architect_to_pm: "Please update the PRD with the suggested story changes, then re-export the complete prd.md to docs/."
|
|
130
|
-
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
|
|
131
|
-
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
|
|
132
|
-
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
|
|
@@ -1,161 +0,0 @@
|
|
|
1
|
-
workflow:
|
|
2
|
-
id: greenfield-ui
|
|
3
|
-
name: Greenfield UI/Frontend Development
|
|
4
|
-
description: >-
|
|
5
|
-
Agent workflow for building frontend applications from concept to development.
|
|
6
|
-
Supports both comprehensive planning for complex UIs and rapid prototyping for simple interfaces.
|
|
7
|
-
type: greenfield
|
|
8
|
-
project_types:
|
|
9
|
-
- spa
|
|
10
|
-
- mobile-app
|
|
11
|
-
- micro-frontend
|
|
12
|
-
- static-site
|
|
13
|
-
- ui-prototype
|
|
14
|
-
- simple-interface
|
|
15
|
-
|
|
16
|
-
sequence:
|
|
17
|
-
- agent: analyst
|
|
18
|
-
creates: project-brief.md
|
|
19
|
-
optional_steps:
|
|
20
|
-
- brainstorming_session
|
|
21
|
-
- market_research_prompt
|
|
22
|
-
notes: "Can do brainstorming first, then optional deep research before creating project brief. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
|
|
23
|
-
|
|
24
|
-
- agent: pm
|
|
25
|
-
creates: prd.md
|
|
26
|
-
requires: project-brief.md
|
|
27
|
-
notes: "Creates PRD from project brief using prd-tmpl, focused on UI/frontend requirements. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
|
|
28
|
-
|
|
29
|
-
- agent: ux-expert
|
|
30
|
-
creates: front-end-spec.md
|
|
31
|
-
requires: prd.md
|
|
32
|
-
optional_steps:
|
|
33
|
-
- user_research_prompt
|
|
34
|
-
notes: "Creates UI/UX specification using front-end-spec-tmpl. SAVE OUTPUT: Copy final front-end-spec.md to your project's docs/ folder."
|
|
35
|
-
|
|
36
|
-
- agent: ux-expert
|
|
37
|
-
creates: v0_prompt (optional)
|
|
38
|
-
requires: front-end-spec.md
|
|
39
|
-
condition: user_wants_ai_generation
|
|
40
|
-
notes: "OPTIONAL BUT RECOMMENDED: Generate AI UI prompt for tools like v0, Lovable, etc. Use the generate-ai-frontend-prompt task. User can then generate UI in external tool and download project structure."
|
|
41
|
-
|
|
42
|
-
- agent: architect
|
|
43
|
-
creates: front-end-architecture.md
|
|
44
|
-
requires: front-end-spec.md
|
|
45
|
-
optional_steps:
|
|
46
|
-
- technical_research_prompt
|
|
47
|
-
- review_generated_ui_structure
|
|
48
|
-
notes: "Creates frontend architecture using front-end-architecture-tmpl. If user generated UI with v0/Lovable, can incorporate the project structure into architecture. May suggest changes to PRD stories or new stories. SAVE OUTPUT: Copy final front-end-architecture.md to your project's docs/ folder."
|
|
49
|
-
|
|
50
|
-
- agent: pm
|
|
51
|
-
updates: prd.md (if needed)
|
|
52
|
-
requires: front-end-architecture.md
|
|
53
|
-
condition: architecture_suggests_prd_changes
|
|
54
|
-
notes: "If architect suggests story changes, update PRD and re-export the complete unredacted prd.md to docs/ folder."
|
|
55
|
-
|
|
56
|
-
- agent: po
|
|
57
|
-
validates: all_artifacts
|
|
58
|
-
uses: po-master-checklist
|
|
59
|
-
notes: "Validates all documents for consistency and completeness. May require updates to any document."
|
|
60
|
-
|
|
61
|
-
- agent: various
|
|
62
|
-
updates: any_flagged_documents
|
|
63
|
-
condition: po_checklist_issues
|
|
64
|
-
notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
|
|
65
|
-
|
|
66
|
-
- project_setup_guidance:
|
|
67
|
-
action: guide_project_structure
|
|
68
|
-
condition: user_has_generated_ui
|
|
69
|
-
notes: "If user generated UI with v0/Lovable: For polyrepo setup, place downloaded project in separate frontend repo. For monorepo, place in apps/web or frontend/ directory. Review architecture document for specific guidance."
|
|
70
|
-
|
|
71
|
-
- workflow_end:
|
|
72
|
-
action: move_to_ide
|
|
73
|
-
notes: |
|
|
74
|
-
Planning phase complete! Now transition to IDE Development:
|
|
75
|
-
|
|
76
|
-
1. ENSURE DOCUMENTS ARE IN PROJECT:
|
|
77
|
-
- Copy final prd.md to project's docs/prd.md
|
|
78
|
-
- Copy final architecture.md to project's docs/architecture.md
|
|
79
|
-
- All documents must be in the project before proceeding
|
|
80
|
-
|
|
81
|
-
2. SHARD DOCUMENTS (in IDE):
|
|
82
|
-
- Option A: Use PO agent to shard: @po then ask to shard docs/prd.md
|
|
83
|
-
- Option B: Manual: Drag shard-doc task + docs/prd.md into chat
|
|
84
|
-
- This creates docs/prd/ and docs/architecture/ folders with sharded content
|
|
85
|
-
|
|
86
|
-
3. START DEVELOPMENT CYCLE:
|
|
87
|
-
a. SM Agent (New Chat): @sm → *create
|
|
88
|
-
- Creates next story from sharded docs
|
|
89
|
-
- Review and approve story (Draft → Approved)
|
|
90
|
-
|
|
91
|
-
b. Dev Agent (New Chat): @dev
|
|
92
|
-
- Implements approved story
|
|
93
|
-
- Updates File List with all changes
|
|
94
|
-
- Marks story as "Review" when complete
|
|
95
|
-
|
|
96
|
-
c. QA Agent (New Chat): @qa → review-story
|
|
97
|
-
- Senior dev review with refactoring ability
|
|
98
|
-
- Fixes small issues directly
|
|
99
|
-
- Leaves checklist for remaining items
|
|
100
|
-
- Updates story status (Review → Done or stays Review)
|
|
101
|
-
|
|
102
|
-
d. If QA left unchecked items:
|
|
103
|
-
- Dev Agent (New Chat): Address remaining items
|
|
104
|
-
- Return to QA for final approval
|
|
105
|
-
|
|
106
|
-
4. REPEAT: Continue cycle for all epic stories
|
|
107
|
-
|
|
108
|
-
Reference: data#bmad-kb:IDE Development Workflow
|
|
109
|
-
|
|
110
|
-
flow_diagram: |
|
|
111
|
-
```mermaid
|
|
112
|
-
graph TD
|
|
113
|
-
A[Start: UI Development] --> B[analyst: project-brief.md]
|
|
114
|
-
B --> C[pm: prd.md]
|
|
115
|
-
C --> D[ux-expert: front-end-spec.md]
|
|
116
|
-
D --> D2{Generate v0 prompt?}
|
|
117
|
-
D2 -->|Yes| D3[ux-expert: create v0 prompt]
|
|
118
|
-
D2 -->|No| E[architect: front-end-architecture.md]
|
|
119
|
-
D3 --> D4[User: generate UI in v0/Lovable]
|
|
120
|
-
D4 --> E
|
|
121
|
-
E --> F{Architecture suggests PRD changes?}
|
|
122
|
-
F -->|Yes| G[pm: update prd.md]
|
|
123
|
-
F -->|No| H[po: validate all artifacts]
|
|
124
|
-
G --> H
|
|
125
|
-
H --> I{PO finds issues?}
|
|
126
|
-
I -->|Yes| J[Return to relevant agent for fixes]
|
|
127
|
-
I -->|No| K[Move to IDE Environment]
|
|
128
|
-
J --> H
|
|
129
|
-
|
|
130
|
-
B -.-> B1[Optional: brainstorming]
|
|
131
|
-
B -.-> B2[Optional: market research]
|
|
132
|
-
D -.-> D1[Optional: user research]
|
|
133
|
-
E -.-> E1[Optional: technical research]
|
|
134
|
-
|
|
135
|
-
style K fill:#90EE90
|
|
136
|
-
style D3 fill:#E6E6FA
|
|
137
|
-
style D4 fill:#E6E6FA
|
|
138
|
-
style B fill:#FFE4B5
|
|
139
|
-
style C fill:#FFE4B5
|
|
140
|
-
style D fill:#FFE4B5
|
|
141
|
-
style E fill:#FFE4B5
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
decision_guidance:
|
|
145
|
-
when_to_use:
|
|
146
|
-
- Building production frontend applications
|
|
147
|
-
- Multiple views/pages with complex interactions
|
|
148
|
-
- Need comprehensive UI/UX design and testing
|
|
149
|
-
- Multiple team members will be involved
|
|
150
|
-
- Long-term maintenance expected
|
|
151
|
-
- Customer-facing applications
|
|
152
|
-
|
|
153
|
-
handoff_prompts:
|
|
154
|
-
analyst_to_pm: "Project brief is complete. Save it as docs/project-brief.md in your project, then create the PRD."
|
|
155
|
-
pm_to_ux: "PRD is ready. Save it as docs/prd.md in your project, then create the UI/UX specification."
|
|
156
|
-
ux_to_architect: "UI/UX spec complete. Save it as docs/front-end-spec.md in your project, then create the frontend architecture."
|
|
157
|
-
architect_review: "Frontend architecture complete. Save it as docs/front-end-architecture.md. Do you suggest any changes to the PRD stories or need new stories added?"
|
|
158
|
-
architect_to_pm: "Please update the PRD with the suggested story changes, then re-export the complete prd.md to docs/."
|
|
159
|
-
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
|
|
160
|
-
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
|
|
161
|
-
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
|