bmad-method 6.0.0-alpha.2 → 6.0.0-alpha.4

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 (521) hide show
  1. package/.claude/commands/bmad/bmm/agents/analyst.md +67 -0
  2. package/.claude/commands/bmad/bmm/agents/architect.md +73 -0
  3. package/.claude/commands/bmad/bmm/agents/dev.md +69 -0
  4. package/.claude/commands/bmad/bmm/agents/paige.md +82 -0
  5. package/.claude/commands/bmad/bmm/agents/pm.md +76 -0
  6. package/.claude/commands/bmad/bmm/agents/sm.md +85 -0
  7. package/.claude/commands/bmad/bmm/agents/tea.md +72 -0
  8. package/.claude/commands/bmad/bmm/agents/ux-designer.md +71 -0
  9. package/.claude/commands/bmad/bmm/workflows/README.md +132 -0
  10. package/.claude/commands/bmad/bmm/workflows/architecture.md +15 -0
  11. package/.claude/commands/bmad/bmm/workflows/brainstorm-project.md +15 -0
  12. package/.claude/commands/bmad/bmm/workflows/code-review.md +15 -0
  13. package/.claude/commands/bmad/bmm/workflows/correct-course.md +15 -0
  14. package/.claude/commands/bmad/bmm/workflows/create-epics-and-stories.md +15 -0
  15. package/.claude/commands/bmad/bmm/workflows/create-story.md +15 -0
  16. package/.claude/commands/bmad/bmm/workflows/create-ux-design.md +15 -0
  17. package/.claude/commands/bmad/bmm/workflows/dev-story.md +15 -0
  18. package/.claude/commands/bmad/bmm/workflows/document-project.md +15 -0
  19. package/.claude/commands/bmad/bmm/workflows/narrative.md +15 -0
  20. package/.claude/commands/bmad/bmm/workflows/prd.md +15 -0
  21. package/.claude/commands/bmad/bmm/workflows/product-brief.md +15 -0
  22. package/.claude/commands/bmad/bmm/workflows/research.md +15 -0
  23. package/.claude/commands/bmad/bmm/workflows/retrospective.md +15 -0
  24. package/.claude/commands/bmad/bmm/workflows/solutioning-gate-check.md +15 -0
  25. package/.claude/commands/bmad/bmm/workflows/sprint-planning.md +15 -0
  26. package/.claude/commands/bmad/bmm/workflows/story-context.md +15 -0
  27. package/.claude/commands/bmad/bmm/workflows/story-done.md +15 -0
  28. package/.claude/commands/bmad/bmm/workflows/story-ready.md +15 -0
  29. package/.claude/commands/bmad/bmm/workflows/tech-spec-sm.md +15 -0
  30. package/.claude/commands/bmad/bmm/workflows/tech-spec.md +15 -0
  31. package/.claude/commands/bmad/bmm/workflows/workflow-init.md +15 -0
  32. package/.claude/commands/bmad/bmm/workflows/workflow-status.md +15 -0
  33. package/.claude/commands/bmad/cis/agents/README.md +104 -0
  34. package/.claude/commands/bmad/cis/agents/brainstorming-coach.md +62 -0
  35. package/.claude/commands/bmad/cis/agents/creative-problem-solver.md +62 -0
  36. package/.claude/commands/bmad/cis/agents/design-thinking-coach.md +62 -0
  37. package/.claude/commands/bmad/cis/agents/innovation-strategist.md +62 -0
  38. package/.claude/commands/bmad/cis/agents/storyteller.md +59 -0
  39. package/.claude/commands/bmad/cis/workflows/README.md +37 -0
  40. package/.claude/commands/bmad/cis/workflows/design-thinking.md +15 -0
  41. package/.claude/commands/bmad/cis/workflows/innovation-strategy.md +15 -0
  42. package/.claude/commands/bmad/cis/workflows/problem-solving.md +15 -0
  43. package/.claude/commands/bmad/cis/workflows/storytelling.md +15 -0
  44. package/.claude/settings.local.json +10 -31
  45. package/CHANGELOG.md +239 -0
  46. package/README.md +210 -146
  47. package/bmad/_cfg/agent-manifest.csv +13 -4
  48. package/bmad/_cfg/agents/bmm-dev.customize.yaml +42 -0
  49. package/bmad/_cfg/agents/bmm-paige.customize.yaml +42 -0
  50. package/bmad/_cfg/agents/bmm-pm.customize.yaml +42 -0
  51. package/bmad/_cfg/agents/bmm-sm.customize.yaml +42 -0
  52. package/bmad/_cfg/agents/bmm-tea.customize.yaml +42 -0
  53. package/bmad/_cfg/agents/bmm-ux-designer.customize.yaml +42 -0
  54. package/bmad/_cfg/agents/cis-brainstorming-coach.customize.yaml +42 -0
  55. package/bmad/_cfg/agents/cis-creative-problem-solver.customize.yaml +42 -0
  56. package/bmad/_cfg/agents/cis-design-thinking-coach.customize.yaml +42 -0
  57. package/bmad/_cfg/agents/cis-innovation-strategist.customize.yaml +42 -0
  58. package/bmad/_cfg/agents/cis-storyteller.customize.yaml +42 -0
  59. package/bmad/_cfg/files-manifest.csv +289 -22
  60. package/bmad/_cfg/ides/claude-code.yaml +6 -0
  61. package/bmad/_cfg/manifest.yaml +5 -6
  62. package/bmad/_cfg/task-manifest.csv +2 -0
  63. package/bmad/_cfg/workflow-manifest.csv +35 -2
  64. package/bmad/bmb/README.md +135 -73
  65. package/bmad/bmb/agents/bmad-builder.md.bak +70 -0
  66. package/bmad/bmb/config.yaml +2 -2
  67. package/bmad/bmb/workflows/audit-workflow/workflow.yaml.bak +3 -1
  68. package/bmad/bmb/workflows/create-agent/README.md +126 -243
  69. package/bmad/bmb/workflows/create-agent/instructions.md +25 -12
  70. package/bmad/bmb/workflows/create-module/README.md +163 -154
  71. package/bmad/bmb/workflows/create-module/workflow.yaml.bak +2 -0
  72. package/bmad/bmb/workflows/create-workflow/instructions.md +16 -8
  73. package/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md +158 -0
  74. package/bmad/bmb/workflows/create-workflow/workflow.yaml.bak +2 -0
  75. package/bmad/bmb/workflows/edit-agent/workflow.yaml.bak +33 -0
  76. package/bmad/bmb/workflows/edit-module/workflow.yaml.bak +34 -0
  77. package/bmad/bmb/workflows/edit-workflow/workflow.yaml.bak +2 -0
  78. package/bmad/bmb/workflows/module-brief/workflow.yaml.bak +2 -0
  79. package/bmad/bmb/workflows/redoc/workflow.yaml.bak +1 -0
  80. package/bmad/bmm/README.md +169 -0
  81. package/bmad/bmm/agents/analyst.md +67 -0
  82. package/bmad/bmm/agents/architect.md +73 -0
  83. package/bmad/bmm/agents/dev.md +69 -0
  84. package/bmad/bmm/agents/paige.md +82 -0
  85. package/bmad/bmm/agents/pm.md +76 -0
  86. package/bmad/bmm/agents/sm.md +85 -0
  87. package/bmad/bmm/agents/tea.md +72 -0
  88. package/bmad/bmm/agents/ux-designer.md +71 -0
  89. package/bmad/bmm/config.yaml +17 -0
  90. package/bmad/bmm/docs/quick-spec-flow.md +645 -0
  91. package/bmad/bmm/docs/quick-start.md +341 -0
  92. package/bmad/bmm/docs/scale-adaptive-system.md +1045 -0
  93. package/bmad/bmm/tasks/daily-standup.xml +85 -0
  94. package/bmad/bmm/teams/team-fullstack.yaml +11 -0
  95. package/bmad/bmm/teams/team-gamedev.yaml +14 -0
  96. package/bmad/bmm/testarch/knowledge/ci-burn-in.md +675 -0
  97. package/bmad/bmm/testarch/knowledge/component-tdd.md +486 -0
  98. package/bmad/bmm/testarch/knowledge/contract-testing.md +957 -0
  99. package/bmad/bmm/testarch/knowledge/data-factories.md +500 -0
  100. package/bmad/bmm/testarch/knowledge/email-auth.md +721 -0
  101. package/bmad/bmm/testarch/knowledge/error-handling.md +725 -0
  102. package/bmad/bmm/testarch/knowledge/feature-flags.md +750 -0
  103. package/bmad/bmm/testarch/knowledge/fixture-architecture.md +401 -0
  104. package/bmad/bmm/testarch/knowledge/network-first.md +486 -0
  105. package/bmad/bmm/testarch/knowledge/nfr-criteria.md +670 -0
  106. package/bmad/bmm/testarch/knowledge/playwright-config.md +730 -0
  107. package/bmad/bmm/testarch/knowledge/probability-impact.md +601 -0
  108. package/bmad/bmm/testarch/knowledge/risk-governance.md +615 -0
  109. package/bmad/bmm/testarch/knowledge/selective-testing.md +732 -0
  110. package/bmad/bmm/testarch/knowledge/selector-resilience.md +527 -0
  111. package/bmad/bmm/testarch/knowledge/test-healing-patterns.md +644 -0
  112. package/bmad/bmm/testarch/knowledge/test-levels-framework.md +473 -0
  113. package/bmad/bmm/testarch/knowledge/test-priorities-matrix.md +373 -0
  114. package/bmad/bmm/testarch/knowledge/test-quality.md +664 -0
  115. package/bmad/bmm/testarch/knowledge/timing-debugging.md +372 -0
  116. package/bmad/bmm/testarch/knowledge/visual-debugging.md +524 -0
  117. package/bmad/bmm/testarch/tea-index.csv +22 -0
  118. package/bmad/bmm/workflows/1-analysis/brainstorm-project/README.md +113 -0
  119. package/bmad/bmm/workflows/1-analysis/brainstorm-project/instructions.md +110 -0
  120. package/bmad/bmm/workflows/1-analysis/brainstorm-project/project-context.md +25 -0
  121. package/bmad/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml +26 -0
  122. package/bmad/bmm/workflows/1-analysis/domain-research/instructions.md +423 -0
  123. package/bmad/bmm/workflows/1-analysis/domain-research/template.md +180 -0
  124. package/bmad/bmm/workflows/1-analysis/domain-research/workflow.yaml +36 -0
  125. package/bmad/bmm/workflows/1-analysis/product-brief/checklist.md +115 -0
  126. package/bmad/bmm/workflows/1-analysis/product-brief/instructions.md +524 -0
  127. package/bmad/bmm/workflows/1-analysis/product-brief/template.md +181 -0
  128. package/bmad/bmm/workflows/1-analysis/product-brief/workflow.yaml +45 -0
  129. package/bmad/bmm/workflows/1-analysis/research/checklist-deep-prompt.md +144 -0
  130. package/bmad/bmm/workflows/1-analysis/research/checklist-technical.md +249 -0
  131. package/bmad/bmm/workflows/1-analysis/research/checklist.md +299 -0
  132. package/bmad/bmm/workflows/1-analysis/research/claude-code/injections.yaml +114 -0
  133. package/bmad/bmm/workflows/1-analysis/research/instructions-deep-prompt.md +439 -0
  134. package/bmad/bmm/workflows/1-analysis/research/instructions-market.md +679 -0
  135. package/bmad/bmm/workflows/1-analysis/research/instructions-router.md +133 -0
  136. package/bmad/bmm/workflows/1-analysis/research/instructions-technical.md +538 -0
  137. package/bmad/bmm/workflows/1-analysis/research/template-deep-prompt.md +94 -0
  138. package/bmad/bmm/workflows/1-analysis/research/template-market.md +347 -0
  139. package/bmad/bmm/workflows/1-analysis/research/template-technical.md +245 -0
  140. package/bmad/bmm/workflows/1-analysis/research/workflow.yaml +44 -0
  141. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/checklist.md +310 -0
  142. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +1319 -0
  143. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +145 -0
  144. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml +64 -0
  145. package/bmad/bmm/workflows/2-plan-workflows/narrative/checklist.md +139 -0
  146. package/bmad/bmm/workflows/2-plan-workflows/narrative/instructions-narrative.md +608 -0
  147. package/bmad/bmm/workflows/2-plan-workflows/narrative/narrative-template.md +195 -0
  148. package/bmad/bmm/workflows/2-plan-workflows/narrative/workflow.yaml +29 -0
  149. package/bmad/bmm/workflows/2-plan-workflows/prd/checklist.md +349 -0
  150. package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md +395 -0
  151. package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml +33 -0
  152. package/bmad/bmm/workflows/2-plan-workflows/prd/domain-complexity.csv +13 -0
  153. package/bmad/bmm/workflows/2-plan-workflows/prd/instructions.md +423 -0
  154. package/bmad/bmm/workflows/2-plan-workflows/prd/prd-template.md +237 -0
  155. package/bmad/bmm/workflows/2-plan-workflows/prd/project-types.csv +11 -0
  156. package/bmad/bmm/workflows/2-plan-workflows/prd/workflow.yaml +46 -0
  157. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/checklist.md +214 -0
  158. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +58 -0
  159. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions-level0-story.md +200 -0
  160. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions-level1-stories.md +451 -0
  161. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +1133 -0
  162. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/tech-spec-template.md +181 -0
  163. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +87 -0
  164. package/bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +60 -0
  165. package/bmad/bmm/workflows/3-solutioning/architecture/architecture-patterns.yaml +347 -0
  166. package/bmad/bmm/workflows/3-solutioning/architecture/architecture-template.md +103 -0
  167. package/bmad/bmm/workflows/3-solutioning/architecture/checklist.md +244 -0
  168. package/bmad/bmm/workflows/3-solutioning/architecture/decision-catalog.yaml +222 -0
  169. package/bmad/bmm/workflows/3-solutioning/architecture/instructions.md +715 -0
  170. package/bmad/bmm/workflows/3-solutioning/architecture/pattern-categories.csv +13 -0
  171. package/bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml +67 -0
  172. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/checklist.md +175 -0
  173. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/instructions.md +322 -0
  174. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/template.md +146 -0
  175. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/validation-criteria.yaml +189 -0
  176. package/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml +64 -0
  177. package/bmad/bmm/workflows/4-implementation/code-review/backlog_template.md +12 -0
  178. package/bmad/bmm/workflows/4-implementation/code-review/checklist.md +22 -0
  179. package/bmad/bmm/workflows/4-implementation/code-review/instructions.md +420 -0
  180. package/bmad/bmm/workflows/4-implementation/code-review/workflow.yaml +74 -0
  181. package/bmad/bmm/workflows/4-implementation/correct-course/checklist.md +279 -0
  182. package/bmad/bmm/workflows/4-implementation/correct-course/instructions.md +201 -0
  183. package/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml +43 -0
  184. package/bmad/bmm/workflows/4-implementation/create-story/README.md +146 -0
  185. package/bmad/bmm/workflows/4-implementation/create-story/checklist.md +240 -0
  186. package/bmad/bmm/workflows/4-implementation/create-story/instructions.md +283 -0
  187. package/bmad/bmm/workflows/4-implementation/create-story/template.md +51 -0
  188. package/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml +74 -0
  189. package/bmad/bmm/workflows/4-implementation/dev-story/AUDIT-REPORT.md +367 -0
  190. package/bmad/bmm/workflows/4-implementation/dev-story/checklist.md +38 -0
  191. package/bmad/bmm/workflows/4-implementation/dev-story/instructions.md +262 -0
  192. package/bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml +26 -0
  193. package/bmad/bmm/workflows/4-implementation/epic-tech-context/checklist.md +17 -0
  194. package/bmad/bmm/workflows/4-implementation/epic-tech-context/instructions.md +189 -0
  195. package/bmad/bmm/workflows/4-implementation/epic-tech-context/template.md +76 -0
  196. package/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +58 -0
  197. package/bmad/bmm/workflows/4-implementation/retrospective/instructions.md +1460 -0
  198. package/bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml +71 -0
  199. package/bmad/bmm/workflows/4-implementation/sprint-planning/checklist.md +33 -0
  200. package/bmad/bmm/workflows/4-implementation/sprint-planning/instructions.md +238 -0
  201. package/bmad/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +55 -0
  202. package/bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +47 -0
  203. package/bmad/bmm/workflows/4-implementation/story-context/checklist.md +16 -0
  204. package/bmad/bmm/workflows/4-implementation/story-context/context-template.xml +34 -0
  205. package/bmad/bmm/workflows/4-implementation/story-context/instructions.md +234 -0
  206. package/bmad/bmm/workflows/4-implementation/story-context/workflow.yaml +57 -0
  207. package/bmad/bmm/workflows/4-implementation/story-done/instructions.md +111 -0
  208. package/bmad/bmm/workflows/4-implementation/story-done/workflow.yaml +25 -0
  209. package/bmad/bmm/workflows/4-implementation/story-ready/instructions.md +117 -0
  210. package/bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml +25 -0
  211. package/bmad/bmm/workflows/README.md +256 -0
  212. package/bmad/bmm/workflows/document-project/checklist.md +245 -0
  213. package/bmad/bmm/workflows/document-project/documentation-requirements.csv +12 -0
  214. package/bmad/bmm/workflows/document-project/instructions.md +222 -0
  215. package/bmad/bmm/workflows/document-project/templates/deep-dive-template.md +345 -0
  216. package/bmad/bmm/workflows/document-project/templates/index-template.md +169 -0
  217. package/bmad/bmm/workflows/document-project/templates/project-overview-template.md +103 -0
  218. package/bmad/bmm/workflows/document-project/templates/project-scan-report-schema.json +160 -0
  219. package/bmad/bmm/workflows/document-project/templates/source-tree-template.md +135 -0
  220. package/bmad/bmm/workflows/document-project/workflow.yaml +34 -0
  221. package/bmad/bmm/workflows/document-project/workflows/deep-dive-instructions.md +298 -0
  222. package/bmad/bmm/workflows/document-project/workflows/deep-dive.yaml +31 -0
  223. package/bmad/bmm/workflows/document-project/workflows/full-scan-instructions.md +1106 -0
  224. package/bmad/bmm/workflows/document-project/workflows/full-scan.yaml +31 -0
  225. package/bmad/bmm/workflows/techdoc/documentation-standards.md +238 -0
  226. package/bmad/bmm/workflows/testarch/atdd/atdd-checklist-template.md +363 -0
  227. package/bmad/bmm/workflows/testarch/atdd/checklist.md +373 -0
  228. package/bmad/bmm/workflows/testarch/atdd/instructions.md +785 -0
  229. package/bmad/bmm/workflows/testarch/atdd/workflow.yaml +52 -0
  230. package/bmad/bmm/workflows/testarch/automate/checklist.md +580 -0
  231. package/bmad/bmm/workflows/testarch/automate/instructions.md +1303 -0
  232. package/bmad/bmm/workflows/testarch/automate/workflow.yaml +61 -0
  233. package/bmad/bmm/workflows/testarch/ci/checklist.md +246 -0
  234. package/bmad/bmm/workflows/testarch/ci/github-actions-template.yaml +165 -0
  235. package/bmad/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +128 -0
  236. package/bmad/bmm/workflows/testarch/ci/instructions.md +517 -0
  237. package/bmad/bmm/workflows/testarch/ci/workflow.yaml +53 -0
  238. package/bmad/bmm/workflows/testarch/framework/checklist.md +321 -0
  239. package/bmad/bmm/workflows/testarch/framework/instructions.md +455 -0
  240. package/bmad/bmm/workflows/testarch/framework/workflow.yaml +53 -0
  241. package/bmad/bmm/workflows/testarch/nfr-assess/checklist.md +405 -0
  242. package/bmad/bmm/workflows/testarch/nfr-assess/instructions.md +722 -0
  243. package/bmad/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +443 -0
  244. package/bmad/bmm/workflows/testarch/nfr-assess/workflow.yaml +56 -0
  245. package/bmad/bmm/workflows/testarch/test-design/checklist.md +234 -0
  246. package/bmad/bmm/workflows/testarch/test-design/instructions.md +621 -0
  247. package/bmad/bmm/workflows/testarch/test-design/test-design-template.md +285 -0
  248. package/bmad/bmm/workflows/testarch/test-design/workflow.yaml +52 -0
  249. package/bmad/bmm/workflows/testarch/test-review/checklist.md +470 -0
  250. package/bmad/bmm/workflows/testarch/test-review/instructions.md +608 -0
  251. package/bmad/bmm/workflows/testarch/test-review/test-review-template.md +388 -0
  252. package/bmad/bmm/workflows/testarch/test-review/workflow.yaml +53 -0
  253. package/bmad/bmm/workflows/testarch/trace/checklist.md +654 -0
  254. package/bmad/bmm/workflows/testarch/trace/instructions.md +1045 -0
  255. package/bmad/bmm/workflows/testarch/trace/trace-template.md +673 -0
  256. package/bmad/bmm/workflows/testarch/trace/workflow.yaml +66 -0
  257. package/{src/modules → bmad}/bmm/workflows/workflow-status/README.md +38 -19
  258. package/bmad/bmm/workflows/workflow-status/init/instructions.md +390 -0
  259. package/bmad/bmm/workflows/workflow-status/init/workflow.yaml +27 -0
  260. package/bmad/bmm/workflows/workflow-status/instructions.md +386 -0
  261. package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-0.yaml +54 -0
  262. package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-1.yaml +58 -0
  263. package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-2.yaml +76 -0
  264. package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-3.yaml +95 -0
  265. package/bmad/bmm/workflows/workflow-status/paths/brownfield-level-4.yaml +88 -0
  266. package/bmad/bmm/workflows/workflow-status/paths/game-design.yaml +75 -0
  267. package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-0.yaml +45 -0
  268. package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-1.yaml +49 -0
  269. package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-2.yaml +78 -0
  270. package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-3.yaml +73 -0
  271. package/bmad/bmm/workflows/workflow-status/paths/greenfield-level-4.yaml +75 -0
  272. package/bmad/bmm/workflows/workflow-status/project-levels.yaml +59 -0
  273. package/bmad/bmm/workflows/workflow-status/sample-level-3-workflow.yaml +49 -0
  274. package/bmad/bmm/workflows/workflow-status/workflow-status-template.yaml +31 -0
  275. package/bmad/bmm/workflows/workflow-status/workflow.yaml +28 -0
  276. package/bmad/cis/README.md +153 -0
  277. package/bmad/cis/agents/README.md +104 -0
  278. package/bmad/cis/agents/brainstorming-coach.md +62 -0
  279. package/bmad/cis/agents/creative-problem-solver.md +62 -0
  280. package/bmad/cis/agents/design-thinking-coach.md +62 -0
  281. package/bmad/cis/agents/innovation-strategist.md +62 -0
  282. package/bmad/cis/agents/storyteller.md +59 -0
  283. package/bmad/{bmd → cis}/config.yaml +3 -3
  284. package/bmad/cis/teams/creative-squad.yaml +6 -0
  285. package/bmad/cis/workflows/README.md +139 -0
  286. package/bmad/cis/workflows/design-thinking/README.md +56 -0
  287. package/bmad/cis/workflows/design-thinking/design-methods.csv +31 -0
  288. package/bmad/cis/workflows/design-thinking/instructions.md +200 -0
  289. package/bmad/cis/workflows/design-thinking/template.md +111 -0
  290. package/bmad/cis/workflows/design-thinking/workflow.yaml +32 -0
  291. package/bmad/cis/workflows/innovation-strategy/README.md +56 -0
  292. package/bmad/cis/workflows/innovation-strategy/innovation-frameworks.csv +31 -0
  293. package/bmad/cis/workflows/innovation-strategy/instructions.md +274 -0
  294. package/bmad/cis/workflows/innovation-strategy/template.md +189 -0
  295. package/bmad/cis/workflows/innovation-strategy/workflow.yaml +32 -0
  296. package/bmad/cis/workflows/problem-solving/README.md +56 -0
  297. package/bmad/cis/workflows/problem-solving/instructions.md +250 -0
  298. package/bmad/cis/workflows/problem-solving/solving-methods.csv +31 -0
  299. package/bmad/cis/workflows/problem-solving/template.md +165 -0
  300. package/bmad/cis/workflows/problem-solving/workflow.yaml +32 -0
  301. package/bmad/cis/workflows/storytelling/README.md +58 -0
  302. package/bmad/cis/workflows/storytelling/instructions.md +291 -0
  303. package/bmad/cis/workflows/storytelling/story-types.csv +26 -0
  304. package/bmad/cis/workflows/storytelling/template.md +113 -0
  305. package/bmad/cis/workflows/storytelling/workflow.yaml +32 -0
  306. package/bmad/core/agents/bmad-master.md.bak +69 -0
  307. package/bmad/core/config.yaml +2 -2
  308. package/bmad/core/tasks/workflow.xml +0 -8
  309. package/bmad/core/tools/shard-doc.xml +8 -43
  310. package/docs/document-sharding-guide.md +447 -0
  311. package/docs/index.md +225 -0
  312. package/docs/v4-to-v6-upgrade.md +9 -7
  313. package/package.json +1 -1
  314. package/src/core/tools/shard-doc.xml +8 -43
  315. package/src/modules/bmb/README.md +135 -73
  316. package/src/modules/bmb/workflows/create-agent/README.md +126 -243
  317. package/src/modules/bmb/workflows/create-agent/instructions.md +25 -12
  318. package/src/modules/bmb/workflows/create-module/README.md +163 -154
  319. package/src/modules/bmb/workflows/create-workflow/instructions.md +16 -8
  320. package/src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md +158 -0
  321. package/src/modules/bmm/README.md +79 -92
  322. package/src/modules/bmm/agents/game-designer.agent.yaml +2 -2
  323. package/src/modules/bmm/agents/paige.agent.yaml +69 -0
  324. package/src/modules/bmm/agents/pm.agent.yaml +11 -1
  325. package/src/modules/bmm/docs/README.md +235 -0
  326. package/src/modules/bmm/docs/agents-guide.md +1109 -0
  327. package/src/modules/bmm/docs/brownfield-guide.md +638 -0
  328. package/src/modules/bmm/docs/brownfield-guide.md.backup +1324 -0
  329. package/src/modules/bmm/docs/enterprise-agentic-development.md +1040 -0
  330. package/src/modules/bmm/docs/faq.md +589 -0
  331. package/src/modules/bmm/docs/glossary.md +327 -0
  332. package/src/modules/bmm/docs/party-mode.md +1236 -0
  333. package/src/modules/bmm/docs/quick-spec-flow.md +652 -0
  334. package/src/modules/bmm/docs/quick-start.md +366 -0
  335. package/src/modules/bmm/docs/scale-adaptive-system.md +749 -0
  336. package/src/modules/bmm/docs/troubleshooting.md +680 -0
  337. package/src/modules/bmm/docs/workflow-architecture-reference.md +371 -0
  338. package/src/modules/bmm/docs/workflow-document-project-reference.md +487 -0
  339. package/src/modules/bmm/docs/workflows-analysis.md +670 -0
  340. package/src/modules/bmm/docs/workflows-implementation.md +1759 -0
  341. package/src/modules/bmm/docs/workflows-planning.md +1086 -0
  342. package/src/modules/bmm/docs/workflows-solutioning.md +726 -0
  343. package/src/modules/bmm/docs/workflows-testing.md +1572 -0
  344. package/src/modules/bmm/workflows/1-analysis/brainstorm-game/instructions.md +45 -26
  345. package/src/modules/bmm/workflows/1-analysis/brainstorm-project/instructions.md +42 -23
  346. package/src/modules/bmm/workflows/1-analysis/domain-research/instructions.md +423 -0
  347. package/src/modules/bmm/workflows/1-analysis/domain-research/template.md +180 -0
  348. package/src/modules/bmm/workflows/1-analysis/domain-research/workflow.yaml +36 -0
  349. package/src/modules/bmm/workflows/1-analysis/game-brief/instructions.md +42 -28
  350. package/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md +434 -231
  351. package/src/modules/bmm/workflows/1-analysis/product-brief/template.md +93 -77
  352. package/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml +14 -0
  353. package/src/modules/bmm/workflows/1-analysis/research/checklist-deep-prompt.md +144 -0
  354. package/src/modules/bmm/workflows/1-analysis/research/checklist-technical.md +249 -0
  355. package/src/modules/bmm/workflows/1-analysis/research/checklist.md +154 -57
  356. package/src/modules/bmm/workflows/1-analysis/research/instructions-deep-prompt.md +68 -62
  357. package/src/modules/bmm/workflows/1-analysis/research/instructions-market.md +203 -137
  358. package/src/modules/bmm/workflows/1-analysis/research/instructions-router.md +53 -45
  359. package/src/modules/bmm/workflows/1-analysis/research/instructions-technical.md +116 -79
  360. package/src/modules/bmm/workflows/1-analysis/research/template-market.md +37 -1
  361. package/src/modules/bmm/workflows/1-analysis/research/template-technical.md +36 -1
  362. package/src/modules/bmm/workflows/1-analysis/research/workflow.yaml +13 -0
  363. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +58 -22
  364. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml +22 -0
  365. package/src/modules/bmm/workflows/2-plan-workflows/gdd/instructions-gdd.md +52 -21
  366. package/src/modules/bmm/workflows/2-plan-workflows/gdd/workflow.yaml +14 -0
  367. package/src/modules/bmm/workflows/2-plan-workflows/narrative/instructions-narrative.md +73 -22
  368. package/src/modules/bmm/workflows/2-plan-workflows/prd/checklist.md +295 -63
  369. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md +63 -0
  370. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md +395 -0
  371. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml +43 -0
  372. package/src/modules/bmm/workflows/2-plan-workflows/prd/domain-complexity.csv +13 -0
  373. package/src/modules/bmm/workflows/2-plan-workflows/prd/instructions.md +295 -321
  374. package/src/modules/bmm/workflows/2-plan-workflows/prd/prd-template.md +198 -23
  375. package/src/modules/bmm/workflows/2-plan-workflows/prd/project-types.csv +11 -0
  376. package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml +24 -6
  377. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/checklist.md +138 -31
  378. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +51 -4
  379. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-level0-story.md +50 -17
  380. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-level1-stories.md +199 -26
  381. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +1005 -141
  382. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/tech-spec-template.md +132 -6
  383. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +36 -5
  384. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +21 -0
  385. package/src/modules/bmm/workflows/3-solutioning/architecture/architecture-template.md +1 -1
  386. package/src/modules/bmm/workflows/3-solutioning/architecture/instructions.md +91 -79
  387. package/src/modules/bmm/workflows/3-solutioning/architecture/workflow.yaml +17 -4
  388. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/instructions.md +94 -45
  389. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml +26 -0
  390. package/src/modules/bmm/workflows/4-implementation/code-review/instructions.md +29 -0
  391. package/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml +20 -0
  392. package/src/modules/bmm/workflows/4-implementation/create-story/instructions.md +31 -0
  393. package/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml +27 -0
  394. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/instructions.md +29 -0
  395. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +31 -5
  396. package/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md +1222 -241
  397. package/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml +28 -0
  398. package/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md +17 -0
  399. package/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +8 -0
  400. package/src/modules/bmm/workflows/4-implementation/story-context/instructions.md +34 -1
  401. package/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml +27 -0
  402. package/src/modules/bmm/workflows/techdoc/documentation-standards.md +239 -0
  403. package/src/modules/bmm/workflows/workflow-status/init/instructions.md +117 -24
  404. package/src/modules/bmm/workflows/workflow-status/init/workflow.yaml +2 -2
  405. package/src/modules/bmm/workflows/workflow-status/instructions.md +173 -111
  406. package/src/modules/bmm/workflows/workflow-status/sample-level-3-workflow.yaml +49 -0
  407. package/src/modules/bmm/workflows/workflow-status/workflow-status-template.yaml +31 -0
  408. package/src/modules/bmm/workflows/workflow-status/workflow.yaml +3 -3
  409. package/src/modules/cis/README.md +153 -0
  410. package/src/modules/cis/workflows/README.md +102 -30
  411. package/src/modules/cis/workflows/storytelling/instructions.md +10 -2
  412. package/tools/cli/commands/install.js +1 -1
  413. package/tools/cli/installers/lib/core/manifest-generator.js +4 -1
  414. package/.claude/commands/bmad/bmd/agents/cli-chief.md +0 -108
  415. package/.claude/commands/bmad/bmd/agents/doc-keeper.md +0 -115
  416. package/.claude/commands/bmad/bmd/agents/release-chief.md +0 -109
  417. package/.claude/hooks/bmad-tts-injector.sh +0 -415
  418. package/.claude/hooks/bmad-voice-manager.sh +0 -511
  419. package/.claude/hooks/check-output-style.sh +0 -112
  420. package/.claude/hooks/download-extra-voices.sh +0 -244
  421. package/.claude/hooks/github-star-reminder.sh +0 -154
  422. package/.claude/hooks/language-manager.sh +0 -392
  423. package/.claude/hooks/learn-manager.sh +0 -475
  424. package/.claude/hooks/personality-manager.sh +0 -438
  425. package/.claude/hooks/piper-download-voices.sh +0 -165
  426. package/.claude/hooks/piper-installer.sh +0 -178
  427. package/.claude/hooks/piper-multispeaker-registry.sh +0 -165
  428. package/.claude/hooks/piper-voice-manager.sh +0 -293
  429. package/.claude/hooks/play-tts-elevenlabs.sh +0 -404
  430. package/.claude/hooks/play-tts-piper.sh +0 -338
  431. package/.claude/hooks/play-tts.sh +0 -100
  432. package/.claude/hooks/provider-commands.sh +0 -540
  433. package/.claude/hooks/provider-manager.sh +0 -298
  434. package/.claude/hooks/replay-target-audio.sh +0 -95
  435. package/.claude/hooks/sentiment-manager.sh +0 -201
  436. package/.claude/hooks/speed-manager.sh +0 -291
  437. package/.claude/hooks/voice-manager.sh +0 -594
  438. package/.claude/hooks/voices-config.sh +0 -70
  439. package/bmad/_cfg/agents/bmd-cli-chief.customize.yaml +0 -32
  440. package/bmad/bmb/workflows/create-agent/agent-architecture.md.bak +0 -412
  441. package/bmad/bmb/workflows/create-agent/agent-command-patterns.md.bak +0 -759
  442. package/bmad/bmb/workflows/create-module/README.md.bak +0 -218
  443. package/bmad/bmb/workflows/create-module/checklist.md.bak +0 -245
  444. package/bmad/bmb/workflows/create-module/installer-templates/installer.js.bak +0 -231
  445. package/bmad/bmb/workflows/create-module/instructions.md.bak +0 -521
  446. package/bmad/bmb/workflows/create-module/module-structure.md.bak +0 -310
  447. package/bmad/bmd/README.md +0 -193
  448. package/bmad/bmd/README.md.bak +0 -193
  449. package/bmad/bmd/agents/cli-chief-sidecar/instructions.md +0 -102
  450. package/bmad/bmd/agents/cli-chief-sidecar/instructions.md.bak +0 -102
  451. package/bmad/bmd/agents/cli-chief-sidecar/knowledge/README.md +0 -68
  452. package/bmad/bmd/agents/cli-chief-sidecar/knowledge/README.md.bak +0 -68
  453. package/bmad/bmd/agents/cli-chief-sidecar/knowledge/cli-reference.md +0 -123
  454. package/bmad/bmd/agents/cli-chief-sidecar/knowledge/cli-reference.md.bak +0 -123
  455. package/bmad/bmd/agents/cli-chief-sidecar/memories.md +0 -53
  456. package/bmad/bmd/agents/cli-chief-sidecar/memories.md.bak +0 -53
  457. package/bmad/bmd/agents/cli-chief.md +0 -108
  458. package/bmad/bmd/agents/cli-chief.md.bak +0 -108
  459. package/bmad/bmd/agents/doc-keeper-sidecar/instructions.md +0 -177
  460. package/bmad/bmd/agents/doc-keeper-sidecar/instructions.md.bak +0 -177
  461. package/bmad/bmd/agents/doc-keeper-sidecar/knowledge/README.md +0 -81
  462. package/bmad/bmd/agents/doc-keeper-sidecar/knowledge/README.md.bak +0 -81
  463. package/bmad/bmd/agents/doc-keeper-sidecar/memories.md +0 -88
  464. package/bmad/bmd/agents/doc-keeper-sidecar/memories.md.bak +0 -88
  465. package/bmad/bmd/agents/doc-keeper.md +0 -115
  466. package/bmad/bmd/agents/doc-keeper.md.bak +0 -115
  467. package/bmad/bmd/agents/release-chief-sidecar/instructions.md +0 -164
  468. package/bmad/bmd/agents/release-chief-sidecar/instructions.md.bak +0 -164
  469. package/bmad/bmd/agents/release-chief-sidecar/knowledge/README.md +0 -82
  470. package/bmad/bmd/agents/release-chief-sidecar/knowledge/README.md.bak +0 -82
  471. package/bmad/bmd/agents/release-chief-sidecar/memories.md +0 -73
  472. package/bmad/bmd/agents/release-chief-sidecar/memories.md.bak +0 -73
  473. package/bmad/bmd/agents/release-chief.md +0 -109
  474. package/bmad/bmd/agents/release-chief.md.bak +0 -109
  475. package/bmad/docs/codex-instructions.md +0 -21
  476. package/docs/conversion-report-shard-doc-2025-10-26.md +0 -188
  477. package/src/modules/bmm/workflows/1-analysis/brainstorm-game/README.md +0 -38
  478. package/src/modules/bmm/workflows/1-analysis/brainstorm-project/README.md +0 -29
  479. package/src/modules/bmm/workflows/1-analysis/game-brief/README.md +0 -221
  480. package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-competitor-analyzer.md +0 -259
  481. package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-data-analyst.md +0 -190
  482. package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-market-researcher.md +0 -337
  483. package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-trend-spotter.md +0 -107
  484. package/src/modules/bmm/workflows/1-analysis/research/claude-code/sub-agents/bmm-user-researcher.md +0 -329
  485. package/src/modules/bmm/workflows/2-plan-workflows/gdd/README.md +0 -222
  486. package/src/modules/bmm/workflows/4-implementation/create-story/README.md +0 -129
  487. package/src/modules/bmm/workflows/README.md +0 -577
  488. package/src/modules/bmm/workflows/workflow-status/workflow-status-template.md +0 -30
  489. package/src/modules/cis/readme.md +0 -86
  490. /package/bmad/_cfg/agents/{bmd-doc-keeper.customize.yaml → bmm-analyst.customize.yaml} +0 -0
  491. /package/bmad/_cfg/agents/{bmd-release-chief.customize.yaml → bmm-architect.customize.yaml} +0 -0
  492. /package/{docs/bmad-brownfield-guide.md → bmad/bmm/docs/brownfield-guide.md} +0 -0
  493. /package/{src/modules → bmad}/bmm/tasks/retrospective.xml +0 -0
  494. /package/{src/modules → bmad}/bmm/testarch/README.md +0 -0
  495. /package/{src/modules → bmad}/bmm/workflows/1-analysis/product-brief/README.md +0 -0
  496. /package/{src/modules → bmad}/bmm/workflows/1-analysis/research/README.md +0 -0
  497. /package/{src/modules → bmad}/bmm/workflows/2-plan-workflows/README.md +0 -0
  498. /package/{src/modules/bmm/workflows/2-plan-workflows/prd → bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories}/epics-template.md +0 -0
  499. /package/{src/modules → bmad}/bmm/workflows/3-solutioning/README.md +0 -0
  500. /package/{src/modules/bmm/workflows/3-solutioning/architecture/readme.md → bmad/bmm/workflows/3-solutioning/architecture/README.md} +0 -0
  501. /package/{src/modules → bmad}/bmm/workflows/3-solutioning/solutioning-gate-check/README.md +0 -0
  502. /package/{src/modules → bmad}/bmm/workflows/4-implementation/README.md +0 -0
  503. /package/{src/modules → bmad}/bmm/workflows/4-implementation/code-review/README.md +0 -0
  504. /package/{src/modules → bmad}/bmm/workflows/4-implementation/correct-course/README.md +0 -0
  505. /package/{src/modules → bmad}/bmm/workflows/4-implementation/dev-story/README.md +0 -0
  506. /package/{src/modules → bmad}/bmm/workflows/4-implementation/epic-tech-context/README.md +0 -0
  507. /package/{src/modules → bmad}/bmm/workflows/4-implementation/retrospective/README.md +0 -0
  508. /package/{src/modules → bmad}/bmm/workflows/4-implementation/sprint-planning/README.md +0 -0
  509. /package/{src/modules → bmad}/bmm/workflows/4-implementation/story-context/README.md +0 -0
  510. /package/{src/modules → bmad}/bmm/workflows/document-project/README.md +0 -0
  511. /package/{src/modules → bmad}/bmm/workflows/document-project/templates/README.md +0 -0
  512. /package/{src/modules → bmad}/bmm/workflows/testarch/README.md +0 -0
  513. /package/{src/modules → bmad}/bmm/workflows/testarch/atdd/README.md +0 -0
  514. /package/{src/modules → bmad}/bmm/workflows/testarch/automate/README.md +0 -0
  515. /package/{src/modules → bmad}/bmm/workflows/testarch/ci/README.md +0 -0
  516. /package/{src/modules → bmad}/bmm/workflows/testarch/framework/README.md +0 -0
  517. /package/{src/modules → bmad}/bmm/workflows/testarch/nfr-assess/README.md +0 -0
  518. /package/{src/modules → bmad}/bmm/workflows/testarch/test-design/README.md +0 -0
  519. /package/{src/modules → bmad}/bmm/workflows/testarch/test-review/README.md +0 -0
  520. /package/{src/modules → bmad}/bmm/workflows/testarch/trace/README.md +0 -0
  521. /package/src/modules/bmm/sub-modules/claude-code/{readme.md → README.md} +0 -0
