bmad-method 4.37.0 → 4.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (251) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.md +3 -3
  2. package/.github/ISSUE_TEMPLATE/feature_request.md +3 -3
  3. package/.github/workflows/discord.yaml +11 -2
  4. package/.github/workflows/format-check.yaml +42 -0
  5. package/.github/workflows/manual-release.yaml +173 -0
  6. package/.husky/pre-commit +3 -0
  7. package/.vscode/settings.json +26 -1
  8. package/CHANGELOG.md +2 -23
  9. package/README.md +2 -0
  10. package/bmad-core/agent-teams/team-all.yaml +1 -1
  11. package/bmad-core/agents/analyst.md +16 -15
  12. package/bmad-core/agents/architect.md +11 -11
  13. package/bmad-core/agents/bmad-master.md +23 -22
  14. package/bmad-core/agents/bmad-orchestrator.md +13 -17
  15. package/bmad-core/agents/dev.md +14 -11
  16. package/bmad-core/agents/pm.md +15 -14
  17. package/bmad-core/agents/po.md +9 -8
  18. package/bmad-core/agents/qa.md +42 -22
  19. package/bmad-core/agents/sm.md +7 -6
  20. package/bmad-core/agents/ux-expert.md +6 -5
  21. package/bmad-core/core-config.yaml +2 -0
  22. package/bmad-core/data/bmad-kb.md +1 -1
  23. package/bmad-core/data/test-levels-framework.md +146 -0
  24. package/bmad-core/data/test-priorities-matrix.md +172 -0
  25. package/bmad-core/tasks/apply-qa-fixes.md +148 -0
  26. package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
  27. package/bmad-core/tasks/nfr-assess.md +343 -0
  28. package/bmad-core/tasks/qa-gate.md +161 -0
  29. package/bmad-core/tasks/review-story.md +234 -74
  30. package/bmad-core/tasks/risk-profile.md +353 -0
  31. package/bmad-core/tasks/test-design.md +174 -0
  32. package/bmad-core/tasks/trace-requirements.md +264 -0
  33. package/bmad-core/templates/architecture-tmpl.yaml +49 -49
  34. package/bmad-core/templates/brainstorming-output-tmpl.yaml +5 -5
  35. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +31 -31
  36. package/bmad-core/templates/brownfield-prd-tmpl.yaml +13 -13
  37. package/bmad-core/templates/competitor-analysis-tmpl.yaml +19 -6
  38. package/bmad-core/templates/front-end-architecture-tmpl.yaml +21 -9
  39. package/bmad-core/templates/front-end-spec-tmpl.yaml +24 -24
  40. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +122 -104
  41. package/bmad-core/templates/market-research-tmpl.yaml +2 -2
  42. package/bmad-core/templates/prd-tmpl.yaml +9 -9
  43. package/bmad-core/templates/project-brief-tmpl.yaml +4 -4
  44. package/bmad-core/templates/qa-gate-tmpl.yaml +102 -0
  45. package/bmad-core/templates/story-tmpl.yaml +12 -12
  46. package/bmad-core/workflows/brownfield-fullstack.yaml +9 -9
  47. package/bmad-core/workflows/brownfield-service.yaml +1 -1
  48. package/bmad-core/workflows/brownfield-ui.yaml +1 -1
  49. package/bmad-core/workflows/greenfield-fullstack.yaml +1 -1
  50. package/bmad-core/workflows/greenfield-service.yaml +1 -1
  51. package/bmad-core/workflows/greenfield-ui.yaml +1 -1
  52. package/common/utils/bmad-doc-template.md +5 -5
  53. package/dist/agents/analyst.txt +1086 -1079
  54. package/dist/agents/architect.txt +1534 -1526
  55. package/dist/agents/bmad-master.txt +646 -632
  56. package/dist/agents/bmad-orchestrator.txt +40 -18
  57. package/dist/agents/dev.txt +158 -19
  58. package/dist/agents/pm.txt +1082 -1107
  59. package/dist/agents/po.txt +314 -332
  60. package/dist/agents/qa.txt +1754 -151
  61. package/dist/agents/sm.txt +88 -98
  62. package/dist/agents/ux-expert.txt +80 -87
  63. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +109 -146
  64. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +75 -86
  65. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +41 -48
  66. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +1903 -1941
  67. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +15 -50
  68. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +149 -195
  69. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +0 -15
  70. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +20 -37
  71. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +2660 -2752
  72. package/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt +871 -0
  73. package/dist/expansion-packs/bmad-creative-writing/agents/book-critic.txt +78 -0
  74. package/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt +839 -0
  75. package/dist/expansion-packs/bmad-creative-writing/agents/cover-designer.txt +85 -0
  76. package/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt +861 -0
  77. package/dist/expansion-packs/bmad-creative-writing/agents/editor.txt +796 -0
  78. package/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt +927 -0
  79. package/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt +842 -0
  80. package/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt +1126 -0
  81. package/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt +864 -0
  82. package/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt +5917 -0
  83. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +25 -27
  84. package/dist/teams/team-all.txt +5541 -3768
  85. package/dist/teams/team-fullstack.txt +3014 -2987
  86. package/dist/teams/team-ide-minimal.txt +2219 -469
  87. package/dist/teams/team-no-ui.txt +2993 -2966
  88. package/docs/enhanced-ide-development-workflow.md +220 -15
  89. package/docs/user-guide.md +271 -18
  90. package/docs/versioning-and-releases.md +122 -44
  91. package/docs/working-in-the-brownfield.md +264 -31
  92. package/eslint.config.mjs +119 -0
  93. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +4 -4
  94. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +1 -1
  95. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  96. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +26 -28
  97. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +50 -50
  98. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +23 -23
  99. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +24 -24
  100. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +42 -42
  101. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
  102. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +5 -5
  103. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +1 -1
  104. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +3 -3
  105. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +1 -1
  106. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +1 -1
  107. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +23 -23
  108. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +63 -63
  109. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +20 -20
  110. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +65 -65
  111. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +5 -5
  112. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +1 -1
  113. package/expansion-packs/bmad-creative-writing/README.md +132 -0
  114. package/expansion-packs/bmad-creative-writing/agent-teams/agent-team.yaml +19 -0
  115. package/expansion-packs/bmad-creative-writing/agents/beta-reader.md +91 -0
  116. package/expansion-packs/bmad-creative-writing/agents/book-critic.md +35 -0
  117. package/expansion-packs/bmad-creative-writing/agents/character-psychologist.md +90 -0
  118. package/expansion-packs/bmad-creative-writing/agents/cover-designer.md +41 -0
  119. package/expansion-packs/bmad-creative-writing/agents/dialog-specialist.md +89 -0
  120. package/expansion-packs/bmad-creative-writing/agents/editor.md +90 -0
  121. package/expansion-packs/bmad-creative-writing/agents/genre-specialist.md +92 -0
  122. package/expansion-packs/bmad-creative-writing/agents/narrative-designer.md +90 -0
  123. package/expansion-packs/bmad-creative-writing/agents/plot-architect.md +92 -0
  124. package/expansion-packs/bmad-creative-writing/agents/world-builder.md +91 -0
  125. package/expansion-packs/bmad-creative-writing/checklists/beta-feedback-closure-checklist.md +16 -0
  126. package/expansion-packs/bmad-creative-writing/checklists/character-consistency-checklist.md +16 -0
  127. package/expansion-packs/bmad-creative-writing/checklists/comedic-timing-checklist.md +16 -0
  128. package/expansion-packs/bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md +16 -0
  129. package/expansion-packs/bmad-creative-writing/checklists/ebook-formatting-checklist.md +15 -0
  130. package/expansion-packs/bmad-creative-writing/checklists/epic-poetry-meter-checklist.md +16 -0
  131. package/expansion-packs/bmad-creative-writing/checklists/fantasy-magic-system-checklist.md +16 -0
  132. package/expansion-packs/bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md +15 -0
  133. package/expansion-packs/bmad-creative-writing/checklists/genre-tropes-checklist.md +15 -0
  134. package/expansion-packs/bmad-creative-writing/checklists/historical-accuracy-checklist.md +16 -0
  135. package/expansion-packs/bmad-creative-writing/checklists/horror-suspense-checklist.md +16 -0
  136. package/expansion-packs/bmad-creative-writing/checklists/kdp-cover-ready-checklist.md +18 -0
  137. package/expansion-packs/bmad-creative-writing/checklists/line-edit-quality-checklist.md +16 -0
  138. package/expansion-packs/bmad-creative-writing/checklists/marketing-copy-checklist.md +16 -0
  139. package/expansion-packs/bmad-creative-writing/checklists/mystery-clue-trail-checklist.md +16 -0
  140. package/expansion-packs/bmad-creative-writing/checklists/orbital-mechanics-checklist.md +16 -0
  141. package/expansion-packs/bmad-creative-writing/checklists/plot-structure-checklist.md +49 -0
  142. package/expansion-packs/bmad-creative-writing/checklists/publication-readiness-checklist.md +16 -0
  143. package/expansion-packs/bmad-creative-writing/checklists/romance-emotional-beats-checklist.md +16 -0
  144. package/expansion-packs/bmad-creative-writing/checklists/scene-quality-checklist.md +16 -0
  145. package/expansion-packs/bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md +15 -0
  146. package/expansion-packs/bmad-creative-writing/checklists/sensitivity-representation-checklist.md +16 -0
  147. package/expansion-packs/bmad-creative-writing/checklists/steampunk-gadget-checklist.md +16 -0
  148. package/expansion-packs/bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md +16 -0
  149. package/expansion-packs/bmad-creative-writing/checklists/timeline-continuity-checklist.md +16 -0
  150. package/expansion-packs/bmad-creative-writing/checklists/world-building-continuity-checklist.md +16 -0
  151. package/expansion-packs/bmad-creative-writing/checklists/ya-appropriateness-checklist.md +16 -0
  152. package/expansion-packs/bmad-creative-writing/config.yaml +11 -0
  153. package/expansion-packs/bmad-creative-writing/data/bmad-kb.md +197 -0
  154. package/expansion-packs/bmad-creative-writing/data/story-structures.md +58 -0
  155. package/expansion-packs/bmad-creative-writing/docs/brief.md +183 -0
  156. package/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md +117 -0
  157. package/expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md +16 -0
  158. package/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md +55 -0
  159. package/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md +22 -0
  160. package/expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md +16 -0
  161. package/expansion-packs/bmad-creative-writing/tasks/build-world.md +17 -0
  162. package/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md +15 -0
  163. package/expansion-packs/bmad-creative-writing/tasks/create-doc.md +101 -0
  164. package/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md +19 -0
  165. package/expansion-packs/bmad-creative-writing/tasks/critical-review.md +19 -0
  166. package/expansion-packs/bmad-creative-writing/tasks/develop-character.md +17 -0
  167. package/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md +93 -0
  168. package/expansion-packs/bmad-creative-writing/tasks/expand-premise.md +16 -0
  169. package/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md +16 -0
  170. package/expansion-packs/bmad-creative-writing/tasks/final-polish.md +16 -0
  171. package/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md +18 -0
  172. package/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md +19 -0
  173. package/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md +16 -0
  174. package/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md +18 -0
  175. package/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md +16 -0
  176. package/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md +17 -0
  177. package/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md +16 -0
  178. package/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md +15 -0
  179. package/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md +16 -0
  180. package/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md +51 -0
  181. package/expansion-packs/bmad-creative-writing/templates/beta-feedback-form.yaml +96 -0
  182. package/expansion-packs/bmad-creative-writing/templates/chapter-draft-tmpl.yaml +81 -0
  183. package/expansion-packs/bmad-creative-writing/templates/character-profile-tmpl.yaml +92 -0
  184. package/expansion-packs/bmad-creative-writing/templates/cover-design-brief-tmpl.yaml +97 -0
  185. package/expansion-packs/bmad-creative-writing/templates/premise-brief-tmpl.yaml +77 -0
  186. package/expansion-packs/bmad-creative-writing/templates/scene-list-tmpl.yaml +54 -0
  187. package/expansion-packs/bmad-creative-writing/templates/story-outline-tmpl.yaml +96 -0
  188. package/expansion-packs/bmad-creative-writing/templates/world-guide-tmpl.yaml +88 -0
  189. package/expansion-packs/bmad-creative-writing/workflows/book-cover-design-workflow.md +176 -0
  190. package/expansion-packs/bmad-creative-writing/workflows/novel-greenfield-workflow.yaml +58 -0
  191. package/expansion-packs/bmad-creative-writing/workflows/novel-serial-workflow.yaml +51 -0
  192. package/expansion-packs/bmad-creative-writing/workflows/novel-snowflake-workflow.yaml +69 -0
  193. package/expansion-packs/bmad-creative-writing/workflows/novel-writing.yaml +92 -0
  194. package/expansion-packs/bmad-creative-writing/workflows/screenplay-development.yaml +86 -0
  195. package/expansion-packs/bmad-creative-writing/workflows/series-planning.yaml +79 -0
  196. package/expansion-packs/bmad-creative-writing/workflows/short-story-creation.yaml +65 -0
  197. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  198. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +20 -20
  199. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +7 -7
  200. package/package.json +62 -39
  201. package/prettier.config.mjs +32 -0
  202. package/sync-version.sh +23 -0
  203. package/tools/bmad-npx-wrapper.js +10 -10
  204. package/tools/builders/web-builder.js +124 -130
  205. package/tools/bump-all-versions.js +42 -33
  206. package/tools/bump-expansion-version.js +23 -16
  207. package/tools/cli.js +10 -12
  208. package/tools/flattener/aggregate.js +10 -10
  209. package/tools/flattener/binary.js +44 -17
  210. package/tools/flattener/discovery.js +19 -18
  211. package/tools/flattener/files.js +6 -6
  212. package/tools/flattener/ignoreRules.js +125 -125
  213. package/tools/flattener/main.js +426 -70
  214. package/tools/flattener/projectRoot.js +186 -25
  215. package/tools/flattener/prompts.js +9 -9
  216. package/tools/flattener/stats.helpers.js +395 -0
  217. package/tools/flattener/stats.js +64 -14
  218. package/tools/flattener/test-matrix.js +413 -0
  219. package/tools/flattener/xml.js +33 -31
  220. package/tools/installer/bin/bmad.js +156 -113
  221. package/tools/installer/config/ide-agent-config.yaml +1 -1
  222. package/tools/installer/config/install.config.yaml +13 -3
  223. package/tools/installer/lib/config-loader.js +46 -42
  224. package/tools/installer/lib/file-manager.js +91 -113
  225. package/tools/installer/lib/ide-base-setup.js +57 -56
  226. package/tools/installer/lib/ide-setup.js +545 -399
  227. package/tools/installer/lib/installer.js +875 -714
  228. package/tools/installer/lib/memory-profiler.js +54 -53
  229. package/tools/installer/lib/module-manager.js +19 -15
  230. package/tools/installer/lib/resource-locator.js +26 -28
  231. package/tools/installer/package.json +19 -19
  232. package/tools/lib/dependency-resolver.js +26 -30
  233. package/tools/lib/yaml-utils.js +7 -7
  234. package/tools/preview-release-notes.js +66 -0
  235. package/tools/shared/bannerArt.js +3 -3
  236. package/tools/sync-installer-version.js +7 -9
  237. package/tools/update-expansion-version.js +14 -15
  238. package/tools/upgraders/v3-to-v4-upgrader.js +203 -294
  239. package/tools/version-bump.js +41 -26
  240. package/tools/yaml-format.js +56 -43
  241. package/.github/workflows/release.yaml +0 -60
  242. package/.releaserc.json +0 -21
  243. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/Complete AI Agent System - Flowchart.svg +0 -102
  244. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.1 Google Cloud Project Setup/1.1.1 - Initial Project Configuration - bash copy.txt +0 -13
  245. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.1 Google Cloud Project Setup/1.1.1 - Initial Project Configuration - bash.txt +0 -13
  246. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.2 Agent Development Kit Installation/1.2.2 - Basic Project Structure - txt.txt +0 -25
  247. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.3 Core Configuration Files/1.3.1 - settings.py +0 -34
  248. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.3 Core Configuration Files/1.3.2 - main.py - Base Application.py +0 -70
  249. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.4 Deployment Configuration/1.4.2 - cloudbuild.yaml +0 -26
  250. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +0 -109
  251. package/tools/semantic-release-sync-installer.js +0 -30
