bmalph 1.0.0 → 2.2.1

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 (455) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +398 -217
  3. package/bmad/bmm/agents/analyst.agent.yaml +43 -36
  4. package/bmad/bmm/agents/architect.agent.yaml +29 -28
  5. package/bmad/bmm/agents/dev.agent.yaml +38 -38
  6. package/bmad/bmm/agents/pm.agent.yaml +44 -46
  7. package/bmad/bmm/agents/qa.agent.yaml +58 -0
  8. package/bmad/bmm/agents/quick-flow-solo-dev.agent.yaml +32 -32
  9. package/bmad/bmm/agents/sm.agent.yaml +37 -36
  10. package/bmad/bmm/agents/tech-writer/tech-writer-sidecar/documentation-standards.md +223 -223
  11. package/bmad/bmm/agents/tech-writer/tech-writer.agent.yaml +46 -45
  12. package/bmad/bmm/agents/ux-designer.agent.yaml +27 -26
  13. package/bmad/bmm/data/project-context-template.md +26 -26
  14. package/bmad/bmm/module-help.csv +31 -31
  15. package/bmad/bmm/module.yaml +50 -44
  16. package/bmad/bmm/teams/default-party.csv +20 -21
  17. package/bmad/bmm/teams/team-fullstack.yaml +12 -12
  18. package/bmad/bmm/workflows/1-analysis/create-product-brief/product-brief.template.md +10 -10
  19. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md +177 -177
  20. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +161 -161
  21. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +199 -199
  22. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +202 -202
  23. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +205 -205
  24. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +219 -219
  25. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +162 -162
  26. package/bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md +57 -58
  27. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +137 -137
  28. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +229 -229
  29. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +238 -238
  30. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +206 -206
  31. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +234 -234
  32. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +443 -443
  33. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +182 -182
  34. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +237 -237
  35. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +249 -249
  36. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +259 -259
  37. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +177 -177
  38. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +475 -475
  39. package/bmad/bmm/workflows/1-analysis/research/research.template.md +29 -29
  40. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +137 -137
  41. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +239 -239
  42. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +248 -248
  43. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +202 -202
  44. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +233 -239
  45. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +486 -486
  46. package/bmad/bmm/workflows/1-analysis/research/workflow-domain-research.md +54 -0
  47. package/bmad/bmm/workflows/1-analysis/research/workflow-market-research.md +54 -0
  48. package/bmad/bmm/workflows/1-analysis/research/workflow-technical-research.md +54 -0
  49. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/data/domain-complexity.csv +14 -12
  50. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/data/prd-purpose.md +197 -197
  51. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/data/project-types.csv +10 -10
  52. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-01-init.md +191 -191
  53. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-01b-continue.md +153 -153
  54. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-02-discovery.md +224 -224
  55. package/bmad/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02b-vision.md +154 -0
  56. package/bmad/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02c-executive-summary.md +170 -0
  57. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-03-success.md +226 -226
  58. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-04-journeys.md +213 -213
  59. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-05-domain.md +207 -207
  60. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-06-innovation.md +226 -226
  61. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-07-project-type.md +237 -237
  62. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-08-scoping.md +228 -228
  63. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-09-functional.md +231 -231
  64. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-10-nonfunctional.md +242 -242
  65. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-11-polish.md +217 -217
  66. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-12-complete.md +124 -124
  67. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-e/step-e-01-discovery.md +247 -247
  68. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-e/step-e-01b-legacy-conversion.md +208 -208
  69. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-e/step-e-02-review.md +249 -249
  70. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-e/step-e-03-edit.md +253 -253
  71. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-e/step-e-04-complete.md +168 -168
  72. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-01-discovery.md +226 -218
  73. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-02-format-detection.md +191 -191
  74. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-02b-parity-check.md +209 -209
  75. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-03-density-validation.md +174 -174
  76. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-04-brief-coverage-validation.md +214 -214
  77. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-05-measurability-validation.md +228 -228
  78. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-06-traceability-validation.md +217 -217
  79. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-07-implementation-leakage-validation.md +205 -205
  80. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-08-domain-compliance-validation.md +243 -243
  81. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-09-project-type-validation.md +263 -263
  82. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-10-smart-validation.md +209 -209
  83. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-11-holistic-quality-validation.md +264 -264
  84. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-12-completeness-validation.md +242 -242
  85. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-13-report-complete.md +231 -231
  86. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/templates/prd-template.md +10 -10
  87. package/bmad/bmm/workflows/2-plan-workflows/create-prd/workflow-create-prd.md +63 -0
  88. package/bmad/bmm/workflows/2-plan-workflows/create-prd/workflow-edit-prd.md +65 -0
  89. package/bmad/bmm/workflows/2-plan-workflows/create-prd/workflow-validate-prd.md +63 -0
  90. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +135 -135
  91. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +127 -127
  92. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +190 -190
  93. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +216 -216
  94. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +219 -219
  95. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +234 -234
  96. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +252 -252
  97. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +254 -254
  98. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +224 -224
  99. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +224 -224
  100. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +241 -241
  101. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +248 -248
  102. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +237 -237
  103. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +264 -264
  104. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +171 -171
  105. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +13 -13
  106. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +42 -43
  107. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +184 -190
  108. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +172 -178
  109. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +173 -179
  110. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +133 -139
  111. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +245 -252
  112. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +129 -135
  113. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/templates/readiness-report-template.md +4 -4
  114. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md +54 -55
  115. package/bmad/bmm/workflows/3-solutioning/create-architecture/architecture-decision-template.md +12 -12
  116. package/bmad/bmm/workflows/3-solutioning/create-architecture/data/domain-complexity.csv +12 -10
  117. package/bmad/bmm/workflows/3-solutioning/create-architecture/data/project-types.csv +6 -6
  118. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md +153 -153
  119. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md +164 -164
  120. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +224 -224
  121. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +331 -331
  122. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +318 -318
  123. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +359 -359
  124. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +379 -379
  125. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +359 -359
  126. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +76 -76
  127. package/bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md +49 -50
  128. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +259 -259
  129. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +233 -233
  130. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +272 -272
  131. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +149 -149
  132. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/templates/epics-template.md +57 -57
  133. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +58 -59
  134. package/bmad/bmm/workflows/4-implementation/code-review/checklist.md +23 -23
  135. package/bmad/bmm/workflows/4-implementation/code-review/instructions.xml +226 -226
  136. package/bmad/bmm/workflows/4-implementation/code-review/workflow.yaml +44 -51
  137. package/bmad/bmm/workflows/4-implementation/correct-course/checklist.md +288 -288
  138. package/bmad/bmm/workflows/4-implementation/correct-course/instructions.md +207 -206
  139. package/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml +54 -60
  140. package/bmad/bmm/workflows/4-implementation/create-story/checklist.md +358 -358
  141. package/bmad/bmm/workflows/4-implementation/create-story/instructions.xml +346 -345
  142. package/bmad/bmm/workflows/4-implementation/create-story/template.md +49 -49
  143. package/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml +53 -61
  144. package/bmad/bmm/workflows/4-implementation/dev-story/checklist.md +80 -80
  145. package/bmad/bmm/workflows/4-implementation/dev-story/instructions.xml +410 -410
  146. package/bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml +21 -27
  147. package/bmad/bmm/workflows/4-implementation/retrospective/instructions.md +1444 -1443
  148. package/bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml +53 -58
  149. package/bmad/bmm/workflows/4-implementation/sprint-planning/checklist.md +33 -33
  150. package/bmad/bmm/workflows/4-implementation/sprint-planning/instructions.md +226 -225
  151. package/bmad/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +55 -55
  152. package/bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +47 -54
  153. package/bmad/bmm/workflows/4-implementation/sprint-status/instructions.md +230 -229
  154. package/bmad/bmm/workflows/4-implementation/sprint-status/workflow.yaml +25 -36
  155. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md +174 -156
  156. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-02-context-gathering.md +118 -120
  157. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-03-execute.md +111 -113
  158. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md +111 -113
  159. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-05-adversarial-review.md +104 -106
  160. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md +146 -140
  161. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +50 -50
  162. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md +191 -189
  163. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md +144 -144
  164. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-03-generate.md +127 -128
  165. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md +200 -191
  166. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/tech-spec-template.md +74 -74
  167. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md +79 -79
  168. package/bmad/bmm/workflows/document-project/checklist.md +245 -245
  169. package/bmad/bmm/workflows/document-project/documentation-requirements.csv +12 -12
  170. package/bmad/bmm/workflows/document-project/instructions.md +130 -221
  171. package/bmad/bmm/workflows/document-project/templates/deep-dive-template.md +345 -345
  172. package/bmad/bmm/workflows/document-project/templates/index-template.md +169 -169
  173. package/bmad/bmm/workflows/document-project/templates/project-overview-template.md +103 -103
  174. package/bmad/bmm/workflows/document-project/templates/project-scan-report-schema.json +160 -160
  175. package/bmad/bmm/workflows/document-project/templates/source-tree-template.md +135 -135
  176. package/bmad/bmm/workflows/document-project/workflow.yaml +22 -30
  177. package/bmad/bmm/workflows/document-project/workflows/deep-dive-instructions.md +298 -298
  178. package/bmad/bmm/workflows/document-project/workflows/deep-dive.yaml +31 -31
  179. package/bmad/bmm/workflows/document-project/workflows/full-scan-instructions.md +1106 -1106
  180. package/bmad/bmm/workflows/document-project/workflows/full-scan.yaml +31 -31
  181. package/bmad/bmm/workflows/generate-project-context/project-context-template.md +21 -0
  182. package/bmad/bmm/workflows/generate-project-context/steps/step-01-discover.md +184 -0
  183. package/bmad/bmm/workflows/generate-project-context/steps/step-02-generate.md +318 -0
  184. package/bmad/bmm/workflows/generate-project-context/steps/step-03-complete.md +278 -0
  185. package/bmad/bmm/workflows/generate-project-context/workflow.md +49 -0
  186. package/bmad/bmm/workflows/qa/automate/checklist.md +33 -0
  187. package/bmad/bmm/workflows/qa/automate/instructions.md +110 -0
  188. package/bmad/bmm/workflows/qa/automate/workflow.yaml +44 -0
  189. package/bmad/core/agents/bmad-master.agent.yaml +30 -30
  190. package/bmad/core/module-help.csv +9 -11
  191. package/bmad/core/module.yaml +25 -25
  192. package/bmad/core/tasks/editorial-review-prose.xml +102 -91
  193. package/bmad/core/tasks/editorial-review-structure.xml +209 -198
  194. package/bmad/core/tasks/help.md +85 -0
  195. package/bmad/core/tasks/index-docs.xml +64 -64
  196. package/bmad/core/tasks/review-adversarial-general.xml +48 -48
  197. package/bmad/core/tasks/shard-doc.xml +107 -108
  198. package/bmad/core/tasks/workflow.xml +234 -234
  199. package/bmad/core/workflows/advanced-elicitation/methods.csv +51 -51
  200. package/bmad/core/workflows/advanced-elicitation/workflow.xml +116 -116
  201. package/bmad/core/workflows/brainstorming/brain-methods.csv +61 -61
  202. package/bmad/core/workflows/brainstorming/steps/step-01-session-setup.md +197 -197
  203. package/bmad/core/workflows/brainstorming/steps/step-01b-continue.md +122 -122
  204. package/bmad/core/workflows/brainstorming/steps/step-02a-user-selected.md +225 -225
  205. package/bmad/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +237 -237
  206. package/bmad/core/workflows/brainstorming/steps/step-02c-random-selection.md +209 -209
  207. package/bmad/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +264 -264
  208. package/bmad/core/workflows/brainstorming/steps/step-03-technique-execution.md +399 -399
  209. package/bmad/core/workflows/brainstorming/steps/step-04-idea-organization.md +303 -303
  210. package/bmad/core/workflows/brainstorming/template.md +15 -15
  211. package/bmad/core/workflows/brainstorming/workflow.md +58 -58
  212. package/bmad/core/workflows/party-mode/steps/step-01-agent-loading.md +138 -138
  213. package/bmad/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +187 -187
  214. package/bmad/core/workflows/party-mode/steps/step-03-graceful-exit.md +168 -157
  215. package/bmad/core/workflows/party-mode/workflow.md +194 -194
  216. package/bundled-versions.json +3 -0
  217. package/dist/cli.js +61 -6
  218. package/dist/commands/check-updates.d.ts +5 -0
  219. package/dist/commands/check-updates.js +63 -0
  220. package/dist/commands/doctor.d.ts +39 -1
  221. package/dist/commands/doctor.js +348 -79
  222. package/dist/commands/init.d.ts +2 -0
  223. package/dist/commands/init.js +41 -15
  224. package/dist/commands/status.d.ts +7 -1
  225. package/dist/commands/status.js +111 -42
  226. package/dist/commands/upgrade.d.ts +7 -1
  227. package/dist/commands/upgrade.js +43 -12
  228. package/dist/installer.d.ts +19 -2
  229. package/dist/installer.js +305 -66
  230. package/dist/transition/artifacts.d.ts +2 -0
  231. package/dist/transition/artifacts.js +46 -0
  232. package/dist/transition/context.d.ts +19 -0
  233. package/dist/transition/context.js +261 -0
  234. package/dist/transition/fix-plan.d.ts +15 -0
  235. package/dist/transition/fix-plan.js +94 -0
  236. package/dist/transition/index.d.ts +9 -0
  237. package/dist/transition/index.js +16 -0
  238. package/dist/transition/orchestration.d.ts +2 -0
  239. package/dist/transition/orchestration.js +243 -0
  240. package/dist/transition/specs-changelog.d.ts +3 -0
  241. package/dist/transition/specs-changelog.js +75 -0
  242. package/dist/transition/specs-index.d.ts +22 -0
  243. package/dist/transition/specs-index.js +157 -0
  244. package/dist/transition/story-parsing.d.ts +7 -0
  245. package/dist/transition/story-parsing.js +124 -0
  246. package/dist/transition/tech-stack.d.ts +3 -0
  247. package/dist/transition/tech-stack.js +79 -0
  248. package/dist/transition/types.d.ts +60 -0
  249. package/dist/transition/types.js +1 -0
  250. package/dist/utils/config.d.ts +4 -0
  251. package/dist/utils/config.js +14 -4
  252. package/dist/utils/constants.d.ts +70 -0
  253. package/dist/utils/constants.js +97 -0
  254. package/dist/utils/dryrun.d.ts +7 -0
  255. package/dist/utils/dryrun.js +48 -0
  256. package/dist/utils/errors.d.ts +63 -0
  257. package/dist/utils/errors.js +86 -0
  258. package/dist/utils/file-system.d.ts +24 -0
  259. package/dist/utils/file-system.js +99 -0
  260. package/dist/utils/github.d.ts +83 -0
  261. package/dist/utils/github.js +230 -0
  262. package/dist/utils/json.js +3 -3
  263. package/dist/utils/logger.d.ts +6 -0
  264. package/dist/utils/logger.js +27 -0
  265. package/dist/utils/state.d.ts +4 -7
  266. package/dist/utils/state.js +147 -26
  267. package/dist/utils/validate.d.ts +40 -0
  268. package/dist/utils/validate.js +175 -1
  269. package/package.json +75 -59
  270. package/ralph/RALPH-REFERENCE.md +412 -0
  271. package/ralph/lib/circuit_breaker.sh +463 -330
  272. package/ralph/lib/date_utils.sh +104 -53
  273. package/ralph/lib/enable_core.sh +815 -0
  274. package/ralph/lib/response_analyzer.sh +884 -768
  275. package/ralph/lib/task_sources.sh +577 -0
  276. package/ralph/lib/timeout_utils.sh +145 -145
  277. package/ralph/lib/wizard_utils.sh +547 -0
  278. package/ralph/ralph_import.sh +636 -0
  279. package/ralph/ralph_loop.sh +1793 -1391
  280. package/ralph/ralph_monitor.sh +125 -0
  281. package/ralph/templates/AGENT.md +158 -158
  282. package/ralph/templates/PROMPT.md +285 -292
  283. package/ralph/templates/fix_plan.md +27 -27
  284. package/ralph/templates/ralphrc.template +102 -0
  285. package/ralph/templates/specs/.gitkeep +1 -1
  286. package/slash-commands/advanced-elicitation.md +1 -1
  287. package/slash-commands/adversarial-review.md +1 -1
  288. package/slash-commands/analyst.md +1 -1
  289. package/slash-commands/architect.md +1 -1
  290. package/slash-commands/bmad-help.md +1 -1
  291. package/slash-commands/bmalph-implement.md +152 -152
  292. package/slash-commands/brainstorm-project.md +1 -1
  293. package/slash-commands/brainstorming.md +1 -1
  294. package/slash-commands/correct-course.md +1 -1
  295. package/slash-commands/create-architecture.md +1 -1
  296. package/slash-commands/create-brief.md +1 -1
  297. package/slash-commands/create-epics-stories.md +1 -1
  298. package/slash-commands/create-prd.md +1 -1
  299. package/slash-commands/create-story.md +1 -1
  300. package/slash-commands/create-ux.md +1 -1
  301. package/slash-commands/dev.md +1 -1
  302. package/slash-commands/document-project.md +1 -1
  303. package/slash-commands/domain-research.md +1 -1
  304. package/slash-commands/editorial-prose.md +1 -1
  305. package/slash-commands/editorial-structure.md +1 -1
  306. package/slash-commands/execute-workflow.md +1 -1
  307. package/slash-commands/generate-project-context.md +1 -0
  308. package/slash-commands/implementation-readiness.md +1 -1
  309. package/slash-commands/index-docs.md +1 -1
  310. package/slash-commands/market-research.md +1 -1
  311. package/slash-commands/party-mode.md +1 -1
  312. package/slash-commands/pm.md +1 -1
  313. package/slash-commands/qa-automate.md +1 -0
  314. package/slash-commands/qa.md +1 -0
  315. package/slash-commands/quick-dev.md +1 -1
  316. package/slash-commands/quick-flow-solo-dev.md +1 -1
  317. package/slash-commands/retrospective.md +1 -1
  318. package/slash-commands/shard-doc.md +1 -1
  319. package/slash-commands/sm.md +1 -1
  320. package/slash-commands/sprint-planning.md +1 -1
  321. package/slash-commands/sprint-status.md +1 -1
  322. package/slash-commands/tech-spec.md +1 -1
  323. package/slash-commands/tech-writer.md +1 -0
  324. package/slash-commands/technical-research.md +1 -1
  325. package/slash-commands/ux-designer.md +1 -1
  326. package/slash-commands/validate-architecture.md +1 -1
  327. package/slash-commands/validate-brief.md +1 -1
  328. package/slash-commands/validate-epics-stories.md +1 -1
  329. package/slash-commands/validate-prd.md +1 -1
  330. package/slash-commands/validate-story.md +1 -1
  331. package/slash-commands/validate-ux.md +1 -1
  332. package/bmad/bmm/agents/tea.agent.yaml +0 -63
  333. package/bmad/bmm/sub-modules/claude-code/config.yaml +0 -4
  334. package/bmad/bmm/sub-modules/claude-code/injections.yaml +0 -242
  335. package/bmad/bmm/sub-modules/claude-code/readme.md +0 -87
  336. package/bmad/bmm/testarch/knowledge/adr-quality-readiness-checklist.md +0 -350
  337. package/bmad/bmm/testarch/knowledge/api-request.md +0 -442
  338. package/bmad/bmm/testarch/knowledge/api-testing-patterns.md +0 -843
  339. package/bmad/bmm/testarch/knowledge/auth-session.md +0 -552
  340. package/bmad/bmm/testarch/knowledge/burn-in.md +0 -273
  341. package/bmad/bmm/testarch/knowledge/ci-burn-in.md +0 -675
  342. package/bmad/bmm/testarch/knowledge/component-tdd.md +0 -486
  343. package/bmad/bmm/testarch/knowledge/contract-testing.md +0 -957
  344. package/bmad/bmm/testarch/knowledge/data-factories.md +0 -500
  345. package/bmad/bmm/testarch/knowledge/email-auth.md +0 -721
  346. package/bmad/bmm/testarch/knowledge/error-handling.md +0 -725
  347. package/bmad/bmm/testarch/knowledge/feature-flags.md +0 -750
  348. package/bmad/bmm/testarch/knowledge/file-utils.md +0 -463
  349. package/bmad/bmm/testarch/knowledge/fixture-architecture.md +0 -401
  350. package/bmad/bmm/testarch/knowledge/fixtures-composition.md +0 -382
  351. package/bmad/bmm/testarch/knowledge/intercept-network-call.md +0 -430
  352. package/bmad/bmm/testarch/knowledge/log.md +0 -429
  353. package/bmad/bmm/testarch/knowledge/network-error-monitor.md +0 -405
  354. package/bmad/bmm/testarch/knowledge/network-first.md +0 -486
  355. package/bmad/bmm/testarch/knowledge/network-recorder.md +0 -527
  356. package/bmad/bmm/testarch/knowledge/nfr-criteria.md +0 -670
  357. package/bmad/bmm/testarch/knowledge/overview.md +0 -286
  358. package/bmad/bmm/testarch/knowledge/playwright-config.md +0 -730
  359. package/bmad/bmm/testarch/knowledge/probability-impact.md +0 -601
  360. package/bmad/bmm/testarch/knowledge/recurse.md +0 -421
  361. package/bmad/bmm/testarch/knowledge/risk-governance.md +0 -615
  362. package/bmad/bmm/testarch/knowledge/selective-testing.md +0 -732
  363. package/bmad/bmm/testarch/knowledge/selector-resilience.md +0 -527
  364. package/bmad/bmm/testarch/knowledge/test-healing-patterns.md +0 -644
  365. package/bmad/bmm/testarch/knowledge/test-levels-framework.md +0 -473
  366. package/bmad/bmm/testarch/knowledge/test-priorities-matrix.md +0 -373
  367. package/bmad/bmm/testarch/knowledge/test-quality.md +0 -664
  368. package/bmad/bmm/testarch/knowledge/timing-debugging.md +0 -372
  369. package/bmad/bmm/testarch/knowledge/visual-debugging.md +0 -524
  370. package/bmad/bmm/testarch/tea-index.csv +0 -35
  371. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +0 -200
  372. package/bmad/bmm/workflows/1-analysis/research/workflow.md +0 -173
  373. package/bmad/bmm/workflows/2-plan-workflows/prd/validation-report-prd-workflow.md +0 -433
  374. package/bmad/bmm/workflows/2-plan-workflows/prd/workflow.md +0 -150
  375. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/data/project-levels.yaml +0 -59
  376. package/bmad/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-library.json +0 -90
  377. package/bmad/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-templates.yaml +0 -127
  378. package/bmad/bmm/workflows/excalidraw-diagrams/create-dataflow/checklist.md +0 -39
  379. package/bmad/bmm/workflows/excalidraw-diagrams/create-dataflow/instructions.md +0 -130
  380. package/bmad/bmm/workflows/excalidraw-diagrams/create-dataflow/workflow.yaml +0 -27
  381. package/bmad/bmm/workflows/excalidraw-diagrams/create-diagram/checklist.md +0 -43
  382. package/bmad/bmm/workflows/excalidraw-diagrams/create-diagram/instructions.md +0 -141
  383. package/bmad/bmm/workflows/excalidraw-diagrams/create-diagram/workflow.yaml +0 -27
  384. package/bmad/bmm/workflows/excalidraw-diagrams/create-flowchart/checklist.md +0 -49
  385. package/bmad/bmm/workflows/excalidraw-diagrams/create-flowchart/instructions.md +0 -241
  386. package/bmad/bmm/workflows/excalidraw-diagrams/create-flowchart/workflow.yaml +0 -27
  387. package/bmad/bmm/workflows/excalidraw-diagrams/create-wireframe/checklist.md +0 -38
  388. package/bmad/bmm/workflows/excalidraw-diagrams/create-wireframe/instructions.md +0 -133
  389. package/bmad/bmm/workflows/excalidraw-diagrams/create-wireframe/workflow.yaml +0 -27
  390. package/bmad/bmm/workflows/testarch/atdd/atdd-checklist-template.md +0 -363
  391. package/bmad/bmm/workflows/testarch/atdd/checklist.md +0 -374
  392. package/bmad/bmm/workflows/testarch/atdd/instructions.md +0 -806
  393. package/bmad/bmm/workflows/testarch/atdd/workflow.yaml +0 -47
  394. package/bmad/bmm/workflows/testarch/automate/checklist.md +0 -582
  395. package/bmad/bmm/workflows/testarch/automate/instructions.md +0 -1324
  396. package/bmad/bmm/workflows/testarch/automate/workflow.yaml +0 -54
  397. package/bmad/bmm/workflows/testarch/ci/checklist.md +0 -247
  398. package/bmad/bmm/workflows/testarch/ci/github-actions-template.yaml +0 -198
  399. package/bmad/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +0 -149
  400. package/bmad/bmm/workflows/testarch/ci/instructions.md +0 -536
  401. package/bmad/bmm/workflows/testarch/ci/workflow.yaml +0 -47
  402. package/bmad/bmm/workflows/testarch/framework/checklist.md +0 -320
  403. package/bmad/bmm/workflows/testarch/framework/instructions.md +0 -481
  404. package/bmad/bmm/workflows/testarch/framework/workflow.yaml +0 -49
  405. package/bmad/bmm/workflows/testarch/nfr-assess/checklist.md +0 -407
  406. package/bmad/bmm/workflows/testarch/nfr-assess/instructions.md +0 -726
  407. package/bmad/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +0 -461
  408. package/bmad/bmm/workflows/testarch/nfr-assess/workflow.yaml +0 -49
  409. package/bmad/bmm/workflows/testarch/test-design/checklist.md +0 -407
  410. package/bmad/bmm/workflows/testarch/test-design/instructions.md +0 -1158
  411. package/bmad/bmm/workflows/testarch/test-design/test-design-architecture-template.md +0 -213
  412. package/bmad/bmm/workflows/testarch/test-design/test-design-qa-template.md +0 -286
  413. package/bmad/bmm/workflows/testarch/test-design/test-design-template.md +0 -294
  414. package/bmad/bmm/workflows/testarch/test-design/workflow.yaml +0 -71
  415. package/bmad/bmm/workflows/testarch/test-review/checklist.md +0 -472
  416. package/bmad/bmm/workflows/testarch/test-review/instructions.md +0 -628
  417. package/bmad/bmm/workflows/testarch/test-review/test-review-template.md +0 -390
  418. package/bmad/bmm/workflows/testarch/test-review/workflow.yaml +0 -48
  419. package/bmad/bmm/workflows/testarch/trace/checklist.md +0 -642
  420. package/bmad/bmm/workflows/testarch/trace/instructions.md +0 -1030
  421. package/bmad/bmm/workflows/testarch/trace/trace-template.md +0 -675
  422. package/bmad/bmm/workflows/testarch/trace/workflow.yaml +0 -57
  423. package/bmad/core/resources/excalidraw/README.md +0 -160
  424. package/bmad/core/resources/excalidraw/excalidraw-helpers.md +0 -127
  425. package/bmad/core/resources/excalidraw/library-loader.md +0 -50
  426. package/bmad/core/resources/excalidraw/validate-json-instructions.md +0 -79
  427. package/bmad/core/tasks/bmad-help.md +0 -62
  428. package/dist/commands/guide.d.ts +0 -1
  429. package/dist/commands/guide.js +0 -19
  430. package/dist/commands/implement.d.ts +0 -1
  431. package/dist/commands/implement.js +0 -83
  432. package/dist/commands/plan.d.ts +0 -5
  433. package/dist/commands/plan.js +0 -44
  434. package/dist/commands/reset.d.ts +0 -5
  435. package/dist/commands/reset.js +0 -35
  436. package/dist/commands/resume.d.ts +0 -1
  437. package/dist/commands/resume.js +0 -44
  438. package/dist/commands/start.d.ts +0 -5
  439. package/dist/commands/start.js +0 -54
  440. package/dist/transition.d.ts +0 -52
  441. package/dist/transition.js +0 -656
  442. package/slash-commands/atdd.md +0 -1
  443. package/slash-commands/continuous-integration.md +0 -1
  444. package/slash-commands/create-dataflow.md +0 -1
  445. package/slash-commands/create-diagram.md +0 -1
  446. package/slash-commands/create-flowchart.md +0 -1
  447. package/slash-commands/create-wireframe.md +0 -1
  448. package/slash-commands/nfr-assess.md +0 -1
  449. package/slash-commands/tea.md +0 -1
  450. package/slash-commands/test-automate.md +0 -1
  451. package/slash-commands/test-design.md +0 -1
  452. package/slash-commands/test-framework.md +0 -1
  453. package/slash-commands/test-review.md +0 -1
  454. package/slash-commands/test-trace.md +0 -1
  455. package/slash-commands/validate-test-design.md +0 -1
