bmad-method 6.0.0-alpha.17 → 6.0.0-alpha.18

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 (186) hide show
  1. package/CHANGELOG.md +97 -0
  2. package/package.json +1 -1
  3. package/src/modules/bmgd/_module-installer/installer.js +160 -0
  4. package/src/modules/bmgd/_module-installer/platform-specifics/claude-code.js +23 -0
  5. package/src/modules/bmgd/_module-installer/platform-specifics/windsurf.js +18 -0
  6. package/src/modules/bmgd/agents/game-architect.agent.yaml +23 -8
  7. package/src/modules/bmgd/agents/game-designer.agent.yaml +38 -18
  8. package/src/modules/bmgd/agents/game-dev.agent.yaml +30 -14
  9. package/src/modules/bmgd/agents/game-qa.agent.yaml +64 -0
  10. package/src/modules/bmgd/agents/game-scrum-master.agent.yaml +27 -39
  11. package/src/modules/bmgd/agents/game-solo-dev.agent.yaml +56 -0
  12. package/src/modules/bmgd/docs/README.md +180 -0
  13. package/src/modules/bmgd/docs/agents-guide.md +407 -0
  14. package/src/modules/bmgd/docs/game-types-guide.md +503 -0
  15. package/src/modules/bmgd/docs/glossary.md +294 -0
  16. package/src/modules/bmgd/docs/quick-flow-guide.md +288 -0
  17. package/src/modules/bmgd/docs/quick-start.md +250 -0
  18. package/src/modules/bmgd/docs/troubleshooting.md +259 -0
  19. package/src/modules/bmgd/docs/workflow-overview.jpg +0 -0
  20. package/src/modules/bmgd/docs/workflows-guide.md +463 -0
  21. package/src/modules/bmgd/gametest/knowledge/balance-testing.md +220 -0
  22. package/src/modules/bmgd/gametest/knowledge/certification-testing.md +319 -0
  23. package/src/modules/bmgd/gametest/knowledge/compatibility-testing.md +228 -0
  24. package/src/modules/bmgd/gametest/knowledge/godot-testing.md +376 -0
  25. package/src/modules/bmgd/gametest/knowledge/input-testing.md +315 -0
  26. package/src/modules/bmgd/gametest/knowledge/localization-testing.md +304 -0
  27. package/src/modules/bmgd/gametest/knowledge/multiplayer-testing.md +322 -0
  28. package/src/modules/bmgd/gametest/knowledge/performance-testing.md +204 -0
  29. package/src/modules/bmgd/gametest/knowledge/playtesting.md +384 -0
  30. package/src/modules/bmgd/gametest/knowledge/qa-automation.md +190 -0
  31. package/src/modules/bmgd/gametest/knowledge/regression-testing.md +280 -0
  32. package/src/modules/bmgd/gametest/knowledge/save-testing.md +280 -0
  33. package/src/modules/bmgd/gametest/knowledge/smoke-testing.md +404 -0
  34. package/src/modules/bmgd/gametest/knowledge/test-priorities.md +271 -0
  35. package/src/modules/bmgd/gametest/knowledge/unity-testing.md +383 -0
  36. package/src/modules/bmgd/gametest/knowledge/unreal-testing.md +388 -0
  37. package/src/modules/bmgd/gametest/qa-index.csv +17 -0
  38. package/src/modules/bmgd/module.yaml +25 -9
  39. package/src/modules/bmgd/teams/default-party.csv +2 -0
  40. package/src/modules/bmgd/teams/team-gamedev.yaml +12 -1
  41. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-01-init.md +164 -0
  42. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-02-context.md +210 -0
  43. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-03-ideation.md +289 -0
  44. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/steps/step-04-complete.md +275 -0
  45. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.md +49 -0
  46. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml +29 -8
  47. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-01-init.md +223 -0
  48. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-01b-continue.md +151 -0
  49. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-02-vision.md +218 -0
  50. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-03-market.md +218 -0
  51. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-04-fundamentals.md +231 -0
  52. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-05-scope.md +242 -0
  53. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-06-references.md +224 -0
  54. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-07-content.md +282 -0
  55. package/src/modules/bmgd/workflows/1-preproduction/game-brief/steps/step-08-complete.md +296 -0
  56. package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.md +62 -0
  57. package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml +40 -9
  58. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-01-init.md +248 -0
  59. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-01b-continue.md +173 -0
  60. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-02-context.md +332 -0
  61. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-03-platforms.md +245 -0
  62. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-04-vision.md +229 -0
  63. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-05-core-gameplay.md +258 -0
  64. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-06-mechanics.md +249 -0
  65. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-07-game-type.md +266 -0
  66. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-08-progression.md +272 -0
  67. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-09-levels.md +264 -0
  68. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-10-art-audio.md +255 -0
  69. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-11-technical.md +275 -0
  70. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-12-epics.md +284 -0
  71. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-13-metrics.md +250 -0
  72. package/src/modules/bmgd/workflows/2-design/gdd/steps/step-14-complete.md +335 -0
  73. package/src/modules/bmgd/workflows/2-design/gdd/workflow.md +61 -0
  74. package/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml +27 -7
  75. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01-init.md +228 -0
  76. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-01b-continue.md +163 -0
  77. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-02-foundation.md +262 -0
  78. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-03-story.md +238 -0
  79. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-04-characters.md +297 -0
  80. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-05-world.md +262 -0
  81. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-06-dialogue.md +250 -0
  82. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-07-environmental.md +244 -0
  83. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-08-delivery.md +264 -0
  84. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-09-integration.md +254 -0
  85. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-10-production.md +262 -0
  86. package/src/modules/bmgd/workflows/2-design/narrative/steps/step-11-complete.md +331 -0
  87. package/src/modules/bmgd/workflows/2-design/narrative/workflow.md +57 -0
  88. package/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml +53 -8
  89. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-01-init.md +223 -0
  90. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-01b-continue.md +153 -0
  91. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-02-context.md +262 -0
  92. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-03-starter.md +290 -0
  93. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-04-decisions.md +300 -0
  94. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-05-crosscutting.md +319 -0
  95. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-06-structure.md +304 -0
  96. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-07-patterns.md +349 -0
  97. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-08-validation.md +293 -0
  98. package/src/modules/bmgd/workflows/3-technical/game-architecture/steps/step-09-complete.md +302 -0
  99. package/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.md +55 -0
  100. package/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml +50 -21
  101. package/src/modules/bmgd/workflows/4-production/code-review/checklist.md +23 -0
  102. package/src/modules/bmgd/workflows/4-production/code-review/instructions.xml +225 -0
  103. package/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml +18 -15
  104. package/src/modules/bmgd/workflows/4-production/correct-course/checklist.md +1 -1
  105. package/src/modules/bmgd/workflows/4-production/correct-course/instructions.md +1 -1
  106. package/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml +11 -6
  107. package/src/modules/bmgd/workflows/4-production/create-story/checklist.md +332 -214
  108. package/src/modules/bmgd/workflows/4-production/create-story/instructions.xml +298 -0
  109. package/src/modules/bmgd/workflows/4-production/create-story/template.md +3 -5
  110. package/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml +12 -7
  111. package/src/modules/bmgd/workflows/4-production/dev-story/checklist.md +65 -23
  112. package/src/modules/bmgd/workflows/4-production/dev-story/instructions.xml +409 -0
  113. package/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml +13 -3
  114. package/src/modules/bmgd/workflows/4-production/retrospective/instructions.md +4 -4
  115. package/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml +12 -7
  116. package/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md +32 -41
  117. package/src/modules/bmgd/workflows/4-production/sprint-planning/sprint-status-template.yaml +13 -13
  118. package/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml +6 -1
  119. package/src/modules/bmgd/workflows/4-production/sprint-status/instructions.md +229 -0
  120. package/src/modules/bmgd/workflows/4-production/sprint-status/workflow.yaml +35 -0
  121. package/src/modules/bmgd/workflows/bmgd-quick-flow/create-tech-spec/instructions.md +140 -0
  122. package/src/modules/bmgd/workflows/bmgd-quick-flow/create-tech-spec/workflow.yaml +27 -0
  123. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/checklist.md +37 -0
  124. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/instructions.md +220 -0
  125. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-dev/workflow.yaml +45 -0
  126. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/checklist.md +26 -0
  127. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/instructions.md +156 -0
  128. package/src/modules/bmgd/workflows/bmgd-quick-flow/quick-prototype/workflow.yaml +36 -0
  129. package/src/modules/bmgd/workflows/gametest/automate/checklist.md +93 -0
  130. package/src/modules/bmgd/workflows/gametest/automate/instructions.md +317 -0
  131. package/src/modules/bmgd/workflows/gametest/automate/workflow.yaml +50 -0
  132. package/src/modules/bmgd/workflows/gametest/performance/checklist.md +96 -0
  133. package/src/modules/bmgd/workflows/gametest/performance/instructions.md +323 -0
  134. package/src/modules/bmgd/workflows/gametest/performance/performance-template.md +256 -0
  135. package/src/modules/bmgd/workflows/gametest/performance/workflow.yaml +48 -0
  136. package/src/modules/bmgd/workflows/gametest/playtest-plan/checklist.md +93 -0
  137. package/src/modules/bmgd/workflows/gametest/playtest-plan/instructions.md +297 -0
  138. package/src/modules/bmgd/workflows/gametest/playtest-plan/playtest-template.md +208 -0
  139. package/src/modules/bmgd/workflows/gametest/playtest-plan/workflow.yaml +59 -0
  140. package/src/modules/bmgd/workflows/gametest/test-design/checklist.md +98 -0
  141. package/src/modules/bmgd/workflows/gametest/test-design/instructions.md +280 -0
  142. package/src/modules/bmgd/workflows/gametest/test-design/test-design-template.md +205 -0
  143. package/src/modules/bmgd/workflows/gametest/test-design/workflow.yaml +47 -0
  144. package/src/modules/bmgd/workflows/gametest/test-framework/checklist.md +103 -0
  145. package/src/modules/bmgd/workflows/gametest/test-framework/instructions.md +348 -0
  146. package/src/modules/bmgd/workflows/gametest/test-framework/workflow.yaml +48 -0
  147. package/src/modules/bmgd/workflows/gametest/test-review/checklist.md +87 -0
  148. package/src/modules/bmgd/workflows/gametest/test-review/instructions.md +272 -0
  149. package/src/modules/bmgd/workflows/gametest/test-review/test-review-template.md +203 -0
  150. package/src/modules/bmgd/workflows/gametest/test-review/workflow.yaml +48 -0
  151. package/src/modules/bmgd/workflows/workflow-status/init/instructions.md +299 -0
  152. package/src/modules/bmgd/workflows/workflow-status/init/workflow.yaml +29 -0
  153. package/src/modules/bmgd/workflows/workflow-status/instructions.md +395 -0
  154. package/src/modules/bmgd/workflows/workflow-status/paths/gamedev-brownfield.yaml +65 -0
  155. package/src/modules/bmgd/workflows/workflow-status/paths/gamedev-greenfield.yaml +71 -0
  156. package/src/modules/bmgd/workflows/workflow-status/paths/quickflow-brownfield.yaml +29 -0
  157. package/src/modules/bmgd/workflows/workflow-status/paths/quickflow-greenfield.yaml +39 -0
  158. package/src/modules/bmgd/workflows/workflow-status/project-levels.yaml +63 -0
  159. package/src/modules/bmgd/workflows/workflow-status/workflow-status-template.yaml +24 -0
  160. package/src/modules/bmgd/workflows/workflow-status/workflow.yaml +30 -0
  161. package/tools/cli/commands/install.js +9 -0
  162. package/tools/cli/installers/lib/core/installer.js +109 -109
  163. package/tools/cli/installers/lib/core/installer.js.bak +3204 -0
  164. package/tools/cli/installers/lib/modules/manager.js +16 -4
  165. package/tools/cli/lib/agent/compiler.js +99 -0
  166. package/tools/cli/lib/ui.js +78 -27
  167. package/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md +0 -502
  168. package/src/modules/bmgd/workflows/4-production/code-review/instructions.md +0 -398
  169. package/src/modules/bmgd/workflows/4-production/create-story/instructions.md +0 -256
  170. package/src/modules/bmgd/workflows/4-production/dev-story/instructions.md +0 -267
  171. package/src/modules/bmgd/workflows/4-production/epic-tech-context/checklist.md +0 -17
  172. package/src/modules/bmgd/workflows/4-production/epic-tech-context/instructions.md +0 -164
  173. package/src/modules/bmgd/workflows/4-production/epic-tech-context/template.md +0 -76
  174. package/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml +0 -58
  175. package/src/modules/bmgd/workflows/4-production/story-context/checklist.md +0 -16
  176. package/src/modules/bmgd/workflows/4-production/story-context/context-template.xml +0 -34
  177. package/src/modules/bmgd/workflows/4-production/story-context/instructions.md +0 -209
  178. package/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml +0 -63
  179. package/src/modules/bmgd/workflows/4-production/story-done/instructions.md +0 -111
  180. package/src/modules/bmgd/workflows/4-production/story-done/workflow.yaml +0 -28
  181. package/src/modules/bmgd/workflows/4-production/story-ready/instructions.md +0 -117
  182. package/src/modules/bmgd/workflows/4-production/story-ready/workflow.yaml +0 -25
  183. /package/src/modules/bmgd/workflows/1-preproduction/game-brief/{template.md → templates/game-brief-template.md} +0 -0
  184. /package/src/modules/bmgd/workflows/2-design/gdd/{gdd-template.md → templates/gdd-template.md} +0 -0
  185. /package/src/modules/bmgd/workflows/2-design/narrative/{narrative-template.md → templates/narrative-template.md} +0 -0
  186. /package/src/modules/bmgd/workflows/3-technical/game-architecture/{architecture-template.md → templates/architecture-template.md} +0 -0