@@ -210,7 +210,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
210
210
  ## Instructions
211
211
 
212
212
  1. **Initial Assessment**
213
-
214
213
  - If user or the task being run provides a checklist name:
215
214
  - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
216
215
  - If multiple matches found, ask user to clarify
@@ -223,14 +222,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
223
222
  - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
224
223
 
225
224
  2. **Document and Artifact Gathering**
226
-
227
225
  - Each checklist will specify its required documents/artifacts at the beginning
228
226
  - Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
229
227
 
230
228
  3. **Checklist Processing**
231
229
 
232
230
  If in interactive mode:
233
-
234
231
  - Work through each section of the checklist one at a time
235
232
  - For each section:
236
233
  - Review all items in the section following instructions for that section embedded in the checklist
@@ -239,7 +236,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
239
236
  - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
240
237
 
241
238
  If in YOLO mode:
242
-
243
239
  - Process all sections at once
244
240
  - Create a comprehensive report of all findings
245
241
  - Present the complete analysis to the user
@@ -247,7 +243,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
247
243
  4. **Validation Approach**
248
244
 
249
245
  For each checklist item:
250
-
251
246
  - Read and understand the requirement
252
247
  - Look for evidence in the documentation that satisfies the requirement
253
248
  - Consider both explicit mentions and implicit coverage
