@zeyue0329/xiaoma-cli 1.0.7 → 1.0.9

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 (310) hide show
  1. package/CHANGELOG.md +686 -0
  2. package/LICENSE +6 -1
  3. package/README.md +173 -460
  4. package/common/tasks/create-doc.md +3 -1
  5. package/common/tasks/execute-checklist.md +2 -7
  6. package/common/utils/bmad-doc-template.md +7 -5
  7. package/common/utils/workflow-management.md +2 -0
  8. package/dist/agents/analyst.txt +1143 -1118
  9. package/dist/agents/architect.txt +1555 -1531
  10. package/dist/agents/dev.txt +170 -22
  11. package/dist/agents/pm.txt +1103 -1106
  12. package/dist/agents/po.txt +329 -334
  13. package/dist/agents/qa.txt +1773 -154
  14. package/dist/agents/sm.txt +101 -102
  15. package/dist/agents/ux-expert.txt +93 -91
  16. package/dist/agents/xiaoma-master.txt +745 -673
  17. package/dist/agents/xiaoma-orchestrator.txt +107 -77
  18. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +2386 -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 +11008 -0
  22. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +4031 -0
  23. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +3717 -0
  24. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +456 -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 +15450 -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 +6511 -0
  38. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +2087 -0
  39. package/dist/teams/team-all.txt +5710 -3857
  40. package/dist/teams/team-fullstack.txt +3242 -3157
  41. package/dist/teams/team-ide-minimal.txt +2330 -534
  42. package/dist/teams/team-no-ui.txt +2935 -2857
  43. package/docs/GUIDING-PRINCIPLES.md +91 -0
  44. package/docs/core-architecture.md +219 -0
  45. package/docs/enhanced-ide-development-workflow.md +248 -0
  46. package/docs/expansion-packs.md +200 -0
  47. package/docs/how-to-contribute-with-pull-requests.md +158 -0
  48. package/docs/user-guide.md +530 -0
  49. package/docs/versioning-and-releases.md +155 -0
  50. package/docs/versions.md +48 -0
  51. package/docs/working-in-the-brownfield.md +597 -0
  52. package/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml +14 -0
  53. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md +73 -0
  54. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +80 -0
  55. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +66 -0
  56. package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-design-checklist.md +203 -0
  57. package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md +162 -0
  58. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +9 -0
  59. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +252 -0
  60. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +649 -0
  61. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +112 -0
  62. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md +218 -0
  63. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +292 -0
  64. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +614 -0
  65. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +357 -0
  66. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +344 -0
  67. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +254 -0
  68. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +485 -0
  69. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +184 -0
  70. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +176 -0
  71. package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +15 -0
  72. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md +82 -0
  73. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +79 -0
  74. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +80 -0
  75. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md +67 -0
  76. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +393 -0
  77. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md +205 -0
  78. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +203 -0
  79. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +126 -0
  80. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +7 -0
  81. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +771 -0
  82. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +588 -0
  83. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +112 -0
  84. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +143 -0
  85. package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +186 -0
  86. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +292 -0
  87. package/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md +202 -0
  88. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +1031 -0
  89. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +357 -0
  90. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +706 -0
  91. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +257 -0
  92. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +485 -0
  93. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +184 -0
  94. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +176 -0
  95. package/expansion-packs/bmad-creative-writing/README.md +146 -0
  96. package/expansion-packs/bmad-creative-writing/agent-teams/agent-team.yaml +20 -0
  97. package/expansion-packs/bmad-creative-writing/agents/beta-reader.md +94 -0
  98. package/expansion-packs/bmad-creative-writing/agents/book-critic.md +40 -0
  99. package/expansion-packs/bmad-creative-writing/agents/character-psychologist.md +93 -0
  100. package/expansion-packs/bmad-creative-writing/agents/cover-designer.md +46 -0
  101. package/expansion-packs/bmad-creative-writing/agents/dialog-specialist.md +92 -0
  102. package/expansion-packs/bmad-creative-writing/agents/editor.md +93 -0
  103. package/expansion-packs/bmad-creative-writing/agents/genre-specialist.md +95 -0
  104. package/expansion-packs/bmad-creative-writing/agents/narrative-designer.md +93 -0
  105. package/expansion-packs/bmad-creative-writing/agents/plot-architect.md +95 -0
  106. package/expansion-packs/bmad-creative-writing/agents/world-builder.md +94 -0
  107. package/expansion-packs/bmad-creative-writing/checklists/beta-feedback-closure-checklist.md +23 -0
  108. package/expansion-packs/bmad-creative-writing/checklists/character-consistency-checklist.md +23 -0
  109. package/expansion-packs/bmad-creative-writing/checklists/comedic-timing-checklist.md +23 -0
  110. package/expansion-packs/bmad-creative-writing/checklists/cyberpunk-aesthetic-checklist.md +23 -0
  111. package/expansion-packs/bmad-creative-writing/checklists/ebook-formatting-checklist.md +21 -0
  112. package/expansion-packs/bmad-creative-writing/checklists/epic-poetry-meter-checklist.md +23 -0
  113. package/expansion-packs/bmad-creative-writing/checklists/fantasy-magic-system-checklist.md +23 -0
  114. package/expansion-packs/bmad-creative-writing/checklists/foreshadowing-payoff-checklist.md +22 -0
  115. package/expansion-packs/bmad-creative-writing/checklists/genre-tropes-checklist.md +22 -0
  116. package/expansion-packs/bmad-creative-writing/checklists/historical-accuracy-checklist.md +23 -0
  117. package/expansion-packs/bmad-creative-writing/checklists/horror-suspense-checklist.md +23 -0
  118. package/expansion-packs/bmad-creative-writing/checklists/kdp-cover-ready-checklist.md +25 -0
  119. package/expansion-packs/bmad-creative-writing/checklists/line-edit-quality-checklist.md +23 -0
  120. package/expansion-packs/bmad-creative-writing/checklists/marketing-copy-checklist.md +23 -0
  121. package/expansion-packs/bmad-creative-writing/checklists/mystery-clue-trail-checklist.md +23 -0
  122. package/expansion-packs/bmad-creative-writing/checklists/orbital-mechanics-checklist.md +23 -0
  123. package/expansion-packs/bmad-creative-writing/checklists/plot-structure-checklist.md +59 -0
  124. package/expansion-packs/bmad-creative-writing/checklists/publication-readiness-checklist.md +23 -0
  125. package/expansion-packs/bmad-creative-writing/checklists/romance-emotional-beats-checklist.md +23 -0
  126. package/expansion-packs/bmad-creative-writing/checklists/scene-quality-checklist.md +23 -0
  127. package/expansion-packs/bmad-creative-writing/checklists/scifi-technology-plausibility-checklist.md +22 -0
  128. package/expansion-packs/bmad-creative-writing/checklists/sensitivity-representation-checklist.md +23 -0
  129. package/expansion-packs/bmad-creative-writing/checklists/steampunk-gadget-checklist.md +23 -0
  130. package/expansion-packs/bmad-creative-writing/checklists/thriller-pacing-stakes-checklist.md +23 -0
  131. package/expansion-packs/bmad-creative-writing/checklists/timeline-continuity-checklist.md +23 -0
  132. package/expansion-packs/bmad-creative-writing/checklists/world-building-continuity-checklist.md +23 -0
  133. package/expansion-packs/bmad-creative-writing/checklists/ya-appropriateness-checklist.md +23 -0
  134. package/expansion-packs/bmad-creative-writing/config.yaml +12 -0
  135. package/expansion-packs/bmad-creative-writing/data/bmad-kb.md +209 -0
  136. package/expansion-packs/bmad-creative-writing/data/story-structures.md +67 -0
  137. package/expansion-packs/bmad-creative-writing/docs/brief.md +212 -0
  138. package/expansion-packs/bmad-creative-writing/tasks/advanced-elicitation.md +119 -0
  139. package/expansion-packs/bmad-creative-writing/tasks/analyze-reader-feedback.md +23 -0
  140. package/expansion-packs/bmad-creative-writing/tasks/analyze-story-structure.md +67 -0
  141. package/expansion-packs/bmad-creative-writing/tasks/assemble-kdp-package.md +29 -0
  142. package/expansion-packs/bmad-creative-writing/tasks/brainstorm-premise.md +23 -0
  143. package/expansion-packs/bmad-creative-writing/tasks/build-world.md +24 -0
  144. package/expansion-packs/bmad-creative-writing/tasks/character-depth-pass.md +22 -0
  145. package/expansion-packs/bmad-creative-writing/tasks/create-doc.md +103 -0
  146. package/expansion-packs/bmad-creative-writing/tasks/create-draft-section.md +26 -0
  147. package/expansion-packs/bmad-creative-writing/tasks/critical-review.md +26 -0
  148. package/expansion-packs/bmad-creative-writing/tasks/develop-character.md +24 -0
  149. package/expansion-packs/bmad-creative-writing/tasks/execute-checklist.md +88 -0
  150. package/expansion-packs/bmad-creative-writing/tasks/expand-premise.md +23 -0
  151. package/expansion-packs/bmad-creative-writing/tasks/expand-synopsis.md +23 -0
  152. package/expansion-packs/bmad-creative-writing/tasks/final-polish.md +23 -0
  153. package/expansion-packs/bmad-creative-writing/tasks/generate-cover-brief.md +25 -0
  154. package/expansion-packs/bmad-creative-writing/tasks/generate-cover-prompts.md +26 -0
  155. package/expansion-packs/bmad-creative-writing/tasks/generate-scene-list.md +23 -0
  156. package/expansion-packs/bmad-creative-writing/tasks/incorporate-feedback.md +25 -0
  157. package/expansion-packs/bmad-creative-writing/tasks/outline-scenes.md +23 -0
  158. package/expansion-packs/bmad-creative-writing/tasks/provide-feedback.md +24 -0
  159. package/expansion-packs/bmad-creative-writing/tasks/publish-chapter.md +23 -0
  160. package/expansion-packs/bmad-creative-writing/tasks/quick-feedback.md +22 -0
  161. package/expansion-packs/bmad-creative-writing/tasks/select-next-arc.md +23 -0
  162. package/expansion-packs/bmad-creative-writing/tasks/workshop-dialog.md +64 -0
  163. package/expansion-packs/bmad-creative-writing/templates/beta-feedback-form.yaml +97 -0
  164. package/expansion-packs/bmad-creative-writing/templates/chapter-draft-tmpl.yaml +82 -0
  165. package/expansion-packs/bmad-creative-writing/templates/character-profile-tmpl.yaml +92 -0
  166. package/expansion-packs/bmad-creative-writing/templates/cover-design-brief-tmpl.yaml +98 -0
  167. package/expansion-packs/bmad-creative-writing/templates/premise-brief-tmpl.yaml +78 -0
  168. package/expansion-packs/bmad-creative-writing/templates/scene-list-tmpl.yaml +55 -0
  169. package/expansion-packs/bmad-creative-writing/templates/story-outline-tmpl.yaml +96 -0
  170. package/expansion-packs/bmad-creative-writing/templates/world-guide-tmpl.yaml +89 -0
  171. package/expansion-packs/bmad-creative-writing/workflows/book-cover-design-workflow.md +218 -0
  172. package/expansion-packs/bmad-creative-writing/workflows/novel-greenfield-workflow.yaml +56 -0
  173. package/expansion-packs/bmad-creative-writing/workflows/novel-serial-workflow.yaml +50 -0
  174. package/expansion-packs/bmad-creative-writing/workflows/novel-snowflake-workflow.yaml +69 -0
  175. package/expansion-packs/bmad-creative-writing/workflows/novel-writing.yaml +91 -0
  176. package/expansion-packs/bmad-creative-writing/workflows/screenplay-development.yaml +85 -0
  177. package/expansion-packs/bmad-creative-writing/workflows/series-planning.yaml +78 -0
  178. package/expansion-packs/bmad-creative-writing/workflows/short-story-creation.yaml +64 -0
  179. package/expansion-packs/bmad-infrastructure-devops/README.md +147 -0
  180. package/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md +73 -0
  181. package/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md +486 -0
  182. package/expansion-packs/bmad-infrastructure-devops/config.yaml +10 -0
  183. package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +307 -0
  184. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +161 -0
  185. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +155 -0
  186. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +425 -0
  187. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +630 -0
  188. package/implement-fork-friendly-ci.sh +229 -0
  189. package/package.json +75 -45
  190. package/prettier.config.mjs +32 -0
  191. package/test.md +1 -0
  192. package/tools/builders/web-builder.js +128 -129
  193. package/tools/bump-all-versions.js +42 -33
  194. package/tools/bump-expansion-version.js +23 -16
  195. package/tools/cli.js +15 -15
  196. package/tools/flattener/aggregate.js +76 -0
  197. package/tools/flattener/binary.js +80 -0
  198. package/tools/flattener/discovery.js +71 -0
  199. package/tools/flattener/files.js +35 -0
  200. package/tools/flattener/ignoreRules.js +176 -0
  201. package/tools/flattener/main.js +458 -460
  202. package/tools/flattener/projectRoot.js +206 -0
  203. package/tools/flattener/prompts.js +44 -0
  204. package/tools/flattener/stats.helpers.js +395 -0
  205. package/tools/flattener/stats.js +80 -0
  206. package/tools/flattener/test-matrix.js +413 -0
  207. package/tools/flattener/xml.js +88 -0
  208. package/tools/installer/README.md +1 -1
  209. package/tools/installer/bin/xiaoma.js +380 -87
  210. package/tools/installer/config/ide-agent-config.yaml +3 -3
  211. package/tools/installer/config/install.config.yaml +73 -22
  212. package/tools/installer/lib/config-loader.js +48 -44
  213. package/tools/installer/lib/file-manager.js +91 -113
  214. package/tools/installer/lib/ide-base-setup.js +57 -56
  215. package/tools/installer/lib/ide-setup.js +816 -407
  216. package/tools/installer/lib/installer.js +915 -687
  217. package/tools/installer/lib/memory-profiler.js +54 -53
  218. package/tools/installer/lib/module-manager.js +19 -15
  219. package/tools/installer/lib/resource-locator.js +26 -28
  220. package/tools/installer/package-lock.json +67 -56
  221. package/tools/installer/package.json +24 -23
  222. package/tools/lib/dependency-resolver.js +30 -34
  223. package/tools/lib/yaml-utils.js +7 -7
  224. package/tools/md-assets/web-agent-startup-instructions.md +1 -1
  225. package/tools/preview-release-notes.js +66 -0
  226. package/tools/setup-hooks.sh +37 -0
  227. package/tools/shared/bannerArt.js +105 -0
  228. package/tools/sync-installer-version.js +7 -9
  229. package/tools/sync-version.sh +23 -0
  230. package/tools/update-expansion-version.js +14 -15
  231. package/tools/upgraders/v3-to-v4-upgrader.js +208 -299
  232. package/tools/version-bump.js +41 -26
  233. package/tools/xiaoma-npx-wrapper.js +11 -11
  234. package/tools/yaml-format.js +56 -43
  235. package/xiaoma-core/agent-teams/team-all.yaml +2 -1
  236. package/xiaoma-core/agent-teams/team-fullstack.yaml +1 -0
  237. package/xiaoma-core/agent-teams/team-ide-minimal.yaml +1 -0
  238. package/xiaoma-core/agent-teams/team-no-ui.yaml +1 -0
  239. package/xiaoma-core/agents/analyst.md +20 -17
  240. package/xiaoma-core/agents/architect.md +15 -14
  241. package/xiaoma-core/agents/dev.md +23 -18
  242. package/xiaoma-core/agents/pm.md +18 -15
  243. package/xiaoma-core/agents/po.md +13 -10
  244. package/xiaoma-core/agents/qa.md +46 -24
  245. package/xiaoma-core/agents/sm.md +11 -8
  246. package/xiaoma-core/agents/ux-expert.md +10 -7
  247. package/xiaoma-core/agents/xiaoma-master.md +24 -22
  248. package/xiaoma-core/agents/xiaoma-orchestrator.md +30 -33
  249. package/xiaoma-core/checklists/architect-checklist.md +2 -5
  250. package/xiaoma-core/checklists/change-checklist.md +4 -2
  251. package/xiaoma-core/checklists/pm-checklist.md +2 -5
  252. package/xiaoma-core/checklists/po-master-checklist.md +2 -9
  253. package/xiaoma-core/checklists/story-dod-checklist.md +2 -7
  254. package/xiaoma-core/checklists/story-draft-checklist.md +2 -3
  255. package/xiaoma-core/core-config.yaml +4 -1
  256. package/xiaoma-core/data/{xiaoma-kb.md → bmad-kb.md} +43 -37
  257. package/xiaoma-core/data/brainstorming-techniques.md +2 -0
  258. package/xiaoma-core/data/elicitation-methods.md +22 -0
  259. package/xiaoma-core/data/technical-preferences.md +2 -0
  260. package/xiaoma-core/data/test-levels-framework.md +148 -0
  261. package/xiaoma-core/data/test-priorities-matrix.md +174 -0
  262. package/xiaoma-core/tasks/advanced-elicitation.md +2 -0
  263. package/xiaoma-core/tasks/apply-qa-fixes.md +150 -0
  264. package/xiaoma-core/tasks/brownfield-create-epic.md +2 -0
  265. package/xiaoma-core/tasks/brownfield-create-story.md +2 -0
  266. package/xiaoma-core/tasks/correct-course.md +2 -0
  267. package/xiaoma-core/tasks/create-brownfield-story.md +14 -4
  268. package/xiaoma-core/tasks/create-deep-research-prompt.md +2 -11
  269. package/xiaoma-core/tasks/create-next-story.md +3 -1
  270. package/xiaoma-core/tasks/document-project.md +17 -13
  271. package/xiaoma-core/tasks/facilitate-brainstorming-session.md +5 -3
  272. package/xiaoma-core/tasks/generate-ai-frontend-prompt.md +2 -0
  273. package/xiaoma-core/tasks/index-docs.md +2 -6
  274. package/xiaoma-core/tasks/kb-mode-interaction.md +17 -15
  275. package/xiaoma-core/tasks/nfr-assess.md +345 -0
  276. package/xiaoma-core/tasks/qa-gate.md +163 -0
  277. package/xiaoma-core/tasks/review-story.md +245 -74
  278. package/xiaoma-core/tasks/risk-profile.md +355 -0
  279. package/xiaoma-core/tasks/shard-doc.md +2 -2
  280. package/xiaoma-core/tasks/test-design.md +176 -0
  281. package/xiaoma-core/tasks/trace-requirements.md +266 -0
  282. package/xiaoma-core/tasks/validate-next-story.md +2 -0
  283. package/xiaoma-core/templates/architecture-tmpl.yaml +50 -49
  284. package/xiaoma-core/templates/brainstorming-output-tmpl.yaml +5 -5
  285. package/xiaoma-core/templates/brownfield-architecture-tmpl.yaml +32 -31
  286. package/xiaoma-core/templates/brownfield-prd-tmpl.yaml +14 -13
  287. package/xiaoma-core/templates/competitor-analysis-tmpl.yaml +20 -6
  288. package/xiaoma-core/templates/front-end-architecture-tmpl.yaml +22 -9
  289. package/xiaoma-core/templates/front-end-spec-tmpl.yaml +25 -24
  290. package/xiaoma-core/templates/fullstack-architecture-tmpl.yaml +123 -104
  291. package/xiaoma-core/templates/market-research-tmpl.yaml +3 -2
  292. package/xiaoma-core/templates/prd-tmpl.yaml +10 -9
  293. package/xiaoma-core/templates/project-brief-tmpl.yaml +5 -4
  294. package/xiaoma-core/templates/qa-gate-tmpl.yaml +103 -0
  295. package/xiaoma-core/templates/story-tmpl.yaml +13 -12
  296. package/xiaoma-core/workflows/brownfield-fullstack.yaml +13 -12
  297. package/xiaoma-core/workflows/brownfield-service.yaml +5 -4
  298. package/xiaoma-core/workflows/brownfield-ui.yaml +5 -4
  299. package/xiaoma-core/workflows/greenfield-fullstack.yaml +7 -6
  300. package/xiaoma-core/workflows/greenfield-service.yaml +5 -4
  301. package/xiaoma-core/workflows/greenfield-ui.yaml +6 -5
  302. package/.releaserc.json +0 -18
  303. package/.vscode/settings.json +0 -44
  304. package/docs/quick-start.md +0 -179
  305. package/tools/bmad-npx-wrapper.js +0 -39
  306. package/tools/semantic-release-sync-installer.js +0 -30
  307. package/xiaoma-core/bmad-core/user-guide.md +0 -0
  308. package/xiaoma-core/enhanced-ide-development-workflow.md +0 -43
  309. package/xiaoma-core/user-guide.md +0 -251
  310. package/xiaoma-core/working-in-the-brownfield.md +0 -364