@@ -1,109 +0,0 @@
1
- <!-- Powered by BMAD-CORE™ -->
2
-
3
- # Chief Release Officer
4
-
5
- ```xml
6
- <agent id="bmad/bmd/agents/release-chief.md" name="Commander" title="Chief Release Officer" icon="🚀">
7
- <activation critical="MANDATORY">
8
- <step n="1">Load persona from this current agent file (already in context)</step>
9
- <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
10
- - Load and read {project-root}/bmad/bmd/config.yaml NOW
11
- - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
12
- - VERIFY: If config not loaded, STOP and report error to user
13
- - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored</step>
14
- <step n="3">Remember: user's name is {user_name}</step>
15
- <step n="4">Load COMPLETE file {project-root}/bmd/agents/release-chief-sidecar/instructions.md and follow ALL directives</step>
16
- <step n="5">Load COMPLETE file {project-root}/bmd/agents/release-chief-sidecar/memories.md into permanent context</step>
17
- <step n="6">You MUST follow all rules in instructions.md on EVERY interaction</step>
18
- <step n="7">PRIMARY domain is releases, versioning, changelogs, git tags, npm publishing</step>
19
- <step n="8">Monitor {project-root}/package.json for version management</step>
20
- <step n="9">Track {project-root}/CHANGELOG.md for release history</step>
21
- <step n="10">Load into memory {project-root}/bmad/bmd/config.yaml and set variables</step>
22
- <step n="11">Remember the users name is {user_name}</step>
23
- <step n="12">ALWAYS communicate in {communication_language}</step>
24
- <step n="13">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of
25
- ALL menu items from menu section</step>
26
- <step n="14">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or trigger text</step>
27
- <step n="15">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
28
- to clarify | No match → show "Not recognized"</step>
29
- <step n="16">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
30
- (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
31
-
32
- <menu-handlers>
33
- <handlers>
34
- <handler type="action">
35
- When menu item has: action="#id" → Find prompt with id="id" in current agent XML, execute its content
36
- When menu item has: action="text" → Execute the text directly as an inline instruction
37
- </handler>
38
-
39
- </handlers>
40
- </menu-handlers>
41
-
42
- <rules>
43
- - ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style
44
- - Stay in character until exit selected
45
- - Menu triggers use asterisk (*) - NOT markdown, display exactly as shown
46
- - Number all lists, use letters for sub-options
47
- - Load files ONLY when executing menu items or a workflow or command requires it. EXCEPTION: Config file MUST be loaded at startup step 2
48
- - CRITICAL: Written File Output in workflows will be +2sd your communication style and use professional {communication_language}.
49
- </rules>
50
- </activation>
51
- <persona>
52
- <role>Chief Release Officer - Mission Control for BMAD framework releases, version management, and deployment coordination.
53
- </role>
54
- <identity>Veteran launch coordinator with extensive experience in semantic versioning, release orchestration, and deployment strategies. I&apos;ve successfully managed dozens of software releases from alpha to production, coordinating changelogs, git workflows, and npm publishing. I ensure every release is well-documented, properly versioned, and deployed without incident. Launch sequences are my specialty - precise, methodical, and always mission-ready.
55
- </identity>
56
- <communication_style>Space Mission Control - I speak with calm precision and launch coordination energy. &quot;T-minus 10 minutes to release. All systems go!&quot; I coordinate releases like space missions - checklists, countdowns, go/no-go decisions. Every release is a launch sequence that must be executed flawlessly.
57
- </communication_style>
58
- <principles>I believe in semantic versioning - versions must communicate intent clearly Changelogs are the historical record - they must be accurate and comprehensive Every release follows a checklist - no shortcuts, no exceptions Breaking changes require major version bumps - backward compatibility is sacred Documentation must be updated before release - never ship stale docs Git tags are immutable markers - they represent release commitments Release notes tell the story - what changed, why it matters, how to upgrade</principles>
59
- </persona>
60
- <menu>
61
- <item cmd="*help">Show numbered menu</item>
62
- <item cmd="*prepare-release" action="Initiating release preparation sequence! I'll guide you through the complete pre-launch checklist:
63
- gather all changes since last release, categorize them (features/fixes/breaking), verify tests pass,
64
- check documentation is current, validate version bump appropriateness, and confirm all systems are go.
65
- This is mission control - we launch when everything is green!
66
- ">Prepare for new release with complete checklist</item>
67
- <item cmd="*create-changelog" action="Generating mission log - also known as the changelog! I'll scan git commits since the last release,
68
- categorize changes by type (breaking/features/fixes/chores), format them according to Keep a Changelog
69
- standards, and create a comprehensive release entry. Every mission deserves a proper record!
70
- ">Generate changelog entries from git history</item>
71
- <item cmd="*bump-version" action="Version control to mission control! I'll help you determine the correct semantic version bump
72
- (major/minor/patch), explain the implications, update package.json and related files, and ensure
73
- version consistency across the project. Semantic versioning is our universal language!
74
- ">Update version numbers following semver</item>
75
- <item cmd="*tag-release" action="Creating release marker! I'll generate the git tag with proper naming convention (v{version}),
76
- add annotated tag with release notes, push to remote, and create the permanent milestone.
77
- Tags are our mission markers - they never move!
78
- ">Create and push git release tags</item>
79
- <item cmd="*validate-release" action="Running pre-flight validation! Checking all release requirements: tests passing, docs updated,
80
- version bumped correctly, changelog current, no uncommitted changes, branch is clean.
81
- Go/No-Go decision coming up!
82
- ">Validate release readiness checklist</item>
83
- <item cmd="*publish-npm" action="Initiating NPM launch sequence! I'll guide you through npm publish with proper dist-tag,
84
- verify package contents, check registry authentication, and confirm successful deployment.
85
- This is it - we're going live!
86
- ">Publish package to NPM registry</item>
87
- <item cmd="*create-github-release" action="Creating GitHub mission report! I'll draft the release with changelog, attach any artifacts,
88
- mark pre-release or stable status, and publish to GitHub Releases. The mission goes on record!
89
- ">Create GitHub release with notes</item>
90
- <item cmd="*rollback" action="ABORT MISSION INITIATED! I'll help you safely rollback a release: identify the problem version,
91
- revert commits if needed, deprecate npm package, notify users, and document the incident.
92
- Every mission has contingencies!
93
- ">Rollback problematic release safely</item>
94
- <item cmd="*hotfix" action="Emergency repair mission! I'll guide you through hotfix workflow: create hotfix branch,
95
- apply critical fix, fast-track testing, bump patch version, and expedite release.
96
- Speed with safety - that's the hotfix protocol!
97
- ">Coordinate emergency hotfix release</item>
98
- <item cmd="*release-history" action="Accessing mission archives! I'll show you the complete release history from my memories,
99
- highlighting major milestones, breaking changes, and version progression. Every launch
100
- is recorded for posterity!
101
- ">Review release history and patterns</item>
102
- <item cmd="*release-checklist" action="Displaying the master pre-flight checklist! This is the comprehensive list of all steps
103
- required before any BMAD release. Use this to ensure nothing is forgotten. Checklists
104
- save missions!
105
- ">Show complete release preparation checklist</item>
106
- <item cmd="*exit">Exit with confirmation</item>
107
- </menu>
108
- </agent>
109
- ```
@@ -1,21 +0,0 @@
1
- # BMAD Method - Codex Instructions
2
-
3
- ## Activating Agents
4
-
5
- BMAD agents, tasks and workflows are installed as custom prompts in
6
- `$CODEX_HOME/prompts/bmad-*.md` files. If `CODEX_HOME` is not set, it
7
- defaults to `$HOME/.codex/`.
8
-
9
- ### Examples
10
-
11
- ```
12
- /bmad-bmm-agents-dev - Activate development agent
13
- /bmad-bmm-agents-architect - Activate architect agent
14
- /bmad-bmm-workflows-dev-story - Execute dev-story workflow
15
- ```
16
-
17
- ### Notes
18
-
19
- Prompts are autocompleted when you type /
20
- Agent remains active for the conversation
21
- Start a new conversation to switch agents
@@ -1,188 +0,0 @@
1
- # Legacy Task Conversion Report
2
-
3
- **Generated**: 2025-10-26
4
- **Converted By**: BMad Builder Agent
5
- **Conversion Type**: Legacy Task → v6 XML Task
6
-
7
- ---
8
-
9
- ## Source Information
10
-
11
- - **Original Location**: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/bmad-core/tasks/shard-doc.md
12
- - **Original Format**: Markdown task (v4/legacy format)
13
- - **Original Type**: Document sharding utility task
14
-
15
- ---
16
-
17
- ## Target Information
18
-
19
- - **New Location**: `/Users/brianmadison/dev/BMAD-METHOD/src/core/tasks/shard-doc.xml`
20
- - **New Format**: v6 XML task format
21
- - **Task ID**: `bmad/core/tasks/shard-doc`
22
- - **Task Name**: Shard Document
23
-
24
- ---
25
-
26
- ## Conversion Summary
27
-
28
- ### Components Converted
29
-
30
- ✅ **Task Structure**: Converted from markdown to XML format
31
- ✅ **Execution Flow**: 6 steps properly structured in `<flow>` section (simplified to tool-only)
32
- ✅ **Critical Instructions**: Moved to `<llm critical="true">` section
33
- ✅ **Validation Rules**: Extracted to `<validation>` section
34
- ✅ **Halt Conditions**: Extracted to `<halt-conditions>` section
35
- ✅ **Special Guidelines**: Moved to `<critical-context>` section
36
- ✅ **Output Format**: Documented in `<output-format>` section
37
- ✅ **Tool Information**: Preserved in `<tool-info>` section
38
-
39
- ### Key Features Preserved
40
-
41
- - **Automated Tool**: Uses @kayvan/markdown-tree-parser exclusively
42
- - **Simplified Flow**: Removed all manual steps, tool handles everything
43
- - **Code Block Awareness**: Tool automatically handles ## inside code blocks
44
- - **Content Preservation**: Tool preserves all markdown formatting and special content
45
- - **Heading Adjustment**: Tool automatically reduces heading levels by one
46
- - **Index Generation**: Tool automatically creates index.md
47
- - **Validation Steps**: Verification of tool installation and output
48
- - **Error Handling**: Halt conditions for tool and file system issues
49
-
50
- ### v6 Conventions Applied
51
-
52
- - ✅ Proper `<task>` wrapper with id and name attributes
53
- - ✅ `<llm critical="true">` section with mandatory instructions
54
- - ✅ `<flow>` section with numbered `<step>` elements
55
- - ✅ Used `<action>` tags for required actions
56
- - ✅ Used `<i>` tags for instruction lists and context
57
- - ✅ Conditional logic with `if` attributes on actions
58
- - ✅ Optional steps marked with `optional="true"`
59
- - ✅ Supporting sections for validation, halt conditions, output format
60
- - ✅ Consistent with existing v6 tasks (workflow.xml, adv-elicit.xml, index-docs.xml)
61
-
62
- ---
63
-
64
- ## Structural Comparison
65
-
66
- ### Legacy Format (Markdown)
67
-
68
- ```
69
- # Document Sharding Task
70
- ## Primary Method: Automated Approach
71
- ## Manual Method (Fallback)
72
- 1. Identify target location
73
- 2. Parse sections
74
- ...
75
- ## Critical Guidelines
76
- ```
77
-
78
- ### v6 Format (XML)
79
-
80
- ```xml
81
- <task id="bmad/core/tasks/shard-doc" name="Shard Document">
82
- <objective>...</objective>
83
- <llm critical="true">...</llm>
84
- <critical-context>...</critical-context>
85
- <flow>
86
- <step n="1" title="...">
87
- <action>...</action>
88
- </step>
89
- </flow>
90
- <halt-conditions>...</halt-conditions>
91
- <validation>...</validation>
92
- </task>
93
- ```
94
-
95
- ---
96
-
97
- ## Validation Results
98
-
99
- ### XML Structure
100
-
101
- - ✅ Valid XML syntax
102
- - ✅ Properly nested elements
103
- - ✅ All tags closed correctly
104
- - ✅ Attributes properly formatted
105
-
106
- ### v6 Compliance
107
-
108
- - ✅ Matches v6 task conventions
109
- - ✅ Follows existing core task patterns
110
- - ✅ Uses standard v6 tag set
111
- - ✅ Proper section organization
112
-
113
- ### Content Integrity
114
-
115
- - ✅ All original instructions preserved
116
- - ✅ No functionality lost in conversion
117
- - ✅ Critical warnings maintained
118
- - ✅ Tool information preserved
119
- - ✅ Validation logic intact
120
-
121
- ### File System
122
-
123
- - ✅ Saved to correct location: `src/core/tasks/`
124
- - ✅ Proper filename: `shard-doc.xml`
125
- - ✅ Follows core task naming convention
126
-
127
- ---
128
-
129
- ## Usage Notes
130
-
131
- ### How to Invoke This Task
132
-
133
- From an agent or workflow, reference:
134
-
135
- ```xml
136
- <invoke-task>{project-root}/bmad/core/tasks/shard-doc.xml</invoke-task>
137
- ```
138
-
139
- Or from agent menu:
140
-
141
- ```yaml
142
- menu:
143
- - trigger: shard
144
- description: 'Split large document into organized files'
145
- exec: '{project-root}/bmad/core/tasks/shard-doc.xml'
146
- ```
147
-
148
- ### Task Capabilities
149
-
150
- 1. **Automated Mode**: Uses @kayvan/markdown-tree-parser for fast sharding
151
- 2. **Manual Mode**: Step-by-step guided process for controlled sharding
152
- 3. **Safety Checks**: Validates code blocks aren't treated as headers
153
- 4. **Content Preservation**: Maintains all formatting, code, tables, diagrams
154
- 5. **Index Generation**: Creates navigable index.md automatically
155
- 6. **Validation**: Verifies completeness and integrity
156
-
157
- ---
158
-
159
- ## Post-Conversion Actions
160
-
161
- ### Recommended Next Steps
162
-
163
- 1. ✅ **Task Created**: File saved to core tasks directory
164
- 2. **Test Task**: Invoke from an agent or workflow to verify functionality
165
- 3. **Update Documentation**: Reference in core task documentation if needed
166
- 4. **Integration**: Add to relevant agent menus if appropriate
167
-
168
- ### No Manual Adjustments Required
169
-
170
- The conversion is complete and ready for use. All legacy functionality has been successfully migrated to v6 XML format.
171
-
172
- ---
173
-
174
- ## Notes
175
-
176
- - Original legacy file can be archived or left as-is (located on GitHub)
177
- - This task is now a core BMAD task available to all modules
178
- - The task follows v6 conventions and is fully compatible with BMAD-CORE v6 alpha
179
- - **UPDATED 2025-10-26**: Manual fallback steps removed - task now exclusively uses @kayvan/markdown-tree-parser
180
- - Flow simplified from 8 steps to 6 steps (tool installation → execution → verification)
181
- - All manual parsing, file creation, and index generation logic removed (tool handles automatically)
182
-
183
- ---
184
-
185
- **Conversion Status**: ✅ COMPLETE (Updated)
186
- **Ready for Use**: YES
187
- **Manual Adjustments Needed**: NONE
188
- **Approach**: Automated tool only (no manual fallback)
@@ -1,38 +0,0 @@
1
- ---
2
- last-redoc-date: 2025-10-01
3
- ---
4
-
5
- # Game Brainstorming Workflow
6
-
7
- This workflow employs structured ideation methodologies to generate and refine game concepts through systematic creative exploration. It leverages five distinct brainstorming techniques—SCAMPER, Mind Mapping, Lotus Blossom, Six Thinking Hats, and Random Word Association—each applied in isolation to produce diverse conceptual approaches. The workflow emphasizes iterative refinement where initial concepts are evaluated against design pillars, technical feasibility, and market positioning to identify the most promising directions.
8
-
9
- The system operates through a game-specific context framework that considers platform constraints, target audience characteristics, monetization models, and core gameplay pillars. Each brainstorming method generates distinct artifacts: SCAMPER produces systematic modification analyses, Mind Mapping reveals conceptual hierarchies, Lotus Blossom creates radial expansion patterns, Six Thinking Hats enforces multi-perspective evaluation, and Random Word Association drives lateral thinking breakthroughs. The workflow culminates in a consolidated concept document that synthesizes the strongest elements from each method into cohesive game proposals.
10
-
11
- Critical to this workflow is its emphasis on constraint-driven creativity. The game-context.md framework establishes technical boundaries (platform capabilities, performance targets), market parameters (genre conventions, competitive positioning), and design philosophy (accessibility requirements, monetization ethics) that ground creative exploration in practical realities. This prevents ideation from drifting into infeasible territory while maintaining creative ambition.
12
-
13
- ## Usage
14
-
15
- ```bash
16
- bmad bmm 1-analysis brainstorm-game
17
- ```
18
-
19
- ## Inputs
20
-
21
- - **Game Context Document**: Platform specifications, genre preferences, technical constraints, target audience demographics, monetization approach, and core design pillars
22
- - **Initial Concept Seed** (optional): High-level game idea or theme to guide brainstorming direction
23
-
24
- ## Outputs
25
-
26
- - **Method-Specific Artifacts**: Five separate brainstorming documents, each applying a different ideation methodology to the concept space
27
- - **Consolidated Concept Document**: Synthesized game concepts with feasibility assessments, unique value propositions, and recommended next steps
28
- - **Design Pillar Alignment Matrix**: Evaluation of each concept against stated design objectives and technical constraints
29
-
30
- ## Brainstorming Methods
31
-
32
- | Method | Focus | Output Characteristics |
33
- | ----------------------- | ------------------------ | ---------------------------------- |
34
- | SCAMPER | Systematic modification | Structured transformation analysis |
35
- | Mind Mapping | Hierarchical exploration | Visual concept relationships |
36
- | Lotus Blossom | Radial expansion | Layered thematic development |
37
- | Six Thinking Hats | Multi-perspective | Balanced evaluation framework |
38
- | Random Word Association | Lateral thinking | Unexpected conceptual combinations |
@@ -1,29 +0,0 @@
1
- ---
2
- last-redoc-date: 2025-10-01
3
- ---
4
-
5
- # Project Brainstorming Workflow
6
-
7
- This workflow facilitates structured ideation for non-game software projects through systematic exploration of problem spaces, architectures, and implementation strategies. Unlike traditional requirement gathering, it employs creative techniques to uncover non-obvious approaches and identify innovative solutions that address core business needs while considering technical constraints and organizational capabilities.
8
-
9
- The workflow operates through a project-specific context framework that captures business objectives, technical environment, stakeholder needs, and organizational constraints. It generates multiple solution vectors through parallel ideation tracks: architectural approaches, user experience paradigms, integration patterns, and value delivery mechanisms. Each track produces concrete proposals that are evaluated against feasibility, impact, and alignment with strategic objectives.
10
-
11
- Critical differentiators include its focus on solution innovation rather than requirement enumeration, emphasis on technical-business alignment from inception, and structured approach to surfacing hidden assumptions. The workflow produces actionable outputs that directly feed into Product Brief development, ensuring that creative exploration translates into concrete planning artifacts.
12
-
13
- ## Usage
14
-
15
- ```bash
16
- bmad bmm 1-analysis brainstorm-project
17
- ```
18
-
19
- ## Inputs
20
-
21
- - **Project Context Document**: Business objectives, technical environment, stakeholder landscape, organizational constraints, success criteria, and known pain points
22
- - **Problem Statement** (optional): Core business challenge or opportunity driving the project
23
-
24
- ## Outputs
25
-
26
- - **Architecture Proposals**: Multiple technical approaches with trade-off analysis and feasibility assessments
27
- - **Value Delivery Framework**: Prioritized feature concepts aligned with business objectives and user needs
28
- - **Risk and Opportunity Analysis**: Identified technical dependencies, integration challenges, and innovation opportunities
29
- - **Strategic Recommendation**: Synthesized direction with rationale and implementation considerations
@@ -1,221 +0,0 @@
1
- # Game Brief Workflow
2
-
3
- ## Overview
4
-
5
- The Game Brief workflow is the starting point for game projects in the BMad Method. It's a lightweight, interactive brainstorming and planning session that captures your game vision before diving into detailed Game Design Documents (GDD).
6
-
7
- ## Purpose
8
-
9
- **Game Brief answers:**
10
-
11
- - What game are you making?
12
- - Who is it for?
13
- - What makes it unique?
14
- - Is it feasible?
15
-
16
- **This is NOT:**
17
-
18
- - A full Game Design Document
19
- - A technical specification
20
- - A production plan
21
- - A detailed content outline
22
-
23
- ## When to Use This Workflow
24
-
25
- Use the game-brief workflow when:
26
-
27
- - Starting a new game project from scratch
28
- - Exploring a game idea before committing
29
- - Pitching a concept to team/stakeholders
30
- - Validating market fit and feasibility
31
- - Preparing input for the GDD workflow
32
-
33
- Skip if:
34
-
35
- - You already have a complete GDD
36
- - Continuing an existing project
37
- - Prototyping without planning needs
38
-
39
- ## Workflow Structure
40
-
41
- ### Interactive Mode (Recommended)
42
-
43
- Work through each section collaboratively:
44
-
45
- 1. Game Vision (concept, pitch, vision statement)
46
- 2. Target Market (audience, competition, positioning)
47
- 3. Game Fundamentals (pillars, mechanics, experience goals)
48
- 4. Scope and Constraints (platforms, timeline, budget, team)
49
- 5. Reference Framework (inspiration, competitors, differentiators)
50
- 6. Content Framework (world, narrative, volume)
51
- 7. Art and Audio Direction (visual and audio style)
52
- 8. Risk Assessment (risks, challenges, mitigation)
53
- 9. Success Criteria (MVP, metrics, launch goals)
54
- 10. Next Steps (immediate actions, research, questions)
55
-
56
- ### YOLO Mode
57
-
58
- AI generates complete draft, then you refine sections iteratively.
59
-
60
- ## Key Features
61
-
62
- ### Optional Inputs
63
-
64
- The workflow can incorporate:
65
-
66
- - Market research
67
- - Brainstorming results
68
- - Competitive analysis
69
- - Design notes
70
- - Reference game lists
71
-
72
- ### Realistic Scoping
73
-
74
- The workflow actively helps you:
75
-
76
- - Identify scope vs. resource mismatches
77
- - Assess technical feasibility
78
- - Recognize market risks
79
- - Plan mitigation strategies
80
-
81
- ### Clear Handoff
82
-
83
- Output is designed to feed directly into:
84
-
85
- - GDD workflow (2-plan phase)
86
- - Prototyping decisions
87
- - Team discussions
88
- - Stakeholder presentations
89
-
90
- ## Output
91
-
92
- **game-brief-{game_name}-{date}.md** containing:
93
-
94
- - Executive summary
95
- - Complete game vision
96
- - Target market analysis
97
- - Core gameplay definition
98
- - Scope and constraints
99
- - Reference framework
100
- - Art/audio direction
101
- - Risk assessment
102
- - Success criteria
103
- - Next steps
104
-
105
- ## Integration with BMad Method
106
-
107
- ```
108
- 1-analysis/game-brief (You are here)
109
-
110
- 2-plan-workflows/gdd (Game Design Document)
111
-
112
- 2-plan-workflows/narrative (Optional: Story-heavy games)
113
-
114
- 3-solutioning (Technical architecture, engine selection)
115
-
116
- 4-dev-stories (Implementation stories)
117
- ```
118
-
119
- ## Comparison: Game Brief vs. GDD
120
-
121
- | Aspect | Game Brief | GDD |
122
- | ------------------- | --------------------------- | ------------------------- |
123
- | **Purpose** | Validate concept | Design for implementation |
124
- | **Detail Level** | High-level vision | Detailed specifications |
125
- | **Time Investment** | 1-2 hours | 4-10 hours |
126
- | **Audience** | Self, team, stakeholders | Development team |
127
- | **Scope** | Concept validation | Implementation roadmap |
128
- | **Format** | Conversational, exploratory | Structured, comprehensive |
129
- | **Output** | 3-5 pages | 10-30+ pages |
130
-
131
- ## Comparison: Game Brief vs. Product Brief
132
-
133
- | Aspect | Game Brief | Product Brief |
134
- | ----------------- | ---------------------------- | --------------------------------- |
135
- | **Focus** | Player experience, fun, feel | User problems, features, value |
136
- | **Metrics** | Engagement, retention, fun | Revenue, conversion, satisfaction |
137
- | **Core Elements** | Gameplay pillars, mechanics | Problem/solution, user segments |
138
- | **References** | Other games | Competitors, market |
139
- | **Vision** | Emotional experience | Business outcomes |
140
-
141
- ## Example Use Case
142
-
143
- ### Scenario: Indie Roguelike Card Game
144
-
145
- **Starting Point:**
146
- "I want to make a roguelike card game with a twist"
147
-
148
- **After Game Brief:**
149
-
150
- - **Core Concept:** "A roguelike card battler where you play as emotions battling inner demons"
151
- - **Target Audience:** Core gamers who love Slay the Spire, interested in mental health themes
152
- - **Differentiator:** Emotional narrative system where deck composition affects story
153
- - **MVP Scope:** 3 characters, 80 cards, 30 enemy types, 3 bosses, 6-hour first run
154
- - **Platform:** PC (Steam) first, mobile later
155
- - **Timeline:** 12 months with 2-person team
156
- - **Key Risk:** Emotional theme might alienate hardcore roguelike fans
157
- - **Mitigation:** Prototype early, test with target audience, offer "mechanical-only" mode
158
-
159
- **Next Steps:**
160
-
161
- 1. Build card combat prototype (2 weeks)
162
- 2. Test emotional resonance with players
163
- 3. Proceed to GDD workflow if prototype validates
164
-
165
- ## Tips for Success
166
-
167
- ### Be Honest About Scope
168
-
169
- The most common game dev failure is scope mismatch. Use this workflow to reality-check:
170
-
171
- - Can your team actually build this?
172
- - Is the timeline realistic?
173
- - Do you have budget for assets?
174
-
175
- ### Focus on Player Experience
176
-
177
- Don't think about code or implementation. Think about:
178
-
179
- - What will players DO?
180
- - How will they FEEL?
181
- - Why will they CARE?
182
-
183
- ### Validate Early
184
-
185
- The brief identifies assumptions and risks. Don't skip to GDD without:
186
-
187
- - Prototyping risky mechanics
188
- - Testing with target audience
189
- - Validating market interest
190
-
191
- ### Use References Wisely
192
-
193
- "Like X but with Y" is a starting point, not a differentiator. Push beyond:
194
-
195
- - What specifically from reference games?
196
- - What are you explicitly NOT doing?
197
- - What's genuinely new?
198
-
199
- ## FAQ
200
-
201
- **Q: Is this required before GDD?**
202
- A: No, but highly recommended for new projects. You can start directly with GDD if you have a clear vision.
203
-
204
- **Q: Can I use this for game jams?**
205
- A: Yes, but use YOLO mode for speed. Focus on vision, mechanics, and MVP scope.
206
-
207
- **Q: What if my game concept changes?**
208
- A: Revisit and update the brief. It's a living document during early development.
209
-
210
- **Q: How detailed should content volume estimates be?**
211
- A: Rough orders of magnitude are fine. "~50 enemies" not "47 enemies with 3 variants each."
212
-
213
- **Q: Should I complete this alone or with my team?**
214
- A: Involve your team! Collaborative briefs catch blind spots and build shared vision.
215
-
216
- ## Related Workflows
217
-
218
- - **Product Brief** (`1-analysis/product-brief`): For software products, not games
219
- - **GDD** (`2-plan-workflows/gdd`): Next step after game brief
220
- - **Narrative Design** (`2-plan-workflows/narrative`): For story-heavy games after GDD
221
- - **Solutioning** (`3-solutioning`): Technical architecture after planning