@@ -261,7 +256,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
261
256
  5. **Section Analysis**
262
257
 
263
258
  For each section:
264
-
265
259
  - think step by step to calculate pass rate
266
260
  - Identify common themes in failed items
267
261
  - Provide specific recommendations for improvement
@@ -271,7 +265,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
271
265
  6. **Final Report**
272
266
 
273
267
  Prepare a summary that includes:
274
-
275
268
  - Overall checklist completion status
276
269
  - Pass rates by section
277
270
  - List of failed items with context
@@ -306,7 +299,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
306
299
  [[LLM: Begin by understanding the game design context and goals. Ask clarifying questions if needed to determine the best approach for game-specific ideation.]]
307
300
 
308
301
  1. **Establish Game Context**
309
-
310
302
  - Understand the game genre or opportunity area
311
303
  - Identify target audience and platform constraints
312
304
  - Determine session goals (concept exploration vs. mechanic refinement)
@@ -324,7 +316,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
324
316
 
325
317
  1. **"What If" Game Scenarios**
326
318
  [[LLM: Generate provocative what-if questions that challenge game design assumptions and expand thinking beyond current genre limitations.]]
327
-
328
319
  - What if players could rewind time in any genre?
329
320
  - What if the game world reacted to the player's real-world location?
330
321
  - What if failure was more rewarding than success?
@@ -333,7 +324,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
333
324
 
334
325
  2. **Cross-Genre Fusion**
335
326
  [[LLM: Help user combine unexpected game genres and mechanics to create unique experiences.]]
336
-
337
327
  - "How might [genre A] mechanics work in [genre B]?"
338
328
  - Puzzle mechanics in action games
339
329
  - Dating sim elements in strategy games
@@ -342,7 +332,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
342
332
 
343
333
  3. **Player Motivation Reversal**
344
334
  [[LLM: Flip traditional player motivations to reveal new gameplay possibilities.]]
345
-
346
335
  - What if losing was the goal?
347
336
  - What if cooperation was forced in competitive games?
348
337
  - What if players had to help their enemies?
@@ -359,7 +348,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
359
348
 
