@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,393 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # Game Architect Solution Validation Checklist
4
+
5
+ This checklist serves as a comprehensive framework for the Game Architect to validate the technical design and architecture before game development execution. The Game Architect should systematically work through each item, ensuring the game architecture is robust, scalable, performant, and aligned with the Game Design Document requirements.
6
+
7
+ [[LLM: INITIALIZATION INSTRUCTIONS - REQUIRED ARTIFACTS
8
+
9
+ Before proceeding with this checklist, ensure you have access to:
10
+
11
+ 1. game-architecture.md - The primary game architecture document (check docs/game-architecture.md)
12
+ 2. game-design-doc.md - Game Design Document for game requirements alignment (check docs/game-design-doc.md)
13
+ 3. Any system diagrams referenced in the architecture
14
+ 4. Unity project structure documentation
15
+ 5. Game balance and configuration specifications
16
+ 6. Platform target specifications
17
+
18
+ IMPORTANT: If any required documents are missing or inaccessible, immediately ask the user for their location or content before proceeding.
19
+
20
+ GAME PROJECT TYPE DETECTION:
21
+ First, determine the game project type by checking:
22
+
23
+ - Is this a 2D Unity game project?
24
+ - What platforms are targeted?
25
+ - What are the core game mechanics from the GDD?
26
+ - Are there specific performance requirements?
27
+
28
+ VALIDATION APPROACH:
29
+ For each section, you must:
30
+
31
+ 1. Deep Analysis - Don't just check boxes, thoroughly analyze each item against the provided documentation
32
+ 2. Evidence-Based - Cite specific sections or quotes from the documents when validating
33
+ 3. Critical Thinking - Question assumptions and identify gaps, not just confirm what's present
34
+ 4. Performance Focus - Consider frame rate impact and mobile optimization for every architectural decision
35
+
36
+ EXECUTION MODE:
37
+ Ask the user if they want to work through the checklist:
38
+
39
+ - Section by section (interactive mode) - Review each section, present findings, get confirmation before proceeding
40
+ - All at once (comprehensive mode) - Complete full analysis and present comprehensive report at end]]
41
+
42
+ ## 1. GAME DESIGN REQUIREMENTS ALIGNMENT
43
+
44
+ [[LLM: Before evaluating this section, fully understand the game's core mechanics and player experience from the GDD. What type of gameplay is this? What are the player's primary actions? What must feel responsive and smooth? Keep these in mind as you validate the technical architecture serves the game design.]]
45
+
46
+ ### 1.1 Core Mechanics Coverage
47
+
48
+ - [ ] Architecture supports all core game mechanics from GDD
49
+ - [ ] Technical approaches for all game systems are addressed
50
+ - [ ] Player controls and input handling are properly architected
51
+ - [ ] Game state management covers all required states
52
+ - [ ] All gameplay features have corresponding technical systems
53
+
54
+ ### 1.2 Performance & Platform Requirements
55
+
56
+ - [ ] Target frame rate requirements are addressed with specific solutions
57
+ - [ ] Mobile platform constraints are considered in architecture
58
+ - [ ] Memory usage optimization strategies are defined
59
+ - [ ] Battery life considerations are addressed
60
+ - [ ] Cross-platform compatibility is properly architected
61
+
62
+ ### 1.3 Unity-Specific Requirements Adherence
63
+
64
+ - [ ] Unity version and LTS requirements are satisfied
65
+ - [ ] Unity Package Manager dependencies are specified
66
+ - [ ] Target platform build settings are addressed
67
+ - [ ] Unity asset pipeline usage is optimized
68
+ - [ ] MonoBehaviour lifecycle usage is properly planned
69
+
70
+ ## 2. GAME ARCHITECTURE FUNDAMENTALS
71
+
72
+ [[LLM: Game architecture must be clear for rapid iteration. As you review this section, think about how a game developer would implement these systems. Are the component responsibilities clear? Would the architecture support quick gameplay tweaks and balancing changes? Look for Unity-specific patterns and clear separation of game logic.]]
73
+
74
+ ### 2.1 Game Systems Clarity
75
+
76
+ - [ ] Game architecture is documented with clear system diagrams
77
+ - [ ] Major game systems and their responsibilities are defined
78
+ - [ ] System interactions and dependencies are mapped
79
+ - [ ] Game data flows are clearly illustrated
80
+ - [ ] Unity-specific implementation approaches are specified
81
+
82
+ ### 2.2 Unity Component Architecture
83
+
84
+ - [ ] Clear separation between GameObjects, Components, and ScriptableObjects
85
+ - [ ] MonoBehaviour usage follows Unity best practices
86
+ - [ ] Prefab organization and instantiation patterns are defined
87
+ - [ ] Scene management and loading strategies are clear
88
+ - [ ] Unity's component-based architecture is properly leveraged
89
+
90
+ ### 2.3 Game Design Patterns & Practices
91
+
92
+ - [ ] Appropriate game programming patterns are employed (Singleton, Observer, State Machine, etc.)
93
+ - [ ] Unity best practices are followed throughout
94
+ - [ ] Common game development anti-patterns are avoided
95
+ - [ ] Consistent architectural style across game systems
96
+ - [ ] Pattern usage is documented with Unity-specific examples
97
+
98
+ ### 2.4 Scalability & Iteration Support
99
+
100
+ - [ ] Game systems support rapid iteration and balancing changes
101
+ - [ ] Components can be developed and tested independently
102
+ - [ ] Game configuration changes can be made without code changes
103
+ - [ ] Architecture supports adding new content and features
104
+ - [ ] System designed for AI agent implementation of game features
105
+
106
+ ## 3. UNITY TECHNOLOGY STACK & DECISIONS
107
+
108
+ [[LLM: Unity technology choices impact long-term maintainability. For each Unity-specific decision, consider: Is this using Unity's strengths? Will this scale to full production? Are we fighting against Unity's paradigms? Verify that specific Unity versions and package versions are defined.]]
109
+
110
+ ### 3.1 Unity Technology Selection
111
+
112
+ - [ ] Unity version (preferably LTS) is specifically defined
113
+ - [ ] Required Unity packages are listed with versions
114
+ - [ ] Unity features used are appropriate for 2D game development
115
+ - [ ] Third-party Unity assets are justified and documented
116
+ - [ ] Technology choices leverage Unity's 2D toolchain effectively
117
+
118
+ ### 3.2 Game Systems Architecture
119
+
120
+ - [ ] Game Manager and core systems architecture is defined
121
+ - [ ] Audio system using Unity's AudioMixer is specified
122
+ - [ ] Input system using Unity's new Input System is outlined
123
+ - [ ] UI system using Unity's UI Toolkit or UGUI is determined
124
+ - [ ] Scene management and loading architecture is clear
125
+ - [ ] Gameplay systems architecture covers core game mechanics and player interactions
126
+ - [ ] Component architecture details define MonoBehaviour and ScriptableObject patterns
127
+ - [ ] Physics configuration for Unity 2D is comprehensively defined
128
+ - [ ] State machine architecture covers game states, player states, and entity behaviors
129
+ - [ ] UI component system and data binding patterns are established
130
+ - [ ] UI state management across screens and game states is defined
131
+ - [ ] Data persistence and save system architecture is fully specified
132
+ - [ ] Analytics integration approach is defined (if applicable)
133
+ - [ ] Multiplayer architecture is detailed (if applicable)
134
+ - [ ] Rendering pipeline configuration and optimization strategies are clear
135
+ - [ ] Shader guidelines and performance considerations are documented
136
+ - [ ] Sprite management and optimization strategies are defined
137
+ - [ ] Particle system architecture and performance budgets are established
138
+ - [ ] Audio architecture includes system design and category management
139
+ - [ ] Audio mixing configuration with Unity AudioMixer is detailed
140
+ - [ ] Sound bank management and asset organization is specified
141
+ - [ ] Unity development conventions and best practices are documented
142
+
143
+ ### 3.3 Data Architecture & Game Balance
144
+
145
+ - [ ] ScriptableObject usage for game data is properly planned
146
+ - [ ] Game balance data structures are fully defined
147
+ - [ ] Save/load system architecture is specified
148
+ - [ ] Data serialization approach is documented
149
+ - [ ] Configuration and tuning data management is outlined
150
+
151
+ ### 3.4 Asset Pipeline & Management
152
+
153
+ - [ ] Sprite and texture management approach is defined
154
+ - [ ] Audio asset organization is specified
155
+ - [ ] Prefab organization and management is planned
156
+ - [ ] Asset loading and memory management strategies are outlined
157
+ - [ ] Build pipeline and asset bundling approach is defined
158
+
159
+ ## 4. GAME PERFORMANCE & OPTIMIZATION
160
+
161
+ [[LLM: Performance is critical for games. This section focuses on Unity-specific performance considerations. Think about frame rate stability, memory allocation, and mobile constraints. Look for specific Unity profiling and optimization strategies.]]
162
+
163
+ ### 4.1 Rendering Performance
164
+
165
+ - [ ] 2D rendering pipeline optimization is addressed
166
+ - [ ] Sprite batching and draw call optimization is planned
167
+ - [ ] UI rendering performance is considered
168
+ - [ ] Particle system performance limits are defined
169
+ - [ ] Target platform rendering constraints are addressed
170
+
171
+ ### 4.2 Memory Management
172
+
173
+ - [ ] Object pooling strategies are defined for frequently instantiated objects
174
+ - [ ] Memory allocation minimization approaches are specified
175
+ - [ ] Asset loading and unloading strategies prevent memory leaks
176
+ - [ ] Garbage collection impact is minimized through design
177
+ - [ ] Mobile memory constraints are properly addressed
178
+
179
+ ### 4.3 Game Logic Performance
180
+
181
+ - [ ] Update loop optimization strategies are defined
182
+ - [ ] Physics system performance considerations are addressed
183
+ - [ ] Coroutine usage patterns are optimized
184
+ - [ ] Event system performance impact is minimized
185
+ - [ ] AI and game logic performance budgets are established
186
+
187
+ ### 4.4 Mobile & Cross-Platform Performance
188
+
189
+ - [ ] Mobile-specific performance optimizations are planned
190
+ - [ ] Battery life optimization strategies are defined
191
+ - [ ] Platform-specific performance tuning is addressed
192
+ - [ ] Scalable quality settings system is designed
193
+ - [ ] Performance testing approach for target devices is outlined
194
+
195
+ ## 5. GAME SYSTEMS RESILIENCE & TESTING
196
+
197
+ [[LLM: Games need robust systems that handle edge cases gracefully. Consider what happens when the player does unexpected things, when systems fail, or when running on low-end devices. Look for specific testing strategies for game logic and Unity systems.]]
198
+
199
+ ### 5.1 Game State Resilience
200
+
201
+ - [ ] Save/load system error handling is comprehensive
202
+ - [ ] Game state corruption recovery is addressed
203
+ - [ ] Invalid player input handling is specified
204
+ - [ ] Game system failure recovery approaches are defined
205
+ - [ ] Edge case handling in game logic is documented
206
+
207
+ ### 5.2 Unity-Specific Testing
208
+
209
+ - [ ] Unity Test Framework usage is defined
210
+ - [ ] Game logic unit testing approach is specified
211
+ - [ ] Play mode testing strategies are outlined
212
+ - [ ] Performance testing with Unity Profiler is planned
213
+ - [ ] Device testing approach across target platforms is defined
214
+
215
+ ### 5.3 Game Balance & Configuration Testing
216
+
217
+ - [ ] Game balance testing methodology is defined
218
+ - [ ] Configuration data validation is specified
219
+ - [ ] A/B testing support is considered if needed
220
+ - [ ] Game metrics collection is planned
221
+ - [ ] Player feedback integration approach is outlined
222
+
223
+ ## 6. GAME DEVELOPMENT WORKFLOW
224
+
225
+ [[LLM: Efficient game development requires clear workflows. Consider how designers, artists, and programmers will collaborate. Look for clear asset pipelines, version control strategies, and build processes that support the team.]]
226
+
227
+ ### 6.1 Unity Project Organization
228
+
229
+ - [ ] Unity project folder structure is clearly defined
230
+ - [ ] Asset naming conventions are specified
231
+ - [ ] Scene organization and workflow is documented
232
+ - [ ] Prefab organization and usage patterns are defined
233
+ - [ ] Version control strategy for Unity projects is outlined
234
+
235
+ ### 6.2 Content Creation Workflow
236
+
237
+ - [ ] Art asset integration workflow is defined
238
+ - [ ] Audio asset integration process is specified
239
+ - [ ] Level design and creation workflow is outlined
240
+ - [ ] Game data configuration process is clear
241
+ - [ ] Iteration and testing workflow supports rapid changes
242
+
243
+ ### 6.3 Build & Deployment
244
+
245
+ - [ ] Unity build pipeline configuration is specified
246
+ - [ ] Multi-platform build strategy is defined
247
+ - [ ] Build automation approach is outlined
248
+ - [ ] Testing build deployment is addressed
249
+ - [ ] Release build optimization is planned
250
+
251
+ ## 7. GAME-SPECIFIC IMPLEMENTATION GUIDANCE
252
+
253
+ [[LLM: Clear implementation guidance prevents game development mistakes. Consider Unity-specific coding patterns, common pitfalls in game development, and clear examples of how game systems should be implemented.]]
254
+
255
+ ### 7.1 Unity C# Coding Standards
256
+
257
+ - [ ] Unity-specific C# coding standards are defined
258
+ - [ ] MonoBehaviour lifecycle usage patterns are specified
259
+ - [ ] Coroutine usage guidelines are outlined
260
+ - [ ] Event system usage patterns are defined
261
+ - [ ] ScriptableObject creation and usage patterns are documented
262
+
263
+ ### 7.2 Game System Implementation Patterns
264
+
265
+ - [ ] Singleton pattern usage for game managers is specified
266
+ - [ ] State machine implementation patterns are defined
267
+ - [ ] Observer pattern usage for game events is outlined
268
+ - [ ] Object pooling implementation patterns are documented
269
+ - [ ] Component communication patterns are clearly defined
270
+
271
+ ### 7.3 Unity Development Environment
272
+
273
+ - [ ] Unity project setup and configuration is documented
274
+ - [ ] Required Unity packages and versions are specified
275
+ - [ ] Unity Editor workflow and tools usage is outlined
276
+ - [ ] Debug and testing tools configuration is defined
277
+ - [ ] Unity development best practices are documented
278
+
279
+ ## 8. GAME CONTENT & ASSET MANAGEMENT
280
+
281
+ [[LLM: Games require extensive asset management. Consider how sprites, audio, prefabs, and data will be organized, loaded, and managed throughout the game's lifecycle. Look for scalable approaches that work with Unity's asset pipeline.]]
282
+
283
+ ### 8.1 Game Asset Organization
284
+
285
+ - [ ] Sprite and texture organization is clearly defined
286
+ - [ ] Audio asset organization and management is specified
287
+ - [ ] Prefab organization and naming conventions are outlined
288
+ - [ ] ScriptableObject organization for game data is defined
289
+ - [ ] Asset dependency management is addressed
290
+
291
+ ### 8.2 Dynamic Asset Loading
292
+
293
+ - [ ] Runtime asset loading strategies are specified
294
+ - [ ] Asset bundling approach is defined if needed
295
+ - [ ] Memory management for loaded assets is outlined
296
+ - [ ] Asset caching and unloading strategies are defined
297
+ - [ ] Platform-specific asset loading is addressed
298
+
299
+ ### 8.3 Game Content Scalability
300
+
301
+ - [ ] Level and content organization supports growth
302
+ - [ ] Modular content design patterns are defined
303
+ - [ ] Content versioning and updates are addressed
304
+ - [ ] User-generated content support is considered if needed
305
+ - [ ] Content validation and testing approaches are specified
306
+
307
+ ## 9. AI AGENT GAME DEVELOPMENT SUITABILITY
308
+
309
+ [[LLM: This game architecture may be implemented by AI agents. Review with game development clarity in mind. Are Unity patterns consistent? Is game logic complexity minimized? Would an AI agent understand Unity-specific concepts? Look for clear component responsibilities and implementation patterns.]]
310
+
311
+ ### 9.1 Unity System Modularity
312
+
313
+ - [ ] Game systems are appropriately sized for AI implementation
314
+ - [ ] Unity component dependencies are minimized and clear
315
+ - [ ] MonoBehaviour responsibilities are singular and well-defined
316
+ - [ ] ScriptableObject usage patterns are consistent
317
+ - [ ] Prefab organization supports systematic implementation
318
+
319
+ ### 9.2 Game Logic Clarity
320
+
321
+ - [ ] Game mechanics are broken down into clear, implementable steps
322
+ - [ ] Unity-specific patterns are documented with examples
323
+ - [ ] Complex game logic is simplified into component interactions
324
+ - [ ] State machines and game flow are explicitly defined
325
+ - [ ] Component communication patterns are predictable
326
+
327
+ ### 9.3 Implementation Support
328
+
329
+ - [ ] Unity project structure templates are provided
330
+ - [ ] Component implementation patterns are documented
331
+ - [ ] Common Unity pitfalls are identified with solutions
332
+ - [ ] Game system testing patterns are clearly defined
333
+ - [ ] Performance optimization guidelines are explicit
334
+
335
+ ## 10. PLATFORM & PUBLISHING CONSIDERATIONS
336
+
337
+ [[LLM: Different platforms have different requirements and constraints. Consider mobile app stores, desktop platforms, and web deployment. Look for platform-specific optimizations and compliance requirements.]]
338
+
339
+ ### 10.1 Platform-Specific Architecture
340
+
341
+ - [ ] Mobile platform constraints are properly addressed
342
+ - [ ] Desktop platform features are leveraged appropriately
343
+ - [ ] Web platform limitations are considered if applicable
344
+ - [ ] Console platform requirements are addressed if applicable
345
+ - [ ] Platform-specific input handling is planned
346
+
347
+ ### 10.2 Publishing & Distribution
348
+
349
+ - [ ] App store compliance requirements are addressed
350
+ - [ ] Platform-specific build configurations are defined
351
+ - [ ] Update and patch deployment strategy is planned
352
+ - [ ] Platform analytics integration is considered
353
+ - [ ] Platform-specific monetization is addressed if applicable
354
+
355
+ [[LLM: FINAL GAME ARCHITECTURE VALIDATION REPORT
356
+
357
+ Generate a comprehensive validation report that includes:
358
+
359
+ 1. Executive Summary
360
+ - Overall game architecture readiness (High/Medium/Low)
361
+ - Critical risks for game development
362
+ - Key strengths of the game architecture
363
+ - Unity-specific assessment
364
+
365
+ 2. Game Systems Analysis
366
+ - Pass rate for each major system section
367
+ - Most concerning gaps in game architecture
368
+ - Systems requiring immediate attention
369
+ - Unity integration completeness
370
+
371
+ 3. Performance Risk Assessment
372
+ - Top 5 performance risks for the game
373
+ - Mobile platform specific concerns
374
+ - Frame rate stability risks
375
+ - Memory usage concerns
376
+
377
+ 4. Implementation Recommendations
378
+ - Must-fix items before development
379
+ - Unity-specific improvements needed
380
+ - Game development workflow enhancements
381
+
382
+ 5. AI Agent Implementation Readiness
383
+ - Game-specific concerns for AI implementation
384
+ - Unity component complexity assessment
385
+ - Areas needing additional clarification
386
+
387
+ 6. Game Development Workflow Assessment
388
+ - Asset pipeline completeness
389
+ - Team collaboration workflow clarity
390
+ - Build and deployment readiness
391
+ - Testing strategy completeness
392
+
393
+ After presenting the report, ask the user if they would like detailed analysis of any specific game system or Unity-specific concerns.]]
@@ -0,0 +1,205 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # Game Development Change Navigation Checklist
4
+
5
+ **Purpose:** To systematically guide the Game SM agent and user through analysis and planning when a significant change (performance issue, platform constraint, technical blocker, gameplay feedback) is identified during Unity game development.
6
+
7
+ **Instructions:** Review each item with the user. Mark `[x]` for completed/confirmed, `[N/A]` if not applicable, or add notes for discussion points.
8
+
9
+ [[LLM: INITIALIZATION INSTRUCTIONS - GAME CHANGE NAVIGATION
10
+
11
+ Changes during game development are common - performance issues, platform constraints, gameplay feedback, and technical limitations are part of the process.
12
+
13
+ Before proceeding, understand:
14
+
15
+ 1. This checklist is for SIGNIFICANT changes affecting game architecture or features
16
+ 2. Minor tweaks (shader adjustments, UI positioning) don't require this process
17
+ 3. The goal is to maintain playability while adapting to technical realities
18
+ 4. Performance and player experience are paramount
19
+
20
+ Required context:
21
+
22
+ - The triggering issue (performance metrics, crash logs, feedback)
23
+ - Current development state (implemented features, current sprint)
24
+ - Access to GDD, technical specs, and performance budgets
25
+ - Understanding of remaining features and milestones
26
+
27
+ APPROACH:
28
+ This is an interactive process. Discuss performance implications, platform constraints, and player impact. The user makes final decisions, but provide expert Unity/game dev guidance.
29
+
30
+ REMEMBER: Game development is iterative. Changes often lead to better gameplay and performance.]]
31
+
32
+ ---
33
+
34
+ ## 1. Understand the Trigger & Context
35
+
36
+ [[LLM: Start by understanding the game-specific issue. Ask technical questions:
37
+
38
+ - What performance metrics triggered this? (FPS, memory, load times)
39
+ - Is this platform-specific or universal?
40
+ - Can we reproduce it consistently?
41
+ - What Unity profiler data do we have?
42
+ - Is this a gameplay issue or technical constraint?
43
+
44
+ Focus on measurable impacts and technical specifics.]]
45
+
46
+ - [ ] **Identify Triggering Element:** Clearly identify the game feature/system revealing the issue.
47
+ - [ ] **Define the Issue:** Articulate the core problem precisely.
48
+ - [ ] Performance bottleneck (CPU/GPU/Memory)?
49
+ - [ ] Platform-specific limitation?
50
+ - [ ] Unity engine constraint?
51
+ - [ ] Gameplay/balance issue from playtesting?
52
+ - [ ] Asset pipeline or build size problem?
53
+ - [ ] Third-party SDK/plugin conflict?
54
+ - [ ] **Assess Performance Impact:** Document specific metrics (current FPS, target FPS, memory usage, build size).
55
+ - [ ] **Gather Technical Evidence:** Note profiler data, crash logs, platform test results, player feedback.
56
+
57
+ ## 2. Game Feature Impact Assessment
58
+
59
+ [[LLM: Game features are interconnected. Evaluate systematically:
60
+
61
+ 1. Can we optimize the current feature without changing gameplay?
62
+ 2. Do dependent features need adjustment?
63
+ 3. Are there platform-specific workarounds?
64
+ 4. Does this affect our performance budget allocation?
65
+
66
+ Consider both technical and gameplay impacts.]]
67
+
68
+ - [ ] **Analyze Current Sprint Features:**
69
+ - [ ] Can the current feature be optimized (LOD, pooling, batching)?
70
+ - [ ] Does it need gameplay simplification?
71
+ - [ ] Should it be platform-specific (high-end only)?
72
+ - [ ] **Analyze Dependent Systems:**
73
+ - [ ] Review all game systems interacting with the affected feature.
74
+ - [ ] Do physics systems need adjustment?
75
+ - [ ] Are UI/HUD systems impacted?
76
+ - [ ] Do save/load systems require changes?
77
+ - [ ] Are multiplayer systems affected?
78
+ - [ ] **Summarize Feature Impact:** Document effects on gameplay systems and technical architecture.
79
+
80
+ ## 3. Game Artifact Conflict & Impact Analysis
81
+
82
+ [[LLM: Game documentation drives development. Check each artifact:
83
+
84
+ 1. Does this invalidate GDD mechanics?
85
+ 2. Are technical architecture assumptions still valid?
86
+ 3. Do performance budgets need reallocation?
87
+ 4. Are platform requirements still achievable?
88
+
89
+ Missing conflicts cause performance issues later.]]
90
+
91
+ - [ ] **Review GDD:**
92
+ - [ ] Does the issue conflict with core gameplay mechanics?
93
+ - [ ] Do game features need scaling for performance?
94
+ - [ ] Are progression systems affected?
95
+ - [ ] Do balance parameters need adjustment?
96
+ - [ ] **Review Technical Architecture:**
97
+ - [ ] Does the issue conflict with Unity architecture (scene structure, prefab hierarchy)?
98
+ - [ ] Are component systems impacted?
99
+ - [ ] Do shader/rendering approaches need revision?
100
+ - [ ] Are data structures optimal for the scale?
101
+ - [ ] **Review Performance Specifications:**
102
+ - [ ] Are target framerates still achievable?
103
+ - [ ] Do memory budgets need reallocation?
104
+ - [ ] Are load time targets realistic?
105
+ - [ ] Do we need platform-specific targets?
106
+ - [ ] **Review Asset Specifications:**
107
+ - [ ] Do texture resolutions need adjustment?
108
+ - [ ] Are model poly counts appropriate?
109
+ - [ ] Do audio compression settings need changes?
110
+ - [ ] Is the animation budget sustainable?
111
+ - [ ] **Summarize Artifact Impact:** List all game documents requiring updates.
112
+
113
+ ## 4. Path Forward Evaluation
114
+
115
+ [[LLM: Present game-specific solutions with technical trade-offs:
116
+
117
+ 1. What's the performance gain?
118
+ 2. How much rework is required?
119
+ 3. What's the player experience impact?
120
+ 4. Are there platform-specific solutions?
121
+ 5. Is this maintainable across updates?
122
+
123
+ Be specific about Unity implementation details.]]
124
+
125
+ - [ ] **Option 1: Optimization Within Current Design:**
126
+ - [ ] Can performance be improved through Unity optimizations?
127
+ - [ ] Object pooling implementation?
128
+ - [ ] LOD system addition?
129
+ - [ ] Texture atlasing?
130
+ - [ ] Draw call batching?
131
+ - [ ] Shader optimization?
132
+ - [ ] Define specific optimization techniques.
133
+ - [ ] Estimate performance improvement potential.
134
+ - [ ] **Option 2: Feature Scaling/Simplification:**
135
+ - [ ] Can the feature be simplified while maintaining fun?
136
+ - [ ] Identify specific elements to scale down.
137
+ - [ ] Define platform-specific variations.
138
+ - [ ] Assess player experience impact.
139
+ - [ ] **Option 3: Architecture Refactor:**
140
+ - [ ] Would restructuring improve performance significantly?
141
+ - [ ] Identify Unity-specific refactoring needs:
142
+ - [ ] Scene organization changes?
143
+ - [ ] Prefab structure optimization?
144
+ - [ ] Component system redesign?
145
+ - [ ] State machine optimization?
146
+ - [ ] Estimate development effort.
147
+ - [ ] **Option 4: Scope Adjustment:**
148
+ - [ ] Can we defer features to post-launch?
149
+ - [ ] Should certain features be platform-exclusive?
150
+ - [ ] Do we need to adjust milestone deliverables?
151
+ - [ ] **Select Recommended Path:** Choose based on performance gain vs. effort.
152
+
153
+ ## 5. Game Development Change Proposal Components
154
+
155
+ [[LLM: The proposal must include technical specifics:
156
+
157
+ 1. Performance metrics (before/after projections)
158
+ 2. Unity implementation details
159
+ 3. Platform-specific considerations
160
+ 4. Testing requirements
161
+ 5. Risk mitigation strategies
162
+
163
+ Make it actionable for game developers.]]
164
+
165
+ (Ensure all points from previous sections are captured)
166
+
167
+ - [ ] **Technical Issue Summary:** Performance/technical problem with metrics.
168
+ - [ ] **Feature Impact Summary:** Affected game systems and dependencies.
169
+ - [ ] **Performance Projections:** Expected improvements from chosen solution.
170
+ - [ ] **Implementation Plan:** Unity-specific technical approach.
171
+ - [ ] **Platform Considerations:** Any platform-specific implementations.
172
+ - [ ] **Testing Strategy:** Performance benchmarks and validation approach.
173
+ - [ ] **Risk Assessment:** Technical risks and mitigation plans.
174
+ - [ ] **Updated Game Stories:** Revised stories with technical constraints.
175
+
176
+ ## 6. Final Review & Handoff
177
+
178
+ [[LLM: Game changes require technical validation. Before concluding:
179
+
180
+ 1. Are performance targets clearly defined?
181
+ 2. Is the Unity implementation approach clear?
182
+ 3. Do we have rollback strategies?
183
+ 4. Are test scenarios defined?
184
+ 5. Is platform testing covered?
185
+
186
+ Get explicit approval on technical approach.
187
+
188
+ FINAL REPORT:
189
+ Provide a technical summary:
190
+
191
+ - Performance issue and root cause
192
+ - Chosen solution with expected gains
193
+ - Implementation approach in Unity
194
+ - Testing and validation plan
195
+ - Timeline and milestone impacts
196
+
197
+ Keep it technically precise and actionable.]]
198
+
199
+ - [ ] **Review Checklist:** Confirm all technical aspects discussed.
200
+ - [ ] **Review Change Proposal:** Ensure Unity implementation details are clear.
201
+ - [ ] **Performance Validation:** Define how we'll measure success.
202
+ - [ ] **User Approval:** Obtain approval for technical approach.
203
+ - [ ] **Developer Handoff:** Ensure game-dev agent has all technical details needed.
204
+
205
+ ---