@zeyue0329/xiaoma-cli 1.0.8 → 1.0.10

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 (326) hide show
  1. package/.github/FORK_GUIDE.md +106 -0
  2. package/.github/FUNDING.yaml +15 -0
  3. package/.github/ISSUE_TEMPLATE/bug_report.md +32 -0
  4. package/.github/ISSUE_TEMPLATE/feature_request.md +22 -0
  5. package/.github/workflows/discord.yaml +26 -0
  6. package/.github/workflows/format-check.yaml +44 -0
  7. package/.github/workflows/manual-release.yaml +174 -0
  8. package/.github/workflows/pr-validation.yaml +55 -0
  9. package/.husky/pre-commit +3 -0
  10. package/.vscode/settings.json +26 -1
  11. package/CHANGELOG.md +686 -0
  12. package/CONTRIBUTING.md +250 -0
  13. package/LICENSE +6 -1
  14. package/common/tasks/create-doc.md +2 -0
  15. package/common/tasks/execute-checklist.md +2 -7
  16. package/common/utils/bmad-doc-template.md +7 -5
  17. package/common/utils/workflow-management.md +2 -0
  18. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +2103 -0
  19. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +1627 -0
  20. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +822 -0
  21. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +8486 -0
  22. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +3210 -0
  23. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +3244 -0
  24. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +317 -0
  25. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +982 -0
  26. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +12854 -0
  27. package/dist/expansion-packs/bmad-creative-writing/agents/beta-reader.txt +921 -0
  28. package/dist/expansion-packs/bmad-creative-writing/agents/book-critic.txt +81 -0
  29. package/dist/expansion-packs/bmad-creative-writing/agents/character-psychologist.txt +886 -0
  30. package/dist/expansion-packs/bmad-creative-writing/agents/cover-designer.txt +85 -0
  31. package/dist/expansion-packs/bmad-creative-writing/agents/dialog-specialist.txt +903 -0
  32. package/dist/expansion-packs/bmad-creative-writing/agents/editor.txt +837 -0
  33. package/dist/expansion-packs/bmad-creative-writing/agents/genre-specialist.txt +989 -0
  34. package/dist/expansion-packs/bmad-creative-writing/agents/narrative-designer.txt +888 -0
  35. package/dist/expansion-packs/bmad-creative-writing/agents/plot-architect.txt +1173 -0
  36. package/dist/expansion-packs/bmad-creative-writing/agents/world-builder.txt +914 -0
  37. package/dist/expansion-packs/bmad-creative-writing/teams/agent-team.txt +6071 -0
  38. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +2079 -0
  39. package/docs/GUIDING-PRINCIPLES.md +91 -0
  40. package/docs/core-architecture.md +219 -0
  41. package/docs/enhanced-ide-development-workflow.md +248 -0
  42. package/docs/expansion-packs.md +200 -0
  43. package/docs/how-to-contribute-with-pull-requests.md +158 -0
  44. package/docs/user-guide.md +530 -0
  45. package/docs/versioning-and-releases.md +155 -0
  46. package/docs/versions.md +48 -0
  47. package/docs/working-in-the-brownfield.md +597 -0
  48. package/eslint.config.mjs +119 -0
  49. package/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml +14 -0
  50. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md +73 -0
  51. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +80 -0
  52. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +66 -0
  53. package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-design-checklist.md +203 -0
  54. package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md +162 -0
  55. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +9 -0
  56. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +252 -0
  57. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +649 -0
  58. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +112 -0
  59. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md +218 -0
  60. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +292 -0
  61. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +614 -0
  62. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +357 -0
  63. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +344 -0
  64. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +254 -0
  65. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +485 -0
  66. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +184 -0
  67. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +176 -0
  68. package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +15 -0
  69. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md +82 -0
  70. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +79 -0
  71. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +80 -0
  72. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md +67 -0
  73. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +393 -0
  74. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md +205 -0
  75. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +203 -0
  76. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +126 -0
  77. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +7 -0
  78. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +771 -0
  79. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +588 -0
  80. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +112 -0
  81. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +143 -0
  82. package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +186 -0
  83. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +292 -0
  84. package/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md +202 -0
  85. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +1031 -0
  86. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +357 -0
  87. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +706 -0
  88. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +257 -0
  89. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +485 -0
  90. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +184 -0
  91. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +176 -0
  92. package/expansion-packs/bmad-creative-writing/README.md +146 -0
  93. package/expansion-packs/bmad-creative-writing/agent-teams/agent-team.yaml +20 -0
  94. package/expansion-packs/bmad-creative-writing/agents/beta-reader.md +94 -0
  95. package/expansion-packs/bmad-creative-writing/agents/book-critic.md +40 -0
  96. package/expansion-packs/bmad-creative-writing/agents/character-psychologist.md +93 -0
  97. package/expansion-packs/bmad-creative-writing/agents/cover-designer.md +46 -0
  98. package/expansion-packs/bmad-creative-writing/agents/dialog-specialist.md +92 -0
  99. package/expansion-packs/bmad-creative-writing/agents/editor.md +93 -0
  100. package/expansion-packs/bmad-creative-writing/agents/genre-specialist.md +95 -0
  101. package/expansion-packs/bmad-creative-writing/agents/narrative-designer.md +93 -0
  102. package/expansion-packs/bmad-creative-writing/agents/plot-architect.md +95 -0
  103. package/expansion-packs/bmad-creative-writing/agents/world-builder.md +94 -0
  104. package/expansion-packs/bmad-creative-writing/checklists/beta-feedback-closure-checklist.md +23 -0
  105. package/expansion-packs/bmad-creative-writing/checklists/character-consistency-checklist.md +23 -0
  106. package/expansion-packs/bmad-creative-writing/checklists/comedic-timing-checklist.md +23 -0
  107. package/expansion-packs/bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md +23 -0
  108. package/expansion-packs/bmad-creative-writing/checklists/ebook-formatting-checklist.md +21 -0
  109. package/expansion-packs/bmad-creative-writing/checklists/epic-poetry-meter-checklist.md +23 -0
  110. package/expansion-packs/bmad-creative-writing/checklists/fantasy-magic-system-checklist.md +23 -0
  111. package/expansion-packs/bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md +22 -0
  112. package/expansion-packs/bmad-creative-writing/checklists/genre-tropes-checklist.md +22 -0
  113. package/expansion-packs/bmad-creative-writing/checklists/historical-accuracy-checklist.md +23 -0
  114. package/expansion-packs/bmad-creative-writing/checklists/horror-suspense-checklist.md +23 -0
  115. package/expansion-packs/bmad-creative-writing/checklists/kdp-cover-ready-checklist.md +25 -0
  116. package/expansion-packs/bmad-creative-writing/checklists/line-edit-quality-checklist.md +23 -0
  117. package/expansion-packs/bmad-creative-writing/checklists/marketing-copy-checklist.md +23 -0
  118. package/expansion-packs/bmad-creative-writing/checklists/mystery-clue-trail-checklist.md +23 -0
  119. package/expansion-packs/bmad-creative-writing/checklists/orbital-mechanics-checklist.md +23 -0
  120. package/expansion-packs/bmad-creative-writing/checklists/plot-structure-checklist.md +59 -0
  121. package/expansion-packs/bmad-creative-writing/checklists/publication-readiness-checklist.md +23 -0
  122. package/expansion-packs/bmad-creative-writing/checklists/romance-emotional-beats-checklist.md +23 -0
  123. package/expansion-packs/bmad-creative-writing/checklists/scene-quality-checklist.md +23 -0
  124. package/expansion-packs/bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md +22 -0
  125. package/expansion-packs/bmad-creative-writing/checklists/sensitivity-representation-checklist.md +23 -0
  126. package/expansion-packs/bmad-creative-writing/checklists/steampunk-gadget-checklist.md +23 -0
  127. package/expansion-packs/bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md +23 -0
  128. package/expansion-packs/bmad-creative-writing/checklists/timeline-continuity-checklist.md +23 -0
  129. package/expansion-packs/bmad-creative-writing/checklists/world-building-continuity-checklist.md +23 -0
  130. package/expansion-packs/bmad-creative-writing/checklists/ya-appropriateness-checklist.md +23 -0
  131. package/expansion-packs/bmad-creative-writing/config.yaml +12 -0
  132. package/expansion-packs/bmad-creative-writing/data/bmad-kb.md +209 -0
  133. package/expansion-packs/bmad-creative-writing/data/story-structures.md +67 -0
  134. package/expansion-packs/bmad-creative-writing/docs/brief.md +212 -0
  135. package/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md +119 -0
  136. package/expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md +23 -0
  137. package/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md +67 -0
  138. package/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md +29 -0
  139. package/expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md +23 -0
  140. package/expansion-packs/bmad-creative-writing/tasks/build-world.md +24 -0
  141. package/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md +22 -0
  142. package/expansion-packs/bmad-creative-writing/tasks/create-doc.md +103 -0
  143. package/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md +26 -0
  144. package/expansion-packs/bmad-creative-writing/tasks/critical-review.md +26 -0
  145. package/expansion-packs/bmad-creative-writing/tasks/develop-character.md +24 -0
  146. package/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md +88 -0
  147. package/expansion-packs/bmad-creative-writing/tasks/expand-premise.md +23 -0
  148. package/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md +23 -0
  149. package/expansion-packs/bmad-creative-writing/tasks/final-polish.md +23 -0
  150. package/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md +25 -0
  151. package/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md +26 -0
  152. package/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md +23 -0
  153. package/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md +25 -0
  154. package/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md +23 -0
  155. package/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md +24 -0
  156. package/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md +23 -0
  157. package/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md +22 -0
  158. package/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md +23 -0
  159. package/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md +64 -0
  160. package/expansion-packs/bmad-creative-writing/templates/beta-feedback-form.yaml +97 -0
  161. package/expansion-packs/bmad-creative-writing/templates/chapter-draft-tmpl.yaml +82 -0
  162. package/expansion-packs/bmad-creative-writing/templates/character-profile-tmpl.yaml +92 -0
  163. package/expansion-packs/bmad-creative-writing/templates/cover-design-brief-tmpl.yaml +98 -0
  164. package/expansion-packs/bmad-creative-writing/templates/premise-brief-tmpl.yaml +78 -0
  165. package/expansion-packs/bmad-creative-writing/templates/scene-list-tmpl.yaml +55 -0
  166. package/expansion-packs/bmad-creative-writing/templates/story-outline-tmpl.yaml +96 -0
  167. package/expansion-packs/bmad-creative-writing/templates/world-guide-tmpl.yaml +89 -0
  168. package/expansion-packs/bmad-creative-writing/workflows/book-cover-design-workflow.md +218 -0
  169. package/expansion-packs/bmad-creative-writing/workflows/novel-greenfield-workflow.yaml +56 -0
  170. package/expansion-packs/bmad-creative-writing/workflows/novel-serial-workflow.yaml +50 -0
  171. package/expansion-packs/bmad-creative-writing/workflows/novel-snowflake-workflow.yaml +69 -0
  172. package/expansion-packs/bmad-creative-writing/workflows/novel-writing.yaml +91 -0
  173. package/expansion-packs/bmad-creative-writing/workflows/screenplay-development.yaml +85 -0
  174. package/expansion-packs/bmad-creative-writing/workflows/series-planning.yaml +78 -0
  175. package/expansion-packs/bmad-creative-writing/workflows/short-story-creation.yaml +64 -0
  176. package/expansion-packs/bmad-infrastructure-devops/README.md +147 -0
  177. package/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md +73 -0
  178. package/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md +486 -0
  179. package/expansion-packs/bmad-infrastructure-devops/config.yaml +10 -0
  180. package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +307 -0
  181. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +161 -0
  182. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +155 -0
  183. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +425 -0
  184. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +630 -0
  185. package/implement-fork-friendly-ci.sh +229 -0
  186. package/package.json +75 -45
  187. package/prettier.config.mjs +32 -0
  188. package/test.md +1 -0
  189. package/tools/builders/web-builder.js +143 -149
  190. package/tools/bump-all-versions.js +42 -33
  191. package/tools/bump-expansion-version.js +23 -16
  192. package/tools/cli.js +15 -15
  193. package/tools/flattener/aggregate.js +76 -0
  194. package/tools/flattener/binary.js +80 -0
  195. package/tools/flattener/discovery.js +71 -0
  196. package/tools/flattener/files.js +35 -0
  197. package/tools/flattener/ignoreRules.js +176 -0
  198. package/tools/flattener/main.js +458 -460
  199. package/tools/flattener/projectRoot.js +206 -0
  200. package/tools/flattener/prompts.js +44 -0
  201. package/tools/flattener/stats.helpers.js +395 -0
  202. package/tools/flattener/stats.js +80 -0
  203. package/tools/flattener/test-matrix.js +413 -0
  204. package/tools/flattener/xml.js +88 -0
  205. package/tools/installer/README.md +1 -1
  206. package/tools/installer/bin/xiaoma.js +390 -150
  207. package/tools/installer/config/ide-agent-config.yaml +1 -1
  208. package/tools/installer/config/install.config.yaml +60 -9
  209. package/tools/installer/lib/config-loader.js +55 -51
  210. package/tools/installer/lib/file-manager.js +92 -117
  211. package/tools/installer/lib/ide-base-setup.js +57 -56
  212. package/tools/installer/lib/ide-setup.js +821 -414
  213. package/tools/installer/lib/installer.js +924 -699
  214. package/tools/installer/lib/memory-profiler.js +54 -53
  215. package/tools/installer/lib/module-manager.js +19 -15
  216. package/tools/installer/lib/resource-locator.js +31 -33
  217. package/tools/installer/package.json +24 -23
  218. package/tools/lib/dependency-resolver.js +39 -43
  219. package/tools/lib/yaml-utils.js +7 -7
  220. package/tools/md-assets/web-agent-startup-instructions.md +6 -6
  221. package/tools/preview-release-notes.js +66 -0
  222. package/tools/setup-hooks.sh +37 -0
  223. package/tools/shared/bannerArt.js +105 -0
  224. package/tools/sync-installer-version.js +7 -9
  225. package/tools/sync-version.sh +23 -0
  226. package/tools/update-expansion-version.js +14 -15
  227. package/tools/upgraders/v3-to-v4-upgrader.js +203 -294
  228. package/tools/version-bump.js +41 -26
  229. package/tools/xiaoma-npx-wrapper.js +14 -14
  230. package/tools/yaml-format.js +56 -43
  231. package/xiaoma-core/agent-teams/team-all.yaml +3 -2
  232. package/xiaoma-core/agent-teams/team-fullstack.yaml +2 -1
  233. package/xiaoma-core/agent-teams/team-ide-minimal.yaml +1 -0
  234. package/xiaoma-core/agent-teams/team-no-ui.yaml +2 -1
  235. package/xiaoma-core/agents/analyst.md +20 -17
  236. package/xiaoma-core/agents/architect.md +15 -14
  237. package/xiaoma-core/agents/{xiaoma-master.md → bmad-master.md} +29 -27
  238. package/xiaoma-core/agents/{xiaoma-orchestrator.md → bmad-orchestrator.md} +36 -39
  239. package/xiaoma-core/agents/dev.md +23 -18
  240. package/xiaoma-core/agents/pm.md +18 -15
  241. package/xiaoma-core/agents/po.md +13 -10
  242. package/xiaoma-core/agents/qa.md +46 -24
  243. package/xiaoma-core/agents/sm.md +11 -8
  244. package/xiaoma-core/agents/ux-expert.md +10 -7
  245. package/xiaoma-core/checklists/architect-checklist.md +2 -5
  246. package/xiaoma-core/checklists/change-checklist.md +4 -2
  247. package/xiaoma-core/checklists/pm-checklist.md +2 -5
  248. package/xiaoma-core/checklists/po-master-checklist.md +2 -9
  249. package/xiaoma-core/checklists/story-dod-checklist.md +2 -7
  250. package/xiaoma-core/checklists/story-draft-checklist.md +2 -3
  251. package/xiaoma-core/core-config.yaml +4 -1
  252. package/xiaoma-core/data/{xiaoma-kb.md → bmad-kb.md} +48 -42
  253. package/xiaoma-core/data/brainstorming-techniques.md +2 -0
  254. package/xiaoma-core/data/elicitation-methods.md +22 -0
  255. package/xiaoma-core/data/technical-preferences.md +2 -0
  256. package/xiaoma-core/data/test-levels-framework.md +148 -0
  257. package/xiaoma-core/data/test-priorities-matrix.md +174 -0
  258. package/xiaoma-core/tasks/advanced-elicitation.md +2 -0
  259. package/xiaoma-core/tasks/apply-qa-fixes.md +150 -0
  260. package/xiaoma-core/tasks/brownfield-create-epic.md +2 -0
  261. package/xiaoma-core/tasks/brownfield-create-story.md +2 -0
  262. package/xiaoma-core/tasks/correct-course.md +2 -0
  263. package/xiaoma-core/tasks/create-brownfield-story.md +14 -4
  264. package/xiaoma-core/tasks/create-deep-research-prompt.md +2 -11
  265. package/xiaoma-core/tasks/create-next-story.md +3 -1
  266. package/xiaoma-core/tasks/document-project.md +17 -13
  267. package/xiaoma-core/tasks/facilitate-brainstorming-session.md +5 -3
  268. package/xiaoma-core/tasks/generate-ai-frontend-prompt.md +2 -0
  269. package/xiaoma-core/tasks/index-docs.md +2 -6
  270. package/xiaoma-core/tasks/kb-mode-interaction.md +17 -15
  271. package/xiaoma-core/tasks/nfr-assess.md +345 -0
  272. package/xiaoma-core/tasks/qa-gate.md +163 -0
  273. package/xiaoma-core/tasks/review-story.md +245 -74
  274. package/xiaoma-core/tasks/risk-profile.md +355 -0
  275. package/xiaoma-core/tasks/shard-doc.md +2 -2
  276. package/xiaoma-core/tasks/test-design.md +176 -0
  277. package/xiaoma-core/tasks/trace-requirements.md +266 -0
  278. package/xiaoma-core/tasks/validate-next-story.md +5 -3
  279. package/xiaoma-core/templates/architecture-tmpl.yaml +50 -49
  280. package/xiaoma-core/templates/brainstorming-output-tmpl.yaml +5 -5
  281. package/xiaoma-core/templates/brownfield-architecture-tmpl.yaml +32 -31
  282. package/xiaoma-core/templates/brownfield-prd-tmpl.yaml +14 -13
  283. package/xiaoma-core/templates/competitor-analysis-tmpl.yaml +20 -6
  284. package/xiaoma-core/templates/front-end-architecture-tmpl.yaml +22 -9
  285. package/xiaoma-core/templates/front-end-spec-tmpl.yaml +25 -24
  286. package/xiaoma-core/templates/fullstack-architecture-tmpl.yaml +123 -104
  287. package/xiaoma-core/templates/market-research-tmpl.yaml +3 -2
  288. package/xiaoma-core/templates/prd-tmpl.yaml +10 -9
  289. package/xiaoma-core/templates/project-brief-tmpl.yaml +5 -4
  290. package/xiaoma-core/templates/qa-gate-tmpl.yaml +103 -0
  291. package/xiaoma-core/templates/story-tmpl.yaml +13 -12
  292. package/xiaoma-core/workflows/brownfield-fullstack.yaml +13 -12
  293. package/xiaoma-core/workflows/brownfield-service.yaml +5 -4
  294. package/xiaoma-core/workflows/brownfield-ui.yaml +5 -4
  295. package/xiaoma-core/workflows/greenfield-fullstack.yaml +7 -6
  296. package/xiaoma-core/workflows/greenfield-service.yaml +5 -4
  297. package/xiaoma-core/workflows/greenfield-ui.yaml +6 -5
  298. package/.releaserc.json +0 -18
  299. package/README.md +0 -532
  300. package/XiaoMa-Web/345/244/232/346/231/272/350/203/275/344/275/2230-1/351/241/271/347/233/256/345/274/200/345/217/221/345/256/214/346/225/264/346/214/207/345/215/227.md +0 -977
  301. package/XiaoMa-Web/347/216/260/346/234/211/351/241/271/347/233/256/351/234/200/346/261/202/345/274/200/345/217/221/345/256/214/346/225/264/346/214/207/345/215/227.md +0 -873
  302. package/XiaoMa-Web/347/272/257/345/211/215/347/253/257/351/241/271/347/233/256Claude-Code/345/274/200/345/217/221/345/256/214/346/225/264/346/214/207/345/215/227.md +0 -372
  303. package/XiaoMa-Web/351/241/271/347/233/256/346/200/273/347/273/223/346/212/245/345/221/212.md +0 -310
  304. package/dist/agents/analyst.txt +0 -2882
  305. package/dist/agents/architect.txt +0 -3543
  306. package/dist/agents/dev-cn.txt +0 -428
  307. package/dist/agents/dev.txt +0 -428
  308. package/dist/agents/pm.txt +0 -2229
  309. package/dist/agents/po.txt +0 -1364
  310. package/dist/agents/qa.txt +0 -386
  311. package/dist/agents/sm.txt +0 -668
  312. package/dist/agents/ux-expert.txt +0 -701
  313. package/dist/agents/xiaoma-master.txt +0 -8756
  314. package/dist/agents/xiaoma-orchestrator.txt +0 -1490
  315. package/dist/teams/team-all.txt +0 -11062
  316. package/dist/teams/team-fullstack.txt +0 -10392
  317. package/dist/teams/team-ide-minimal.txt +0 -3507
  318. package/dist/teams/team-no-ui.txt +0 -8951
  319. package/docs/quick-start.md +0 -179
  320. package/tools/bmad-npx-wrapper.js +0 -39
  321. package/tools/installer/package-lock.json +0 -704
  322. package/tools/semantic-release-sync-installer.js +0 -30
  323. package/xiaoma-core/bmad-core/user-guide.md +0 -0
  324. package/xiaoma-core/enhanced-ide-development-workflow.md +0 -43
  325. package/xiaoma-core/user-guide.md +0 -251
  326. package/xiaoma-core/working-in-the-brownfield.md +0 -364