360
349
  1. **SCAMPER for Game Mechanics**
361
350
  [[LLM: Guide through each SCAMPER prompt specifically for game design.]]
362
-
363
351
  - **S** = Substitute: What mechanics can be substituted? (walking → flying → swimming)
364
352
  - **C** = Combine: What systems can be merged? (inventory + character growth)
365
353
  - **A** = Adapt: What mechanics from other media? (books, movies, sports)
@@ -370,7 +358,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
370
358
 
371
359
  2. **Player Agency Spectrum**
372
360
  [[LLM: Explore different levels of player control and agency across game systems.]]
373
-
374
361
  - Full Control: Direct character movement, combat, building
375
362
  - Indirect Control: Setting rules, giving commands, environmental changes
376
363
  - Influence Only: Suggestions, preferences, emotional reactions
@@ -378,7 +365,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
378
365
 
379
366
  3. **Temporal Game Design**
380
367
  [[LLM: Explore how time affects gameplay and player experience.]]
381
-
382
368
  - Real-time vs. turn-based mechanics
383
369
  - Time travel and manipulation
384
370
  - Persistent vs. session-based progress
@@ -389,7 +375,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
389
375
 
390
376
  1. **Emotion-First Design**
391
377
  [[LLM: Start with target emotions and work backward to mechanics that create them.]]
392
-
393
378
  - Target Emotion: Wonder → Mechanics: Discovery, mystery, scale
394
379
  - Target Emotion: Triumph → Mechanics: Challenge, skill growth, recognition
395
380
  - Target Emotion: Connection → Mechanics: Cooperation, shared goals, communication
@@ -397,7 +382,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
397
382
 
398
383
  2. **Player Archetype Brainstorming**
399
384
  [[LLM: Design for different player types and motivations.]]
400
-
401
385
  - Achievers: Progression, completion, mastery
402
386
  - Explorers: Discovery, secrets, world-building
403
387
  - Socializers: Interaction, cooperation, community
@@ -406,7 +390,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
406
390
 
407
391
  3. **Accessibility-First Innovation**
408
392
  [[LLM: Generate ideas that make games more accessible while creating new gameplay.]]
409
-
410
393
  - Visual impairment considerations leading to audio-focused mechanics
411
394
  - Motor accessibility inspiring one-handed or simplified controls
412
395
  - Cognitive accessibility driving clear feedback and pacing
@@ -416,7 +399,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
416
399
 
417
400
  1. **Environmental Storytelling**
418
401
  [[LLM: Brainstorm ways the game world itself tells stories without explicit narrative.]]
419
-
420
402
  - How does the environment show history?
421
403
  - What do interactive objects reveal about characters?
422
404
  - How can level design communicate mood?
@@ -424,7 +406,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
424
406
 
425
407
  2. **Player-Generated Narrative**
426
408
  [[LLM: Explore ways players create their own stories through gameplay.]]
427
-
428
409
  - Emergent storytelling through player choices
429
410
  - Procedural narrative generation
430
411
  - Player-to-player story sharing
@@ -432,7 +413,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
432
413
 
433
414
  3. **Genre Expectation Subversion**
434
415
  [[LLM: Identify and deliberately subvert player expectations within genres.]]
435
-
436
416
  - Fantasy RPG where magic is mundane
437
417
  - Horror game where monsters are friendly
438
418
  - Racing game where going slow is optimal
@@ -442,7 +422,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
442
422
 
443
423
  1. **Platform-Specific Design**
444
424
  [[LLM: Generate ideas that leverage unique platform capabilities.]]
445
-
446
425
  - Mobile: GPS, accelerometer, camera, always-connected
447
426
  - Web: URLs, tabs, social sharing, real-time collaboration
448
427
  - Console: Controllers, TV viewing, couch co-op
@@ -450,7 +429,6 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
450
429
 
451
430
  2. **Constraint-Based Creativity**
452
431
  [[LLM: Use technical or design constraints as creative catalysts.]]
453
-
454
432
  - One-button games
455
433
  - Games without graphics
456
434
  - Games that play in notification bars
@@ -496,19 +474,16 @@ This task provides a comprehensive toolkit of creative brainstorming techniques
496
474
  [[LLM: Guide the brainstorming session with appropriate pacing for game design exploration.]]
497
475
 
498
476
  1. **Inspiration Phase** (10-15 min)
499
-
500
477
  - Reference existing games and mechanics
501
478
  - Explore player experiences and emotions
502
479
  - Gather visual and thematic inspiration
503
480
 
504
481
  2. **Divergent Exploration** (25-35 min)
505
-
506
482
  - Generate many game concepts or mechanics
507
483
  - Use expansion and fusion techniques
508
484
  - Encourage wild and impossible ideas
509
485
 
510
486
  3. **Player-Centered Filtering** (15-20 min)
511
-
512
487
  - Consider target audience reactions
513
488
  - Evaluate emotional impact and engagement
514
489
  - Group ideas by player experience goals
@@ -629,63 +604,54 @@ CRITICAL: First, help the user select the most appropriate research focus based
629
604
  Present these numbered options to the user:
630
605
 
631
606
  1. **Product Validation Research**
632
-
633
607
  - Validate product hypotheses and market fit
634
608
  - Test assumptions about user needs and solutions
635
609
  - Assess technical and business feasibility
636
610
  - Identify risks and mitigation strategies
637
611
 
638
612
  2. **Market Opportunity Research**
639
-
640
613
  - Analyze market size and growth potential
641
614
  - Identify market segments and dynamics
642
615
  - Assess market entry strategies
643
616
  - Evaluate timing and market readiness
644
617
 
645
618
  3. **User & Customer Research**
646
-
647
619
  - Deep dive into user personas and behaviors
648
620
  - Understand jobs-to-be-done and pain points
649
621
  - Map customer journeys and touchpoints
650
622
  - Analyze willingness to pay and value perception
651
623
 
652
624
  4. **Competitive Intelligence Research**
653
-
654
625
  - Detailed competitor analysis and positioning
655
626
  - Feature and capability comparisons
656
627
  - Business model and strategy analysis
657
628
  - Identify competitive advantages and gaps
658
629
 
659
630
  5. **Technology & Innovation Research**
660
-
661
631
  - Assess technology trends and possibilities
662
632
  - Evaluate technical approaches and architectures
663
633
  - Identify emerging technologies and disruptions
664
634
  - Analyze build vs. buy vs. partner options
665
635
 
666
636
  6. **Industry & Ecosystem Research**
667
-
668
637
  - Map industry value chains and dynamics
669
638
  - Identify key players and relationships
670
639
  - Analyze regulatory and compliance factors
671
640
  - Understand partnership opportunities