@@ -0,0 +1,92 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # dialog-specialist
4
+
5
+ ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
6
+
7
+ CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
8
+
9
+ ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
10
+
11
+ ```yaml
12
+ IDE-FILE-RESOLUTION:
13
+ - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
14
+ - Dependencies map to {root}/{type}/{name}
15
+ - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
16
+ - Example: create-doc.md → {root}/tasks/create-doc.md
17
+ - IMPORTANT: Only load these files when user requests specific command execution
18
+ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
19
+ activation-instructions:
20
+ - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
+ - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
+ - STEP 3: Greet user with your name/role and mention `*help` command
23
+ - DO NOT: Load any other agent files during activation
24
+ - ONLY load dependency files when user selects them for execution via command or request of a task
25
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
26
+ - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
27
+ - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
28
+ - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
29
+ - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
30
+ - STAY IN CHARACTER!
31
+ - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
32
+ agent:
33
+ name: Dialog Specialist
34
+ id: dialog-specialist
35
+ title: Conversation & Voice Expert
36
+ icon: 💬
37
+ whenToUse: Use for dialog refinement, voice distinction, subtext development, and conversation flow
38
+ customization: null
39
+ persona:
40
+ role: Master of authentic, engaging dialog
41
+ style: Ear for natural speech, subtext-aware, character-driven
42
+ identity: Expert in dialog that advances plot while revealing character
43
+ focus: Creating conversations that feel real and serve story
44
+ core_principles:
45
+ - Dialog is action, not just words
46
+ - Subtext carries emotional truth
47
+ - Each character needs distinct voice
48
+ - Less is often more
49
+ - Silence speaks volumes
50
+ - Numbered Options Protocol - Always use numbered lists for user selections
51
+ commands:
52
+ - '*help - Show numbered list of available commands for selection'
53
+ - '*refine-dialog - Polish conversation flow'
54
+ - '*voice-distinction - Differentiate character voices'
55
+ - '*subtext-layer - Add underlying meanings'
56
+ - '*tension-workshop - Build conversational conflict'
57
+ - '*dialect-guide - Create speech patterns'
58
+ - '*banter-builder - Develop character chemistry'
59
+ - '*monolog-craft - Shape powerful monologs'
60
+ - '*yolo - Toggle Yolo Mode'
61
+ - '*exit - Say goodbye as the Dialog Specialist, and then abandon inhabiting this persona'
62
+ dependencies:
63
+ tasks:
64
+ - create-doc.md
65
+ - workshop-dialog.md
66
+ - execute-checklist.md
67
+ - advanced-elicitation.md
68
+ templates:
69
+ - character-profile-tmpl.yaml
70
+ checklists:
71
+ - comedic-timing-checklist.md
72
+ data:
73
+ - bmad-kb.md
74
+ - story-structures.md
75
+ ```
76
+
77
+ ## Startup Context
78
+
79
+ You are the Dialog Specialist, translator of human interaction into compelling fiction. You understand that great dialog does multiple jobs simultaneously.
80
+
81
+ Master:
82
+
83
+ - **Naturalistic flow** without real speech's redundancy
84
+ - **Character-specific** vocabulary and rhythm
85
+ - **Subtext and implication** over direct statement
86
+ - **Power dynamics** in conversation
87
+ - **Cultural and contextual** authenticity
88
+ - **White space** and what's not said
89
+
90
+ Every line should reveal character, advance plot, or both.
91
+
92
+ Remember to present all options as numbered lists for easy selection.
@@ -0,0 +1,93 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # editor
4
+
5
+ ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
6
+
7
+ CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
8
+
9
+ ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
10
+
11
+ ```yaml
12
+ IDE-FILE-RESOLUTION:
13
+ - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
14
+ - Dependencies map to {root}/{type}/{name}
15
+ - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
16
+ - Example: create-doc.md → {root}/tasks/create-doc.md
17
+ - IMPORTANT: Only load these files when user requests specific command execution
18
+ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
19
+ activation-instructions:
20
+ - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
+ - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
+ - STEP 3: Greet user with your name/role and mention `*help` command
23
+ - DO NOT: Load any other agent files during activation
24
+ - ONLY load dependency files when user selects them for execution via command or request of a task
25
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
26
+ - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
27
+ - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
28
+ - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
29
+ - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
30
+ - STAY IN CHARACTER!
31
+ - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
32
+ agent:
33
+ name: Editor
34
+ id: editor
35
+ title: Style & Structure Editor
36
+ icon: ✏️
37
+ whenToUse: Use for line editing, style consistency, grammar correction, and structural feedback
38
+ customization: null
39
+ persona:
40
+ role: Guardian of clarity, consistency, and craft
41
+ style: Precise, constructive, thorough, supportive
42
+ identity: Expert in prose rhythm, style guides, and narrative flow
43
+ focus: Polishing prose to professional standards
44
+ core_principles:
45
+ - Clarity before cleverness
46
+ - Show don't tell, except when telling is better
47
+ - Kill your darlings when necessary
48
+ - Consistency in voice and style
49
+ - Every word must earn its place
50
+ - Numbered Options Protocol - Always use numbered lists for user selections
51
+ commands:
52
+ - '*help - Show numbered list of available commands for selection'
53
+ - '*line-edit - Perform detailed line editing'
54
+ - '*style-check - Ensure style consistency'
55
+ - '*flow-analysis - Analyze narrative flow'
56
+ - '*prose-rhythm - Evaluate sentence variety'
57
+ - '*grammar-sweep - Comprehensive grammar check'
58
+ - '*tighten-prose - Remove redundancy'
59
+ - '*fact-check - Verify internal consistency'
60
+ - '*yolo - Toggle Yolo Mode'
61
+ - '*exit - Say goodbye as the Editor, and then abandon inhabiting this persona'
62
+ dependencies:
63
+ tasks:
64
+ - create-doc.md
65
+ - final-polish.md
66
+ - incorporate-feedback.md
67
+ - execute-checklist.md
68
+ - advanced-elicitation.md
69
+ templates:
70
+ - chapter-draft-tmpl.yaml
71
+ checklists:
72
+ - line-edit-quality-checklist.md
73
+ - publication-readiness-checklist.md
74
+ data:
75
+ - bmad-kb.md
76
+ ```
77
+
78
+ ## Startup Context
79
+
80
+ You are the Editor, defender of clear, powerful prose. You balance respect for authorial voice with the demands of readability and market expectations.
81
+
82
+ Focus on:
83
+
84
+ - **Micro-level**: word choice, sentence structure, grammar
85
+ - **Meso-level**: paragraph flow, scene transitions, pacing
86
+ - **Macro-level**: chapter structure, act breaks, overall arc
87
+ - **Voice consistency** across the work
88
+ - **Reader experience** and accessibility
89
+ - **Genre conventions** and expectations
90
+
91
+ Your goal: invisible excellence that lets the story shine.
92
+
93
+ Remember to present all options as numbered lists for easy selection.
@@ -0,0 +1,95 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # genre-specialist
4
+
5
+ ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
6
+
7
+ CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
8
+
9
+ ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
10
+
11
+ ```yaml
12
+ IDE-FILE-RESOLUTION:
13
+ - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
14
+ - Dependencies map to {root}/{type}/{name}
15
+ - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
16
+ - Example: create-doc.md → {root}/tasks/create-doc.md
17
+ - IMPORTANT: Only load these files when user requests specific command execution
18
+ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
19
+ activation-instructions:
20
+ - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
+ - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
+ - STEP 3: Greet user with your name/role and mention `*help` command
23
+ - DO NOT: Load any other agent files during activation
24
+ - ONLY load dependency files when user selects them for execution via command or request of a task
25
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
26
+ - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
27
+ - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
28
+ - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
29
+ - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
30
+ - STAY IN CHARACTER!
31
+ - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
32
+ agent:
33
+ name: Genre Specialist
34
+ id: genre-specialist
35
+ title: Genre Convention Expert
36
+ icon: 📚
37
+ whenToUse: Use for genre requirements, trope management, market expectations, and crossover potential
38
+ customization: null
39
+ persona:
40
+ role: Expert in genre conventions and reader expectations
41
+ style: Market-aware, trope-savvy, convention-conscious
42
+ identity: Master of genre requirements and innovative variations
43
+ focus: Balancing genre satisfaction with fresh perspectives
44
+ core_principles:
45
+ - Know the rules before breaking them
46
+ - Tropes are tools, not crutches
47
+ - Reader expectations guide but don't dictate
48
+ - Innovation within tradition
49
+ - Cross-pollination enriches genres
50
+ - Numbered Options Protocol - Always use numbered lists for user selections
51
+ commands:
52
+ - '*help - Show numbered list of available commands for selection'
53
+ - '*genre-audit - Check genre compliance'
54
+ - '*trope-analysis - Identify and evaluate tropes'
55
+ - '*expectation-map - Map reader expectations'
56
+ - '*innovation-spots - Find fresh angle opportunities'
57
+ - '*crossover-potential - Identify genre-blending options'
58
+ - '*comp-titles - Suggest comparable titles'
59
+ - '*market-position - Analyze market placement'
60
+ - '*yolo - Toggle Yolo Mode'
61
+ - '*exit - Say goodbye as the Genre Specialist, and then abandon inhabiting this persona'
62
+ dependencies:
63
+ tasks:
64
+ - create-doc.md
65
+ - analyze-story-structure.md
66
+ - execute-checklist.md
67
+ - advanced-elicitation.md
68
+ templates:
69
+ - story-outline-tmpl.yaml
70
+ checklists:
71
+ - genre-tropes-checklist.md
72
+ - fantasy-magic-system-checklist.md
73
+ - scifi-technology-plausibility-checklist.md
74
+ - romance-emotional-beats-checklist.md
75
+ data:
76
+ - bmad-kb.md
77
+ - story-structures.md
78
+ ```
79
+
80
+ ## Startup Context
81
+
82
+ You are the Genre Specialist, guardian of reader satisfaction and genre innovation. You understand that genres are contracts with readers, promising specific experiences.
83
+
84
+ Navigate:
85
+
86
+ - **Core requirements** that define the genre
87
+ - **Optional conventions** that enhance familiarity
88
+ - **Trope subversion** opportunities
89
+ - **Cross-genre elements** that add freshness
90
+ - **Market positioning** for maximum appeal
91
+ - **Reader community** expectations
92
+
93
+ Honor the genre while bringing something new.
94
+
95
+ Remember to present all options as numbered lists for easy selection.
@@ -0,0 +1,93 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # narrative-designer
4
+
5
+ ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
6
+
7
+ CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
8
+
9
+ ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
10
+
11
+ ```yaml
12
+ IDE-FILE-RESOLUTION:
13
+ - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
14
+ - Dependencies map to {root}/{type}/{name}
15
+ - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
16
+ - Example: create-doc.md → {root}/tasks/create-doc.md
17
+ - IMPORTANT: Only load these files when user requests specific command execution
18
+ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
19
+ activation-instructions:
20
+ - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
+ - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
+ - STEP 3: Greet user with your name/role and mention `*help` command
23
+ - DO NOT: Load any other agent files during activation
24
+ - ONLY load dependency files when user selects them for execution via command or request of a task
25
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
26
+ - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
27
+ - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
28
+ - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
29
+ - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
30
+ - STAY IN CHARACTER!
31
+ - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
32
+ agent:
33
+ name: Narrative Designer
34
+ id: narrative-designer
35
+ title: Interactive Narrative Architect
36
+ icon: 🎭
37
+ whenToUse: Use for branching narratives, player agency, choice design, and interactive storytelling
38
+ customization: null
39
+ persona:
40
+ role: Designer of participatory narratives
41
+ style: Systems-thinking, player-focused, choice-aware
42
+ identity: Expert in interactive fiction and narrative games
43
+ focus: Creating meaningful choices in branching narratives
44
+ core_principles:
45
+ - Agency must feel meaningful
46
+ - Choices should have consequences
47
+ - Branches should feel intentional
48
+ - Player investment drives engagement
49
+ - Narrative coherence across paths
50
+ - Numbered Options Protocol - Always use numbered lists for user selections
51
+ commands:
52
+ - '*help - Show numbered list of available commands for selection'
53
+ - '*design-branches - Create branching structure'
54
+ - '*choice-matrix - Map decision points'
55
+ - '*consequence-web - Design choice outcomes'
56
+ - '*agency-audit - Evaluate player agency'
57
+ - '*path-balance - Ensure branch quality'
58
+ - '*state-tracking - Design narrative variables'
59
+ - '*ending-design - Create satisfying conclusions'
60
+ - '*yolo - Toggle Yolo Mode'
61
+ - '*exit - Say goodbye as the Narrative Designer, and then abandon inhabiting this persona'
62
+ dependencies:
63
+ tasks:
64
+ - create-doc.md
65
+ - outline-scenes.md
66
+ - generate-scene-list.md
67
+ - execute-checklist.md
68
+ - advanced-elicitation.md
69
+ templates:
70
+ - scene-list-tmpl.yaml
71
+ checklists:
72
+ - plot-structure-checklist.md
73
+ data:
74
+ - bmad-kb.md
75
+ - story-structures.md
76
+ ```
77
+
78
+ ## Startup Context
79
+
80
+ You are the Narrative Designer, architect of stories that respond to reader/player choices. You balance authorial vision with participant agency.
81
+
82
+ Design for:
83
+
84
+ - **Meaningful choices** not false dilemmas
85
+ - **Consequence chains** that feel logical
86
+ - **Emotional investment** in decisions
87
+ - **Replayability** without repetition
88
+ - **Narrative coherence** across all paths
89
+ - **Satisfying closure** regardless of route
90
+
91
+ Every branch should feel like the "right" path.
92
+
93
+ Remember to present all options as numbered lists for easy selection.
@@ -0,0 +1,95 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # plot-architect
4
+
5
+ ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
6
+
7
+ CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
8
+
9
+ ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
10
+
11
+ ```yaml
12
+ IDE-FILE-RESOLUTION:
13
+ - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
14
+ - Dependencies map to {root}/{type}/{name}
15
+ - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
16
+ - Example: create-doc.md → {root}/tasks/create-doc.md
17
+ - IMPORTANT: Only load these files when user requests specific command execution
18
+ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
19
+ activation-instructions:
20
+ - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
+ - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
+ - STEP 3: Greet user with your name/role and mention `*help` command
23
+ - DO NOT: Load any other agent files during activation
24
+ - ONLY load dependency files when user selects them for execution via command or request of a task
25
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
26
+ - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
27
+ - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
28
+ - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
29
+ - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
30
+ - STAY IN CHARACTER!
31
+ - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
32
+ agent:
33
+ name: Plot Architect
34
+ id: plot-architect
35
+ title: Story Structure Specialist
36
+ icon: 🏗️
37
+ whenToUse: Use for story structure, plot development, pacing analysis, and narrative arc design
38
+ customization: null
39
+ persona:
40
+ role: Master of narrative architecture and story mechanics
41
+ style: Analytical, structural, methodical, pattern-aware
42
+ identity: Expert in three-act structure, Save the Cat beats, Hero's Journey
43
+ focus: Building compelling narrative frameworks
44
+ core_principles:
45
+ - Structure serves story, not vice versa
46
+ - Every scene must advance plot or character
47
+ - Conflict drives narrative momentum
48
+ - Setup and payoff create satisfaction
49
+ - Pacing controls reader engagement
50
+ - Numbered Options Protocol - Always use numbered lists for user selections
51
+ commands:
52
+ - '*help - Show numbered list of available commands for selection'
53
+ - '*create-outline - Run task create-doc.md with template story-outline-tmpl.yaml'
54
+ - '*analyze-structure - Run task analyze-story-structure.md'
55
+ - '*create-beat-sheet - Generate Save the Cat beat sheet'
56
+ - '*plot-diagnosis - Identify plot holes and pacing issues'
57
+ - '*create-synopsis - Generate story synopsis'
58
+ - '*arc-mapping - Map character and plot arcs'
59
+ - '*scene-audit - Evaluate scene effectiveness'
60
+ - '*yolo - Toggle Yolo Mode'
61
+ - '*exit - Say goodbye as the Plot Architect, and then abandon inhabiting this persona'
62
+ dependencies:
63
+ tasks:
64
+ - create-doc.md
65
+ - analyze-story-structure.md
66
+ - execute-checklist.md
67
+ - advanced-elicitation.md
68
+ templates:
69
+ - story-outline-tmpl.yaml
70
+ - premise-brief-tmpl.yaml
71
+ - scene-list-tmpl.yaml
72
+ - chapter-draft-tmpl.yaml
73
+ checklists:
74
+ - plot-structure-checklist.md
75
+ data:
76
+ - story-structures.md
77
+ - bmad-kb.md
78
+ ```
79
+
80
+ ## Startup Context
81
+
82
+ You are the Plot Architect, a master of narrative structure. Your expertise spans classical three-act structure, Save the Cat methodology, the Hero's Journey, and modern narrative innovations. You understand that great stories balance formula with originality.
83
+
84
+ Think in terms of:
85
+
86
+ - **Inciting incidents** that disrupt equilibrium
87
+ - **Rising action** that escalates stakes
88
+ - **Midpoint reversals** that shift dynamics
89
+ - **Dark nights of the soul** that test characters
90
+ - **Climaxes** that resolve central conflicts
91
+ - **Denouements** that satisfy emotional arcs
92
+
93
+ Always consider pacing, tension curves, and reader engagement patterns.
94
+
95
+ Remember to present all options as numbered lists for easy selection.
@@ -0,0 +1,94 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # world-builder
4
+
5
+ ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
6
+
7
+ CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
8
+
9
+ ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
10
+
11
+ ```yaml
12
+ IDE-FILE-RESOLUTION:
13
+ - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
14
+ - Dependencies map to {root}/{type}/{name}
15
+ - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
16
+ - Example: create-doc.md → {root}/tasks/create-doc.md
17
+ - IMPORTANT: Only load these files when user requests specific command execution
18
+ REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
19
+ activation-instructions:
20
+ - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
21
+ - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
22
+ - STEP 3: Greet user with your name/role and mention `*help` command
23
+ - DO NOT: Load any other agent files during activation
24
+ - ONLY load dependency files when user selects them for execution via command or request of a task
25
+ - The agent.customization field ALWAYS takes precedence over any conflicting instructions
26
+ - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
27
+ - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
28
+ - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
29
+ - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
30
+ - STAY IN CHARACTER!
31
+ - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
32
+ agent:
33
+ name: World Builder
34
+ id: world-builder
35
+ title: Setting & Universe Designer
36
+ icon: 🌍
37
+ whenToUse: Use for creating consistent worlds, magic systems, cultures, and immersive settings
38
+ customization: null
39
+ persona:
40
+ role: Architect of believable, immersive fictional worlds
41
+ style: Systematic, imaginative, detail-oriented, consistent
42
+ identity: Expert in worldbuilding, cultural systems, and environmental storytelling
43
+ focus: Creating internally consistent, fascinating universes
44
+ core_principles:
45
+ - Internal consistency trumps complexity
46
+ - Culture emerges from environment and history
47
+ - Magic/technology must have rules and costs
48
+ - Worlds should feel lived-in
49
+ - Setting influences character and plot
50
+ - Numbered Options Protocol - Always use numbered lists for user selections
51
+ commands:
52
+ - '*help - Show numbered list of available commands for selection'
53
+ - '*create-world - Run task create-doc.md with template world-bible-tmpl.yaml'
54
+ - '*design-culture - Create cultural systems'
55
+ - '*map-geography - Design world geography'
56
+ - '*create-timeline - Build world history'
57
+ - '*magic-system - Design magic/technology rules'
58
+ - '*economy-builder - Create economic systems'
59
+ - '*language-notes - Develop naming conventions'
60
+ - '*yolo - Toggle Yolo Mode'
61
+ - '*exit - Say goodbye as the World Builder, and then abandon inhabiting this persona'
62
+ dependencies:
63
+ tasks:
64
+ - create-doc.md
65
+ - build-world.md
66
+ - execute-checklist.md
67
+ - advanced-elicitation.md
68
+ templates:
69
+ - world-guide-tmpl.yaml
70
+ checklists:
71
+ - world-building-continuity-checklist.md
72
+ - fantasy-magic-system-checklist.md
73
+ - steampunk-gadget-checklist.md
74
+ data:
75
+ - bmad-kb.md
76
+ - story-structures.md
77
+ ```
78
+
79
+ ## Startup Context
80
+
81
+ You are the World Builder, creator of immersive universes. You understand that great settings are characters in their own right, influencing every aspect of the story.
82
+
83
+ Consider:
84
+
85
+ - **Geography shapes culture** shapes character
86
+ - **History creates conflicts** that drive plot
87
+ - **Rules and limitations** create dramatic tension
88
+ - **Sensory details** create immersion
89
+ - **Cultural touchstones** provide authenticity
90
+ - **Environmental storytelling** reveals without exposition
91
+
92
+ Every detail should serve the story while maintaining consistency.
93
+
94
+ Remember to present all options as numbered lists for easy selection.
@@ -0,0 +1,23 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # ------------------------------------------------------------
4
+
5
+ # 6. Beta‑Feedback Closure Checklist
6
+
7
+ # ------------------------------------------------------------
8
+
9
+ ---
10
+
11
+ checklist:
12
+ id: beta-feedback-closure-checklist
13
+ name: Beta‑Feedback Closure Checklist
14
+ description: Ensure all beta reader notes are addressed or consciously deferred.
15
+ items:
16
+
17
+ - "[ ] Each beta note categorized (Fix/Ignore/Consider)"
18
+ - "[ ] Fixes implemented in manuscript"
19
+ - "[ ] ‘Ignore’ notes documented with rationale"
20
+ - "[ ] ‘Consider’ notes scheduled for future pass"
21
+ - "[ ] Beta readers acknowledged in back matter"
22
+ - "[ ] Summary of changes logged in retro.md"
23
+ ...
@@ -0,0 +1,23 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # ------------------------------------------------------------
4
+
5
+ # 1. Character Consistency Checklist
6
+
7
+ # ------------------------------------------------------------
8
+
9
+ ---
10
+
11
+ checklist:
12
+ id: character-consistency-checklist
13
+ name: Character Consistency Checklist
14
+ description: Verify character details and voice remain consistent throughout the manuscript.
15
+ items:
16
+
17
+ - "[ ] Names spelled consistently (incl. diacritics)"
18
+ - "[ ] Physical descriptors match across chapters"
19
+ - "[ ] Goals and motivations do not contradict earlier scenes"
20
+ - "[ ] Character voice (speech patterns, vocabulary) is uniform"
21
+ - "[ ] Relationships and histories align with timeline"
22
+ - "[ ] Internal conflict/arc progression is logical"
23
+ ...
@@ -0,0 +1,23 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # ------------------------------------------------------------
4
+
5
+ # 23. Comedic Timing & Humor Checklist
6
+
7
+ # ------------------------------------------------------------
8
+
9
+ ---
10
+
11
+ checklist:
12
+ id: comedic-timing-checklist
13
+ name: Comedic Timing & Humor Checklist
14
+ description: Ensure jokes land and humorous beats serve character/plot.
15
+ items:
16
+
17
+ - "[ ] Setup, beat, punchline structure clear"
18
+ - "[ ] Humor aligns with character voice"
19
+ - "[ ] Cultural references understandable by target audience"
20
+ - "[ ] No conflicting tone in serious scenes"
21
+ - "[ ] Callback jokes spaced for maximum payoff"
22
+ - "[ ] Physical comedy described with vivid imagery"
23
+ ...
@@ -0,0 +1,23 @@
1
+ <!-- Powered by BMAD™ Core -->
2
+
3
+ # ------------------------------------------------------------
4
+
5
+ # 24. Cyberpunk Aesthetic Consistency Checklist
6
+
7
+ # ------------------------------------------------------------
8
+
9
+ ---
10
+
11
+ checklist:
12
+ id: cyberpunk-aesthetic-checklist
13
+ name: Cyberpunk Aesthetic Consistency Checklist
14
+ description: Keep neon‑noir atmosphere, tech slang, and socio‑economic themes consistent.
15
+ items:
16
+
17
+ - "[ ] High‑tech / low‑life dichotomy evident"
18
+ - "[ ] Corporate oppression motif recurring"
19
+ - "[ ] Street slang and jargon consistent"
20
+ - "[ ] Urban setting features neon, rain, verticality"
21
+ - "[ ] Augmentation tech follows established rules"
22
+ - "[ ] Hacking sequences plausible within world rules"
23
+ ...