@@ -0,0 +1,143 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # Correct Course Task - Game Development
4
+
5
+ ## Purpose
6
+
7
+ - Guide a structured response to game development change triggers using the `{root}/checklists/game-change-checklist`.
8
+ - Analyze the impacts of changes on game features, technical systems, and milestone deliverables.
9
+ - Explore game-specific solutions (e.g., performance optimizations, feature scaling, platform adjustments).
10
+ - Draft specific, actionable proposed updates to affected game artifacts (e.g., GDD sections, technical specs, Unity configurations).
11
+ - Produce a consolidated "Game Development Change Proposal" document for review and approval.
12
+ - Ensure clear handoff path for changes requiring fundamental redesign or technical architecture updates.
13
+
14
+ ## Instructions
15
+
16
+ ### 1. Initial Setup & Mode Selection
17
+
18
+ - **Acknowledge Task & Inputs:**
19
+ - Confirm with the user that the "Game Development Correct Course Task" is being initiated.
20
+ - Verify the change trigger (e.g., performance issue, platform constraint, gameplay feedback, technical blocker).
21
+ - Confirm access to relevant game artifacts:
22
+ - Game Design Document (GDD)
23
+ - Technical Design Documents
24
+ - Unity Architecture specifications
25
+ - Performance budgets and platform requirements
26
+ - Current sprint's game stories and epics
27
+ - Asset specifications and pipelines
28
+ - Confirm access to `{root}/checklists/game-change-checklist`.
29
+
30
+ - **Establish Interaction Mode:**
31
+ - Ask the user their preferred interaction mode:
32
+ - **"Incrementally (Default & Recommended):** Work through the game-change-checklist section by section, discussing findings and drafting changes collaboratively. Best for complex technical or gameplay changes."
33
+ - **"YOLO Mode (Batch Processing):** Conduct batched analysis and present consolidated findings. Suitable for straightforward performance optimizations or minor adjustments."
34
+ - Confirm the selected mode and inform: "We will now use the game-change-checklist to analyze the change and draft proposed updates specific to our Unity game development context."
35
+
36
+ ### 2. Execute Game Development Checklist Analysis
37
+
38
+ - Systematically work through the game-change-checklist sections:
39
+ 1. **Change Context & Game Impact**
40
+ 2. **Feature/System Impact Analysis**
41
+ 3. **Technical Artifact Conflict Resolution**
42
+ 4. **Performance & Platform Evaluation**
43
+ 5. **Path Forward Recommendation**
44
+
45
+ - For each checklist section:
46
+ - Present game-specific prompts and considerations
47
+ - Analyze impacts on:
48
+ - Unity scenes and prefabs
49
+ - Component dependencies
50
+ - Performance metrics (FPS, memory, build size)
51
+ - Platform-specific code paths
52
+ - Asset loading and management
53
+ - Third-party plugins/SDKs
54
+ - Discuss findings with clear technical context
55
+ - Record status: `[x] Addressed`, `[N/A]`, `[!] Further Action Needed`
56
+ - Document Unity-specific decisions and constraints
57
+
58
+ ### 3. Draft Game-Specific Proposed Changes
59
+
60
+ Based on the analysis and agreed path forward:
61
+
62
+ - **Identify affected game artifacts requiring updates:**
63
+ - GDD sections (mechanics, systems, progression)
64
+ - Technical specifications (architecture, performance targets)
65
+ - Unity-specific configurations (build settings, quality settings)
66
+ - Game story modifications (scope, acceptance criteria)
67
+ - Asset pipeline adjustments
68
+ - Platform-specific adaptations
69
+
70
+ - **Draft explicit changes for each artifact:**
71
+ - **Game Stories:** Revise story text, Unity-specific acceptance criteria, technical constraints
72
+ - **Technical Specs:** Update architecture diagrams, component hierarchies, performance budgets
73
+ - **Unity Configurations:** Propose settings changes, optimization strategies, platform variants
74
+ - **GDD Updates:** Modify feature descriptions, balance parameters, progression systems
75
+ - **Asset Specifications:** Adjust texture sizes, model complexity, audio compression
76
+ - **Performance Targets:** Update FPS goals, memory limits, load time requirements
77
+
78
+ - **Include Unity-specific details:**
79
+ - Prefab structure changes
80
+ - Scene organization updates
81
+ - Component refactoring needs
82
+ - Shader/material optimizations
83
+ - Build pipeline modifications
84
+
85
+ ### 4. Generate "Game Development Change Proposal"
86
+
87
+ - Create a comprehensive proposal document containing:
88
+
89
+ **A. Change Summary:**
90
+ - Original issue (performance, gameplay, technical constraint)
91
+ - Game systems affected
92
+ - Platform/performance implications
93
+ - Chosen solution approach
94
+
95
+ **B. Technical Impact Analysis:**
96
+ - Unity architecture changes needed
97
+ - Performance implications (with metrics)
98
+ - Platform compatibility effects
99
+ - Asset pipeline modifications
100
+ - Third-party dependency impacts
101
+
102
+ **C. Specific Proposed Edits:**
103
+ - For each game story: "Change Story GS-X.Y from: [old] To: [new]"
104
+ - For technical specs: "Update Unity Architecture Section X: [changes]"
105
+ - For GDD: "Modify [Feature] in Section Y: [updates]"
106
+ - For configurations: "Change [Setting] from [old_value] to [new_value]"
107
+
108
+ **D. Implementation Considerations:**
109
+ - Required Unity version updates
110
+ - Asset reimport needs
111
+ - Shader recompilation requirements
112
+ - Platform-specific testing needs
113
+
114
+ ### 5. Finalize & Determine Next Steps
115
+
116
+ - Obtain explicit approval for the "Game Development Change Proposal"
117
+ - Provide the finalized document to the user
118
+
119
+ - **Based on change scope:**
120
+ - **Minor adjustments (can be handled in current sprint):**
121
+ - Confirm task completion
122
+ - Suggest handoff to game-dev agent for implementation
123
+ - Note any required playtesting validation
124
+ - **Major changes (require replanning):**
125
+ - Clearly state need for deeper technical review
126
+ - Recommend engaging Game Architect or Technical Lead
127
+ - Provide proposal as input for architecture revision
128
+ - Flag any milestone/deadline impacts
129
+
130
+ ## Output Deliverables
131
+
132
+ - **Primary:** "Game Development Change Proposal" document containing:
133
+ - Game-specific change analysis
134
+ - Technical impact assessment with Unity context
135
+ - Platform and performance considerations
136
+ - Clearly drafted updates for all affected game artifacts
137
+ - Implementation guidance and constraints
138
+
139
+ - **Secondary:** Annotated game-change-checklist showing:
140
+ - Technical decisions made
141
+ - Performance trade-offs considered
142
+ - Platform-specific accommodations
143
+ - Unity-specific implementation notes
@@ -0,0 +1,186 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # Create Game Story Task
4
+
5
+ ## Purpose
6
+
7
+ To identify the next logical game story based on project progress and epic definitions, and then to prepare a comprehensive, self-contained, and actionable story file using the `Game Story Template`. This task ensures the story is enriched with all necessary technical context, Unity-specific requirements, and acceptance criteria, making it ready for efficient implementation by a Game Developer Agent with minimal need for additional research or finding its own context.
8
+
9
+ ## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
10
+
11
+ ### 0. Load Core Configuration and Check Workflow
12
+
13
+ - Load `{root}/core-config.yaml` from the project root
14
+ - If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story creation. You can either: 1) Copy core-config.yaml from GITHUB bmad-core/ and configure it for your game project OR 2) Run the BMad installer against your project to upgrade and add the file automatically. Please add and configure before proceeding."
15
+ - Extract key configurations: `devStoryLocation`, `gdd.*`, `gamearchitecture.*`, `workflow.*`
16
+
17
+ ### 1. Identify Next Story for Preparation
18
+
19
+ #### 1.1 Locate Epic Files and Review Existing Stories
20
+
21
+ - Based on `gddSharded` from config, locate epic files (sharded location/pattern or monolithic GDD sections)
22
+ - If `devStoryLocation` has story files, load the highest `{epicNum}.{storyNum}.story.md` file
23
+ - **If highest story exists:**
24
+ - Verify status is 'Done'. If not, alert user: "ALERT: Found incomplete story! File: {lastEpicNum}.{lastStoryNum}.story.md Status: [current status] You should fix this story first, but would you like to accept risk & override to create the next story in draft?"
25
+ - If proceeding, select next sequential story in the current epic
26
+ - If epic is complete, prompt user: "Epic {epicNum} Complete: All stories in Epic {epicNum} have been completed. Would you like to: 1) Begin Epic {epicNum + 1} with story 1 2) Select a specific story to work on 3) Cancel story creation"
27
+ - **CRITICAL**: NEVER automatically skip to another epic. User MUST explicitly instruct which story to create.
28
+ - **If no story files exist:** The next story is ALWAYS 1.1 (first story of first epic)
29
+ - Announce the identified story to the user: "Identified next story for preparation: {epicNum}.{storyNum} - {Story Title}"
30
+
31
+ ### 2. Gather Story Requirements and Previous Story Context
32
+
33
+ - Extract story requirements from the identified epic file or GDD section
34
+ - If previous story exists, review Dev Agent Record sections for:
35
+ - Completion Notes and Debug Log References
36
+ - Implementation deviations and technical decisions
37
+ - Unity-specific challenges (prefab issues, scene management, performance)
38
+ - Asset pipeline decisions and optimizations
39
+ - Extract relevant insights that inform the current story's preparation
40
+
41
+ ### 3. Gather Architecture Context
42
+
43
+ #### 3.1 Determine Architecture Reading Strategy
44
+
45
+ - **If `gamearchitectureVersion: >= v3` and `gamearchitectureSharded: true`**: Read `{gamearchitectureShardedLocation}/index.md` then follow structured reading order below
46
+ - **Else**: Use monolithic `gamearchitectureFile` for similar sections
47
+
48
+ #### 3.2 Read Architecture Documents Based on Story Type
49
+
50
+ **For ALL Game Stories:** tech-stack.md, unity-project-structure.md, coding-standards.md, testing-resilience-architecture.md
51
+
52
+ **For Gameplay/Mechanics Stories, additionally:** gameplay-systems-architecture.md, component-architecture-details.md, physics-config.md, input-system.md, state-machines.md, game-data-models.md
53
+
54
+ **For UI/UX Stories, additionally:** ui-architecture.md, ui-components.md, ui-state-management.md, scene-management.md
55
+
56
+ **For Backend/Services Stories, additionally:** game-data-models.md, data-persistence.md, save-system.md, analytics-integration.md, multiplayer-architecture.md
57
+
58
+ **For Graphics/Rendering Stories, additionally:** rendering-pipeline.md, shader-guidelines.md, sprite-management.md, particle-systems.md
59
+
60
+ **For Audio Stories, additionally:** audio-architecture.md, audio-mixing.md, sound-banks.md
61
+
62
+ #### 3.3 Extract Story-Specific Technical Details
63
+
64
+ Extract ONLY information directly relevant to implementing the current story. Do NOT invent new patterns, systems, or standards not in the source documents.
65
+
66
+ Extract:
67
+
68
+ - Specific Unity components and MonoBehaviours the story will use
69
+ - Unity Package Manager dependencies and their APIs (e.g., Cinemachine, Input System, URP)
70
+ - Package-specific configurations and setup requirements
71
+ - Prefab structures and scene organization requirements
72
+ - Input system bindings and configurations
73
+ - Physics settings and collision layers
74
+ - UI canvas and layout specifications
75
+ - Asset naming conventions and folder structures
76
+ - Performance budgets (target FPS, memory limits, draw calls)
77
+ - Platform-specific considerations (mobile vs desktop)
78
+ - Testing requirements specific to Unity features
79
+
80
+ ALWAYS cite source documents: `[Source: gamearchitecture/{filename}.md#{section}]`
81
+
82
+ ### 4. Unity-Specific Technical Analysis
83
+
84
+ #### 4.1 Package Dependencies Analysis
85
+
86
+ - Identify Unity Package Manager packages required for the story
87
+ - Document package versions from manifest.json
88
+ - Note any package-specific APIs or components being used
89
+ - List package configuration requirements (e.g., Input System settings, URP asset config)
90
+ - Identify any third-party Asset Store packages and their integration points
91
+
92
+ #### 4.2 Scene and Prefab Planning
93
+
94
+ - Identify which scenes will be modified or created
95
+ - List prefabs that need to be created or updated
96
+ - Document prefab variant requirements
97
+ - Specify scene loading/unloading requirements
98
+
99
+ #### 4.3 Component Architecture
100
+
101
+ - Define MonoBehaviour scripts needed
102
+ - Specify ScriptableObject assets required
103
+ - Document component dependencies and execution order
104
+ - Identify required Unity Events and UnityActions
105
+ - Note any package-specific components (e.g., Cinemachine VirtualCamera, InputActionAsset)
106
+
107
+ #### 4.4 Asset Requirements
108
+
109
+ - List sprite/texture requirements with resolution specs
110
+ - Define animation clips and animator controllers needed
111
+ - Specify audio clips and their import settings
112
+ - Document any shader or material requirements
113
+ - Note any package-specific assets (e.g., URP materials, Input Action maps)
114
+
115
+ ### 5. Populate Story Template with Full Context
116
+
117
+ - Create new story file: `{devStoryLocation}/{epicNum}.{storyNum}.story.md` using Game Story Template
118
+ - Fill in basic story information: Title, Status (Draft), Story statement, Acceptance Criteria from Epic/GDD
119
+ - **`Dev Notes` section (CRITICAL):**
120
+ - CRITICAL: This section MUST contain ONLY information extracted from gamearchitecture documents and GDD. NEVER invent or assume technical details.
121
+ - Include ALL relevant technical details from Steps 2-4, organized by category:
122
+ - **Previous Story Insights**: Key learnings from previous story implementation
123
+ - **Package Dependencies**: Unity packages required, versions, configurations [with source references]
124
+ - **Unity Components**: Specific MonoBehaviours, ScriptableObjects, systems [with source references]
125
+ - **Scene & Prefab Specs**: Scene modifications, prefab structures, variants [with source references]
126
+ - **Input Configuration**: Input actions, bindings, control schemes [with source references]
127
+ - **UI Implementation**: Canvas setup, layout groups, UI events [with source references]
128
+ - **Asset Pipeline**: Asset requirements, import settings, optimization notes
129
+ - **Performance Targets**: FPS targets, memory budgets, profiler metrics
130
+ - **Platform Considerations**: Mobile vs desktop differences, input variations
131
+ - **Testing Requirements**: PlayMode tests, Unity Test Framework specifics
132
+ - Every technical detail MUST include its source reference: `[Source: gamearchitecture/{filename}.md#{section}]`
133
+ - If information for a category is not found in the gamearchitecture docs, explicitly state: "No specific guidance found in gamearchitecture docs"
134
+ - **`Tasks / Subtasks` section:**
135
+ - Generate detailed, sequential list of technical tasks based ONLY on: Epic/GDD Requirements, Story AC, Reviewed GameArchitecture Information
136
+ - Include Unity-specific tasks:
137
+ - Scene setup and configuration
138
+ - Prefab creation and testing
139
+ - Component implementation with proper lifecycle methods
140
+ - Input system integration
141
+ - Physics configuration
142
+ - UI implementation with proper anchoring
143
+ - Performance profiling checkpoints
144
+ - Each task must reference relevant gamearchitecture documentation
145
+ - Include PlayMode testing as explicit subtasks
146
+ - Link tasks to ACs where applicable (e.g., `Task 1 (AC: 1, 3)`)
147
+ - Add notes on Unity project structure alignment or discrepancies found in Step 4
148
+
149
+ ### 6. Story Draft Completion and Review
150
+
151
+ - Review all sections for completeness and accuracy
152
+ - Verify all source references are included for technical details
153
+ - Ensure Unity-specific requirements are comprehensive:
154
+ - All scenes and prefabs documented
155
+ - Component dependencies clear
156
+ - Asset requirements specified
157
+ - Performance targets defined
158
+ - Update status to "Draft" and save the story file
159
+ - Execute `{root}/tasks/execute-checklist` `{root}/checklists/game-story-dod-checklist`
160
+ - Provide summary to user including:
161
+ - Story created: `{devStoryLocation}/{epicNum}.{storyNum}.story.md`
162
+ - Status: Draft
163
+ - Key Unity components and systems included
164
+ - Scene/prefab modifications required
165
+ - Asset requirements identified
166
+ - Any deviations or conflicts noted between GDD and gamearchitecture
167
+ - Checklist Results
168
+ - Next steps: For complex Unity features, suggest the user review the story draft and optionally test critical assumptions in Unity Editor
169
+
170
+ ### 7. Unity-Specific Validation
171
+
172
+ Before finalizing, ensure:
173
+
174
+ - [ ] All required Unity packages are documented with versions
175
+ - [ ] Package-specific APIs and configurations are included
176
+ - [ ] All MonoBehaviour lifecycle methods are considered
177
+ - [ ] Prefab workflows are clearly defined
178
+ - [ ] Scene management approach is specified
179
+ - [ ] Input system integration is complete (legacy or new Input System)
180
+ - [ ] UI canvas setup follows Unity best practices
181
+ - [ ] Performance profiling points are identified
182
+ - [ ] Asset import settings are documented
183
+ - [ ] Platform-specific code paths are noted
184
+ - [ ] Package compatibility is verified (e.g., URP vs Built-in pipeline)
185
+
186
+ This task ensures game development stories are immediately actionable and enable efficient AI-driven development of Unity 2D game features.
@@ -0,0 +1,292 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # Game Design Brainstorming Techniques Task
4
+
5
+ This task provides a comprehensive toolkit of creative brainstorming techniques specifically designed for game design ideation and innovative thinking. The game designer can use these techniques to facilitate productive brainstorming sessions focused on game mechanics, player experience, and creative concepts.
6
+
7
+ ## Process
8
+
9
+ ### 1. Session Setup
10
+
11
+ [[LLM: Begin by understanding the game design context and goals. Ask clarifying questions if needed to determine the best approach for game-specific ideation.]]
12
+
13
+ 1. **Establish Game Context**
14
+ - Understand the game genre or opportunity area
15
+ - Identify target audience and platform constraints
16
+ - Determine session goals (concept exploration vs. mechanic refinement)
17
+ - Clarify scope (full game vs. specific feature)
18
+
19
+ 2. **Select Technique Approach**
20
+ - Option A: User selects specific game design techniques
21
+ - Option B: Game Designer recommends techniques based on context
22
+ - Option C: Random technique selection for creative variety
23
+ - Option D: Progressive technique flow (broad concepts to specific mechanics)
24
+
25
+ ### 2. Game Design Brainstorming Techniques
26
+
27
+ #### Game Concept Expansion Techniques
28
+
29
+ 1. **"What If" Game Scenarios**
30
+ [[LLM: Generate provocative what-if questions that challenge game design assumptions and expand thinking beyond current genre limitations.]]
31
+ - What if players could rewind time in any genre?
32
+ - What if the game world reacted to the player's real-world location?
33
+ - What if failure was more rewarding than success?
34
+ - What if players controlled the antagonist instead?
35
+ - What if the game played itself when no one was watching?
36
+
37
+ 2. **Cross-Genre Fusion**
38
+ [[LLM: Help user combine unexpected game genres and mechanics to create unique experiences.]]
39
+ - "How might [genre A] mechanics work in [genre B]?"
40
+ - Puzzle mechanics in action games
41
+ - Dating sim elements in strategy games
42
+ - Horror elements in racing games
43
+ - Educational content in roguelike structure
44
+
45
+ 3. **Player Motivation Reversal**
46
+ [[LLM: Flip traditional player motivations to reveal new gameplay possibilities.]]
47
+ - What if losing was the goal?
48
+ - What if cooperation was forced in competitive games?
49
+ - What if players had to help their enemies?
50
+ - What if progress meant giving up abilities?
51
+
52
+ 4. **Core Loop Deconstruction**
53
+ [[LLM: Break down successful games to fundamental mechanics and rebuild differently.]]
54
+ - What are the essential 3 actions in this game type?
55
+ - How could we make each action more interesting?
56
+ - What if we changed the order of these actions?
57
+ - What if players could skip or automate certain actions?
58
+
59
+ #### Mechanic Innovation Frameworks
60
+
61
+ 1. **SCAMPER for Game Mechanics**
62
+ [[LLM: Guide through each SCAMPER prompt specifically for game design.]]
63
+ - **S** = Substitute: What mechanics can be substituted? (walking → flying → swimming)
64
+ - **C** = Combine: What systems can be merged? (inventory + character growth)
65
+ - **A** = Adapt: What mechanics from other media? (books, movies, sports)
66
+ - **M** = Modify/Magnify: What can be exaggerated? (super speed, massive scale)
67
+ - **P** = Put to other uses: What else could this mechanic do? (jumping → attacking)
68
+ - **E** = Eliminate: What can be removed? (UI, tutorials, fail states)
69
+ - **R** = Reverse/Rearrange: What sequence changes? (end-to-start, simultaneous)
70
+
71
+ 2. **Player Agency Spectrum**
72
+ [[LLM: Explore different levels of player control and agency across game systems.]]
73
+ - Full Control: Direct character movement, combat, building
74
+ - Indirect Control: Setting rules, giving commands, environmental changes
75
+ - Influence Only: Suggestions, preferences, emotional reactions
76
+ - No Control: Observation, interpretation, passive experience
77
+
78
+ 3. **Temporal Game Design**
79
+ [[LLM: Explore how time affects gameplay and player experience.]]
80
+ - Real-time vs. turn-based mechanics
81
+ - Time travel and manipulation
82
+ - Persistent vs. session-based progress
83
+ - Asynchronous multiplayer timing
84
+ - Seasonal and event-based content
85
+
86
+ #### Player Experience Ideation
87
+
88
+ 1. **Emotion-First Design**
89
+ [[LLM: Start with target emotions and work backward to mechanics that create them.]]
90
+ - Target Emotion: Wonder → Mechanics: Discovery, mystery, scale
91
+ - Target Emotion: Triumph → Mechanics: Challenge, skill growth, recognition
92
+ - Target Emotion: Connection → Mechanics: Cooperation, shared goals, communication
93
+ - Target Emotion: Flow → Mechanics: Clear feedback, progressive difficulty
94
+
95
+ 2. **Player Archetype Brainstorming**
96
+ [[LLM: Design for different player types and motivations.]]
97
+ - Achievers: Progression, completion, mastery
98
+ - Explorers: Discovery, secrets, world-building
99
+ - Socializers: Interaction, cooperation, community
100
+ - Killers: Competition, dominance, conflict
101
+ - Creators: Building, customization, expression
102
+
103
+ 3. **Accessibility-First Innovation**
104
+ [[LLM: Generate ideas that make games more accessible while creating new gameplay.]]
105
+ - Visual impairment considerations leading to audio-focused mechanics
106
+ - Motor accessibility inspiring one-handed or simplified controls
107
+ - Cognitive accessibility driving clear feedback and pacing
108
+ - Economic accessibility creating free-to-play innovations
109
+
110
+ #### Narrative and World Building
111
+
112
+ 1. **Environmental Storytelling**
113
+ [[LLM: Brainstorm ways the game world itself tells stories without explicit narrative.]]
114
+ - How does the environment show history?
115
+ - What do interactive objects reveal about characters?
116
+ - How can level design communicate mood?
117
+ - What stories do systems and mechanics tell?
118
+
119
+ 2. **Player-Generated Narrative**
120
+ [[LLM: Explore ways players create their own stories through gameplay.]]
121
+ - Emergent storytelling through player choices
122
+ - Procedural narrative generation
123
+ - Player-to-player story sharing
124
+ - Community-driven world events
125
+
126
+ 3. **Genre Expectation Subversion**
127
+ [[LLM: Identify and deliberately subvert player expectations within genres.]]
128
+ - Fantasy RPG where magic is mundane
129
+ - Horror game where monsters are friendly
130
+ - Racing game where going slow is optimal
131
+ - Puzzle game where there are multiple correct answers
132
+
133
+ #### Technical Innovation Inspiration
134
+
135
+ 1. **Platform-Specific Design**
136
+ [[LLM: Generate ideas that leverage unique platform capabilities.]]
137
+ - Mobile: GPS, accelerometer, camera, always-connected
138
+ - Web: URLs, tabs, social sharing, real-time collaboration
139
+ - Console: Controllers, TV viewing, couch co-op
140
+ - VR/AR: Physical movement, spatial interaction, presence
141
+
142
+ 2. **Constraint-Based Creativity**
143
+ [[LLM: Use technical or design constraints as creative catalysts.]]
144
+ - One-button games
145
+ - Games without graphics
146
+ - Games that play in notification bars
147
+ - Games using only system sounds
148
+ - Games with intentionally bad graphics
149
+
150
+ ### 3. Game-Specific Technique Selection
151
+
152
+ [[LLM: Help user select appropriate techniques based on their specific game design needs.]]
153
+
154
+ **For Initial Game Concepts:**
155
+
156
+ - What If Game Scenarios
157
+ - Cross-Genre Fusion
158
+ - Emotion-First Design
159
+
160
+ **For Stuck/Blocked Creativity:**
161
+
162
+ - Player Motivation Reversal
163
+ - Constraint-Based Creativity
164
+ - Genre Expectation Subversion
165
+
166
+ **For Mechanic Development:**
167
+
168
+ - SCAMPER for Game Mechanics
169
+ - Core Loop Deconstruction
170
+ - Player Agency Spectrum
171
+
172
+ **For Player Experience:**
173
+
174
+ - Player Archetype Brainstorming
175
+ - Emotion-First Design
176
+ - Accessibility-First Innovation
177
+
178
+ **For World Building:**
179
+
180
+ - Environmental Storytelling
181
+ - Player-Generated Narrative
182
+ - Platform-Specific Design
183
+
184
+ ### 4. Game Design Session Flow
185
+
186
+ [[LLM: Guide the brainstorming session with appropriate pacing for game design exploration.]]
187
+
188
+ 1. **Inspiration Phase** (10-15 min)
189
+ - Reference existing games and mechanics
190
+ - Explore player experiences and emotions
191
+ - Gather visual and thematic inspiration
192
+
193
+ 2. **Divergent Exploration** (25-35 min)
194
+ - Generate many game concepts or mechanics
195
+ - Use expansion and fusion techniques
196
+ - Encourage wild and impossible ideas
197
+
198
+ 3. **Player-Centered Filtering** (15-20 min)
199
+ - Consider target audience reactions
200
+ - Evaluate emotional impact and engagement
201
+ - Group ideas by player experience goals
202
+
203
+ 4. **Feasibility and Synthesis** (15-20 min)
204
+ - Assess technical and design feasibility
205
+ - Combine complementary ideas
206
+ - Develop most promising concepts
207
+
208
+ ### 5. Game Design Output Format
209
+
210
+ [[LLM: Present brainstorming results in a format useful for game development.]]
211
+
212
+ **Session Summary:**
213
+
214
+ - Techniques used and focus areas
215
+ - Total concepts/mechanics generated
216
+ - Key themes and patterns identified
217
+
218
+ **Game Concept Categories:**
219
+
220
+ 1. **Core Game Ideas** - Complete game concepts ready for prototyping
221
+ 2. **Mechanic Innovations** - Specific gameplay mechanics to explore
222
+ 3. **Player Experience Goals** - Emotional and engagement targets
223
+ 4. **Technical Experiments** - Platform or technology-focused concepts
224
+ 5. **Long-term Vision** - Ambitious ideas for future development
225
+
226
+ **Development Readiness:**
227
+
228
+ **Prototype-Ready Ideas:**
229
+
230
+ - Ideas that can be tested immediately
231
+ - Minimum viable implementations
232
+ - Quick validation approaches
233
+
234
+ **Research-Required Ideas:**
235
+
236
+ - Concepts needing technical investigation
237
+ - Player testing and market research needs
238
+ - Competitive analysis requirements
239
+
240
+ **Future Innovation Pipeline:**
241
+
242
+ - Ideas requiring significant development
243
+ - Technology-dependent concepts
244
+ - Market timing considerations
245
+
246
+ **Next Steps:**
247
+
248
+ - Which concepts to prototype first
249
+ - Recommended research areas
250
+ - Suggested playtesting approaches
251
+ - Documentation and GDD planning
252
+
253
+ ## Game Design Specific Considerations
254
+
255
+ ### Platform and Audience Awareness
256
+
257
+ - Always consider target platform limitations and advantages
258
+ - Keep target audience preferences and expectations in mind
259
+ - Balance innovation with familiar game design patterns
260
+ - Consider monetization and business model implications
261
+
262
+ ### Rapid Prototyping Mindset
263
+
264
+ - Focus on ideas that can be quickly tested
265
+ - Emphasize core mechanics over complex features
266
+ - Design for iteration and player feedback
267
+ - Consider digital and paper prototyping approaches
268
+
269
+ ### Player Psychology Integration
270
+
271
+ - Understand motivation and engagement drivers
272
+ - Consider learning curves and skill development
273
+ - Design for different play session lengths
274
+ - Balance challenge and reward appropriately
275
+
276
+ ### Technical Feasibility
277
+
278
+ - Keep development resources and timeline in mind
279
+ - Consider art and audio asset requirements
280
+ - Think about performance and optimization needs
281
+ - Plan for testing and debugging complexity
282
+
283
+ ## Important Notes for Game Design Sessions
284
+
285
+ - Encourage "impossible" ideas - constraints can be added later
286
+ - Build on game mechanics that have proven engagement
287
+ - Consider how ideas scale from prototype to full game
288
+ - Document player experience goals alongside mechanics
289
+ - Think about community and social aspects of gameplay
290
+ - Consider accessibility and inclusivity from the start
291
+ - Balance innovation with market viability
292
+ - Plan for iteration based on player feedback