672
641
 
673
642
  7. **Strategic Options Research**
674
-
675
643
  - Evaluate different strategic directions
676
644
  - Assess business model alternatives
677
645
  - Analyze go-to-market strategies
678
646
  - Consider expansion and scaling paths
679
647
 
680
648
  8. **Risk & Feasibility Research**
681
-
682
649
  - Identify and assess various risk factors
683
650
  - Evaluate implementation challenges
684
651
  - Analyze resource requirements
685
652
  - Consider regulatory and legal implications
686
653
 
687
654
  9. **Custom Research Focus**
688
-
689
655
  - User-defined research objectives
690
656
  - Specialized domain investigation
691
657
  - Cross-functional research needs
@@ -854,13 +820,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
854
820
  ### 5. Review and Refinement
855
821
 
856
822
  1. **Present Complete Prompt**
857
-
858
823
  - Show the full research prompt
859
824
  - Explain key elements and rationale
860
825
  - Highlight any assumptions made
861
826
 
862
827
  2. **Gather Feedback**
863
-
864
828
  - Are the objectives clear and correct?
865
829
  - Do the questions address all concerns?
866
830
  - Is the scope appropriate?
@@ -918,7 +882,6 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
918
882
  2. If the section contains game flow diagrams, level layouts, or system diagrams, explain each diagram briefly with game development context before offering elicitation options (e.g., "The gameplay loop diagram shows how player actions lead to rewards and progression. Notice how each step maintains player engagement and creates opportunities for skill development.")
919
883
 
920
884
  3. If the section contains multiple game elements (like multiple mechanics, multiple levels, multiple systems, etc.), inform the user they can apply elicitation actions to:
921
-
922
885
  - The entire section as a whole
923
886
  - Individual game elements within the section (specify which element when selecting an action)
924
887
 
@@ -1028,7 +991,7 @@ sections:
1028
991
  - id: initial-setup
1029
992
  instruction: |
1030
993
  This template creates a comprehensive Game Design Document that will serve as the foundation for all game development work. The GDD should be detailed enough that developers can create user stories and epics from it. Focus on gameplay systems, mechanics, and technical requirements that can be broken down into implementable features.
1031
-
994
+
1032
995
  If available, review any provided documents or ask if any are optionally available: Project Brief, Market Research, Competitive Analysis
1033
996
 
1034
997
  - id: executive-summary
@@ -1073,7 +1036,7 @@ sections:
1073
1036
  instruction: Define the 30-60 second loop that players will repeat. Be specific about timing and player actions.
1074
1037
  template: |
1075
1038
  **Primary Loop ({{duration}} seconds):**
1076
-
1039
+
1077
1040
  1. {{action_1}} ({{time_1}}s)
1078
1041
  2. {{action_2}} ({{time_2}}s)
1079
1042
  3. {{action_3}} ({{time_3}}s)
@@ -1083,12 +1046,12 @@ sections:
1083
1046
  instruction: Clearly define success and failure states
1084
1047
  template: |
1085
1048
  **Victory Conditions:**
1086
-
1049
+
1087
1050
  - {{win_condition_1}}
1088
1051
  - {{win_condition_2}}
1089
-
1052
+
1090
1053
  **Failure States:**
1091
-
1054
+
1092
1055
  - {{loss_condition_1}}
1093
1056
  - {{loss_condition_2}}
1094
1057
 
@@ -1104,17 +1067,17 @@ sections:
1104
1067
  title: "{{mechanic_name}}"
1105
1068
  template: |
1106
1069
  **Description:** {{detailed_description}}
1107
-
1070
+
1108
1071
  **Player Input:** {{input_method}}
1109
-
1072
+
1110
1073
  **System Response:** {{game_response}}
1111
-
1074
+
1112
1075
  **Implementation Notes:**
1113
-
1076
+
1114
1077
  - {{tech_requirement_1}}
1115
1078
  - {{tech_requirement_2}}
1116
1079
  - {{performance_consideration}}
1117
-
1080
+
1118
1081
  **Dependencies:** {{other_mechanics_needed}}
1119
1082
  - id: controls
1120
1083
  title: Controls
@@ -1133,9 +1096,9 @@ sections:
1133
1096
  title: Player Progression
1134
1097
  template: |
1135
1098
  **Progression Type:** {{linear|branching|metroidvania}}
1136
-
1099
+
1137
1100
  **Key Milestones:**
1138
-
1101
+
1139
1102
  1. **{{milestone_1}}** - {{unlock_description}}
1140
1103
  2. **{{milestone_2}}** - {{unlock_description}}
1141
1104
  3. **{{milestone_3}}** - {{unlock_description}}
@@ -1172,9 +1135,9 @@ sections:
1172
1135
  **Duration:** {{target_time}}
1173
1136
  **Key Elements:** {{required_mechanics}}
1174
1137
  **Difficulty:** {{relative_difficulty}}
1175
-
1138
+
1176
1139
  **Structure Template:**
1177
-
1140
+
1178
1141
  - Introduction: {{intro_description}}
1179
1142
  - Challenge: {{main_challenge}}
1180
1143
  - Resolution: {{completion_requirement}}
@@ -1200,13 +1163,13 @@ sections:
1200
1163
  title: Platform Specific
1201
1164
  template: |
1202
1165
  **Desktop:**
1203
-
1166
+
1204
1167
  - Resolution: {{min_resolution}} - {{max_resolution}}
1205
1168
  - Input: Keyboard, Mouse, Gamepad
1206
1169
  - Browser: Chrome 80+, Firefox 75+, Safari 13+
1207
-
1170
+
1208
1171
  **Mobile:**
1209
-
1172
+
1210
1173
  - Resolution: {{mobile_min}} - {{mobile_max}}
1211
1174
  - Input: Touch, Tilt (optional)
1212
1175
  - OS: iOS 13+, Android 8+
@@ -1215,14 +1178,14 @@ sections:
1215
1178
  instruction: Define asset specifications for the art and audio teams
1216
1179
  template: |
1217
1180
  **Visual Assets:**
1218
-
1181
+
1219
1182
  - Art Style: {{style_description}}
1220
1183
  - Color Palette: {{color_specification}}
1221
1184
  - Animation: {{animation_requirements}}
1222
1185
  - UI Resolution: {{ui_specs}}
1223
-
1186
+
1224
1187
  **Audio Assets:**
1225
-
1188
+
1226
1189
  - Music Style: {{music_genre}}
1227
1190
  - Sound Effects: {{sfx_requirements}}
1228
1191
  - Voice Acting: {{voice_needs}}
@@ -1235,7 +1198,7 @@ sections:
1235
1198
  title: Engine Configuration
1236
1199
  template: |