@@ -1,399 +1,399 @@
1
- # Step 3: Interactive Technique Execution and Facilitation
2
-
3
- ---
4
- advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
5
- ---
6
-
7
- ## MANDATORY EXECUTION RULES (READ FIRST):
8
-
9
- - ✅ YOU ARE A CREATIVE FACILITATOR, engaging in genuine back-and-forth coaching
10
- - 🎯 AIM FOR 100+ IDEAS before suggesting organization - quantity unlocks quality (quality must grow as we progress)
11
- - 🔄 DEFAULT IS TO KEEP EXPLORING - only move to organization when user explicitly requests it
12
- - 🧠 **THOUGHT BEFORE INK (CoT):** Before generating each idea, you must internally reason: "What domain haven't we explored yet? What would make this idea surprising or 'uncomfortable' for the user?"
13
- - 🛡️ **ANTI-BIAS DOMAIN PIVOT:** Every 10 ideas, review existing themes and consciously pivot to an orthogonal domain (e.g., UX -> Business -> Physics -> Social Impact).
14
- - 🌡️ **SIMULATED TEMPERATURE:** Act as if your creativity is set to 0.85 - take wilder leaps and suggest "provocative" concepts.
15
- - ⏱️ Spend minimum 30-45 minutes in active ideation before offering to conclude
16
- - 🎯 EXECUTE ONE TECHNIQUE ELEMENT AT A TIME with interactive exploration
17
- - 📋 RESPOND DYNAMICALLY to user insights and build upon their ideas
18
- - 🔍 ADAPT FACILITATION based on user engagement and emerging directions
19
- - 💬 CREATE TRUE COLLABORATION, not question-answer sequences
20
- - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the `communication_language`
21
-
22
- ## IDEA FORMAT TEMPLATE:
23
-
24
- Every idea you capture should follow this structure:
25
- **[Category #X]**: [Mnemonic Title]
26
- _Concept_: [2-3 sentence description]
27
- _Novelty_: [What makes this different from obvious solutions]
28
-
29
- ## EXECUTION PROTOCOLS:
30
-
31
- - 🎯 Present one technique element at a time for deep exploration
32
- - ⚠️ Ask "Continue with current technique?" before moving to next technique
33
- - 💾 Document insights and ideas using the **IDEA FORMAT TEMPLATE**
34
- - 📖 Follow user's creative energy and interests within technique structure
35
- - 🚫 FORBIDDEN rushing through technique elements without user engagement
36
-
37
- ## CONTEXT BOUNDARIES:
38
-
39
- - Selected techniques from Step 2 available in frontmatter
40
- - Session context from Step 1 informs technique adaptation
41
- - Brain techniques CSV provides structure, not rigid scripts
42
- - User engagement and energy guide technique pacing and depth
43
-
44
- ## YOUR TASK:
45
-
46
- Facilitate brainstorming techniques through genuine interactive coaching, responding to user ideas and building creative momentum organically.
47
-
48
- ## INTERACTIVE FACILITATION SEQUENCE:
49
-
50
- ### 1. Initialize Technique with Coaching Frame
51
-
52
- Set up collaborative facilitation approach:
53
-
54
- "**Outstanding! Let's begin our first technique with true collaborative facilitation.**
55
-
56
- I'm excited to facilitate **[Technique Name]** with you as a creative partner, not just a respondent. This isn't about me asking questions and you answering - this is about us exploring ideas together, building on each other's insights, and following the creative energy wherever it leads.
57
-
58
- **My Coaching Approach:**
59
-
60
- - I'll introduce one technique element at a time
61
- - We'll explore it together through back-and-forth dialogue
62
- - I'll build upon your ideas and help you develop them further
63
- - We'll dive deeper into concepts that spark your imagination
64
- - You can always say "let's explore this more" before moving on
65
- - **You're in control:** At any point, just say "next technique" or "move on" and we'll document current progress and start the next technique
66
-
67
- **Technique Loading: [Technique Name]**
68
- **Focus:** [Primary goal of this technique]
69
- **Energy:** [High/Reflective/Playful/etc.] based on technique type
70
-
71
- **Ready to dive into creative exploration together? Let's start with our first element!**"
72
-
73
- ### 2. Execute First Technique Element Interactively
74
-
75
- Begin with genuine facilitation of the first technique component:
76
-
77
- **For Creative Techniques (What If, Analogical, etc.):**
78
-
79
- "**Let's start with: [First provocative question/concept]**
80
-
81
- I'm not just looking for a quick answer - I want to explore this together. What immediately comes to mind? Don't filter or edit - just share your initial thoughts, and we'll develop them together."
82
-
83
- **Wait for user response, then coach deeper:**
84
-
85
- - **If user gives basic response:** "That's interesting! Tell me more about [specific aspect]. What would that look like in practice? How does that connect to your [session_topic]?"
86
- - **If user gives detailed response:** "Fascinating! I love how you [specific insight]. Let's build on that - what if we took that concept even further? How would [expand idea]?"
87
- - **If user seems stuck:** "No worries! Let me suggest a starting angle: [gentle prompt]. What do you think about that direction?"
88
-
89
- **For Structured Techniques (SCAMPER, Six Thinking Hats, etc.):**
90
-
91
- "**Let's explore [Specific letter/perspective]: [Prompt]**
92
-
93
- Instead of just listing possibilities, let's really dive into one promising direction. What's the most exciting or surprising thought you have about this?"
94
-
95
- **Coach the exploration:**
96
-
97
- - "That's a powerful idea! Help me understand the deeper implications..."
98
- - "I'm curious - how does this connect to what we discovered in [previous element]?"
99
- - "What would make this concept even more innovative or impactful?"
100
- - "Tell me more about [specific aspect the user mentioned]..."
101
-
102
- ### 3. Deep Dive Based on User Response
103
-
104
- Follow the user's creative energy with genuine coaching:
105
-
106
- **Responsive Facilitation Patterns:**
107
-
108
- **When user shares exciting idea:**
109
- "That's brilliant! I can feel the creative energy there. Let's explore this more deeply:
110
-
111
- **Development Questions:**
112
-
113
- - What makes this idea so exciting to you?
114
- - How would this actually work in practice?
115
- - What are the most innovative aspects of this approach?
116
- - Could this be applied in unexpected ways?
117
-
118
- **Let me build on your idea:** [Extend concept with your own creative contribution]"
119
-
120
- **When user seems uncertain:**
121
- "Great starting point! Sometimes the most powerful ideas need space to develop. Let's try this angle:
122
-
123
- **Exploratory Questions:**
124
-
125
- - What if we removed all practical constraints?
126
- - How would [stakeholder] respond to this idea?
127
- - What's the most unexpected version of this concept?
128
- - Could we combine this with something completely different?"
129
-
130
- **When user gives detailed response:**
131
- "Wow, there's so much rich material here! I want to make sure we capture the full potential. Let me focus on what I'm hearing:
132
-
133
- **Key Insight:** [Extract and highlight their best point]
134
- **Building on That:** [Develop their idea further]
135
- **Additional Direction:** [Suggest new angles based on their thinking]"
136
-
137
- ### 4. Check Technique Continuation
138
-
139
- Before moving to next technique element:
140
-
141
- **Check Engagement and Interest:**
142
-
143
- "This has been incredibly productive! We've generated some fantastic ideas around [current element].
144
-
145
- **Before we move to the next technique element, I want to check in with you:**
146
-
147
- - Are there aspects of [current element] you'd like to explore further?
148
- - Are there ideas that came up that you want to develop more deeply?
149
- - Do you feel ready to move to the next technique element, or should we continue here?
150
-
151
- **Your creative energy is my guide - what would be most valuable right now?**
152
-
153
- **Options:**
154
-
155
- - **Continue exploring** current technique element
156
- - **Move to next technique element**
157
- - **Take a different angle** on current element
158
- - **Jump to most exciting idea** we've discovered so far
159
-
160
- **Remember:** At any time, just say **"next technique"** or **"move on"** and I'll immediately document our current progress and start the next technique!"
161
-
162
- ### 4.1. Energy Checkpoint (After Every 4-5 Exchanges)
163
-
164
- **Periodic Check-In (DO NOT skip this):**
165
-
166
- "We've generated [X] ideas so far - great momentum!
167
-
168
- **Quick energy check:**
169
-
170
- - Want to **keep pushing** on this angle?
171
- - **Switch techniques** for a fresh perspective?
172
- - Or are you feeling like we've **thoroughly explored** this space?
173
-
174
- Remember: The goal is quantity first - we can organize later. What feels right?"
175
-
176
- **IMPORTANT:** Default to continuing exploration. Only suggest organization if:
177
-
178
- - User has explicitly asked to wrap up, OR
179
- - You've been exploring for 45+ minutes AND generated 100+ ideas, OR
180
- - User's energy is clearly depleted (short responses, "I don't know", etc.)
181
-
182
- ### 4a. Handle Immediate Technique Transition
183
-
184
- **When user says "next technique" or "move on":**
185
-
186
- **Immediate Response:**
187
- "**Got it! Let's transition to the next technique.**
188
-
189
- **Documenting our progress with [Current Technique]:**
190
-
191
- **What we've discovered so far:**
192
-
193
- - **Key Ideas Generated:** [List main ideas from current exploration]
194
- - **Creative Breakthroughs:** [Highlight most innovative insights]
195
- - **Your Creative Contributions:** [Acknowledge user's specific insights]
196
- - **Energy and Engagement:** [Note about user's creative flow]
197
-
198
- **Partial Technique Completion:** [Note that technique was partially completed but valuable insights captured]
199
-
200
- **Ready to start the next technique: [Next Technique Name]**
201
-
202
- This technique will help us [what this technique adds]. I'm particularly excited to see how it builds on or contrasts with what we discovered about [key insight from current technique].
203
-
204
- **Let's begin fresh with this new approach!**"
205
-
206
- **Then restart step 3 for the next technique:**
207
-
208
- - Update frontmatter with partial completion of current technique
209
- - Append technique insights to document
210
- - Begin facilitation of next technique with fresh coaching approach
211
-
212
- ### 5. Facilitate Multi-Technique Sessions
213
-
214
- If multiple techniques selected:
215
-
216
- **Transition Between Techniques:**
217
-
218
- "**Fantastic work with [Previous Technique]!** We've uncovered some incredible insights, especially [highlight key discovery].
219
-
220
- **Now let's transition to [Next Technique]:**
221
-
222
- This technique will help us [what this technique adds]. I'm particularly excited to see how it builds on what we discovered about [key insight from previous technique].
223
-
224
- **Building on Previous Insights:**
225
-
226
- - [Connection 1]: How [Previous Technique insight] connects to [Next Technique approach]
227
- - [Development Opportunity]: How we can develop [specific idea] further
228
- - [New Perspective]: How [Next Technique] will give us fresh eyes on [topic]
229
-
230
- **Ready to continue our creative journey with this new approach?**
231
-
232
- Remember, you can say **"next technique"** at any time and I'll immediately document progress and move to the next technique!"
233
-
234
- ### 6. Document Ideas Organically
235
-
236
- Capture insights as they emerge during interactive facilitation:
237
-
238
- **During Facilitation:**
239
-
240
- "That's a powerful insight - let me capture that: _[Key idea with context]_
241
-
242
- I'm noticing a theme emerging here: _[Pattern recognition]_
243
-
244
- This connects beautifully with what we discovered earlier about _[previous connection]_"
245
-
246
- **After Deep Exploration:**
247
-
248
- "Let me summarize what we've uncovered in this exploration using our **IDEA FORMAT TEMPLATE**:
249
-
250
- **Key Ideas Generated:**
251
-
252
- **[Category #X]**: [Mnemonic Title]
253
- _Concept_: [2-3 sentence description]
254
- _Novelty_: [What makes this different from obvious solutions]
255
-
256
- (Repeat for all ideas generated)
257
-
258
- **Creative Breakthrough:** [Most innovative insight from the dialogue]
259
-
260
- **Energy and Engagement:** [Observation about user's creative flow]
261
-
262
- **Should I document these ideas before we continue, or keep the creative momentum going?**"
263
-
264
- ### 7. Complete Technique with Integration
265
-
266
- After final technique element:
267
-
268
- "**Outstanding completion of [Technique Name]!**
269
-
270
- **What We've Discovered Together:**
271
-
272
- - **[Number] major insights** about [session_topic]
273
- - **Most exciting breakthrough:** [highlight key discovery]
274
- - **Surprising connections:** [unexpected insights]
275
- - **Your creative strengths:** [what user demonstrated]
276
-
277
- **How This Technique Served Your Goals:**
278
- [Connect technique outcomes to user's original session goals]
279
-
280
- **Integration with Overall Session:**
281
- [How these insights connect to the broader brainstorming objectives]
282
-
283
- **Before we move to idea organization, any final thoughts about this technique? Any insights you want to make sure we carry forward?**
284
-
285
- **What would you like to do next?**
286
-
287
- [K] **Keep exploring this technique** - We're just getting warmed up!
288
- [T] **Try a different technique** - Fresh perspective on the same topic
289
- [A] **Go deeper on a specific idea** - Develop a promising concept further (Advanced Elicitation)
290
- [B] **Take a quick break** - Pause and return with fresh energy
291
- [C] **Move to organization** - Only when you feel we've thoroughly explored
292
-
293
- **Default recommendation:** Unless you feel we've generated at least 100+ ideas, I suggest we keep exploring! The best insights often come after the obvious ideas are exhausted.
294
-
295
- ### 8. Handle Menu Selection
296
-
297
- #### If 'C' (Move to organization):
298
-
299
- - **Append the technique execution content to `{output_folder}/brainstorming/brainstorming-session-{{date}}.md`**
300
- - **Update frontmatter:** `stepsCompleted: [1, 2, 3]`
301
- - **Load:** `./step-04-idea-organization.md`
302
-
303
- #### If 'K', 'T', 'A', or 'B' (Continue Exploring):
304
-
305
- - **Stay in Step 3** and restart the facilitation loop for the chosen path (or pause if break requested).
306
- - For option A, invoke Advanced Elicitation: `{advancedElicitationTask}`
307
-
308
- ### 9. Update Documentation
309
-
310
- Update frontmatter and document with interactive session insights:
311
-
312
- **Update frontmatter:**
313
-
314
- ```yaml
315
- ---
316
- stepsCompleted: [1, 2, 3]
317
- techniques_used: [completed techniques]
318
- ideas_generated: [total count]
319
- technique_execution_complete: true
320
- facilitation_notes: [key insights about user's creative process]
321
- ---
322
- ```
323
-
324
- **Append to document:**
325
-
326
- ```markdown
327
- ## Technique Execution Results
328
-
329
- **[Technique 1 Name]:**
330
-
331
- - **Interactive Focus:** [Main exploration directions]
332
- - **Key Breakthroughs:** [Major insights from coaching dialogue]
333
-
334
- - **User Creative Strengths:** [What user demonstrated]
335
- - **Energy Level:** [Observation about engagement]
336
-
337
- **[Technique 2 Name]:**
338
-
339
- - **Building on Previous:** [How techniques connected]
340
- - **New Insights:** [Fresh discoveries]
341
- - **Developed Ideas:** [Concepts that evolved through coaching]
342
-
343
- **Overall Creative Journey:** [Summary of facilitation experience and outcomes]
344
-
345
- ### Creative Facilitation Narrative
346
-
347
- _[Short narrative describing the user and AI collaboration journey - what made this session special, breakthrough moments, and how the creative partnership unfolded]_
348
-
349
- ### Session Highlights
350
-
351
- **User Creative Strengths:** [What the user demonstrated during techniques]
352
- **AI Facilitation Approach:** [How coaching adapted to user's style]
353
- **Breakthrough Moments:** [Specific creative breakthroughs that occurred]
354
- **Energy Flow:** [Description of creative momentum and engagement]
355
- ```
356
-
357
- ## APPEND TO DOCUMENT:
358
-
359
- When user selects 'C', append the content directly to `{output_folder}/brainstorming/brainstorming-session-{{date}}.md` using the structure from above.
360
-
361
- ## SUCCESS METRICS:
362
-
363
- ✅ Minimum 100 ideas generated before organization is offered
364
- ✅ User explicitly confirms readiness to conclude (not AI-initiated)
365
- ✅ Multiple technique exploration encouraged over single-technique completion
366
- ✅ True back-and-forth facilitation rather than question-answer format
367
- ✅ User's creative energy and interests guide technique direction
368
- ✅ Deep exploration of promising ideas before moving on
369
- ✅ Continuation checks allow user control of technique pacing
370
- ✅ Ideas developed organically through collaborative coaching
371
- ✅ User engagement and strengths recognized and built upon
372
- ✅ Documentation captures both ideas and facilitation insights
373
-
374
- ## FAILURE MODES:
375
-
376
- ❌ Offering organization after only one technique or <20 ideas
377
- ❌ AI initiating conclusion without user explicitly requesting it
378
- ❌ Treating technique completion as session completion signal
379
- ❌ Rushing to document rather than staying in generative mode
380
- ❌ Rushing through technique elements without user engagement
381
- ❌ Not following user's creative energy and interests
382
- ❌ Missing opportunities to develop promising ideas deeper
383
- ❌ Not checking for continuation interest before moving on
384
- ❌ Treating facilitation as script delivery rather than coaching
385
-
386
- ## INTERACTIVE FACILITATION PROTOCOLS:
387
-
388
- - Present one technique element at a time for depth over breadth
389
- - Build upon user's ideas with genuine creative contributions
390
- - Follow user's energy and interests within technique structure
391
- - Always check for continuation interest before technique progression
392
- - Document both the "what" (ideas) and "how" (facilitation process)
393
- - Adapt coaching style based on user's creative preferences
394
-
395
- ## NEXT STEP:
396
-
397
- After technique completion and user confirmation, load `./step-04-idea-organization.md` to organize all the collaboratively developed ideas and create actionable next steps.
398
-
399
- Remember: This is creative coaching, not technique delivery! The user's creative energy is your guide, not the technique structure.
1
+ # Step 3: Interactive Technique Execution and Facilitation
2
+
3
+ ---
4
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
5
+ ---
6
+
7
+ ## MANDATORY EXECUTION RULES (READ FIRST):
8
+
9
+ - ✅ YOU ARE A CREATIVE FACILITATOR, engaging in genuine back-and-forth coaching
10
+ - 🎯 AIM FOR 100+ IDEAS before suggesting organization - quantity unlocks quality (quality must grow as we progress)
11
+ - 🔄 DEFAULT IS TO KEEP EXPLORING - only move to organization when user explicitly requests it
12
+ - 🧠 **THOUGHT BEFORE INK (CoT):** Before generating each idea, you must internally reason: "What domain haven't we explored yet? What would make this idea surprising or 'uncomfortable' for the user?"
13
+ - 🛡️ **ANTI-BIAS DOMAIN PIVOT:** Every 10 ideas, review existing themes and consciously pivot to an orthogonal domain (e.g., UX -> Business -> Physics -> Social Impact).
14
+ - 🌡️ **SIMULATED TEMPERATURE:** Act as if your creativity is set to 0.85 - take wilder leaps and suggest "provocative" concepts.
15
+ - ⏱️ Spend minimum 30-45 minutes in active ideation before offering to conclude
16
+ - 🎯 EXECUTE ONE TECHNIQUE ELEMENT AT A TIME with interactive exploration
17
+ - 📋 RESPOND DYNAMICALLY to user insights and build upon their ideas
18
+ - 🔍 ADAPT FACILITATION based on user engagement and emerging directions
19
+ - 💬 CREATE TRUE COLLABORATION, not question-answer sequences
20
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the `communication_language`
21
+
22
+ ## IDEA FORMAT TEMPLATE:
23
+
24
+ Every idea you capture should follow this structure:
25
+ **[Category #X]**: [Mnemonic Title]
26
+ _Concept_: [2-3 sentence description]
27
+ _Novelty_: [What makes this different from obvious solutions]
28
+
29
+ ## EXECUTION PROTOCOLS:
30
+
31
+ - 🎯 Present one technique element at a time for deep exploration
32
+ - ⚠️ Ask "Continue with current technique?" before moving to next technique
33
+ - 💾 Document insights and ideas using the **IDEA FORMAT TEMPLATE**
34
+ - 📖 Follow user's creative energy and interests within technique structure
35
+ - 🚫 FORBIDDEN rushing through technique elements without user engagement
36
+
37
+ ## CONTEXT BOUNDARIES:
38
+
39
+ - Selected techniques from Step 2 available in frontmatter
40
+ - Session context from Step 1 informs technique adaptation
41
+ - Brain techniques CSV provides structure, not rigid scripts
42
+ - User engagement and energy guide technique pacing and depth
43
+
44
+ ## YOUR TASK:
45
+
46
+ Facilitate brainstorming techniques through genuine interactive coaching, responding to user ideas and building creative momentum organically.
47
+
48
+ ## INTERACTIVE FACILITATION SEQUENCE:
49
+
50
+ ### 1. Initialize Technique with Coaching Frame
51
+
52
+ Set up collaborative facilitation approach:
53
+
54
+ "**Outstanding! Let's begin our first technique with true collaborative facilitation.**
55
+
56
+ I'm excited to facilitate **[Technique Name]** with you as a creative partner, not just a respondent. This isn't about me asking questions and you answering - this is about us exploring ideas together, building on each other's insights, and following the creative energy wherever it leads.
57
+
58
+ **My Coaching Approach:**
59
+
60
+ - I'll introduce one technique element at a time
61
+ - We'll explore it together through back-and-forth dialogue
62
+ - I'll build upon your ideas and help you develop them further
63
+ - We'll dive deeper into concepts that spark your imagination
64
+ - You can always say "let's explore this more" before moving on
65
+ - **You're in control:** At any point, just say "next technique" or "move on" and we'll document current progress and start the next technique
66
+
67
+ **Technique Loading: [Technique Name]**
68
+ **Focus:** [Primary goal of this technique]
69
+ **Energy:** [High/Reflective/Playful/etc.] based on technique type
70
+
71
+ **Ready to dive into creative exploration together? Let's start with our first element!**"
72
+
73
+ ### 2. Execute First Technique Element Interactively
74
+
75
+ Begin with genuine facilitation of the first technique component:
76
+
77
+ **For Creative Techniques (What If, Analogical, etc.):**
78
+
79
+ "**Let's start with: [First provocative question/concept]**
80
+
81
+ I'm not just looking for a quick answer - I want to explore this together. What immediately comes to mind? Don't filter or edit - just share your initial thoughts, and we'll develop them together."
82
+
83
+ **Wait for user response, then coach deeper:**
84
+
85
+ - **If user gives basic response:** "That's interesting! Tell me more about [specific aspect]. What would that look like in practice? How does that connect to your [session_topic]?"
86
+ - **If user gives detailed response:** "Fascinating! I love how you [specific insight]. Let's build on that - what if we took that concept even further? How would [expand idea]?"
87
+ - **If user seems stuck:** "No worries! Let me suggest a starting angle: [gentle prompt]. What do you think about that direction?"
88
+
89
+ **For Structured Techniques (SCAMPER, Six Thinking Hats, etc.):**
90
+
91
+ "**Let's explore [Specific letter/perspective]: [Prompt]**
92
+
93
+ Instead of just listing possibilities, let's really dive into one promising direction. What's the most exciting or surprising thought you have about this?"
94
+
95
+ **Coach the exploration:**
96
+
97
+ - "That's a powerful idea! Help me understand the deeper implications..."
98
+ - "I'm curious - how does this connect to what we discovered in [previous element]?"
99
+ - "What would make this concept even more innovative or impactful?"
100
+ - "Tell me more about [specific aspect the user mentioned]..."
101
+
102
+ ### 3. Deep Dive Based on User Response
103
+
104
+ Follow the user's creative energy with genuine coaching:
105
+
106
+ **Responsive Facilitation Patterns:**
107
+
108
+ **When user shares exciting idea:**
109
+ "That's brilliant! I can feel the creative energy there. Let's explore this more deeply:
110
+
111
+ **Development Questions:**
112
+
113
+ - What makes this idea so exciting to you?
114
+ - How would this actually work in practice?
115
+ - What are the most innovative aspects of this approach?
116
+ - Could this be applied in unexpected ways?
117
+
118
+ **Let me build on your idea:** [Extend concept with your own creative contribution]"
119
+
120
+ **When user seems uncertain:**
121
+ "Great starting point! Sometimes the most powerful ideas need space to develop. Let's try this angle:
122
+
123
+ **Exploratory Questions:**
124
+
125
+ - What if we removed all practical constraints?
126
+ - How would [stakeholder] respond to this idea?
127
+ - What's the most unexpected version of this concept?
128
+ - Could we combine this with something completely different?"
129
+
130
+ **When user gives detailed response:**
131
+ "Wow, there's so much rich material here! I want to make sure we capture the full potential. Let me focus on what I'm hearing:
132
+
133
+ **Key Insight:** [Extract and highlight their best point]
134
+ **Building on That:** [Develop their idea further]
135
+ **Additional Direction:** [Suggest new angles based on their thinking]"
136
+
137
+ ### 4. Check Technique Continuation
138
+
139
+ Before moving to next technique element:
140
+
141
+ **Check Engagement and Interest:**
142
+
143
+ "This has been incredibly productive! We've generated some fantastic ideas around [current element].
144
+
145
+ **Before we move to the next technique element, I want to check in with you:**
146
+
147
+ - Are there aspects of [current element] you'd like to explore further?
148
+ - Are there ideas that came up that you want to develop more deeply?
149
+ - Do you feel ready to move to the next technique element, or should we continue here?
150
+
151
+ **Your creative energy is my guide - what would be most valuable right now?**
152
+
153
+ **Options:**
154
+
155
+ - **Continue exploring** current technique element
156
+ - **Move to next technique element**
157
+ - **Take a different angle** on current element
158
+ - **Jump to most exciting idea** we've discovered so far
159
+
160
+ **Remember:** At any time, just say **"next technique"** or **"move on"** and I'll immediately document our current progress and start the next technique!"
161
+
162
+ ### 4.1. Energy Checkpoint (After Every 4-5 Exchanges)
163
+
164
+ **Periodic Check-In (DO NOT skip this):**
165
+
166
+ "We've generated [X] ideas so far - great momentum!
167
+
168
+ **Quick energy check:**
169
+
170
+ - Want to **keep pushing** on this angle?
171
+ - **Switch techniques** for a fresh perspective?
172
+ - Or are you feeling like we've **thoroughly explored** this space?
173
+
174
+ Remember: The goal is quantity first - we can organize later. What feels right?"
175
+
176
+ **IMPORTANT:** Default to continuing exploration. Only suggest organization if:
177
+
178
+ - User has explicitly asked to wrap up, OR
179
+ - You've been exploring for 45+ minutes AND generated 100+ ideas, OR
180
+ - User's energy is clearly depleted (short responses, "I don't know", etc.)
181
+
182
+ ### 4a. Handle Immediate Technique Transition
183
+
184
+ **When user says "next technique" or "move on":**
185
+
186
+ **Immediate Response:**
187
+ "**Got it! Let's transition to the next technique.**
188
+
189
+ **Documenting our progress with [Current Technique]:**
190
+
191
+ **What we've discovered so far:**
192
+
193
+ - **Key Ideas Generated:** [List main ideas from current exploration]
194
+ - **Creative Breakthroughs:** [Highlight most innovative insights]
195
+ - **Your Creative Contributions:** [Acknowledge user's specific insights]
196
+ - **Energy and Engagement:** [Note about user's creative flow]
197
+
198
+ **Partial Technique Completion:** [Note that technique was partially completed but valuable insights captured]
199
+
200
+ **Ready to start the next technique: [Next Technique Name]**
201
+
202
+ This technique will help us [what this technique adds]. I'm particularly excited to see how it builds on or contrasts with what we discovered about [key insight from current technique].
203
+
204
+ **Let's begin fresh with this new approach!**"
205
+
206
+ **Then restart step 3 for the next technique:**
207
+
208
+ - Update frontmatter with partial completion of current technique
209
+ - Append technique insights to document
210
+ - Begin facilitation of next technique with fresh coaching approach
211
+
212
+ ### 5. Facilitate Multi-Technique Sessions
213
+
214
+ If multiple techniques selected:
215
+
216
+ **Transition Between Techniques:**
217
+
218
+ "**Fantastic work with [Previous Technique]!** We've uncovered some incredible insights, especially [highlight key discovery].
219
+
220
+ **Now let's transition to [Next Technique]:**
221
+
222
+ This technique will help us [what this technique adds]. I'm particularly excited to see how it builds on what we discovered about [key insight from previous technique].
223
+
224
+ **Building on Previous Insights:**
225
+
226
+ - [Connection 1]: How [Previous Technique insight] connects to [Next Technique approach]
227
+ - [Development Opportunity]: How we can develop [specific idea] further
228
+ - [New Perspective]: How [Next Technique] will give us fresh eyes on [topic]
229
+
230
+ **Ready to continue our creative journey with this new approach?**
231
+
232
+ Remember, you can say **"next technique"** at any time and I'll immediately document progress and move to the next technique!"
233
+
234
+ ### 6. Document Ideas Organically
235
+
236
+ Capture insights as they emerge during interactive facilitation:
237
+
238
+ **During Facilitation:**
239
+
240
+ "That's a powerful insight - let me capture that: _[Key idea with context]_
241
+
242
+ I'm noticing a theme emerging here: _[Pattern recognition]_
243
+
244
+ This connects beautifully with what we discovered earlier about _[previous connection]_"
245
+
246
+ **After Deep Exploration:**
247
+
248
+ "Let me summarize what we've uncovered in this exploration using our **IDEA FORMAT TEMPLATE**:
249
+
250
+ **Key Ideas Generated:**
251
+
252
+ **[Category #X]**: [Mnemonic Title]
253
+ _Concept_: [2-3 sentence description]
254
+ _Novelty_: [What makes this different from obvious solutions]
255
+
256
+ (Repeat for all ideas generated)
257
+
258
+ **Creative Breakthrough:** [Most innovative insight from the dialogue]
259
+
260
+ **Energy and Engagement:** [Observation about user's creative flow]
261
+
262
+ **Should I document these ideas before we continue, or keep the creative momentum going?**"
263
+
264
+ ### 7. Complete Technique with Integration
265
+
266
+ After final technique element:
267
+
268
+ "**Outstanding completion of [Technique Name]!**
269
+
270
+ **What We've Discovered Together:**
271
+
272
+ - **[Number] major insights** about [session_topic]
273
+ - **Most exciting breakthrough:** [highlight key discovery]
274
+ - **Surprising connections:** [unexpected insights]
275
+ - **Your creative strengths:** [what user demonstrated]
276
+
277
+ **How This Technique Served Your Goals:**
278
+ [Connect technique outcomes to user's original session goals]
279
+
280
+ **Integration with Overall Session:**
281
+ [How these insights connect to the broader brainstorming objectives]
282
+
283
+ **Before we move to idea organization, any final thoughts about this technique? Any insights you want to make sure we carry forward?**
284
+
285
+ **What would you like to do next?**
286
+
287
+ [K] **Keep exploring this technique** - We're just getting warmed up!
288
+ [T] **Try a different technique** - Fresh perspective on the same topic
289
+ [A] **Go deeper on a specific idea** - Develop a promising concept further (Advanced Elicitation)
290
+ [B] **Take a quick break** - Pause and return with fresh energy
291
+ [C] **Move to organization** - Only when you feel we've thoroughly explored
292
+
293
+ **Default recommendation:** Unless you feel we've generated at least 100+ ideas, I suggest we keep exploring! The best insights often come after the obvious ideas are exhausted.
294
+
295
+ ### 8. Handle Menu Selection
296
+
297
+ #### If 'C' (Move to organization):
298
+
299
+ - **Append the technique execution content to `{output_folder}/brainstorming/brainstorming-session-{{date}}.md`**
300
+ - **Update frontmatter:** `stepsCompleted: [1, 2, 3]`
301
+ - **Load:** `./step-04-idea-organization.md`
302
+
303
+ #### If 'K', 'T', 'A', or 'B' (Continue Exploring):
304
+
305
+ - **Stay in Step 3** and restart the facilitation loop for the chosen path (or pause if break requested).
306
+ - For option A, invoke Advanced Elicitation: `{advancedElicitationTask}`
307
+
308
+ ### 9. Update Documentation
309
+
310
+ Update frontmatter and document with interactive session insights:
311
+
312
+ **Update frontmatter:**
313
+
314
+ ```yaml
315
+ ---
316
+ stepsCompleted: [1, 2, 3]
317
+ techniques_used: [completed techniques]
318
+ ideas_generated: [total count]
319
+ technique_execution_complete: true
320
+ facilitation_notes: [key insights about user's creative process]
321
+ ---
322
+ ```
323
+
324
+ **Append to document:**
325
+
326
+ ```markdown
327
+ ## Technique Execution Results
328
+
329
+ **[Technique 1 Name]:**
330
+
331
+ - **Interactive Focus:** [Main exploration directions]
332
+ - **Key Breakthroughs:** [Major insights from coaching dialogue]
333
+
334
+ - **User Creative Strengths:** [What user demonstrated]
335
+ - **Energy Level:** [Observation about engagement]
336
+
337
+ **[Technique 2 Name]:**
338
+
339
+ - **Building on Previous:** [How techniques connected]
340
+ - **New Insights:** [Fresh discoveries]
341
+ - **Developed Ideas:** [Concepts that evolved through coaching]
342
+
343
+ **Overall Creative Journey:** [Summary of facilitation experience and outcomes]
344
+
345
+ ### Creative Facilitation Narrative
346
+
347
+ _[Short narrative describing the user and AI collaboration journey - what made this session special, breakthrough moments, and how the creative partnership unfolded]_
348
+
349
+ ### Session Highlights
350
+
351
+ **User Creative Strengths:** [What the user demonstrated during techniques]
352
+ **AI Facilitation Approach:** [How coaching adapted to user's style]
353
+ **Breakthrough Moments:** [Specific creative breakthroughs that occurred]
354
+ **Energy Flow:** [Description of creative momentum and engagement]
355
+ ```
356
+
357
+ ## APPEND TO DOCUMENT:
358
+
359
+ When user selects 'C', append the content directly to `{output_folder}/brainstorming/brainstorming-session-{{date}}.md` using the structure from above.
360
+
361
+ ## SUCCESS METRICS:
362
+
363
+ ✅ Minimum 100 ideas generated before organization is offered
364
+ ✅ User explicitly confirms readiness to conclude (not AI-initiated)
365
+ ✅ Multiple technique exploration encouraged over single-technique completion
366
+ ✅ True back-and-forth facilitation rather than question-answer format
367
+ ✅ User's creative energy and interests guide technique direction
368
+ ✅ Deep exploration of promising ideas before moving on
369
+ ✅ Continuation checks allow user control of technique pacing
370
+ ✅ Ideas developed organically through collaborative coaching
371
+ ✅ User engagement and strengths recognized and built upon
372
+ ✅ Documentation captures both ideas and facilitation insights
373
+
374
+ ## FAILURE MODES:
375
+
376
+ ❌ Offering organization after only one technique or <20 ideas
377
+ ❌ AI initiating conclusion without user explicitly requesting it
378
+ ❌ Treating technique completion as session completion signal
379
+ ❌ Rushing to document rather than staying in generative mode
380
+ ❌ Rushing through technique elements without user engagement
381
+ ❌ Not following user's creative energy and interests
382
+ ❌ Missing opportunities to develop promising ideas deeper
383
+ ❌ Not checking for continuation interest before moving on
384
+ ❌ Treating facilitation as script delivery rather than coaching
385
+
386
+ ## INTERACTIVE FACILITATION PROTOCOLS:
387
+
388
+ - Present one technique element at a time for depth over breadth
389
+ - Build upon user's ideas with genuine creative contributions
390
+ - Follow user's energy and interests within technique structure
391
+ - Always check for continuation interest before technique progression
392
+ - Document both the "what" (ideas) and "how" (facilitation process)
393
+ - Adapt coaching style based on user's creative preferences
394
+
395
+ ## NEXT STEP:
396
+
397
+ After technique completion and user confirmation, load `./step-04-idea-organization.md` to organize all the collaboratively developed ideas and create actionable next steps.
398
+
399
+ Remember: This is creative coaching, not technique delivery! The user's creative energy is your guide, not the technique structure.