@@ -0,0 +1,297 @@
1
+ ---
2
+ name: 'step-04-characters'
3
+ description: 'Develop all characters including protagonists, antagonists, supporting cast, and their arcs'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/_bmad/bmgd/workflows/2-design/narrative'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-04-characters.md'
10
+ nextStepFile: '{workflow_path}/steps/step-05-world.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/narrative-design.md'
13
+
14
+ # Task References
15
+ advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
16
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
17
+ ---
18
+
19
+ # Step 4: Characters
20
+
21
+ **Progress: Step 4 of 11** - Next: World Building
22
+
23
+ ## STEP GOAL:
24
+
25
+ Develop all characters: protagonists, antagonists, and supporting cast. Define their backgrounds, motivations, relationships, and character arcs.
26
+
27
+ ## MANDATORY EXECUTION RULES (READ FIRST):
28
+
29
+ ### Universal Rules:
30
+
31
+ - NEVER generate content without user input
32
+ - CRITICAL: Read the complete step file before taking any action
33
+ - CRITICAL: When loading next step with 'C', ensure entire file is read
34
+ - YOU ARE A FACILITATOR, not a content generator
35
+ - NEVER mention time estimates
36
+
37
+ ### Role Reinforcement:
38
+
39
+ - You are a narrative design facilitator
40
+ - Characters should feel like user's creations
41
+ - Draw out personality through questions
42
+
43
+ ### Step-Specific Rules:
44
+
45
+ - FORBIDDEN to create characters without user input
46
+ - Guide user through character development
47
+ - Ensure characters connect to themes
48
+
49
+ ## EXECUTION PROTOCOLS:
50
+
51
+ - Show your analysis before taking any action
52
+ - Present A/P/C menu after generating content
53
+ - ONLY save when user chooses C (Continue)
54
+ - Update frontmatter `stepsCompleted: [1, 2, 3, 4]` before loading next step
55
+
56
+ ## COLLABORATION MENUS (A/P/C):
57
+
58
+ - **A (Advanced Elicitation)**: Deep dive into characters
59
+ - **P (Party Mode)**: Get perspectives on character design
60
+ - **C (Continue)**: Save the content and proceed
61
+
62
+ ## Sequence of Instructions (Do not deviate, skip, or optimize)
63
+
64
+ ### 1. Protagonist Discovery
65
+
66
+ "**Let's develop the protagonist(s) of {{game_name}}.**
67
+
68
+ For each protagonist, tell me:
69
+
70
+ - **Name and description** - Who are they?
71
+ - **Background** - Where do they come from?
72
+ - **Motivation** - What do they want?
73
+ - **Strengths** - What are they good at?
74
+ - **Flaws** - What holds them back?
75
+ - **Internal conflict** - What do they struggle with inside?
76
+ - **External conflict** - What obstacles do they face?
77
+
78
+ Describe your protagonist(s):"
79
+
80
+ ### 2. Antagonist Discovery
81
+
82
+ "**Now let's develop the antagonist(s).**
83
+
84
+ Great antagonists:
85
+
86
+ - Have understandable motivations
87
+ - Challenge the protagonist meaningfully
88
+ - May have sympathetic elements
89
+ - Represent or oppose the themes
90
+
91
+ For each antagonist:
92
+
93
+ - **Name and description**
94
+ - **Background** - How did they become this way?
95
+ - **Goals** - What do they want?
96
+ - **Methods** - How do they pursue their goals?
97
+ - **Relationship to protagonist**
98
+ - **Sympathetic elements** (if any)
99
+
100
+ Describe your antagonist(s):"
101
+
102
+ ### 3. Supporting Cast Discovery
103
+
104
+ "**Let's flesh out the supporting characters.**
105
+
106
+ Common supporting roles:
107
+
108
+ - **Mentor** - Guides the protagonist
109
+ - **Ally/Companion** - Travels with protagonist
110
+ - **Foil** - Contrasts protagonist's traits
111
+ - **Love interest** - Romantic connection
112
+ - **Comic relief** - Lightens tone
113
+ - **Informant** - Provides information
114
+
115
+ For each supporting character:
116
+
117
+ - **Name and role**
118
+ - **Personality and traits**
119
+ - **Relationship to protagonist**
120
+ - **Function in story**
121
+ - **Key scenes/moments**
122
+
123
+ Describe your supporting characters:"
124
+
125
+ ### 4. Character Arcs Discovery
126
+
127
+ "**Now let's map character arcs.**
128
+
129
+ A character arc shows how a character changes (or refuses to change) through the story.
130
+
131
+ **Arc types:**
132
+
133
+ - **Positive arc** - Character overcomes flaw, grows
134
+ - **Negative arc** - Character falls, corrupts
135
+ - **Flat arc** - Character's beliefs tested but hold
136
+ - **Transformation** - Character becomes something new
137
+
138
+ For major characters:
139
+
140
+ - **Starting state** - Who are they at the beginning?
141
+ - **Transformation moments** - What changes them?
142
+ - **Ending state** - Who are they at the end?
143
+ - **Lessons learned**
144
+
145
+ Describe the character arcs:"
146
+
147
+ ### 5. Generate Characters Content
148
+
149
+ Based on the conversation, prepare the content:
150
+
151
+ ```markdown
152
+ ## Characters
153
+
154
+ ### Protagonist(s)
155
+
156
+ #### {{protagonist_name}}
157
+
158
+ **Description:** {{description}}
159
+
160
+ **Background:** {{background}}
161
+
162
+ **Motivation:** {{motivation}}
163
+
164
+ **Strengths:** {{strengths}}
165
+
166
+ **Flaws:** {{flaws}}
167
+
168
+ **Conflicts:**
169
+
170
+ - Internal: {{internal_conflict}}
171
+ - External: {{external_conflict}}
172
+
173
+ ---
174
+
175
+ ### Antagonist(s)
176
+
177
+ #### {{antagonist_name}}
178
+
179
+ **Description:** {{description}}
180
+
181
+ **Background:** {{background}}
182
+
183
+ **Goals:** {{goals}}
184
+
185
+ **Methods:** {{methods}}
186
+
187
+ **Relationship to Protagonist:** {{relationship}}
188
+
189
+ **Sympathetic Elements:** {{if_any}}
190
+
191
+ ---
192
+
193
+ ### Supporting Characters
194
+
195
+ {{for_each_supporting_character}}
196
+
197
+ #### {{character_name}}
198
+
199
+ **Role:** {{role}}
200
+ **Personality:** {{personality}}
201
+ **Function:** {{story_function}}
202
+ **Key Moments:** {{key_scenes}}
203
+ {{/for_each}}
204
+
205
+ ---
206
+
207
+ ## Character Arcs
208
+
209
+ ### {{character_name}} Arc
210
+
211
+ **Starting State:** {{beginning}}
212
+
213
+ **Transformation Moments:**
214
+ {{transformation_points}}
215
+
216
+ **Ending State:** {{end}}
217
+
218
+ **Lessons Learned:** {{lessons}}
219
+
220
+ {{repeat_for_each_major_character}}
221
+ ```
222
+
223
+ ### 6. Present Content and Menu
224
+
225
+ Show the generated content to the user and present:
226
+
227
+ "I've documented all characters and their arcs.
228
+
229
+ **Here's what I'll add to the document:**
230
+
231
+ [Show the complete markdown content from step 5]
232
+
233
+ **Character Summary:**
234
+
235
+ - Protagonists: {{count}}
236
+ - Antagonists: {{count}}
237
+ - Supporting: {{count}}
238
+
239
+ **Validation Check:**
240
+
241
+ - Do characters connect to your themes?
242
+ - Are arcs meaningful and complete?
243
+ - Do relationships create conflict?
244
+
245
+ **Select an Option:**
246
+ [A] Advanced Elicitation - Deep dive into characters
247
+ [P] Party Mode - Get perspectives on character design
248
+ [C] Continue - Save this and move to World Building (Step 5 of 11)"
249
+
250
+ ### 7. Handle Menu Selection
251
+
252
+ #### IF A (Advanced Elicitation):
253
+
254
+ - Execute {advancedElicitationTask} with the current content
255
+ - Ask user: "Accept these changes? (y/n)"
256
+ - If yes: Update content, return to A/P/C menu
257
+ - If no: Keep original, return to A/P/C menu
258
+
259
+ #### IF P (Party Mode):
260
+
261
+ - Execute {partyModeWorkflow} with the current content
262
+ - Ask user: "Accept these changes? (y/n)"
263
+ - If yes: Update content, return to A/P/C menu
264
+ - If no: Keep original, return to A/P/C menu
265
+
266
+ #### IF C (Continue):
267
+
268
+ - Append the final content to `{outputFile}`
269
+ - Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
270
+ - Load `{nextStepFile}`
271
+
272
+ ## CRITICAL STEP COMPLETION NOTE
273
+
274
+ ONLY WHEN [C continue option] is selected and [characters content saved with frontmatter updated], will you then load and read fully `{nextStepFile}`.
275
+
276
+ ---
277
+
278
+ ## SYSTEM SUCCESS/FAILURE METRICS
279
+
280
+ ### SUCCESS:
281
+
282
+ - Protagonists fully developed from user input
283
+ - Antagonists with clear motivations
284
+ - Supporting cast defined with functions
285
+ - Character arcs mapped for major characters
286
+ - A/P/C menu presented and handled correctly
287
+ - Frontmatter updated with stepsCompleted: [1, 2, 3, 4]
288
+
289
+ ### SYSTEM FAILURE:
290
+
291
+ - Creating characters without user input
292
+ - Flat characters without depth
293
+ - Missing character arcs
294
+ - Not presenting A/P/C menu after content
295
+ - Proceeding without user selecting 'C'
296
+
297
+ **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.
@@ -0,0 +1,262 @@
1
+ ---
2
+ name: 'step-05-world'
3
+ description: 'Build the world including setting, history, factions, and key locations'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/_bmad/bmgd/workflows/2-design/narrative'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-05-world.md'
10
+ nextStepFile: '{workflow_path}/steps/step-06-dialogue.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/narrative-design.md'
13
+
14
+ # Task References
15
+ advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
16
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
17
+ ---
18
+
19
+ # Step 5: World Building
20
+
21
+ **Progress: Step 5 of 11** - Next: Dialogue Systems
22
+
23
+ ## STEP GOAL:
24
+
25
+ Build the game's world including setting, history/backstory, factions/organizations, and key locations where the narrative unfolds.
26
+
27
+ ## MANDATORY EXECUTION RULES (READ FIRST):
28
+
29
+ ### Universal Rules:
30
+
31
+ - NEVER generate content without user input
32
+ - CRITICAL: Read the complete step file before taking any action
33
+ - CRITICAL: When loading next step with 'C', ensure entire file is read
34
+ - YOU ARE A FACILITATOR, not a content generator
35
+ - NEVER mention time estimates
36
+
37
+ ### Role Reinforcement:
38
+
39
+ - You are a narrative design facilitator
40
+ - World should support and enhance the story
41
+ - Draw out user's vision of their world
42
+
43
+ ### Step-Specific Rules:
44
+
45
+ - FORBIDDEN to create world elements without user input
46
+ - Connect world to themes and story
47
+ - Focus on narrative-relevant world-building
48
+
49
+ ## EXECUTION PROTOCOLS:
50
+
51
+ - Show your analysis before taking any action
52
+ - Present A/P/C menu after generating content
53
+ - ONLY save when user chooses C (Continue)
54
+ - Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5]` before loading next step
55
+
56
+ ## COLLABORATION MENUS (A/P/C):
57
+
58
+ - **A (Advanced Elicitation)**: Explore world depth
59
+ - **P (Party Mode)**: Get perspectives on world-building
60
+ - **C (Continue)**: Save the content and proceed
61
+
62
+ ## Sequence of Instructions (Do not deviate, skip, or optimize)
63
+
64
+ ### 1. World Overview Discovery
65
+
66
+ "**Let's build the world of {{game_name}}.**
67
+
68
+ Describe your world:
69
+
70
+ - **Setting** - Where and when does this take place?
71
+ - **World type** - Fantasy, sci-fi, modern, historical, etc.
72
+ - **World rules** - Magic systems? Technology level? Physical laws?
73
+ - **Atmosphere** - What mood does the world evoke?
74
+ - **What makes it unique?**
75
+
76
+ Describe the world:"
77
+
78
+ ### 2. History and Backstory Discovery
79
+
80
+ "**What's the history of your world?**
81
+
82
+ Consider:
83
+
84
+ - **Major historical events** - Wars, discoveries, cataclysms?
85
+ - **How did the world reach its current state?**
86
+ - **Legends and myths** - What do people believe?
87
+ - **Past conflicts** - What shaped the present?
88
+ - **Secrets** - What is hidden or forgotten?
89
+
90
+ Describe the history:"
91
+
92
+ ### 3. Factions Discovery (Optional)
93
+
94
+ "**Are there factions, organizations, or groups?** (Optional)
95
+
96
+ If applicable, for each faction:
97
+
98
+ - **Name and purpose**
99
+ - **Leadership and structure**
100
+ - **Goals and methods**
101
+ - **Relationships with other factions**
102
+ - **Role in the story**
103
+
104
+ Describe any factions:"
105
+
106
+ ### 4. Locations Discovery
107
+
108
+ "**Describe the key locations in your world.**
109
+
110
+ For each significant location:
111
+
112
+ - **Name and description**
113
+ - **Narrative significance** - Why does it matter to the story?
114
+ - **Atmosphere and mood**
115
+ - **Key events that occur there**
116
+ - **Who controls/inhabits it?**
117
+
118
+ What are the key locations?"
119
+
120
+ ### 5. Generate World Content
121
+
122
+ Based on the conversation, prepare the content:
123
+
124
+ ```markdown
125
+ ## World Building
126
+
127
+ ### World Overview
128
+
129
+ **Setting:** {{setting_description}}
130
+
131
+ **World Type:** {{world_type}}
132
+
133
+ **World Rules:**
134
+ {{rules_and_systems}}
135
+
136
+ **Atmosphere:** {{world_atmosphere}}
137
+
138
+ **Unique Elements:** {{what_makes_it_unique}}
139
+
140
+ ---
141
+
142
+ ### History and Backstory
143
+
144
+ **Timeline Overview:**
145
+ {{historical_timeline}}
146
+
147
+ **Major Events:**
148
+ {{significant_events}}
149
+
150
+ **Legends and Myths:**
151
+ {{beliefs_and_legends}}
152
+
153
+ **Hidden Secrets:**
154
+ {{world_secrets}}
155
+
156
+ ---
157
+
158
+ ### Factions and Organizations
159
+
160
+ {{for_each_faction}}
161
+
162
+ #### {{faction_name}}
163
+
164
+ **Purpose:** {{purpose}}
165
+ **Leadership:** {{leadership}}
166
+ **Goals:** {{goals}}
167
+ **Methods:** {{methods}}
168
+ **Relationships:** {{faction_relationships}}
169
+ **Story Role:** {{narrative_function}}
170
+ {{/for_each}}
171
+
172
+ ---
173
+
174
+ ### Key Locations
175
+
176
+ {{for_each_location}}
177
+
178
+ #### {{location_name}}
179
+
180
+ **Description:** {{description}}
181
+ **Narrative Significance:** {{why_important}}
182
+ **Atmosphere:** {{mood}}
183
+ **Key Events:** {{events_here}}
184
+ **Inhabitants:** {{who_is_here}}
185
+ {{/for_each}}
186
+ ```
187
+
188
+ ### 6. Present Content and Menu
189
+
190
+ Show the generated content to the user and present:
191
+
192
+ "I've documented the world of {{game_name}}.
193
+
194
+ **Here's what I'll add to the document:**
195
+
196
+ [Show the complete markdown content from step 5]
197
+
198
+ **World Summary:**
199
+
200
+ - Setting: {{setting}}
201
+ - Factions: {{count}}
202
+ - Key locations: {{count}}
203
+
204
+ **Validation Check:**
205
+
206
+ - Does the world support your themes?
207
+ - Are locations narratively significant?
208
+ - Is history relevant to the present story?
209
+
210
+ **Select an Option:**
211
+ [A] Advanced Elicitation - Explore world depth
212
+ [P] Party Mode - Get perspectives on world-building
213
+ [C] Continue - Save this and move to Dialogue Systems (Step 6 of 11)"
214
+
215
+ ### 7. Handle Menu Selection
216
+
217
+ #### IF A (Advanced Elicitation):
218
+
219
+ - Execute {advancedElicitationTask} with the current content
220
+ - Ask user: "Accept these changes? (y/n)"
221
+ - If yes: Update content, return to A/P/C menu
222
+ - If no: Keep original, return to A/P/C menu
223
+
224
+ #### IF P (Party Mode):
225
+
226
+ - Execute {partyModeWorkflow} with the current content
227
+ - Ask user: "Accept these changes? (y/n)"
228
+ - If yes: Update content, return to A/P/C menu
229
+ - If no: Keep original, return to A/P/C menu
230
+
231
+ #### IF C (Continue):
232
+
233
+ - Append the final content to `{outputFile}`
234
+ - Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5]`
235
+ - Load `{nextStepFile}`
236
+
237
+ ## CRITICAL STEP COMPLETION NOTE
238
+
239
+ ONLY WHEN [C continue option] is selected and [world content saved with frontmatter updated], will you then load and read fully `{nextStepFile}`.
240
+
241
+ ---
242
+
243
+ ## SYSTEM SUCCESS/FAILURE METRICS
244
+
245
+ ### SUCCESS:
246
+
247
+ - World setting clearly defined
248
+ - History connects to current story
249
+ - Factions developed (if applicable)
250
+ - Locations are narratively significant
251
+ - A/P/C menu presented and handled correctly
252
+ - Frontmatter updated with stepsCompleted: [1, 2, 3, 4, 5]
253
+
254
+ ### SYSTEM FAILURE:
255
+
256
+ - Creating world without user input
257
+ - World disconnected from story
258
+ - Generic locations without significance
259
+ - Not presenting A/P/C menu after content
260
+ - Proceeding without user selecting 'C'
261
+
262
+ **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.