1237
1200
  **Phaser 3 Setup:**
1238
-
1201
+
1239
1202
  - TypeScript: Strict mode enabled
1240
1203
  - Physics: {{physics_system}} (Arcade/Matter)
1241
1204
  - Renderer: WebGL with Canvas fallback
@@ -1244,7 +1207,7 @@ sections:
1244
1207
  title: Code Architecture
1245
1208
  template: |
1246
1209
  **Required Systems:**
1247
-
1210
+
1248
1211
  - Scene Management
1249
1212
  - State Management
1250
1213
  - Asset Loading
@@ -1256,7 +1219,7 @@ sections:
1256
1219
  title: Data Management
1257
1220
  template: |
1258
1221
  **Save Data:**
1259
-
1222
+
1260
1223
  - Progress tracking
1261
1224
  - Settings persistence
1262
1225
  - Statistics collection
@@ -1374,7 +1337,7 @@ sections:
1374
1337
  - id: initial-setup
1375
1338
  instruction: |
1376
1339
  This template creates comprehensive level design documentation that guides both content creation and technical implementation. This document should provide enough detail for developers to create level loading systems and for designers to create specific levels.
1377
-
1340
+
1378
1341
  If available, review: Game Design Document (GDD), Game Architecture Document. This document should align with the game mechanics and technical systems defined in those documents.
1379
1342
 
1380
1343
  - id: introduction
@@ -1382,7 +1345,7 @@ sections:
1382
1345
  instruction: Establish the purpose and scope of level design for this game
1383
1346
  content: |
1384
1347
  This document defines the level design framework for {{game_title}}, providing guidelines for creating engaging, balanced levels that support the core gameplay mechanics defined in the Game Design Document.
1385
-
1348
+
1386
1349
  This framework ensures consistency across all levels while providing flexibility for creative level design within established technical and design constraints.
1387
1350
  sections:
1388
1351
  - id: change-log
@@ -1429,29 +1392,29 @@ sections:
1429
1392
  title: "{{category_name}} Levels"
1430
1393
  template: |
1431
1394
  **Purpose:** {{gameplay_purpose}}
1432
-
1395
+
1433
1396
  **Target Duration:** {{min_time}} - {{max_time}} minutes
1434
-
1397
+
1435
1398
  **Difficulty Range:** {{difficulty_scale}}
1436
-
1399
+
1437
1400
  **Key Mechanics Featured:**
1438
-
1401
+
1439
1402
  - {{mechanic_1}} - {{usage_description}}
1440
1403
  - {{mechanic_2}} - {{usage_description}}
1441
-
1404
+
1442
1405
  **Player Objectives:**
1443
-
1406
+
1444
1407
  - Primary: {{primary_objective}}
1445
1408
  - Secondary: {{secondary_objective}}
1446
1409
  - Hidden: {{secret_objective}}
1447
-
1410
+
1448
1411
  **Success Criteria:**
1449
-
1412
+
1450
1413
  - {{completion_requirement_1}}
1451
1414
  - {{completion_requirement_2}}
1452
-
1415
+
1453
1416
  **Technical Requirements:**
1454
-
1417
+
1455
1418
  - Maximum entities: {{entity_limit}}
1456
1419
  - Performance target: {{fps_target}} FPS
1457
1420
  - Memory budget: {{memory_limit}}MB
@@ -1466,11 +1429,11 @@ sections:
1466
1429
  instruction: Based on GDD requirements, define the overall level organization
1467
1430
  template: |
1468
1431
  **Organization Type:** {{linear|hub_world|open_world}}
1469
-
1432
+
1470
1433
  **Total Level Count:** {{number}}
1471
-
1434
+
1472
1435
  **World Breakdown:**
1473
-
1436
+
1474
1437
  - World 1: {{level_count}} levels - {{theme}} - {{difficulty_range}}
1475
1438
  - World 2: {{level_count}} levels - {{theme}} - {{difficulty_range}}
1476
1439
  - World 3: {{level_count}} levels - {{theme}} - {{difficulty_range}}
@@ -1505,7 +1468,7 @@ sections:
1505
1468
  instruction: Define how players access new levels
1506
1469
  template: |
1507
1470
  **Progression Gates:**
1508
-
1471
+
1509
1472
  - Linear progression: Complete previous level
1510
1473
  - Star requirements: {{star_count}} stars to unlock
1511
1474
  - Skill gates: Demonstrate {{skill_requirement}}
@@ -1520,17 +1483,17 @@ sections:
1520
1483
  instruction: Define all environmental components that can be used in levels
1521
1484
  template: |
1522
1485
  **Terrain Types:**
1523
-
1486
+
1524
1487
  - {{terrain_1}}: {{properties_and_usage}}
1525
1488
  - {{terrain_2}}: {{properties_and_usage}}
1526
-
1489
+
1527
1490
  **Interactive Objects:**
1528
-
1491
+
1529
1492
  - {{object_1}}: {{behavior_and_purpose}}
1530
1493
  - {{object_2}}: {{behavior_and_purpose}}
1531
-
1494
+
1532
1495
  **Hazards and Obstacles:**
1533
-
1496
+
1534
1497
  - {{hazard_1}}: {{damage_and_behavior}}
1535
1498
  - {{hazard_2}}: {{damage_and_behavior}}
1536
1499
  - id: collectibles-rewards
@@ -1538,18 +1501,18 @@ sections:
1538
1501
  instruction: Define all collectible items and their placement rules
1539
1502
  template: |
1540
1503
  **Collectible Types:**
1541
-
1504
+
1542
1505
  - {{collectible_1}}: {{value_and_purpose}}
1543
1506
  - {{collectible_2}}: {{value_and_purpose}}
1544
-
1507
+
1545
1508
  **Placement Guidelines:**
1546
-
1509
+
1547
1510
  - Mandatory collectibles: {{placement_rules}}
1548
1511
  - Optional collectibles: {{placement_rules}}
1549
1512
  - Secret collectibles: {{placement_rules}}
1550
-
1513
+
1551
1514
  **Reward Distribution:**
1552
-
1515
+
1553
1516
  - Easy to find: {{percentage}}%
1554
1517
  - Moderate challenge: {{percentage}}%
1555
1518
  - High skill required: {{percentage}}%
@@ -1558,18 +1521,18 @@ sections:
1558
1521
  instruction: Define how enemies should be placed and balanced in levels
1559
1522
  template: |
1560
1523
  **Enemy Categories:**
1561
-
1524
+
1562
1525
  - {{enemy_type_1}}: {{behavior_and_usage}}
1563
1526
  - {{enemy_type_2}}: {{behavior_and_usage}}
1564
-
1527
+
1565
1528
  **Placement Principles:**
