Skip to content

Commit 9cafbe7

Browse files
Align Brownfield workflow descriptions and artifact naming (#277)
* chore: Update brownfield-fullstack.yml - Update descriptions, status messages, and artifact names in brownfield-fullstack * chore: Update brownfield-service.yml - Update descriptions, status messages, and artifact names in brownfield-service * chore: Update brownfield-ui.yml - Update descriptions, status messages, and artifact names in brownfield-ui workflows
1 parent 466bef4 commit 9cafbe7

File tree

3 files changed

+38
-38
lines changed

3 files changed

+38
-38
lines changed

bmad-core/workflows/brownfield-fullstack.yml

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -19,21 +19,21 @@ workflow:
1919
notes: "Review existing documentation, codebase structure, and identify integration points. Document current system understanding before proceeding."
2020

2121
- agent: pm
22-
creates: brownfield-prd.md
22+
creates: prd.md
2323
uses: brownfield-prd-tmpl
2424
requires: existing_project_analysis
25-
notes: "Creates comprehensive brownfield PRD with existing system analysis and enhancement planning. SAVE OUTPUT: Copy final brownfield-prd.md to your project's docs/ folder."
25+
notes: "Creates comprehensive PRD with existing system analysis and enhancement planning. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
2626

2727
- agent: architect
28-
creates: brownfield-architecture.md
28+
creates: architecture.md
2929
uses: brownfield-architecture-tmpl
30-
requires: brownfield-prd.md
31-
notes: "Creates brownfield architecture with integration strategy and existing system constraints. SAVE OUTPUT: Copy final brownfield-architecture.md to your project's docs/ folder."
30+
requires: prd.md
31+
notes: "Creates architecture with integration strategy and existing system constraints. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
3232

3333
- agent: po
3434
validates: all_artifacts
3535
uses: po-master-checklist
36-
notes: "Validates all brownfield documents for integration safety and completeness. May require updates to any document."
36+
notes: "Validates all documents for integration safety and completeness. May require updates to any document."
3737

3838
- agent: various
3939
updates: any_flagged_documents
@@ -83,8 +83,8 @@ workflow:
8383
```mermaid
8484
graph TD
8585
A[Start: Brownfield Enhancement] --> B[analyst: analyze existing project]
86-
B --> C[pm: brownfield-prd.md]
87-
C --> D[architect: brownfield-architecture.md]
86+
B --> C[pm: prd.md]
87+
C --> D[architect: architecture.md]
8888
D --> E[po: validate with po-master-checklist]
8989
E --> F{PO finds issues?}
9090
F -->|Yes| G[Return to relevant agent for fixes]
@@ -105,8 +105,8 @@ workflow:
105105
- Multiple team members will work on related changes
106106

107107
handoff_prompts:
108-
analyst_to_pm: "Existing project analysis complete. Create comprehensive brownfield PRD with integration strategy."
109-
pm_to_architect: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the integration architecture."
110-
architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for integration safety."
108+
analyst_to_pm: "Existing project analysis complete. Create comprehensive PRD with integration strategy."
109+
pm_to_architect: "PRD ready. Save it as docs/prd.md, then create the integration architecture."
110+
architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for integration safety."
111111
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
112-
complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
112+
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."

bmad-core/workflows/brownfield-service.yml

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -20,21 +20,21 @@ workflow:
2020
notes: "Review existing service documentation, codebase, performance metrics, and identify integration dependencies."
2121

2222
- agent: pm
23-
creates: brownfield-prd.md
23+
creates: prd.md
2424
uses: brownfield-prd-tmpl
2525
requires: existing_service_analysis
26-
notes: "Creates comprehensive brownfield PRD focused on service enhancement with existing system analysis. SAVE OUTPUT: Copy final brownfield-prd.md to your project's docs/ folder."
26+
notes: "Creates comprehensive PRD focused on service enhancement with existing system analysis. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
2727

2828
- agent: architect
29-
creates: brownfield-architecture.md
29+
creates: architecture.md
3030
uses: brownfield-architecture-tmpl
31-
requires: brownfield-prd.md
32-
notes: "Creates brownfield architecture with service integration strategy and API evolution planning. SAVE OUTPUT: Copy final brownfield-architecture.md to your project's docs/ folder."
31+
requires: prd.md
32+
notes: "Creates architecture with service integration strategy and API evolution planning. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
3333

3434
- agent: po
3535
validates: all_artifacts
3636
uses: po-master-checklist
37-
notes: "Validates all brownfield documents for service integration safety and API compatibility. May require updates to any document."
37+
notes: "Validates all documents for service integration safety and API compatibility. May require updates to any document."
3838

3939
- agent: various
4040
updates: any_flagged_documents
@@ -84,8 +84,8 @@ workflow:
8484
```mermaid
8585
graph TD
8686
A[Start: Service Enhancement] --> B[analyst: analyze existing service]
87-
B --> C[pm: brownfield-prd.md]
88-
C --> D[architect: brownfield-architecture.md]
87+
B --> C[pm: prd.md]
88+
C --> D[architect: architecture.md]
8989
D --> E[po: validate with po-master-checklist]
9090
E --> F{PO finds issues?}
9191
F -->|Yes| G[Return to relevant agent for fixes]
@@ -106,8 +106,8 @@ workflow:
106106
- Multiple integration points affected
107107

108108
handoff_prompts:
109-
analyst_to_pm: "Service analysis complete. Create comprehensive brownfield PRD with service integration strategy."
110-
pm_to_architect: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the service architecture."
111-
architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for service integration safety."
109+
analyst_to_pm: "Service analysis complete. Create comprehensive PRD with service integration strategy."
110+
pm_to_architect: "PRD ready. Save it as docs/prd.md, then create the service architecture."
111+
architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for service integration safety."
112112
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
113-
complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
113+
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."

bmad-core/workflows/brownfield-ui.yml

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -19,29 +19,29 @@ workflow:
1919
notes: "Review existing frontend application, user feedback, analytics data, and identify improvement areas."
2020

2121
- agent: pm
22-
creates: brownfield-prd.md
22+
creates: prd.md
2323
uses: brownfield-prd-tmpl
2424
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."
25+
notes: "Creates comprehensive PRD focused on UI enhancement with existing system analysis. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
2626

2727
- agent: ux-expert
2828
creates: front-end-spec.md
2929
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."
30+
requires: prd.md
31+
notes: "Creates UI/UX specification that integrates with existing design patterns. SAVE OUTPUT: Copy final front-end-spec.md to your project's docs/ folder."
3232

3333
- agent: architect
34-
creates: brownfield-architecture.md
34+
creates: architecture.md
3535
uses: brownfield-architecture-tmpl
3636
requires:
37-
- brownfield-prd.md
37+
- prd.md
3838
- 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."
39+
notes: "Creates frontend architecture with component integration strategy and migration planning. SAVE OUTPUT: Copy final architecture.md to your project's docs/ folder."
4040

4141
- agent: po
4242
validates: all_artifacts
4343
uses: po-master-checklist
44-
notes: "Validates all brownfield documents for UI integration safety and design consistency. May require updates to any document."
44+
notes: "Validates all documents for UI integration safety and design consistency. May require updates to any document."
4545

4646
- agent: various
4747
updates: any_flagged_documents
@@ -91,9 +91,9 @@ workflow:
9191
```mermaid
9292
graph TD
9393
A[Start: UI Enhancement] --> B[analyst: analyze existing UI]
94-
B --> C[pm: brownfield-prd.md]
94+
B --> C[pm: prd.md]
9595
C --> D[ux-expert: front-end-spec.md]
96-
D --> E[architect: brownfield-architecture.md]
96+
D --> E[architect: architecture.md]
9797
E --> F[po: validate with po-master-checklist]
9898
F --> G{PO finds issues?}
9999
G -->|Yes| H[Return to relevant agent for fixes]
@@ -115,9 +115,9 @@ workflow:
115115
- Multiple team members will work on related changes
116116

117117
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."
118+
analyst_to_pm: "UI analysis complete. Create comprehensive PRD with UI integration strategy."
119+
pm_to_ux: "PRD ready. Save it as docs/prd.md, then create the UI/UX specification."
120120
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."
121+
architect_to_po: "Architecture complete. Save it as docs/architecture.md. Please validate all artifacts for UI integration safety."
122122
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."
123+
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."

0 commit comments

Comments
 (0)