siesa-agents 2.1.1 → 2.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (145) hide show
  1. package/README.md +83 -83
  2. package/bin/install.js +400 -399
  3. package/bin/prepare-publish.js +26 -26
  4. package/bin/restore-folders.js +26 -26
  5. package/bmad-core/agent-teams/team-all.yaml +15 -15
  6. package/bmad-core/agent-teams/team-fullstack.yaml +19 -19
  7. package/bmad-core/agent-teams/team-ide-minimal.yaml +11 -11
  8. package/bmad-core/agent-teams/team-no-ui.yaml +14 -14
  9. package/bmad-core/agents/analyst.md +84 -84
  10. package/bmad-core/agents/architect.md +94 -94
  11. package/bmad-core/agents/backend-agent.md +189 -189
  12. package/bmad-core/agents/bmad-master.md +110 -110
  13. package/bmad-core/agents/bmad-orchestrator.md +147 -147
  14. package/bmad-core/agents/dev.md +81 -81
  15. package/bmad-core/agents/frontend-agent.md +168 -168
  16. package/bmad-core/agents/pm.md +84 -84
  17. package/bmad-core/agents/po.md +79 -79
  18. package/bmad-core/agents/qa.md +91 -91
  19. package/bmad-core/agents/sm.md +65 -65
  20. package/bmad-core/agents/ux-expert.md +69 -69
  21. package/bmad-core/checklists/architect-checklist.md +440 -440
  22. package/bmad-core/checklists/backend-checklist.md +142 -142
  23. package/bmad-core/checklists/change-checklist.md +184 -184
  24. package/bmad-core/checklists/frontend-checklist.md +105 -105
  25. package/bmad-core/checklists/pm-checklist.md +372 -372
  26. package/bmad-core/checklists/po-master-checklist.md +434 -434
  27. package/bmad-core/checklists/story-dod-checklist.md +96 -96
  28. package/bmad-core/checklists/story-draft-checklist.md +155 -155
  29. package/bmad-core/core-config.yaml +22 -22
  30. package/bmad-core/data/backend-standards.md +439 -439
  31. package/bmad-core/data/bmad-kb.md +809 -809
  32. package/bmad-core/data/brainstorming-techniques.md +38 -38
  33. package/bmad-core/data/elicitation-methods.md +156 -156
  34. package/bmad-core/data/frontend-standards.md +323 -323
  35. package/bmad-core/data/technical-preferences.md +5 -5
  36. package/bmad-core/data/test-levels-framework.md +148 -148
  37. package/bmad-core/data/test-priorities-matrix.md +174 -174
  38. package/bmad-core/enhanced-ide-development-workflow.md +248 -248
  39. package/bmad-core/install-manifest.yaml +230 -230
  40. package/bmad-core/tasks/advanced-elicitation.md +119 -119
  41. package/bmad-core/tasks/apply-qa-fixes.md +150 -150
  42. package/bmad-core/tasks/brownfield-create-epic.md +162 -162
  43. package/bmad-core/tasks/brownfield-create-story.md +149 -149
  44. package/bmad-core/tasks/correct-course.md +72 -72
  45. package/bmad-core/tasks/create-brownfield-story.md +314 -314
  46. package/bmad-core/tasks/create-component.md +102 -102
  47. package/bmad-core/tasks/create-deep-research-prompt.md +280 -280
  48. package/bmad-core/tasks/create-doc.md +103 -103
  49. package/bmad-core/tasks/create-entity.md +132 -132
  50. package/bmad-core/tasks/create-feature.md +90 -90
  51. package/bmad-core/tasks/create-next-story.md +114 -114
  52. package/bmad-core/tasks/create-service.md +117 -117
  53. package/bmad-core/tasks/create-use-case.md +140 -140
  54. package/bmad-core/tasks/document-project.md +345 -345
  55. package/bmad-core/tasks/execute-checklist.md +88 -88
  56. package/bmad-core/tasks/facilitate-brainstorming-session.md +138 -138
  57. package/bmad-core/tasks/generate-ai-frontend-prompt.md +53 -53
  58. package/bmad-core/tasks/index-docs.md +175 -175
  59. package/bmad-core/tasks/kb-mode-interaction.md +77 -77
  60. package/bmad-core/tasks/nfr-assess.md +345 -345
  61. package/bmad-core/tasks/qa-gate.md +163 -163
  62. package/bmad-core/tasks/review-story.md +316 -316
  63. package/bmad-core/tasks/risk-profile.md +355 -355
  64. package/bmad-core/tasks/scaffold-backend.md +110 -110
  65. package/bmad-core/tasks/scaffold-frontend.md +78 -78
  66. package/bmad-core/tasks/shard-doc.md +187 -187
  67. package/bmad-core/tasks/test-design.md +176 -176
  68. package/bmad-core/tasks/trace-requirements.md +266 -266
  69. package/bmad-core/tasks/validate-next-story.md +136 -136
  70. package/bmad-core/templates/architecture-tmpl.yaml +662 -662
  71. package/bmad-core/templates/brainstorming-output-tmpl.yaml +156 -156
  72. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +477 -477
  73. package/bmad-core/templates/brownfield-prd-tmpl.yaml +281 -281
  74. package/bmad-core/templates/competitor-analysis-tmpl.yaml +307 -307
  75. package/bmad-core/templates/front-end-architecture-tmpl.yaml +258 -258
  76. package/bmad-core/templates/front-end-spec-tmpl.yaml +350 -350
  77. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +824 -824
  78. package/bmad-core/templates/market-research-tmpl.yaml +253 -253
  79. package/bmad-core/templates/prd-tmpl.yaml +203 -203
  80. package/bmad-core/templates/project-brief-tmpl.yaml +222 -222
  81. package/bmad-core/templates/qa-gate-tmpl.yaml +103 -103
  82. package/bmad-core/templates/story-tmpl.yaml +138 -138
  83. package/bmad-core/user-guide.md +530 -530
  84. package/bmad-core/utils/bmad-doc-template.md +327 -327
  85. package/bmad-core/utils/workflow-management.md +71 -71
  86. package/bmad-core/workflows/brownfield-fullstack.yaml +298 -298
  87. package/bmad-core/workflows/brownfield-service.yaml +188 -188
  88. package/bmad-core/workflows/brownfield-ui.yaml +198 -198
  89. package/bmad-core/workflows/greenfield-fullstack.yaml +241 -241
  90. package/bmad-core/workflows/greenfield-service.yaml +207 -207
  91. package/bmad-core/workflows/greenfield-ui.yaml +236 -236
  92. package/bmad-core/working-in-the-brownfield.md +606 -606
  93. package/claude/commands/BMad/agents/analyst.md +88 -0
  94. package/claude/commands/BMad/agents/architect.md +89 -0
  95. package/claude/commands/BMad/agents/backend.md +188 -0
  96. package/claude/commands/BMad/agents/bmad-master.md +114 -0
  97. package/claude/commands/BMad/agents/bmad-orchestrator.md +151 -0
  98. package/claude/commands/BMad/agents/dev.md +85 -0
  99. package/claude/commands/BMad/agents/frontend.md +151 -0
  100. package/claude/commands/BMad/agents/pm.md +88 -0
  101. package/claude/commands/BMad/agents/po.md +83 -0
  102. package/claude/commands/BMad/agents/qa.md +95 -0
  103. package/claude/commands/BMad/agents/sm.md +69 -0
  104. package/claude/commands/BMad/agents/ux-expert.md +73 -0
  105. package/claude/commands/BMad/tasks/advanced-elicitation.md +123 -0
  106. package/claude/commands/BMad/tasks/apply-qa-fixes.md +154 -0
  107. package/claude/commands/BMad/tasks/brownfield-create-epic.md +166 -0
  108. package/claude/commands/BMad/tasks/brownfield-create-story.md +153 -0
  109. package/claude/commands/BMad/tasks/correct-course.md +76 -0
  110. package/claude/commands/BMad/tasks/create-brownfield-story.md +318 -0
  111. package/claude/commands/BMad/tasks/create-deep-research-prompt.md +284 -0
  112. package/claude/commands/BMad/tasks/create-doc.md +107 -0
  113. package/claude/commands/BMad/tasks/create-next-story.md +118 -0
  114. package/claude/commands/BMad/tasks/document-project.md +349 -0
  115. package/claude/commands/BMad/tasks/execute-checklist.md +92 -0
  116. package/claude/commands/BMad/tasks/facilitate-brainstorming-session.md +142 -0
  117. package/claude/commands/BMad/tasks/generate-ai-frontend-prompt.md +57 -0
  118. package/claude/commands/BMad/tasks/index-docs.md +179 -0
  119. package/claude/commands/BMad/tasks/kb-mode-interaction.md +81 -0
  120. package/claude/commands/BMad/tasks/nfr-assess.md +349 -0
  121. package/claude/commands/BMad/tasks/qa-gate.md +167 -0
  122. package/claude/commands/BMad/tasks/review-story.md +320 -0
  123. package/claude/commands/BMad/tasks/risk-profile.md +359 -0
  124. package/claude/commands/BMad/tasks/shard-doc.md +191 -0
  125. package/claude/commands/BMad/tasks/test-design.md +180 -0
  126. package/claude/commands/BMad/tasks/trace-requirements.md +270 -0
  127. package/claude/commands/BMad/tasks/validate-next-story.md +140 -0
  128. package/claude/settings.local.json +20 -0
  129. package/github/b-mad-expert.md +742 -742
  130. package/github/chatmodes/analyst.chatmode.md +89 -89
  131. package/github/chatmodes/architect.chatmode.md +97 -97
  132. package/github/chatmodes/backend.chatmode.md +194 -194
  133. package/github/chatmodes/bmad-master.chatmode.md +115 -115
  134. package/github/chatmodes/bmad-orchestrator.chatmode.md +152 -152
  135. package/github/chatmodes/dev.chatmode.md +86 -86
  136. package/github/chatmodes/frontend.chatmode.md +157 -157
  137. package/github/chatmodes/pm.chatmode.md +89 -89
  138. package/github/chatmodes/po.chatmode.md +84 -84
  139. package/github/chatmodes/qa.chatmode.md +96 -96
  140. package/github/chatmodes/sm.chatmode.md +70 -70
  141. package/github/chatmodes/ux-expert.chatmode.md +74 -74
  142. package/index.js +9 -9
  143. package/package.json +37 -36
  144. package/vscode/mcp.json +11 -11
  145. package/vscode/settings.json +12 -12