1566
-
1529
+
1567
1530
  - Introduction encounters: {{guideline}}
1568
1531
  - Standard encounters: {{guideline}}
1569
1532
  - Challenge encounters: {{guideline}}
1570
-
1533
+
1571
1534
  **Difficulty Scaling:**
1572
-
1535
+
1573
1536
  - Enemy count progression: {{scaling_rule}}
1574
1537
  - Enemy type introduction: {{pacing_rule}}
1575
1538
  - Encounter complexity: {{complexity_rule}}
@@ -1582,14 +1545,14 @@ sections:
1582
1545
  title: Level Layout Principles
1583
1546
  template: |
1584
1547
  **Spatial Design:**
1585
-
1548
+
1586
1549
  - Grid size: {{grid_dimensions}}
1587
1550
  - Minimum path width: {{width_units}}
1588
1551
  - Maximum vertical distance: {{height_units}}
1589
1552
  - Safe zones placement: {{safety_guidelines}}
1590
-
1553
+
1591
1554
  **Navigation Design:**
1592
-
1555
+
1593
1556
  - Clear path indication: {{visual_cues}}
1594
1557
  - Landmark placement: {{landmark_rules}}
1595
1558
  - Dead end avoidance: {{dead_end_policy}}
@@ -1599,13 +1562,13 @@ sections:
1599
1562
  instruction: Define how to control the rhythm and pace of gameplay within levels
1600
1563
  template: |
1601
1564
  **Action Sequences:**
1602
-
1565
+
1603
1566
  - High intensity duration: {{max_duration}}
1604
1567
  - Rest period requirement: {{min_rest_time}}
1605
1568
  - Intensity variation: {{pacing_pattern}}
1606
-
1569
+
1607
1570
  **Learning Sequences:**
1608
-
1571
+
1609
1572
  - New mechanic introduction: {{teaching_method}}
1610
1573
  - Practice opportunity: {{practice_duration}}
1611
1574
  - Skill application: {{application_context}}
@@ -1614,14 +1577,14 @@ sections:
1614
1577
  instruction: Define how to create appropriate challenges for each level type
1615
1578
  template: |
1616
1579
  **Challenge Types:**
1617
-
1580
+
1618
1581
  - Execution challenges: {{skill_requirements}}
1619
1582
  - Puzzle challenges: {{complexity_guidelines}}
1620
1583
  - Time challenges: {{time_pressure_rules}}
1621
1584
  - Resource challenges: {{resource_management}}
1622
-
1585
+
1623
1586
  **Difficulty Calibration:**
1624
-
1587
+
1625
1588
  - Skill check frequency: {{frequency_guidelines}}
1626
1589
  - Failure recovery: {{retry_mechanics}}
1627
1590
  - Hint system integration: {{help_system}}
@@ -1635,7 +1598,7 @@ sections:
1635
1598
  instruction: Define how level data should be structured for implementation
1636
1599
  template: |
1637
1600
  **Level File Format:**
1638
-
1601
+
1639
1602
  - Data format: {{json|yaml|custom}}
1640
1603
  - File naming: `level_{{world}}_{{number}}.{{extension}}`
1641
1604
  - Data organization: {{structure_description}}
@@ -1673,14 +1636,14 @@ sections:
1673
1636
  instruction: Define how level assets are organized and loaded
1674
1637
  template: |
1675
1638
  **Tilemap Requirements:**
1676
-
1639
+
1677
1640
  - Tile size: {{tile_dimensions}}px
1678
1641
  - Tileset organization: {{tileset_structure}}
1679
1642
  - Layer organization: {{layer_system}}
1680
1643
  - Collision data: {{collision_format}}
1681
-
1644
+
1682
1645
  **Audio Integration:**
1683
-
1646
+
1684
1647
  - Background music: {{music_requirements}}
1685
1648
  - Ambient sounds: {{ambient_system}}
1686
1649
  - Dynamic audio: {{dynamic_audio_rules}}
@@ -1689,19 +1652,19 @@ sections:
1689
1652
  instruction: Define performance requirements for level systems
1690
1653
  template: |
1691
1654
  **Entity Limits:**
1692
-
1655
+
1693
1656
  - Maximum active entities: {{entity_limit}}
1694
1657
  - Maximum particles: {{particle_limit}}
1695
1658
  - Maximum audio sources: {{audio_limit}}
1696
-
1659
+
1697
1660
  **Memory Management:**
1698
-
1661
+
1699
1662
  - Texture memory budget: {{texture_memory}}MB
1700
1663
  - Audio memory budget: {{audio_memory}}MB
1701
1664
  - Level loading time: <{{load_time}}s
1702
-
1665
+
1703
1666
  **Culling and LOD:**
1704
-
1667
+
1705
1668
  - Off-screen culling: {{culling_distance}}
1706
1669
  - Level-of-detail rules: {{lod_system}}
1707
1670
  - Asset streaming: {{streaming_requirements}}
@@ -1714,13 +1677,13 @@ sections:
1714
1677
  title: Automated Testing
1715
1678
  template: |
1716
1679
  **Performance Testing:**
1717
-
1680
+
1718
1681
  - Frame rate validation: Maintain {{fps_target}} FPS
1719
1682
  - Memory usage monitoring: Stay under {{memory_limit}}MB
1720
1683
  - Loading time verification: Complete in <{{load_time}}s
1721
-
1684
+
1722
1685
  **Gameplay Testing:**
1723
-
1686
+
1724
1687
  - Completion path validation: All objectives achievable
1725
1688
  - Collectible accessibility: All items reachable
1726
1689
  - Softlock prevention: No unwinnable states
@@ -1748,14 +1711,14 @@ sections:
1748
1711
  title: Balance Validation
1749
1712
  template: |
1750
1713
  **Metrics Collection:**
1751
-
1714
+
1752
1715
  - Completion rate: Target {{completion_percentage}}%
1753
1716
  - Average completion time: {{target_time}} ± {{variance}}
1754
1717
  - Death count per level: <{{max_deaths}}
1755
1718
  - Collectible discovery rate: {{discovery_percentage}}%
1756
-
1719
+
1757
1720
  **Iteration Guidelines:**
1758
-
1721
+
1759
1722
  - Adjustment criteria: {{criteria_for_changes}}
1760
1723
  - Testing sample size: {{minimum_testers}}
1761
1724
  - Validation period: {{testing_duration}}
@@ -1768,14 +1731,14 @@ sections:
1768
1731
  title: Design Phase
1769
1732
  template: |
1770
1733
  **Concept Development:**
1771
-
1734
+
1772
1735
  1. Define level purpose and goals
1773
1736
  2. Create rough layout sketch
