bmad-method 6.0.0-alpha.17 → 6.0.0-alpha.19
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 +117 -0
- package/package.json +1 -1
- package/src/modules/bmgd/_module-installer/installer.js +160 -0
- package/src/modules/bmgd/_module-installer/platform-specifics/claude-code.js +23 -0
- package/src/modules/bmgd/_module-installer/platform-specifics/windsurf.js +18 -0
- package/src/modules/bmgd/agents/game-architect.agent.yaml +23 -8
- package/src/modules/bmgd/agents/game-designer.agent.yaml +38 -18
- package/src/modules/bmgd/agents/game-dev.agent.yaml +30 -14
- package/src/modules/bmgd/agents/game-qa.agent.yaml +64 -0
- package/src/modules/bmgd/agents/game-scrum-master.agent.yaml +27 -39
- package/src/modules/bmgd/agents/game-solo-dev.agent.yaml +56 -0
- package/src/modules/bmgd/docs/README.md +180 -0
- package/src/modules/bmgd/docs/agents-guide.md +407 -0
- package/src/modules/bmgd/docs/game-types-guide.md +503 -0
- package/src/modules/bmgd/docs/glossary.md +294 -0
- package/src/modules/bmgd/docs/quick-flow-guide.md +288 -0
- package/src/modules/bmgd/docs/quick-start.md +250 -0
- package/src/modules/bmgd/docs/troubleshooting.md +259 -0
- package/src/modules/bmgd/docs/workflow-overview.jpg +0 -0
- package/src/modules/bmgd/docs/workflows-guide.md +463 -0
- package/src/modules/bmgd/gametest/knowledge/balance-testing.md +220 -0
- package/src/modules/bmgd/gametest/knowledge/certification-testing.md +319 -0
- package/src/modules/bmgd/gametest/knowledge/compatibility-testing.md +228 -0
- package/src/modules/bmgd/gametest/knowledge/godot-testing.md +376 -0
- package/src/modules/bmgd/gametest/knowledge/input-testing.md +315 -0
- package/src/modules/bmgd/gametest/knowledge/localization-testing.md +304 -0
- package/src/modules/bmgd/gametest/knowledge/multiplayer-testing.md +322 -0
- package/src/modules/bmgd/gametest/knowledge/performance-testing.md +204 -0
- package/src/modules/bmgd/gametest/knowledge/playtesting.md +384 -0
- package/src/modules/bmgd/gametest/knowledge/qa-automation.md +190 -0
- package/src/modules/bmgd/gametest/knowledge/regression-testing.md +280 -0
- package/src/modules/bmgd/gametest/knowledge/save-testing.md +280 -0
- package/src/modules/bmgd/gametest/knowledge/smoke-testing.md +404 -0
- package/src/modules/bmgd/gametest/knowledge/test-priorities.md +271 -0
- package/src/modules/bmgd/gametest/knowledge/unity-testing.md +383 -0
- package/src/modules/bmgd/gametest/knowledge/unreal-testing.md +388 -0
- package/src/modules/bmgd/gametest/qa-index.csv +17 -0
- package/src/modules/bmgd/module.yaml +25 -9
- package/src/modules/bmgd/teams/default-party.csv +2 -0
- package/src/modules/bmgd/teams/team-gamedev.yaml +12 -1
- package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-01-init.md +164 -0
- package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-02-context.md +210 -0
- package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-03-ideation.md +289 -0
- package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-04-complete.md +275 -0
- package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.md +49 -0
- package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml +29 -8
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-01-init.md +223 -0
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-01b-continue.md +151 -0
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-02-vision.md +218 -0
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-03-market.md +218 -0
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-04-fundamentals.md +231 -0
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-05-scope.md +242 -0
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-06-references.md +224 -0
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-07-content.md +282 -0
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-08-complete.md +296 -0
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.md +62 -0
- package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml +40 -9
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-01-init.md +248 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-01b-continue.md +173 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-02-context.md +332 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-03-platforms.md +245 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-04-vision.md +229 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-05-core-gameplay.md +258 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-06-mechanics.md +249 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-07-game-type.md +266 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-08-progression.md +272 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-09-levels.md +264 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-10-art-audio.md +255 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-11-technical.md +275 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-12-epics.md +284 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-13-metrics.md +250 -0
- package/src/modules/bmgd/workflows/2-design/gdd/steps/step-14-complete.md +335 -0
- package/src/modules/bmgd/workflows/2-design/gdd/workflow.md +61 -0
- package/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml +27 -7
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01-init.md +228 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01b-continue.md +163 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-02-foundation.md +262 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-03-story.md +238 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-04-characters.md +297 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-05-world.md +262 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-06-dialogue.md +250 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-07-environmental.md +244 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-08-delivery.md +264 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-09-integration.md +254 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-10-production.md +262 -0
- package/src/modules/bmgd/workflows/2-design/narrative/steps/step-11-complete.md +331 -0
- package/src/modules/bmgd/workflows/2-design/narrative/workflow.md +57 -0
- package/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml +53 -8
- package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-01-init.md +223 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-01b-continue.md +153 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-02-context.md +262 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-03-starter.md +290 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-04-decisions.md +300 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-05-crosscutting.md +319 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-06-structure.md +304 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-07-patterns.md +349 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-08-validation.md +293 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-09-complete.md +302 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.md +55 -0
- package/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml +50 -21
- package/src/modules/bmgd/workflows/4-production/code-review/checklist.md +23 -0
- package/src/modules/bmgd/workflows/4-production/code-review/instructions.xml +225 -0
- package/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml +18 -15
- package/src/modules/bmgd/workflows/4-production/correct-course/checklist.md +1 -1
- package/src/modules/bmgd/workflows/4-production/correct-course/instructions.md +1 -1
- package/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml +11 -6
- package/src/modules/bmgd/workflows/4-production/create-story/checklist.md +332 -214
- package/src/modules/bmgd/workflows/4-production/create-story/instructions.xml +298 -0
- package/src/modules/bmgd/workflows/4-production/create-story/template.md +3 -5
- package/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml +12 -7
- package/src/modules/bmgd/workflows/4-production/dev-story/checklist.md +65 -23
- package/src/modules/bmgd/workflows/4-production/dev-story/instructions.xml +409 -0
- package/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml +13 -3
- package/src/modules/bmgd/workflows/4-production/retrospective/instructions.md +4 -4
- package/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml +12 -7
- package/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md +32 -41
- package/src/modules/bmgd/workflows/4-production/sprint-planning/sprint-status-template.yaml +13 -13
- package/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml +6 -1
- package/src/modules/bmgd/workflows/4-production/sprint-status/instructions.md +229 -0
- package/src/modules/bmgd/workflows/4-production/sprint-status/workflow.yaml +35 -0
- package/src/modules/bmgd/workflows/bmgd-quick-flow/create-tech-spec/instructions.md +140 -0
- package/src/modules/bmgd/workflows/bmgd-quick-flow/create-tech-spec/workflow.yaml +27 -0
- package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/checklist.md +37 -0
- package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/instructions.md +220 -0
- package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/workflow.yaml +45 -0
- package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/checklist.md +26 -0
- package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/instructions.md +156 -0
- package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/workflow.yaml +36 -0
- package/src/modules/bmgd/workflows/gametest/automate/checklist.md +93 -0
- package/src/modules/bmgd/workflows/gametest/automate/instructions.md +317 -0
- package/src/modules/bmgd/workflows/gametest/automate/workflow.yaml +50 -0
- package/src/modules/bmgd/workflows/gametest/performance/checklist.md +96 -0
- package/src/modules/bmgd/workflows/gametest/performance/instructions.md +323 -0
- package/src/modules/bmgd/workflows/gametest/performance/performance-template.md +256 -0
- package/src/modules/bmgd/workflows/gametest/performance/workflow.yaml +48 -0
- package/src/modules/bmgd/workflows/gametest/playtest-plan/checklist.md +93 -0
- package/src/modules/bmgd/workflows/gametest/playtest-plan/instructions.md +297 -0
- package/src/modules/bmgd/workflows/gametest/playtest-plan/playtest-template.md +208 -0
- package/src/modules/bmgd/workflows/gametest/playtest-plan/workflow.yaml +59 -0
- package/src/modules/bmgd/workflows/gametest/test-design/checklist.md +98 -0
- package/src/modules/bmgd/workflows/gametest/test-design/instructions.md +280 -0
- package/src/modules/bmgd/workflows/gametest/test-design/test-design-template.md +205 -0
- package/src/modules/bmgd/workflows/gametest/test-design/workflow.yaml +47 -0
- package/src/modules/bmgd/workflows/gametest/test-framework/checklist.md +103 -0
- package/src/modules/bmgd/workflows/gametest/test-framework/instructions.md +348 -0
- package/src/modules/bmgd/workflows/gametest/test-framework/workflow.yaml +48 -0
- package/src/modules/bmgd/workflows/gametest/test-review/checklist.md +87 -0
- package/src/modules/bmgd/workflows/gametest/test-review/instructions.md +272 -0
- package/src/modules/bmgd/workflows/gametest/test-review/test-review-template.md +203 -0
- package/src/modules/bmgd/workflows/gametest/test-review/workflow.yaml +48 -0
- package/src/modules/bmgd/workflows/workflow-status/init/instructions.md +299 -0
- package/src/modules/bmgd/workflows/workflow-status/init/workflow.yaml +29 -0
- package/src/modules/bmgd/workflows/workflow-status/instructions.md +395 -0
- package/src/modules/bmgd/workflows/workflow-status/paths/gamedev-brownfield.yaml +65 -0
- package/src/modules/bmgd/workflows/workflow-status/paths/gamedev-greenfield.yaml +71 -0
- package/src/modules/bmgd/workflows/workflow-status/paths/quickflow-brownfield.yaml +29 -0
- package/src/modules/bmgd/workflows/workflow-status/paths/quickflow-greenfield.yaml +39 -0
- package/src/modules/bmgd/workflows/workflow-status/project-levels.yaml +63 -0
- package/src/modules/bmgd/workflows/workflow-status/workflow-status-template.yaml +24 -0
- package/src/modules/bmgd/workflows/workflow-status/workflow.yaml +30 -0
- package/tools/cli/commands/install.js +9 -0
- package/tools/cli/installers/lib/core/installer.js +140 -592
- package/tools/cli/installers/lib/modules/manager.js +15 -3
- package/tools/cli/lib/agent/compiler.js +99 -0
- package/tools/cli/lib/ui.js +78 -27
- package/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md +0 -502
- package/src/modules/bmgd/workflows/4-production/code-review/instructions.md +0 -398
- package/src/modules/bmgd/workflows/4-production/create-story/instructions.md +0 -256
- package/src/modules/bmgd/workflows/4-production/dev-story/instructions.md +0 -267
- package/src/modules/bmgd/workflows/4-production/epic-tech-context/checklist.md +0 -17
- package/src/modules/bmgd/workflows/4-production/epic-tech-context/instructions.md +0 -164
- package/src/modules/bmgd/workflows/4-production/epic-tech-context/template.md +0 -76
- package/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml +0 -58
- package/src/modules/bmgd/workflows/4-production/story-context/checklist.md +0 -16
- package/src/modules/bmgd/workflows/4-production/story-context/context-template.xml +0 -34
- package/src/modules/bmgd/workflows/4-production/story-context/instructions.md +0 -209
- package/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml +0 -63
- package/src/modules/bmgd/workflows/4-production/story-done/instructions.md +0 -111
- package/src/modules/bmgd/workflows/4-production/story-done/workflow.yaml +0 -28
- package/src/modules/bmgd/workflows/4-production/story-ready/instructions.md +0 -117
- package/src/modules/bmgd/workflows/4-production/story-ready/workflow.yaml +0 -25
- /package/src/modules/bmgd/workflows/1-preproduction/game-brief/{template.md → templates/game-brief-template.md} +0 -0
- /package/src/modules/bmgd/workflows/2-design/gdd/{gdd-template.md → templates/gdd-template.md} +0 -0
- /package/src/modules/bmgd/workflows/2-design/narrative/{narrative-template.md → templates/narrative-template.md} +0 -0
- /package/src/modules/bmgd/workflows/3-technical/game-architecture/{architecture-template.md → templates/architecture-template.md} +0 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Sprint Planning - Sprint Status Generator
|
|
2
2
|
|
|
3
3
|
<critical>The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml</critical>
|
|
4
|
-
<critical>You MUST have already loaded and processed: {project-root}/\_bmad/
|
|
4
|
+
<critical>You MUST have already loaded and processed: {project-root}/\_bmad/bmgd/workflows/4-production/sprint-planning/workflow.yaml</critical>
|
|
5
5
|
|
|
6
6
|
## 📚 Document Discovery - Full Epic Loading
|
|
7
7
|
|
|
@@ -68,34 +68,23 @@ development_status:
|
|
|
68
68
|
</step>
|
|
69
69
|
|
|
70
70
|
<step n="3" goal="Apply intelligent status detection">
|
|
71
|
-
<action>For each epic, check if tech context file exists:</action>
|
|
72
|
-
|
|
73
|
-
- Check: `{output_folder}/epic-{num}-context.md`
|
|
74
|
-
- If exists → set epic status to `contexted`
|
|
75
|
-
- Else → keep as `backlog`
|
|
76
|
-
|
|
77
71
|
<action>For each story, detect current status by checking files:</action>
|
|
78
72
|
|
|
79
73
|
**Story file detection:**
|
|
80
74
|
|
|
81
75
|
- Check: `{story_location_absolute}/{story-key}.md` (e.g., `stories/1-1-user-authentication.md`)
|
|
82
|
-
- If exists → upgrade status to at least `drafted`
|
|
83
|
-
|
|
84
|
-
**Story context detection:**
|
|
85
|
-
|
|
86
|
-
- Check: `{story_location_absolute}/{story-key}-context.md` (e.g., `stories/1-1-user-authentication-context.md`)
|
|
87
76
|
- If exists → upgrade status to at least `ready-for-dev`
|
|
88
77
|
|
|
89
78
|
**Preservation rule:**
|
|
90
79
|
|
|
91
80
|
- If existing `{status_file}` exists and has more advanced status, preserve it
|
|
92
|
-
- Never downgrade status (e.g., don't change `done` to `
|
|
81
|
+
- Never downgrade status (e.g., don't change `done` to `ready-for-dev`)
|
|
93
82
|
|
|
94
83
|
**Status Flow Reference:**
|
|
95
84
|
|
|
96
|
-
- Epic: `backlog` → `
|
|
97
|
-
- Story: `backlog` → `
|
|
98
|
-
- Retrospective: `optional` ↔ `
|
|
85
|
+
- Epic: `backlog` → `in-progress` → `done`
|
|
86
|
+
- Story: `backlog` → `ready-for-dev` → `in-progress` → `review` → `done`
|
|
87
|
+
- Retrospective: `optional` ↔ `done`
|
|
99
88
|
</step>
|
|
100
89
|
|
|
101
90
|
<step n="4" goal="Generate sprint status file">
|
|
@@ -113,27 +102,31 @@ development_status:
|
|
|
113
102
|
# STATUS DEFINITIONS:
|
|
114
103
|
# ==================
|
|
115
104
|
# Epic Status:
|
|
116
|
-
# - backlog: Epic
|
|
117
|
-
# -
|
|
105
|
+
# - backlog: Epic not yet started
|
|
106
|
+
# - in-progress: Epic actively being worked on
|
|
107
|
+
# - done: All stories in epic completed
|
|
108
|
+
#
|
|
109
|
+
# Epic Status Transitions:
|
|
110
|
+
# - backlog → in-progress: Automatically when first story is created (via create-story)
|
|
111
|
+
# - in-progress → done: Manually when all stories reach 'done' status
|
|
118
112
|
#
|
|
119
113
|
# Story Status:
|
|
120
114
|
# - backlog: Story only exists in epic file
|
|
121
|
-
# -
|
|
122
|
-
# - ready-for-dev: Draft approved and story context created
|
|
115
|
+
# - ready-for-dev: Story file created in stories folder
|
|
123
116
|
# - in-progress: Developer actively working on implementation
|
|
124
|
-
# - review:
|
|
117
|
+
# - review: Ready for code review (via Dev's code-review workflow)
|
|
125
118
|
# - done: Story completed
|
|
126
119
|
#
|
|
127
120
|
# Retrospective Status:
|
|
128
121
|
# - optional: Can be completed but not required
|
|
129
|
-
# -
|
|
122
|
+
# - done: Retrospective has been completed
|
|
130
123
|
#
|
|
131
124
|
# WORKFLOW NOTES:
|
|
132
125
|
# ===============
|
|
133
|
-
# -
|
|
126
|
+
# - Epic transitions to 'in-progress' automatically when first story is created
|
|
134
127
|
# - Stories can be worked in parallel if team capacity allows
|
|
135
|
-
# - SM typically
|
|
136
|
-
# - Dev moves story to 'review',
|
|
128
|
+
# - SM typically creates next story after previous one is 'done' to incorporate learnings
|
|
129
|
+
# - Dev moves story to 'review', then runs code-review (fresh context, different LLM recommended)
|
|
137
130
|
|
|
138
131
|
generated: { date }
|
|
139
132
|
project: { project_name }
|
|
@@ -164,8 +157,7 @@ development_status:
|
|
|
164
157
|
|
|
165
158
|
- Total epics: {{epic_count}}
|
|
166
159
|
- Total stories: {{story_count}}
|
|
167
|
-
- Epics
|
|
168
|
-
- Stories in progress: {{in_progress_count}}
|
|
160
|
+
- Epics in-progress: {{in_progress_count}}
|
|
169
161
|
- Stories done: {{done_count}}
|
|
170
162
|
|
|
171
163
|
<action>Display completion summary to {user_name} in {communication_language}:</action>
|
|
@@ -175,8 +167,7 @@ development_status:
|
|
|
175
167
|
- **File Location:** {status_file}
|
|
176
168
|
- **Total Epics:** {{epic_count}}
|
|
177
169
|
- **Total Stories:** {{story_count}}
|
|
178
|
-
- **
|
|
179
|
-
- **Stories In Progress:** {{in_progress_count}}
|
|
170
|
+
- **Epics In Progress:** {{epics_in_progress_count}}
|
|
180
171
|
- **Stories Completed:** {{done_count}}
|
|
181
172
|
|
|
182
173
|
**Next Steps:**
|
|
@@ -197,38 +188,38 @@ development_status:
|
|
|
197
188
|
**Epic Status Flow:**
|
|
198
189
|
|
|
199
190
|
```
|
|
200
|
-
backlog →
|
|
191
|
+
backlog → in-progress → done
|
|
201
192
|
```
|
|
202
193
|
|
|
203
|
-
- **backlog**: Epic
|
|
204
|
-
- **
|
|
194
|
+
- **backlog**: Epic not yet started
|
|
195
|
+
- **in-progress**: Epic actively being worked on (stories being created/implemented)
|
|
196
|
+
- **done**: All stories in epic completed
|
|
205
197
|
|
|
206
198
|
**Story Status Flow:**
|
|
207
199
|
|
|
208
200
|
```
|
|
209
|
-
backlog →
|
|
201
|
+
backlog → ready-for-dev → in-progress → review → done
|
|
210
202
|
```
|
|
211
203
|
|
|
212
204
|
- **backlog**: Story only exists in epic file
|
|
213
|
-
- **
|
|
214
|
-
- **ready-for-dev**: Draft approved + story context created
|
|
205
|
+
- **ready-for-dev**: Story file created (e.g., `stories/1-3-plant-naming.md`)
|
|
215
206
|
- **in-progress**: Developer actively working
|
|
216
|
-
- **review**:
|
|
207
|
+
- **review**: Ready for code review (via Dev's code-review workflow)
|
|
217
208
|
- **done**: Completed
|
|
218
209
|
|
|
219
210
|
**Retrospective Status:**
|
|
220
211
|
|
|
221
212
|
```
|
|
222
|
-
optional ↔
|
|
213
|
+
optional ↔ done
|
|
223
214
|
```
|
|
224
215
|
|
|
225
|
-
- **optional**:
|
|
226
|
-
- **
|
|
216
|
+
- **optional**: Ready to be conducted but not required
|
|
217
|
+
- **done**: Finished
|
|
227
218
|
|
|
228
219
|
### Guidelines
|
|
229
220
|
|
|
230
|
-
1. **Epic
|
|
221
|
+
1. **Epic Activation**: Mark epic as `in-progress` when starting work on its first story
|
|
231
222
|
2. **Sequential Default**: Stories are typically worked in order, but parallel work is supported
|
|
232
223
|
3. **Parallel Work Supported**: Multiple stories can be `in-progress` if team capacity allows
|
|
233
224
|
4. **Review Before Done**: Stories should pass through `review` before `done`
|
|
234
|
-
5. **Learning Transfer**: SM typically
|
|
225
|
+
5. **Learning Transfer**: SM typically creates next story after previous one is `done` to incorporate learnings
|
|
@@ -11,26 +11,26 @@
|
|
|
11
11
|
# STATUS DEFINITIONS:
|
|
12
12
|
# ==================
|
|
13
13
|
# Epic Status:
|
|
14
|
-
# - backlog: Epic
|
|
15
|
-
# -
|
|
14
|
+
# - backlog: Epic not yet started
|
|
15
|
+
# - in-progress: Epic actively being worked on
|
|
16
|
+
# - done: All stories in epic completed
|
|
16
17
|
#
|
|
17
18
|
# Story Status:
|
|
18
19
|
# - backlog: Story only exists in epic file
|
|
19
|
-
# -
|
|
20
|
-
# -
|
|
21
|
-
# -
|
|
22
|
-
# -
|
|
23
|
-
# - done: Story completed by *story-done
|
|
20
|
+
# - ready-for-dev: Story file created, ready for development
|
|
21
|
+
# - in-progress: Developer actively working on implementation
|
|
22
|
+
# - review: Implementation complete, ready for review
|
|
23
|
+
# - done: Story completed
|
|
24
24
|
#
|
|
25
25
|
# Retrospective Status:
|
|
26
26
|
# - optional: Can be completed but not required
|
|
27
|
-
# -
|
|
27
|
+
# - done: Retrospective has been completed
|
|
28
28
|
#
|
|
29
29
|
# WORKFLOW NOTES:
|
|
30
30
|
# ===============
|
|
31
|
-
# -
|
|
32
|
-
# - SM typically
|
|
33
|
-
# - Dev moves story to 'review',
|
|
31
|
+
# - Mark epic as 'in-progress' when starting work on its first story
|
|
32
|
+
# - SM typically creates next story ONLY after previous one is 'done' to incorporate learnings
|
|
33
|
+
# - Dev moves story to 'review', then Dev runs code-review (fresh context, ideally different LLM)
|
|
34
34
|
|
|
35
35
|
# EXAMPLE STRUCTURE (your actual epics/stories will replace these):
|
|
36
36
|
|
|
@@ -41,9 +41,9 @@ tracking_system: file-system
|
|
|
41
41
|
story_location: "{story_location}"
|
|
42
42
|
|
|
43
43
|
development_status:
|
|
44
|
-
epic-1:
|
|
44
|
+
epic-1: backlog
|
|
45
45
|
1-1-user-authentication: done
|
|
46
|
-
1-2-account-management:
|
|
46
|
+
1-2-account-management: ready-for-dev
|
|
47
47
|
1-3-plant-data-model: backlog
|
|
48
48
|
1-4-add-plant-manual: backlog
|
|
49
49
|
epic-1-retrospective: optional
|
|
@@ -11,7 +11,7 @@ date: system-generated
|
|
|
11
11
|
sprint_artifacts: "{config_source}:sprint_artifacts"
|
|
12
12
|
|
|
13
13
|
# Workflow components
|
|
14
|
-
installed_path: "{project-root}/_bmad/
|
|
14
|
+
installed_path: "{project-root}/_bmad/bmgd/workflows/4-production/sprint-planning"
|
|
15
15
|
instructions: "{installed_path}/instructions.md"
|
|
16
16
|
template: "{installed_path}/sprint-status-template.yaml"
|
|
17
17
|
validation: "{installed_path}/checklist.md"
|
|
@@ -37,6 +37,11 @@ variables:
|
|
|
37
37
|
# Priority: Whole document first, then sharded version
|
|
38
38
|
# Strategy: FULL LOAD - sprint planning needs ALL epics to build complete status
|
|
39
39
|
input_file_patterns:
|
|
40
|
+
gdd:
|
|
41
|
+
description: "Game Design Document"
|
|
42
|
+
whole: "{output_folder}/*gdd*.md"
|
|
43
|
+
sharded: "{output_folder}/*gdd*/*.md"
|
|
44
|
+
load_strategy: "FULL_LOAD"
|
|
40
45
|
epics:
|
|
41
46
|
description: "All epics with user stories"
|
|
42
47
|
whole: "{output_folder}/*epic*.md"
|
|
@@ -0,0 +1,229 @@
|
|
|
1
|
+
# Sprint Status - Multi-Mode Service
|
|
2
|
+
|
|
3
|
+
<critical>The workflow execution engine is governed by: {project-root}/\_bmad/core/tasks/workflow.xml</critical>
|
|
4
|
+
<critical>You MUST have already loaded and processed: {project-root}/\_bmad/bmgd/workflows/4-production/sprint-status/workflow.yaml</critical>
|
|
5
|
+
<critical>Modes: interactive (default), validate, data</critical>
|
|
6
|
+
<critical>⚠️ ABSOLUTELY NO TIME ESTIMATES. Do NOT mention hours, days, weeks, or timelines.</critical>
|
|
7
|
+
|
|
8
|
+
<workflow>
|
|
9
|
+
|
|
10
|
+
<step n="0" goal="Determine execution mode">
|
|
11
|
+
<action>Set mode = {{mode}} if provided by caller; otherwise mode = "interactive"</action>
|
|
12
|
+
|
|
13
|
+
<check if="mode == data">
|
|
14
|
+
<action>Jump to Step 20</action>
|
|
15
|
+
</check>
|
|
16
|
+
|
|
17
|
+
<check if="mode == validate">
|
|
18
|
+
<action>Jump to Step 30</action>
|
|
19
|
+
</check>
|
|
20
|
+
|
|
21
|
+
<check if="mode == interactive">
|
|
22
|
+
<action>Continue to Step 1</action>
|
|
23
|
+
</check>
|
|
24
|
+
</step>
|
|
25
|
+
|
|
26
|
+
<step n="1" goal="Locate sprint status file">
|
|
27
|
+
<action>Try {sprint_status_file}</action>
|
|
28
|
+
<check if="file not found">
|
|
29
|
+
<output>❌ sprint-status.yaml not found.
|
|
30
|
+
Run `/bmad:bmgd:workflows:sprint-planning` to generate it, then rerun sprint-status.</output>
|
|
31
|
+
<action>Exit workflow</action>
|
|
32
|
+
</check>
|
|
33
|
+
<action>Continue to Step 2</action>
|
|
34
|
+
</step>
|
|
35
|
+
|
|
36
|
+
<step n="2" goal="Read and parse sprint-status.yaml">
|
|
37
|
+
<action>Read the FULL file: {sprint_status_file}</action>
|
|
38
|
+
<action>Parse fields: generated, project, project_key, tracking_system, story_location</action>
|
|
39
|
+
<action>Parse development_status map. Classify keys:</action>
|
|
40
|
+
- Epics: keys starting with "epic-" (and not ending with "-retrospective")
|
|
41
|
+
- Retrospectives: keys ending with "-retrospective"
|
|
42
|
+
- Stories: everything else (e.g., 1-2-login-form)
|
|
43
|
+
<action>Map legacy story status "drafted" → "ready-for-dev"</action>
|
|
44
|
+
<action>Count story statuses: backlog, ready-for-dev, in-progress, review, done</action>
|
|
45
|
+
<action>Map legacy epic status "contexted" → "in-progress"</action>
|
|
46
|
+
<action>Count epic statuses: backlog, in-progress, done</action>
|
|
47
|
+
<action>Count retrospective statuses: optional, done</action>
|
|
48
|
+
|
|
49
|
+
<action>Validate all statuses against known values:</action>
|
|
50
|
+
|
|
51
|
+
- Valid story statuses: backlog, ready-for-dev, in-progress, review, done, drafted (legacy)
|
|
52
|
+
- Valid epic statuses: backlog, in-progress, done, contexted (legacy)
|
|
53
|
+
- Valid retrospective statuses: optional, done
|
|
54
|
+
|
|
55
|
+
<check if="any status is unrecognized">
|
|
56
|
+
<output>
|
|
57
|
+
⚠️ **Unknown status detected:**
|
|
58
|
+
{{#each invalid_entries}}
|
|
59
|
+
|
|
60
|
+
- `{{key}}`: "{{status}}" (not recognized)
|
|
61
|
+
{{/each}}
|
|
62
|
+
|
|
63
|
+
**Valid statuses:**
|
|
64
|
+
|
|
65
|
+
- Stories: backlog, ready-for-dev, in-progress, review, done
|
|
66
|
+
- Epics: backlog, in-progress, done
|
|
67
|
+
- Retrospectives: optional, done
|
|
68
|
+
</output>
|
|
69
|
+
<ask>How should these be corrected?
|
|
70
|
+
{{#each invalid_entries}}
|
|
71
|
+
{{@index}}. {{key}}: "{{status}}" → [select valid status]
|
|
72
|
+
{{/each}}
|
|
73
|
+
|
|
74
|
+
Enter corrections (e.g., "1=in-progress, 2=backlog") or "skip" to continue without fixing:</ask>
|
|
75
|
+
<check if="user provided corrections">
|
|
76
|
+
<action>Update sprint-status.yaml with corrected values</action>
|
|
77
|
+
<action>Re-parse the file with corrected statuses</action>
|
|
78
|
+
</check>
|
|
79
|
+
</check>
|
|
80
|
+
|
|
81
|
+
<action>Detect risks:</action>
|
|
82
|
+
|
|
83
|
+
- IF any story has status "review": suggest `/bmad:bmgd:workflows:code-review`
|
|
84
|
+
- IF any story has status "in-progress" AND no stories have status "ready-for-dev": recommend staying focused on active story
|
|
85
|
+
- IF all epics have status "backlog" AND no stories have status "ready-for-dev": prompt `/bmad:bmgd:workflows:create-story`
|
|
86
|
+
- IF `generated` timestamp is more than 7 days old: warn "sprint-status.yaml may be stale"
|
|
87
|
+
- IF any story key doesn't match an epic pattern (e.g., story "5-1-..." but no "epic-5"): warn "orphaned story detected"
|
|
88
|
+
- IF any epic has status in-progress but has no associated stories: warn "in-progress epic has no stories"
|
|
89
|
+
</step>
|
|
90
|
+
|
|
91
|
+
<step n="3" goal="Select next action recommendation">
|
|
92
|
+
<action>Pick the next recommended workflow using priority:</action>
|
|
93
|
+
<note>When selecting "first" story: sort by epic number, then story number (e.g., 1-1 before 1-2 before 2-1)</note>
|
|
94
|
+
1. If any story status == in-progress → recommend `dev-story` for the first in-progress story
|
|
95
|
+
2. Else if any story status == review → recommend `code-review` for the first review story
|
|
96
|
+
3. Else if any story status == ready-for-dev → recommend `dev-story`
|
|
97
|
+
4. Else if any story status == backlog → recommend `create-story`
|
|
98
|
+
5. Else if any retrospective status == optional → recommend `retrospective`
|
|
99
|
+
6. Else → All implementation items done; suggest `workflow-status` to plan next phase
|
|
100
|
+
<action>Store selected recommendation as: next_story_id, next_workflow_id, next_agent (SM/DEV as appropriate)</action>
|
|
101
|
+
</step>
|
|
102
|
+
|
|
103
|
+
<step n="4" goal="Display summary">
|
|
104
|
+
<output>
|
|
105
|
+
## 📊 Sprint Status
|
|
106
|
+
|
|
107
|
+
- Project: {{project}} ({{project_key}})
|
|
108
|
+
- Tracking: {{tracking_system}}
|
|
109
|
+
- Status file: {sprint_status_file}
|
|
110
|
+
|
|
111
|
+
**Stories:** backlog {{count_backlog}}, ready-for-dev {{count_ready}}, in-progress {{count_in_progress}}, review {{count_review}}, done {{count_done}}
|
|
112
|
+
|
|
113
|
+
**Epics:** backlog {{epic_backlog}}, in-progress {{epic_in_progress}}, done {{epic_done}}
|
|
114
|
+
|
|
115
|
+
**Next Recommendation:** /bmad:bmgd:workflows:{{next_workflow_id}} ({{next_story_id}})
|
|
116
|
+
|
|
117
|
+
{{#if risks}}
|
|
118
|
+
**Risks:**
|
|
119
|
+
{{#each risks}}
|
|
120
|
+
|
|
121
|
+
- {{this}}
|
|
122
|
+
{{/each}}
|
|
123
|
+
{{/if}}
|
|
124
|
+
|
|
125
|
+
</output>
|
|
126
|
+
</step>
|
|
127
|
+
|
|
128
|
+
<step n="5" goal="Offer actions">
|
|
129
|
+
<ask>Pick an option:
|
|
130
|
+
1) Run recommended workflow now
|
|
131
|
+
2) Show all stories grouped by status
|
|
132
|
+
3) Show raw sprint-status.yaml
|
|
133
|
+
4) Exit
|
|
134
|
+
Choice:</ask>
|
|
135
|
+
|
|
136
|
+
<check if="choice == 1">
|
|
137
|
+
<output>Run `/bmad:bmgd:workflows:{{next_workflow_id}}`.
|
|
138
|
+
If the command targets a story, set `story_key={{next_story_id}}` when prompted.</output>
|
|
139
|
+
</check>
|
|
140
|
+
|
|
141
|
+
<check if="choice == 2">
|
|
142
|
+
<output>
|
|
143
|
+
### Stories by Status
|
|
144
|
+
- In Progress: {{stories_in_progress}}
|
|
145
|
+
- Review: {{stories_in_review}}
|
|
146
|
+
- Ready for Dev: {{stories_ready_for_dev}}
|
|
147
|
+
- Backlog: {{stories_backlog}}
|
|
148
|
+
- Done: {{stories_done}}
|
|
149
|
+
</output>
|
|
150
|
+
</check>
|
|
151
|
+
|
|
152
|
+
<check if="choice == 3">
|
|
153
|
+
<action>Display the full contents of {sprint_status_file}</action>
|
|
154
|
+
</check>
|
|
155
|
+
|
|
156
|
+
<check if="choice == 4">
|
|
157
|
+
<action>Exit workflow</action>
|
|
158
|
+
</check>
|
|
159
|
+
</step>
|
|
160
|
+
|
|
161
|
+
<!-- ========================= -->
|
|
162
|
+
<!-- Data mode for other flows -->
|
|
163
|
+
<!-- ========================= -->
|
|
164
|
+
|
|
165
|
+
<step n="20" goal="Data mode output">
|
|
166
|
+
<action>Load and parse {sprint_status_file} same as Step 2</action>
|
|
167
|
+
<action>Compute recommendation same as Step 3</action>
|
|
168
|
+
<template-output>next_workflow_id = {{next_workflow_id}}</template-output>
|
|
169
|
+
<template-output>next_story_id = {{next_story_id}}</template-output>
|
|
170
|
+
<template-output>count_backlog = {{count_backlog}}</template-output>
|
|
171
|
+
<template-output>count_ready = {{count_ready}}</template-output>
|
|
172
|
+
<template-output>count_in_progress = {{count_in_progress}}</template-output>
|
|
173
|
+
<template-output>count_review = {{count_review}}</template-output>
|
|
174
|
+
<template-output>count_done = {{count_done}}</template-output>
|
|
175
|
+
<template-output>epic_backlog = {{epic_backlog}}</template-output>
|
|
176
|
+
<template-output>epic_in_progress = {{epic_in_progress}}</template-output>
|
|
177
|
+
<template-output>epic_done = {{epic_done}}</template-output>
|
|
178
|
+
<template-output>risks = {{risks}}</template-output>
|
|
179
|
+
<action>Return to caller</action>
|
|
180
|
+
</step>
|
|
181
|
+
|
|
182
|
+
<!-- ========================= -->
|
|
183
|
+
<!-- Validate mode -->
|
|
184
|
+
<!-- ========================= -->
|
|
185
|
+
|
|
186
|
+
<step n="30" goal="Validate sprint-status file">
|
|
187
|
+
<action>Check that {sprint_status_file} exists</action>
|
|
188
|
+
<check if="missing">
|
|
189
|
+
<template-output>is_valid = false</template-output>
|
|
190
|
+
<template-output>error = "sprint-status.yaml missing"</template-output>
|
|
191
|
+
<template-output>suggestion = "Run sprint-planning to create it"</template-output>
|
|
192
|
+
<action>Return</action>
|
|
193
|
+
</check>
|
|
194
|
+
|
|
195
|
+
<action>Read and parse {sprint_status_file}</action>
|
|
196
|
+
|
|
197
|
+
<action>Validate required metadata fields exist: generated, project, project_key, tracking_system, story_location</action>
|
|
198
|
+
<check if="any required field missing">
|
|
199
|
+
<template-output>is_valid = false</template-output>
|
|
200
|
+
<template-output>error = "Missing required field(s): {{missing_fields}}"</template-output>
|
|
201
|
+
<template-output>suggestion = "Re-run sprint-planning or add missing fields manually"</template-output>
|
|
202
|
+
<action>Return</action>
|
|
203
|
+
</check>
|
|
204
|
+
|
|
205
|
+
<action>Verify development_status section exists with at least one entry</action>
|
|
206
|
+
<check if="development_status missing or empty">
|
|
207
|
+
<template-output>is_valid = false</template-output>
|
|
208
|
+
<template-output>error = "development_status missing or empty"</template-output>
|
|
209
|
+
<template-output>suggestion = "Re-run sprint-planning or repair the file manually"</template-output>
|
|
210
|
+
<action>Return</action>
|
|
211
|
+
</check>
|
|
212
|
+
|
|
213
|
+
<action>Validate all status values against known valid statuses:</action>
|
|
214
|
+
|
|
215
|
+
- Stories: backlog, ready-for-dev, in-progress, review, done (legacy: drafted)
|
|
216
|
+
- Epics: backlog, in-progress, done (legacy: contexted)
|
|
217
|
+
- Retrospectives: optional, done
|
|
218
|
+
<check if="any invalid status found">
|
|
219
|
+
<template-output>is_valid = false</template-output>
|
|
220
|
+
<template-output>error = "Invalid status values: {{invalid_entries}}"</template-output>
|
|
221
|
+
<template-output>suggestion = "Fix invalid statuses in sprint-status.yaml"</template-output>
|
|
222
|
+
<action>Return</action>
|
|
223
|
+
</check>
|
|
224
|
+
|
|
225
|
+
<template-output>is_valid = true</template-output>
|
|
226
|
+
<template-output>message = "sprint-status.yaml valid: metadata complete, all statuses recognized"</template-output>
|
|
227
|
+
</step>
|
|
228
|
+
|
|
229
|
+
</workflow>
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Sprint Status - Game Development Implementation Tracker
|
|
2
|
+
name: sprint-status
|
|
3
|
+
description: "Summarize sprint-status.yaml for game project, surface risks, and route to the right implementation workflow."
|
|
4
|
+
author: "BMad"
|
|
5
|
+
|
|
6
|
+
# Critical variables from config
|
|
7
|
+
config_source: "{project-root}/_bmad/bmgd/config.yaml"
|
|
8
|
+
output_folder: "{config_source}:output_folder"
|
|
9
|
+
user_name: "{config_source}:user_name"
|
|
10
|
+
communication_language: "{config_source}:communication_language"
|
|
11
|
+
document_output_language: "{config_source}:document_output_language"
|
|
12
|
+
date: system-generated
|
|
13
|
+
sprint_artifacts: "{config_source}:sprint_artifacts"
|
|
14
|
+
|
|
15
|
+
# Workflow components
|
|
16
|
+
installed_path: "{project-root}/_bmad/bmgd/workflows/4-production/sprint-status"
|
|
17
|
+
instructions: "{installed_path}/instructions.md"
|
|
18
|
+
|
|
19
|
+
# Inputs
|
|
20
|
+
variables:
|
|
21
|
+
sprint_status_file: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
|
|
22
|
+
tracking_system: "file-system"
|
|
23
|
+
|
|
24
|
+
# Smart input file references
|
|
25
|
+
input_file_patterns:
|
|
26
|
+
sprint_status:
|
|
27
|
+
description: "Sprint status file generated by sprint-planning"
|
|
28
|
+
whole: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
|
|
29
|
+
load_strategy: "FULL_LOAD"
|
|
30
|
+
|
|
31
|
+
# Standalone so IDE commands get generated
|
|
32
|
+
standalone: true
|
|
33
|
+
|
|
34
|
+
# No web bundle needed
|
|
35
|
+
web_bundle: false
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
# Create Tech-Spec - Spec Engineering for Game Development
|
|
2
|
+
|
|
3
|
+
<workflow>
|
|
4
|
+
|
|
5
|
+
<critical>Communicate in {communication_language}, tailored to {user_skill_level}</critical>
|
|
6
|
+
<critical>Generate documents in {document_output_language}</critical>
|
|
7
|
+
<critical>Conversational spec engineering - ask questions, investigate code, produce complete spec</critical>
|
|
8
|
+
<critical>Spec must contain ALL context a fresh dev agent needs to implement it</critical>
|
|
9
|
+
<critical>Focus on game-specific considerations: performance, feel, engine patterns</critical>
|
|
10
|
+
|
|
11
|
+
<checkpoint-handlers>
|
|
12
|
+
<on-select key="a">Load and execute {advanced_elicitation}, then return to current step</on-select>
|
|
13
|
+
<on-select key="p">Load and execute {party_mode_workflow}, then return to current step</on-select>
|
|
14
|
+
<on-select key="b">Load and execute {quick_dev_workflow} with the tech-spec file</on-select>
|
|
15
|
+
</checkpoint-handlers>
|
|
16
|
+
|
|
17
|
+
<step n="1" goal="Understand what the user wants to build">
|
|
18
|
+
|
|
19
|
+
<action>Greet {user_name} and ask them to describe what they want to build or change in their game.</action>
|
|
20
|
+
|
|
21
|
+
<action>Ask game-specific clarifying questions:
|
|
22
|
+
|
|
23
|
+
- What's the feature/mechanic?
|
|
24
|
+
- How does it affect gameplay feel?
|
|
25
|
+
- Performance requirements? (60fps critical path?)
|
|
26
|
+
- Which game systems does it touch?
|
|
27
|
+
- Existing code to integrate with?
|
|
28
|
+
</action>
|
|
29
|
+
|
|
30
|
+
<action>Check for existing context in {output_folder} and {sprint_artifacts}</action>
|
|
31
|
+
|
|
32
|
+
<checkpoint title="Problem Understanding">
|
|
33
|
+
[a] Advanced Elicitation [c] Continue [p] Party Mode
|
|
34
|
+
</checkpoint>
|
|
35
|
+
|
|
36
|
+
</step>
|
|
37
|
+
|
|
38
|
+
<step n="2" goal="Investigate existing game code (if applicable)">
|
|
39
|
+
|
|
40
|
+
<action>If brownfield: identify game engine (Unity/Unreal/Godot/custom)</action>
|
|
41
|
+
|
|
42
|
+
<action>Get file paths, read code, identify:
|
|
43
|
+
|
|
44
|
+
- Engine patterns and conventions
|
|
45
|
+
- Existing game systems to integrate with
|
|
46
|
+
- Performance-critical code paths
|
|
47
|
+
- Test patterns if any
|
|
48
|
+
</action>
|
|
49
|
+
|
|
50
|
+
<action>Document: engine version, code patterns, files to modify, system dependencies</action>
|
|
51
|
+
|
|
52
|
+
<checkpoint title="Context Gathered">
|
|
53
|
+
[a] Advanced Elicitation [c] Continue [p] Party Mode
|
|
54
|
+
</checkpoint>
|
|
55
|
+
|
|
56
|
+
</step>
|
|
57
|
+
|
|
58
|
+
<step n="3" goal="Generate the technical specification">
|
|
59
|
+
|
|
60
|
+
<action>Create tech-spec using this game-focused structure:
|
|
61
|
+
|
|
62
|
+
```markdown
|
|
63
|
+
# Tech-Spec: {title}
|
|
64
|
+
|
|
65
|
+
**Created:** {date}
|
|
66
|
+
**Status:** Ready for Development
|
|
67
|
+
**Engine:** {engine_name} {version}
|
|
68
|
+
|
|
69
|
+
## Overview
|
|
70
|
+
|
|
71
|
+
### Feature/Mechanic Description
|
|
72
|
+
|
|
73
|
+
### Gameplay Impact
|
|
74
|
+
|
|
75
|
+
### Scope (In/Out)
|
|
76
|
+
|
|
77
|
+
## Context for Development
|
|
78
|
+
|
|
79
|
+
### Engine Patterns
|
|
80
|
+
|
|
81
|
+
### Existing Systems Integration
|
|
82
|
+
|
|
83
|
+
### Files to Reference
|
|
84
|
+
|
|
85
|
+
### Technical Decisions
|
|
86
|
+
|
|
87
|
+
## Implementation Plan
|
|
88
|
+
|
|
89
|
+
### Tasks
|
|
90
|
+
|
|
91
|
+
- [ ] Task 1: Description
|
|
92
|
+
- [ ] Task 2: Description
|
|
93
|
+
|
|
94
|
+
### Performance Considerations
|
|
95
|
+
|
|
96
|
+
- Frame budget impact
|
|
97
|
+
- Memory considerations
|
|
98
|
+
- Critical path notes
|
|
99
|
+
|
|
100
|
+
### Acceptance Criteria
|
|
101
|
+
|
|
102
|
+
- [ ] AC 1: Given/When/Then (include feel/responsiveness criteria)
|
|
103
|
+
- [ ] AC 2: ...
|
|
104
|
+
|
|
105
|
+
## Additional Context
|
|
106
|
+
|
|
107
|
+
### Dependencies
|
|
108
|
+
|
|
109
|
+
### Testing Strategy
|
|
110
|
+
|
|
111
|
+
### Notes
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
</action>
|
|
115
|
+
|
|
116
|
+
<action>Save to {sprint_artifacts}/tech-spec-{slug}.md</action>
|
|
117
|
+
|
|
118
|
+
</step>
|
|
119
|
+
|
|
120
|
+
<step n="4" goal="Review and finalize">
|
|
121
|
+
|
|
122
|
+
<action>Present spec to {user_name}, ask if it captures intent, make changes as needed</action>
|
|
123
|
+
|
|
124
|
+
<output>**Tech-Spec Complete!** 🎮
|
|
125
|
+
|
|
126
|
+
Saved to: {sprint_artifacts}/tech-spec-{slug}.md
|
|
127
|
+
|
|
128
|
+
[a] Advanced Elicitation - refine further
|
|
129
|
+
[b] Begin Development (not recommended - fresh context better)
|
|
130
|
+
[d] Done - exit
|
|
131
|
+
[p] Party Mode - get feedback
|
|
132
|
+
|
|
133
|
+
**Recommended:** Run `quick-dev` in fresh context with this spec.
|
|
134
|
+
</output>
|
|
135
|
+
|
|
136
|
+
<ask>Choice (a/b/d/p):</ask>
|
|
137
|
+
|
|
138
|
+
</step>
|
|
139
|
+
|
|
140
|
+
</workflow>
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Quick-Flow: Create Tech-Spec (Game Development)
|
|
2
|
+
name: create-tech-spec
|
|
3
|
+
description: "Conversational spec engineering for games - ask questions, investigate code, produce implementation-ready tech-spec."
|
|
4
|
+
author: "BMad"
|
|
5
|
+
|
|
6
|
+
# Config
|
|
7
|
+
config_source: "{project-root}/_bmad/bmgd/config.yaml"
|
|
8
|
+
output_folder: "{config_source}:output_folder"
|
|
9
|
+
sprint_artifacts: "{config_source}:sprint_artifacts"
|
|
10
|
+
user_name: "{config_source}:user_name"
|
|
11
|
+
communication_language: "{config_source}:communication_language"
|
|
12
|
+
document_output_language: "{config_source}:document_output_language"
|
|
13
|
+
user_skill_level: "{config_source}:game_dev_experience"
|
|
14
|
+
date: system-generated
|
|
15
|
+
|
|
16
|
+
# Workflow components
|
|
17
|
+
installed_path: "{project-root}/_bmad/bmgd/workflows/bmgd-quick-flow/create-tech-spec"
|
|
18
|
+
instructions: "{installed_path}/instructions.md"
|
|
19
|
+
|
|
20
|
+
# Related workflows
|
|
21
|
+
quick_dev_workflow: "{project-root}/_bmad/bmgd/workflows/bmgd-quick-flow/quick-dev/workflow.yaml"
|
|
22
|
+
quick_prototype_workflow: "{project-root}/_bmad/bmgd/workflows/bmgd-quick-flow/quick-prototype/workflow.yaml"
|
|
23
|
+
party_mode_exec: "{project-root}/_bmad/core/workflows/party-mode/workflow.md"
|
|
24
|
+
advanced_elicitation: "{project-root}/_bmad/core/tasks/advanced-elicitation.xml"
|
|
25
|
+
|
|
26
|
+
standalone: true
|
|
27
|
+
web_bundle: false
|