@@ -1,162 +1,162 @@
1
- <!-- Powered by BMAD™ Core -->
2
-
3
- # Create Brownfield Epic Task
4
-
5
- ## Purpose
6
-
7
- Create a single epic for smaller brownfield enhancements that don't require the full PRD and Architecture documentation process. This task is for isolated features or modifications that can be completed within a focused scope.
8
-
9
- ## When to Use This Task
10
-
11
- **Use this task when:**
12
-
13
- - The enhancement can be completed in 1-3 stories
14
- - No significant architectural changes are required
15
- - The enhancement follows existing project patterns
16
- - Integration complexity is minimal
17
- - Risk to existing system is low
18
-
19
- **Use the full brownfield PRD/Architecture process when:**
20
-
21
- - The enhancement requires multiple coordinated stories
22
- - Architectural planning is needed
23
- - Significant integration work is required
24
- - Risk assessment and mitigation planning is necessary
25
-
26
- ## Instructions
27
-
28
- ### 1. Project Analysis (Required)
29
-
30
- Before creating the epic, gather essential information about the existing project:
31
-
32
- **Existing Project Context:**
33
-
34
- - [ ] Project purpose and current functionality understood
35
- - [ ] Existing technology stack identified
36
- - [ ] Current architecture patterns noted
37
- - [ ] Integration points with existing system identified
38
-
39
- **Enhancement Scope:**
40
-
41
- - [ ] Enhancement clearly defined and scoped
42
- - [ ] Impact on existing functionality assessed
43
- - [ ] Required integration points identified
44
- - [ ] Success criteria established
45
-
46
- ### 2. Epic Creation
47
-
48
- Create a focused epic following this structure:
49
-
50
- #### Epic Title
51
-
52
- {{Enhancement Name}} - Brownfield Enhancement
53
-
54
- #### Epic Goal
55
-
56
- {{1-2 sentences describing what the epic will accomplish and why it adds value}}
57
-
58
- #### Epic Description
59
-
60
- **Existing System Context:**
61
-
62
- - Current relevant functionality: {{brief description}}
63
- - Technology stack: {{relevant existing technologies}}
64
- - Integration points: {{where new work connects to existing system}}
65
-
66
- **Enhancement Details:**
67
-
68
- - What's being added/changed: {{clear description}}
69
- - How it integrates: {{integration approach}}
70
- - Success criteria: {{measurable outcomes}}
71
-
72
- #### Stories
73
-
74
- List 1-3 focused stories that complete the epic:
75
-
76
- 1. **Story 1:** {{Story title and brief description}}
77
- 2. **Story 2:** {{Story title and brief description}}
78
- 3. **Story 3:** {{Story title and brief description}}
79
-
80
- #### Compatibility Requirements
81
-
82
- - [ ] Existing APIs remain unchanged
83
- - [ ] Database schema changes are backward compatible
84
- - [ ] UI changes follow existing patterns
85
- - [ ] Performance impact is minimal
86
-
87
- #### Risk Mitigation
88
-
89
- - **Primary Risk:** {{main risk to existing system}}
90
- - **Mitigation:** {{how risk will be addressed}}
91
- - **Rollback Plan:** {{how to undo changes if needed}}
92
-
93
- #### Definition of Done
94
-
95
- - [ ] All stories completed with acceptance criteria met
96
- - [ ] Existing functionality verified through testing
97
- - [ ] Integration points working correctly
98
- - [ ] Documentation updated appropriately
99
- - [ ] No regression in existing features
100
-
101
- ### 3. Validation Checklist
102
-
103
- Before finalizing the epic, ensure:
104
-
105
- **Scope Validation:**
106
-
107
- - [ ] Epic can be completed in 1-3 stories maximum
108
- - [ ] No architectural documentation is required
109
- - [ ] Enhancement follows existing patterns
110
- - [ ] Integration complexity is manageable
111
-
112
- **Risk Assessment:**
113
-
114
- - [ ] Risk to existing system is low
115
- - [ ] Rollback plan is feasible
116
- - [ ] Testing approach covers existing functionality
117
- - [ ] Team has sufficient knowledge of integration points
118
-
119
- **Completeness Check:**
120
-
121
- - [ ] Epic goal is clear and achievable
122
- - [ ] Stories are properly scoped
123
- - [ ] Success criteria are measurable
124
- - [ ] Dependencies are identified
125
-
126
- ### 4. Handoff to Story Manager
127
-
128
- Once the epic is validated, provide this handoff to the Story Manager:
129
-
130
- ---
131
-
132
- **Story Manager Handoff:**
133
-
134
- "Please develop detailed user stories for this brownfield epic. Key considerations:
135
-
136
- - This is an enhancement to an existing system running {{technology stack}}
137
- - Integration points: {{list key integration points}}
138
- - Existing patterns to follow: {{relevant existing patterns}}
139
- - Critical compatibility requirements: {{key requirements}}
140
- - Each story must include verification that existing functionality remains intact
141
-
142
- The epic should maintain system integrity while delivering {{epic goal}}."
143
-
144
- ---
145
-
146
- ## Success Criteria
147
-
148
- The epic creation is successful when:
149
-
150
- 1. Enhancement scope is clearly defined and appropriately sized
151
- 2. Integration approach respects existing system architecture
152
- 3. Risk to existing functionality is minimized
153
- 4. Stories are logically sequenced for safe implementation
154
- 5. Compatibility requirements are clearly specified
155
- 6. Rollback plan is feasible and documented
156
-
157
- ## Important Notes
158
-
159
- - This task is specifically for SMALL brownfield enhancements
160
- - If the scope grows beyond 3 stories, consider the full brownfield PRD process
161
- - Always prioritize existing system integrity over new functionality
162
- - When in doubt about scope or complexity, escalate to full brownfield planning
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # Create Brownfield Epic Task
4
+
5
+ ## Purpose
6
+
7
+ Create a single epic for smaller brownfield enhancements that don't require the full PRD and Architecture documentation process. This task is for isolated features or modifications that can be completed within a focused scope.
8
+
9
+ ## When to Use This Task
10
+
11
+ **Use this task when:**
12
+
13
+ - The enhancement can be completed in 1-3 stories
14
+ - No significant architectural changes are required
15
+ - The enhancement follows existing project patterns
16
+ - Integration complexity is minimal
17
+ - Risk to existing system is low
18
+
19
+ **Use the full brownfield PRD/Architecture process when:**
20
+
21
+ - The enhancement requires multiple coordinated stories
22
+ - Architectural planning is needed
23
+ - Significant integration work is required
24
+ - Risk assessment and mitigation planning is necessary
25
+
26
+ ## Instructions
27
+
28
+ ### 1. Project Analysis (Required)
29
+
30
+ Before creating the epic, gather essential information about the existing project:
31
+
32
+ **Existing Project Context:**
33
+
34
+ - [ ] Project purpose and current functionality understood
35
+ - [ ] Existing technology stack identified
36
+ - [ ] Current architecture patterns noted
37
+ - [ ] Integration points with existing system identified
38
+
39
+ **Enhancement Scope:**
40
+
41
+ - [ ] Enhancement clearly defined and scoped
42
+ - [ ] Impact on existing functionality assessed
43
+ - [ ] Required integration points identified
44
+ - [ ] Success criteria established
45
+
46
+ ### 2. Epic Creation
47
+
48
+ Create a focused epic following this structure:
49
+
50
+ #### Epic Title
51
+
52
+ {{Enhancement Name}} - Brownfield Enhancement
53
+
54
+ #### Epic Goal
55
+
56
+ {{1-2 sentences describing what the epic will accomplish and why it adds value}}
57
+
58
+ #### Epic Description
59
+
60
+ **Existing System Context:**
61
+
62
+ - Current relevant functionality: {{brief description}}
63
+ - Technology stack: {{relevant existing technologies}}
64
+ - Integration points: {{where new work connects to existing system}}
65
+
66
+ **Enhancement Details:**
67
+
68
+ - What's being added/changed: {{clear description}}
69
+ - How it integrates: {{integration approach}}
70
+ - Success criteria: {{measurable outcomes}}
71
+
72
+ #### Stories
73
+
74
+ List 1-3 focused stories that complete the epic:
75
+
76
+ 1. **Story 1:** {{Story title and brief description}}
77
+ 2. **Story 2:** {{Story title and brief description}}
78
+ 3. **Story 3:** {{Story title and brief description}}
79
+
80
+ #### Compatibility Requirements
81
+
82
+ - [ ] Existing APIs remain unchanged
83
+ - [ ] Database schema changes are backward compatible
84
+ - [ ] UI changes follow existing patterns
85
+ - [ ] Performance impact is minimal
86
+
87
+ #### Risk Mitigation
88
+
89
+ - **Primary Risk:** {{main risk to existing system}}
90
+ - **Mitigation:** {{how risk will be addressed}}
91
+ - **Rollback Plan:** {{how to undo changes if needed}}
92
+
93
+ #### Definition of Done
94
+
95
+ - [ ] All stories completed with acceptance criteria met
96
+ - [ ] Existing functionality verified through testing
97
+ - [ ] Integration points working correctly
98
+ - [ ] Documentation updated appropriately
99
+ - [ ] No regression in existing features
100
+
101
+ ### 3. Validation Checklist
102
+
103
+ Before finalizing the epic, ensure:
104
+
105
+ **Scope Validation:**
106
+
107
+ - [ ] Epic can be completed in 1-3 stories maximum
108
+ - [ ] No architectural documentation is required
109
+ - [ ] Enhancement follows existing patterns
110
+ - [ ] Integration complexity is manageable
111
+
112
+ **Risk Assessment:**
113
+
114
+ - [ ] Risk to existing system is low
115
+ - [ ] Rollback plan is feasible
116
+ - [ ] Testing approach covers existing functionality
117
+ - [ ] Team has sufficient knowledge of integration points
118
+
119
+ **Completeness Check:**
120
+
121
+ - [ ] Epic goal is clear and achievable
122
+ - [ ] Stories are properly scoped
123
+ - [ ] Success criteria are measurable
124
+ - [ ] Dependencies are identified
125
+
126
+ ### 4. Handoff to Story Manager
127
+
128
+ Once the epic is validated, provide this handoff to the Story Manager:
129
+
130
+ ---
131
+
132
+ **Story Manager Handoff:**
133
+
134
+ "Please develop detailed user stories for this brownfield epic. Key considerations:
135
+
136
+ - This is an enhancement to an existing system running {{technology stack}}
137
+ - Integration points: {{list key integration points}}
138
+ - Existing patterns to follow: {{relevant existing patterns}}
139
+ - Critical compatibility requirements: {{key requirements}}
140
+ - Each story must include verification that existing functionality remains intact
141
+
142
+ The epic should maintain system integrity while delivering {{epic goal}}."
143
+
144
+ ---
145
+
146
+ ## Success Criteria
147
+
148
+ The epic creation is successful when:
149
+
150
+ 1. Enhancement scope is clearly defined and appropriately sized
151
+ 2. Integration approach respects existing system architecture
152
+ 3. Risk to existing functionality is minimized
153
+ 4. Stories are logically sequenced for safe implementation
154
+ 5. Compatibility requirements are clearly specified
155
+ 6. Rollback plan is feasible and documented
156
+
157
+ ## Important Notes
158
+
159
+ - This task is specifically for SMALL brownfield enhancements
160
+ - If the scope grows beyond 3 stories, consider the full brownfield PRD process
161
+ - Always prioritize existing system integrity over new functionality
162
+ - When in doubt about scope or complexity, escalate to full brownfield planning
@@ -1,149 +1,149 @@
1
- <!-- Powered by BMAD™ Core -->
2
-
3
- # Create Brownfield Story Task
4
-
5
- ## Purpose
6
-
7
- Create a single user story for very small brownfield enhancements that can be completed in one focused development session. This task is for minimal additions or bug fixes that require existing system integration awareness.
8
-
9
- ## When to Use This Task
10
-
11
- **Use this task when:**
12
-
13
- - The enhancement can be completed in a single story
14
- - No new architecture or significant design is required
15
- - The change follows existing patterns exactly
16
- - Integration is straightforward with minimal risk
17
- - Change is isolated with clear boundaries
18
-
19
- **Use brownfield-create-epic when:**
20
-
21
- - The enhancement requires 2-3 coordinated stories
22
- - Some design work is needed
23
- - Multiple integration points are involved
24
-
25
- **Use the full brownfield PRD/Architecture process when:**
26
-
27
- - The enhancement requires multiple coordinated stories
28
- - Architectural planning is needed
29
- - Significant integration work is required
30
-
31
- ## Instructions
32
-
33
- ### 1. Quick Project Assessment
34
-
35
- Gather minimal but essential context about the existing project:
36
-
37
- **Current System Context:**
38
-
39
- - [ ] Relevant existing functionality identified
40
- - [ ] Technology stack for this area noted
41
- - [ ] Integration point(s) clearly understood
42
- - [ ] Existing patterns for similar work identified
43
-
44
- **Change Scope:**
45
-
46
- - [ ] Specific change clearly defined
47
- - [ ] Impact boundaries identified
48
- - [ ] Success criteria established
49
-
50
- ### 2. Story Creation
51
-
52
- Create a single focused story following this structure:
53
-
54
- #### Story Title
55
-
56
- {{Specific Enhancement}} - Brownfield Addition
57
-
58
- #### User Story
59
-
60
- As a {{user type}},
61
- I want {{specific action/capability}},
62
- So that {{clear benefit/value}}.
63
-
64
- #### Story Context
65
-
66
- **Existing System Integration:**
67
-
68
- - Integrates with: {{existing component/system}}
69
- - Technology: {{relevant tech stack}}
70
- - Follows pattern: {{existing pattern to follow}}
71
- - Touch points: {{specific integration points}}
72
-
73
- #### Acceptance Criteria
74
-
75
- **Functional Requirements:**
76
-
77
- 1. {{Primary functional requirement}}
78
- 2. {{Secondary functional requirement (if any)}}
79
- 3. {{Integration requirement}}
80
-
81
- **Integration Requirements:** 4. Existing {{relevant functionality}} continues to work unchanged 5. New functionality follows existing {{pattern}} pattern 6. Integration with {{system/component}} maintains current behavior
82
-
83
- **Quality Requirements:** 7. Change is covered by appropriate tests 8. Documentation is updated if needed 9. No regression in existing functionality verified
84
-
85
- #### Technical Notes
86
-
87
- - **Integration Approach:** {{how it connects to existing system}}
88
- - **Existing Pattern Reference:** {{link or description of pattern to follow}}
89
- - **Key Constraints:** {{any important limitations or requirements}}
90
-
91
- #### Definition of Done
92
-
93
- - [ ] Functional requirements met
94
- - [ ] Integration requirements verified
95
- - [ ] Existing functionality regression tested
96
- - [ ] Code follows existing patterns and standards
97
- - [ ] Tests pass (existing and new)
98
- - [ ] Documentation updated if applicable
99
-
100
- ### 3. Risk and Compatibility Check
101
-
102
- **Minimal Risk Assessment:**
103
-
104
- - **Primary Risk:** {{main risk to existing system}}
105
- - **Mitigation:** {{simple mitigation approach}}
106
- - **Rollback:** {{how to undo if needed}}
107
-
108
- **Compatibility Verification:**
109
-
110
- - [ ] No breaking changes to existing APIs
111
- - [ ] Database changes (if any) are additive only
112
- - [ ] UI changes follow existing design patterns
113
- - [ ] Performance impact is negligible
114
-
115
- ### 4. Validation Checklist
116
-
117
- Before finalizing the story, confirm:
118
-
119
- **Scope Validation:**
120
-
121
- - [ ] Story can be completed in one development session
122
- - [ ] Integration approach is straightforward
123
- - [ ] Follows existing patterns exactly
124
- - [ ] No design or architecture work required
125
-
126
- **Clarity Check:**
127
-
128
- - [ ] Story requirements are unambiguous
129
- - [ ] Integration points are clearly specified
130
- - [ ] Success criteria are testable
131
- - [ ] Rollback approach is simple
132
-
133
- ## Success Criteria
134
-
135
- The story creation is successful when:
136
-
137
- 1. Enhancement is clearly defined and appropriately scoped for single session
138
- 2. Integration approach is straightforward and low-risk
139
- 3. Existing system patterns are identified and will be followed
140
- 4. Rollback plan is simple and feasible
141
- 5. Acceptance criteria include existing functionality verification
142
-
143
- ## Important Notes
144
-
145
- - This task is for VERY SMALL brownfield changes only
146
- - If complexity grows during analysis, escalate to brownfield-create-epic
147
- - Always prioritize existing system integrity
148
- - When in doubt about integration complexity, use brownfield-create-epic instead
149
- - Stories should take no more than 4 hours of focused development work
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # Create Brownfield Story Task
4
+
5
+ ## Purpose
6
+
7
+ Create a single user story for very small brownfield enhancements that can be completed in one focused development session. This task is for minimal additions or bug fixes that require existing system integration awareness.
8
+
9
+ ## When to Use This Task
10
+
11
+ **Use this task when:**
12
+
13
+ - The enhancement can be completed in a single story
14
+ - No new architecture or significant design is required
15
+ - The change follows existing patterns exactly
16
+ - Integration is straightforward with minimal risk
17
+ - Change is isolated with clear boundaries
18
+
19
+ **Use brownfield-create-epic when:**
20
+
21
+ - The enhancement requires 2-3 coordinated stories
22
+ - Some design work is needed
23
+ - Multiple integration points are involved
24
+
25
+ **Use the full brownfield PRD/Architecture process when:**
26
+
27
+ - The enhancement requires multiple coordinated stories
28
+ - Architectural planning is needed
29
+ - Significant integration work is required
30
+
31
+ ## Instructions
32
+
33
+ ### 1. Quick Project Assessment
34
+
35
+ Gather minimal but essential context about the existing project:
36
+
37
+ **Current System Context:**
38
+
39
+ - [ ] Relevant existing functionality identified
40
+ - [ ] Technology stack for this area noted
41
+ - [ ] Integration point(s) clearly understood
42
+ - [ ] Existing patterns for similar work identified
43
+
44
+ **Change Scope:**
45
+
46
+ - [ ] Specific change clearly defined
47
+ - [ ] Impact boundaries identified
48
+ - [ ] Success criteria established
49
+
50
+ ### 2. Story Creation
51
+
52
+ Create a single focused story following this structure:
53
+
54
+ #### Story Title
55
+
56
+ {{Specific Enhancement}} - Brownfield Addition
57
+
58
+ #### User Story
59
+
60
+ As a {{user type}},
61
+ I want {{specific action/capability}},
62
+ So that {{clear benefit/value}}.
63
+
64
+ #### Story Context
65
+
66
+ **Existing System Integration:**
67
+
68
+ - Integrates with: {{existing component/system}}
69
+ - Technology: {{relevant tech stack}}
70
+ - Follows pattern: {{existing pattern to follow}}
71
+ - Touch points: {{specific integration points}}
72
+
73
+ #### Acceptance Criteria
74
+
75
+ **Functional Requirements:**
76
+
77
+ 1. {{Primary functional requirement}}
78
+ 2. {{Secondary functional requirement (if any)}}
79
+ 3. {{Integration requirement}}
80
+
81
+ **Integration Requirements:** 4. Existing {{relevant functionality}} continues to work unchanged 5. New functionality follows existing {{pattern}} pattern 6. Integration with {{system/component}} maintains current behavior
82
+
83
+ **Quality Requirements:** 7. Change is covered by appropriate tests 8. Documentation is updated if needed 9. No regression in existing functionality verified
84
+
85
+ #### Technical Notes
86
+
87
+ - **Integration Approach:** {{how it connects to existing system}}
88
+ - **Existing Pattern Reference:** {{link or description of pattern to follow}}
89
+ - **Key Constraints:** {{any important limitations or requirements}}
90
+
91
+ #### Definition of Done
92
+
93
+ - [ ] Functional requirements met
94
+ - [ ] Integration requirements verified
95
+ - [ ] Existing functionality regression tested
96
+ - [ ] Code follows existing patterns and standards
97
+ - [ ] Tests pass (existing and new)
98
+ - [ ] Documentation updated if applicable
99
+
100
+ ### 3. Risk and Compatibility Check
101
+
102
+ **Minimal Risk Assessment:**
103
+
104
+ - **Primary Risk:** {{main risk to existing system}}
105
+ - **Mitigation:** {{simple mitigation approach}}
106
+ - **Rollback:** {{how to undo if needed}}
107
+
108
+ **Compatibility Verification:**
109
+
110
+ - [ ] No breaking changes to existing APIs
111
+ - [ ] Database changes (if any) are additive only
112
+ - [ ] UI changes follow existing design patterns
113
+ - [ ] Performance impact is negligible
114
+
115
+ ### 4. Validation Checklist
116
+
117
+ Before finalizing the story, confirm:
118
+
119
+ **Scope Validation:**
120
+
121
+ - [ ] Story can be completed in one development session
122
+ - [ ] Integration approach is straightforward
123
+ - [ ] Follows existing patterns exactly
124
+ - [ ] No design or architecture work required
125
+
126
+ **Clarity Check:**
127
+
128
+ - [ ] Story requirements are unambiguous
129
+ - [ ] Integration points are clearly specified
130
+ - [ ] Success criteria are testable
131
+ - [ ] Rollback approach is simple
132
+
133
+ ## Success Criteria
134
+
135
+ The story creation is successful when:
136
+
137
+ 1. Enhancement is clearly defined and appropriately scoped for single session
138
+ 2. Integration approach is straightforward and low-risk
139
+ 3. Existing system patterns are identified and will be followed
140
+ 4. Rollback plan is simple and feasible
141
+ 5. Acceptance criteria include existing functionality verification
142
+
143
+ ## Important Notes
144
+
145
+ - This task is for VERY SMALL brownfield changes only
146
+ - If complexity grows during analysis, escalate to brownfield-create-epic
147
+ - Always prioritize existing system integrity
148
+ - When in doubt about integration complexity, use brownfield-create-epic instead
149
+ - Stories should take no more than 4 hours of focused development work