1774
1737
  3. Identify key mechanics and challenges
1775
1738
  4. Estimate difficulty and duration
1776
-
1739
+
1777
1740
  **Documentation Requirements:**
1778
-
1741
+
1779
1742
  - Level design brief
1780
1743
  - Layout diagrams
1781
1744
  - Mechanic integration notes
@@ -1784,15 +1747,15 @@ sections:
1784
1747
  title: Implementation Phase
1785
1748
  template: |
1786
1749
  **Technical Implementation:**
1787
-
1750
+
1788
1751
  1. Create level data file
1789
1752
  2. Build tilemap and layout
1790
1753
  3. Place entities and objects
1791
1754
  4. Configure level logic and triggers
1792
1755
  5. Integrate audio and visual effects
1793
-
1756
+
1794
1757
  **Quality Assurance:**
1795
-
1758
+
1796
1759
  1. Automated testing execution
1797
1760
  2. Internal playtesting
1798
1761
  3. Performance validation
@@ -1801,14 +1764,14 @@ sections:
1801
1764
  title: Integration Phase
1802
1765
  template: |
1803
1766
  **Game Integration:**
1804
-
1767
+
1805
1768
  1. Level progression integration
1806
1769
  2. Save system compatibility
1807
1770
  3. Analytics integration
1808
1771
  4. Achievement system integration
1809
-
1772
+
1810
1773
  **Final Validation:**
1811
-
1774
+
1812
1775
  1. Full game context testing
1813
1776
  2. Performance regression testing
1814
1777
  3. Platform compatibility verification
@@ -1861,7 +1824,7 @@ sections:
1861
1824
  - id: initial-setup
1862
1825
  instruction: |
1863
1826
  This template creates a comprehensive game brief that serves as the foundation for all subsequent game development work. The brief should capture the essential vision, scope, and requirements needed to create a detailed Game Design Document.
1864
-
1827
+
1865
1828
  This brief is typically created early in the ideation process, often after brainstorming sessions, to crystallize the game concept before moving into detailed design.
1866
1829
 
1867
1830
  - id: game-vision
@@ -1918,7 +1881,7 @@ sections:
1918
1881
  repeatable: true
1919
1882
  template: |
1920
1883
  **Core Mechanic: {{mechanic_name}}**
1921
-
1884
+
1922
1885
  - **Description:** {{how_it_works}}
1923
1886
  - **Player Value:** {{why_its_fun}}
1924
1887
  - **Implementation Scope:** {{complexity_estimate}}
@@ -1945,12 +1908,12 @@ sections:
1945
1908
  title: Technical Constraints
1946
1909
  template: |
1947
1910
  **Platform Requirements:**
1948
-
1911
+
1949
1912
  - Primary: {{platform_1}} - {{requirements}}
1950
1913
  - Secondary: {{platform_2}} - {{requirements}}
1951
-
1914
+
1952
1915
  **Technical Specifications:**
1953
-
1916
+
1954
1917
  - Engine: Phaser 3 + TypeScript
1955
1918
  - Performance Target: {{fps_target}} FPS on {{target_device}}
1956
1919
  - Memory Budget: <{{memory_limit}}MB
@@ -1988,10 +1951,10 @@ sections:
1988
1951
  title: Competitive Analysis
1989
1952
  template: |
1990
1953
  **Direct Competitors:**
1991
-
1954
+
1992
1955
  - {{competitor_1}}: {{strengths_and_weaknesses}}
1993
1956
  - {{competitor_2}}: {{strengths_and_weaknesses}}
1994
-
1957
+
1995
1958
  **Differentiation Strategy:**
1996
1959
  {{how_we_differ_and_why_thats_valuable}}
1997
1960
  - id: market-opportunity
@@ -2015,16 +1978,16 @@ sections:
2015
1978
  title: Content Categories
2016
1979
  template: |
2017
1980
  **Core Content:**
2018
-
1981
+
2019
1982
  - {{content_type_1}}: {{quantity_and_description}}
2020
1983
  - {{content_type_2}}: {{quantity_and_description}}
2021
-
1984
+
2022
1985
  **Optional Content:**
2023
-
1986
+
2024
1987
  - {{optional_content_type}}: {{quantity_and_description}}
2025
-
1988
+
2026
1989
  **Replay Elements:**
2027
-
1990
+
2028
1991
  - {{replayability_features}}
2029
1992
  - id: difficulty-accessibility
2030
1993
  title: Difficulty and Accessibility
@@ -2091,13 +2054,13 @@ sections:
2091
2054
  title: Player Experience Metrics
2092
2055
  template: |
2093
2056
  **Engagement Goals:**
2094
-
2057
+
2095
2058
  - Tutorial completion rate: >{{percentage}}%
2096
2059
  - Average session length: {{duration}} minutes
2097
2060
  - Player retention: D1 {{d1}}%, D7 {{d7}}%, D30 {{d30}}%
2098
-
2061
+
2099
2062
  **Quality Benchmarks:**
2100
-
2063
+
2101
2064
  - Player satisfaction: >{{rating}}/10
2102
2065
  - Completion rate: >{{percentage}}%
2103
2066
  - Technical performance: {{fps_target}} FPS consistent
@@ -2105,13 +2068,13 @@ sections:
2105
2068
  title: Development Metrics
2106
2069
  template: |
2107
2070
  **Technical Targets:**
2108
-
2071
+
2109
2072
  - Zero critical bugs at launch
2110
2073
  - Performance targets met on all platforms
2111
2074
  - Load times under {{seconds}}s
2112
-
2075
+
2113
2076
  **Process Goals:**
2114
-
2077
+
2115
2078
  - Development timeline adherence
2116
2079
  - Feature scope completion
2117
2080
  - Quality assurance standards
@@ -2120,7 +2083,7 @@ sections:
2120
2083
  condition: has_business_goals
2121
2084
  template: |
2122
2085
  **Commercial Goals:**
2123
-
2086
+
2124
2087
  - {{revenue_target}} in first {{time_period}}
2125
2088
  - {{user_acquisition_target}} players in first {{time_period}}
2126
2089
  - {{retention_target}} monthly active users
@@ -2173,12 +2136,12 @@ sections:
2173
2136
  title: Validation Plan
2174
2137
  template: |
2175
2138
  **Concept Testing:**
2176
-
2139
+
2177
2140
  - {{validation_method_1}} - {{timeline}}
2178
2141
  - {{validation_method_2}} - {{timeline}}
2179
-
2142
+
2180
2143
  **Prototype Testing:**
2181
-
2144
+
2182
2145
  - {{testing_approach}} - {{timeline}}
2183
2146
  - {{feedback_collection_method}} - {{timeline}}
2184
2147