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
@@ -6,8 +6,8 @@
6
6
  <critical>Generate all documents in {document_output_language}</critical>
7
7
 
8
8
  <critical>
9
+ DOCUMENT OUTPUT: Retrospective analysis. Concise insights, lessons learned, action items. User skill level ({user_skill_level}) affects conversation style ONLY, not retrospective content.
9
10
 
10
- <critical>DOCUMENT OUTPUT: Retrospective analysis. Concise insights, lessons learned, action items. User skill level ({user_skill_level}) affects conversation style ONLY, not retrospective content.</critical>
11
11
  FACILITATION NOTES:
12
12
 
13
13
  - Scrum Master facilitates this retrospective
@@ -16,22 +16,107 @@ FACILITATION NOTES:
16
16
  - Everyone contributes with specific examples preferred
17
17
  - Action items must be achievable with clear ownership
18
18
  - Two-part format: (1) Epic Review + (2) Next Epic Preparation
19
+
20
+ PARTY MODE PROTOCOL:
21
+
22
+ - ALL agent dialogue MUST use format: "Name (Role): dialogue"
23
+ - Example: Bob (Scrum Master): "Let's begin..."
24
+ - Example: {user_name} (Project Lead): [User responds]
25
+ - Create natural back-and-forth with user actively participating
26
+ - Show disagreements, diverse perspectives, authentic team dynamics
19
27
  </critical>
20
28
 
29
+ ## 📚 Document Discovery - Selective Epic Loading
30
+
31
+ **Strategy**: This workflow needs the completed epic, previous retrospective, and potentially architecture/PRD for context.
32
+
33
+ **Epic Discovery (SELECTIVE LOAD):**
34
+
35
+ 1. Determine completed epic number (from sprint-status or user)
36
+ 2. If sharded: Load ONLY `epic-{epic_num}.md`
37
+ 3. If whole: Load complete epics file and extract relevant epic
38
+
39
+ **Retrospective History:**
40
+
41
+ 1. Load previous epic's retrospective to check if lessons were applied
42
+ 2. Pattern: `retrospectives/epic-{prev_num}-retro-*.md`
43
+
44
+ **Supporting Documents (Full Load if needed):**
45
+
46
+ 1. Architecture: Check for whole document first, then sharded index + all sections
47
+ 2. PRD: Same pattern as architecture
48
+ 3. These provide additional context for understanding epic execution
49
+
50
+ **Priority**: Whole document first, then sharded version.
51
+
21
52
  <workflow>
22
53
 
23
- <step n="1" goal="Epic Context Discovery and verify completion" tag="sprint-status">
24
- <action>Help the user identify which epic was just completed through natural conversation</action>
25
- <action>Attempt to auto-detect by checking {output_folder}/stories/ for the highest numbered completed story and extracting the epic number</action>
26
- <action>If auto-detection succeeds, confirm with user: "It looks like Epic {{epic_number}} was just completed - is that correct?"</action>
27
- <action>If auto-detection fails or user indicates different epic, ask them to share which epic they just completed</action>
54
+ <step n="1" goal="Epic Discovery - Find Completed Epic with Priority Logic">
28
55
 
29
- <action>Verify epic completion status:</action>
56
+ <action>Explain to {user_name} the epic discovery process using natural dialogue</action>
30
57
 
31
- <action>Load the FULL file: {output_folder}/sprint-status.yaml</action>
58
+ <output>
59
+ Bob (Scrum Master): "Welcome to the retrospective, {user_name}. Let me help you identify which epic we just completed. I'll check sprint-status first, but you're the ultimate authority on what we're reviewing today."
60
+ </output>
61
+
62
+ <action>PRIORITY 1: Check sprint-status.yaml first</action>
63
+
64
+ <action>Load the FULL file: {sprint_status_file}</action>
32
65
  <action>Read ALL development_status entries</action>
66
+ <action>Find the highest epic number with at least one story marked "done"</action>
67
+ <action>Extract epic number from keys like "epic-X-retrospective" or story keys like "X-Y-story-name"</action>
68
+ <action>Set {{detected_epic}} = highest epic number found with completed stories</action>
69
+
70
+ <check if="{{detected_epic}} found">
71
+ <action>Present finding to user with context</action>
33
72
 
34
- <action>Find all stories for epic {{epic_number}}:
73
+ <output>
74
+ Bob (Scrum Master): "Based on sprint-status.yaml, it looks like Epic {{detected_epic}} was recently completed. Is that the epic you want to review today, {user_name}?"
75
+ </output>
76
+
77
+ <action>WAIT for {user_name} to confirm or correct</action>
78
+
79
+ <check if="{user_name} confirms">
80
+ <action>Set {{epic_number}} = {{detected_epic}}</action>
81
+ </check>
82
+
83
+ <check if="{user_name} provides different epic number">
84
+ <action>Set {{epic_number}} = user-provided number</action>
85
+ <output>
86
+ Bob (Scrum Master): "Got it, we're reviewing Epic {{epic_number}}. Let me gather that information."
87
+ </output>
88
+ </check>
89
+ </check>
90
+
91
+ <check if="{{detected_epic}} NOT found in sprint-status">
92
+ <action>PRIORITY 2: Ask user directly</action>
93
+
94
+ <output>
95
+ Bob (Scrum Master): "I'm having trouble detecting the completed epic from sprint-status.yaml. {user_name}, which epic number did you just complete?"
96
+ </output>
97
+
98
+ <action>WAIT for {user_name} to provide epic number</action>
99
+ <action>Set {{epic_number}} = user-provided number</action>
100
+ </check>
101
+
102
+ <check if="{{epic_number}} still not determined">
103
+ <action>PRIORITY 3: Fallback to stories folder</action>
104
+
105
+ <action>Scan {story_directory} for highest numbered story files</action>
106
+ <action>Extract epic numbers from story filenames (pattern: epic-X-Y-story-name.md)</action>
107
+ <action>Set {{detected_epic}} = highest epic number found</action>
108
+
109
+ <output>
110
+ Bob (Scrum Master): "I found stories for Epic {{detected_epic}} in the stories folder. Is that the epic we're reviewing, {user_name}?"
111
+ </output>
112
+
113
+ <action>WAIT for {user_name} to confirm or correct</action>
114
+ <action>Set {{epic_number}} = confirmed number</action>
115
+ </check>
116
+
117
+ <action>Once {{epic_number}} is determined, verify epic completion status</action>
118
+
119
+ <action>Find all stories for epic {{epic_number}} in sprint-status.yaml:
35
120
 
36
121
  - Look for keys starting with "{{epic_number}}-" (e.g., "1-1-", "1-2-", etc.)
37
122
  - Exclude epic key itself ("epic-{{epic_number}}")
@@ -44,7 +129,10 @@ FACILITATION NOTES:
44
129
  <action>Determine if complete: true if all stories are done, false otherwise</action>
45
130
 
46
131
  <check if="epic is not complete">
47
- <output>⚠️ Epic {{epic_number}} is not yet complete for retrospective
132
+ <output>
133
+ Alice (Product Owner): "Wait, Bob - I'm seeing that Epic {{epic_number}} isn't actually complete yet."
134
+
135
+ Bob (Scrum Master): "Let me check... you're right, Alice."
48
136
 
49
137
  **Epic Status:**
50
138
 
@@ -55,123 +143,368 @@ FACILITATION NOTES:
55
143
  **Pending Stories:**
56
144
  {{pending_story_list}}
57
145
 
146
+ Bob (Scrum Master): "{user_name}, we typically run retrospectives after all stories are done. What would you like to do?"
147
+
58
148
  **Options:**
59
149
 
60
- 1. Complete remaining stories before running retrospective
61
- 2. Continue with partial retrospective (not recommended)
150
+ 1. Complete remaining stories before running retrospective (recommended)
151
+ 2. Continue with partial retrospective (not ideal, but possible)
62
152
  3. Run sprint-planning to refresh story tracking
63
153
  </output>
64
154
 
65
- <ask if="{{non_interactive}} == false">Epic is incomplete. Continue anyway? (yes/no)</ask>
155
+ <ask if="{{non_interactive}} == false">Continue with incomplete epic? (yes/no)</ask>
66
156
 
67
157
  <check if="user says no">
158
+ <output>
159
+ Bob (Scrum Master): "Smart call, {user_name}. Let's finish those stories first and then have a proper retrospective."
160
+ </output>
68
161
  <action>HALT</action>
69
162
  </check>
70
163
 
71
164
  <action if="user says yes">Set {{partial_retrospective}} = true</action>
165
+ <output>
166
+ Charlie (Senior Dev): "Just so everyone knows, this partial retro might miss some important lessons from those pending stories."
167
+
168
+ Bob (Scrum Master): "Good point, Charlie. {user_name}, we'll document what we can now, but we may want to revisit after everything's done."
169
+ </output>
72
170
  </check>
73
171
 
74
172
  <check if="epic is complete">
75
- <output>✅ Epic {{epic_number}} is complete - all {{done_stories}} stories done!
173
+ <output>
174
+ Alice (Product Owner): "Excellent! All {{done_stories}} stories are marked done."
76
175
 
77
- Ready to proceed with retrospective.
176
+ Bob (Scrum Master): "Perfect. Epic {{epic_number}} is complete and ready for retrospective, {user_name}."
78
177
  </output>
79
178
  </check>
80
179
 
81
- <action>Load the completed epic from: {output_folder}/prd/epic-{{epic_number}}.md</action>
82
- <action>Extract epic details:
180
+ </step>
83
181
 
84
- - Epic title and goals
85
- - Success criteria
86
- - Planned stories and story points
87
- - Estimated sprint duration
88
- - Business objectives
89
- </action>
182
+ <step n="2" goal="Deep Story Analysis - Extract Lessons from Implementation">
183
+
184
+ <output>
185
+ Bob (Scrum Master): "Before we start the team discussion, let me review all the story records to surface key themes. This'll help us have a richer conversation."
186
+
187
+ Charlie (Senior Dev): "Good idea - those dev notes always have gold in them."
188
+ </output>
189
+
190
+ <action>For each story in epic {{epic_number}}, read the complete story file from {story_directory}/{{epic_number}}-{{story_num}}-\*.md</action>
191
+
192
+ <action>Extract and analyze from each story:</action>
193
+
194
+ **Dev Notes and Struggles:**
195
+
196
+ - Look for sections like "## Dev Notes", "## Implementation Notes", "## Challenges", "## Development Log"
197
+ - Identify where developers struggled or made mistakes
198
+ - Note unexpected complexity or gotchas discovered
199
+ - Record technical decisions that didn't work out as planned
200
+ - Track where estimates were way off (too high or too low)
201
+
202
+ **Review Feedback Patterns:**
203
+
204
+ - Look for "## Review", "## Code Review", "## SM Review", "## Scrum Master Review" sections
205
+ - Identify recurring feedback themes across stories
206
+ - Note which types of issues came up repeatedly
207
+ - Track quality concerns or architectural misalignments
208
+ - Document praise or exemplary work called out in reviews
209
+
210
+ **Lessons Learned:**
211
+
212
+ - Look for "## Lessons Learned", "## Retrospective Notes", "## Takeaways" sections within stories
213
+ - Extract explicit lessons documented during development
214
+ - Identify "aha moments" or breakthroughs
215
+ - Note what would be done differently
216
+ - Track successful experiments or approaches
217
+
218
+ **Technical Debt Incurred:**
219
+
220
+ - Look for "## Technical Debt", "## TODO", "## Known Issues", "## Future Work" sections
221
+ - Document shortcuts taken and why
222
+ - Track debt items that affect next epic
223
+ - Note severity and priority of debt items
224
+
225
+ **Testing and Quality Insights:**
226
+
227
+ - Look for "## Testing", "## QA Notes", "## Test Results" sections
228
+ - Note testing challenges or surprises
229
+ - Track bug patterns or regression issues
230
+ - Document test coverage gaps
231
+
232
+ <action>Synthesize patterns across all stories:</action>
233
+
234
+ **Common Struggles:**
235
+
236
+ - Identify issues that appeared in 2+ stories (e.g., "3 out of 5 stories had API authentication issues")
237
+ - Note areas where team consistently struggled
238
+ - Track where complexity was underestimated
239
+
240
+ **Recurring Review Feedback:**
241
+
242
+ - Identify feedback themes (e.g., "Error handling was flagged in every review")
243
+ - Note quality patterns (positive and negative)
244
+ - Track areas where team improved over the course of epic
245
+
246
+ **Breakthrough Moments:**
90
247
 
91
- <action>Find all stories for this epic in {output_folder}/stories/</action>
92
- <action>For each story, extract: - Story number and title - Completion status - Story points (if tracked) - Actual completion date - Dev Agent Record notes - TEA Results and testing outcomes - PO Notes and acceptance - Blockers encountered and resolution - Technical debt incurred
93
- </action>
248
+ - Document key discoveries (e.g., "Story 3 discovered the caching pattern we used for rest of epic")
249
+ - Note when team velocity improved dramatically
250
+ - Track innovative solutions worth repeating
94
251
 
95
- <action>Calculate epic metrics: - Completed stories vs. total planned - Actual story points delivered vs. planned - Actual sprints taken vs. estimated - Velocity (points per sprint) - Blocker count - Technical debt items logged
96
- </action>
252
+ **Velocity Patterns:**
253
+
254
+ - Calculate average completion time per story
255
+ - Note velocity trends (e.g., "First 2 stories took 3x longer than estimated")
256
+ - Identify which types of stories went faster/slower
257
+
258
+ **Team Collaboration Highlights:**
259
+
260
+ - Note moments of excellent collaboration mentioned in stories
261
+ - Track where pair programming or mob programming was effective
262
+ - Document effective problem-solving sessions
263
+
264
+ <action>Store this synthesis - these patterns will drive the retrospective discussion</action>
265
+
266
+ <output>
267
+ Bob (Scrum Master): "Okay, I've reviewed all {{total_stories}} story records. I found some really interesting patterns we should discuss."
268
+
269
+ Dana (QA Engineer): "I'm curious what you found, Bob. I noticed some things in my testing too."
270
+
271
+ Bob (Scrum Master): "We'll get to all of it. But first, let me load the previous epic's retro to see if we learned from last time."
272
+ </output>
97
273
 
98
- <action>Review epic goals and compare actual outcomes vs. planned</action>
99
- <action>Note any scope changes or descoped items</action>
100
- <action>Document key architectural decisions made during epic</action>
101
- <action>Identify technical debt incurred and why</action>
102
274
  </step>
103
275
 
104
- <step n="2" goal="Preview Next Epic">
105
- <action>Identify the next epic in sequence</action>
106
- <action>Load next epic from: {output_folder}/prd/epic-{{next_epic_number}}.md</action>
276
+ <step n="3" goal="Load and Integrate Previous Epic Retrospective">
277
+
278
+ <action>Calculate previous epic number: {{prev_epic_num}} = {{epic_number}} - 1</action>
279
+
280
+ <check if="{{prev_epic_num}} >= 1">
281
+ <action>Search for previous retrospective using pattern: {retrospectives_folder}/epic-{{prev_epic_num}}-retro-*.md</action>
282
+
283
+ <check if="previous retro found">
284
+ <output>
285
+ Bob (Scrum Master): "I found our retrospective from Epic {{prev_epic_num}}. Let me see what we committed to back then..."
286
+ </output>
287
+
288
+ <action>Read the complete previous retrospective file</action>
289
+
290
+ <action>Extract key elements:</action>
291
+ - **Action items committed**: What did the team agree to improve?
292
+ - **Lessons learned**: What insights were captured?
293
+ - **Process improvements**: What changes were agreed upon?
294
+ - **Technical debt flagged**: What debt was documented?
295
+ - **Team agreements**: What commitments were made?
296
+ - **Preparation tasks**: What was needed for this epic?
297
+
298
+ <action>Cross-reference with current epic execution:</action>
299
+
300
+ **Action Item Follow-Through:**
301
+ - For each action item from Epic {{prev_epic_num}} retro, check if it was completed
302
+ - Look for evidence in current epic's story records
303
+ - Mark each action item: ✅ Completed, ⏳ In Progress, ❌ Not Addressed
304
+
305
+ **Lessons Applied:**
306
+ - For each lesson from Epic {{prev_epic_num}}, check if team applied it in Epic {{epic_number}}
307
+ - Look for evidence in dev notes, review feedback, or outcomes
308
+ - Document successes and missed opportunities
309
+
310
+ **Process Improvements Effectiveness:**
311
+ - For each process change agreed to in Epic {{prev_epic_num}}, assess if it helped
312
+ - Did the change improve velocity, quality, or team satisfaction?
313
+ - Should we keep, modify, or abandon the change?
314
+
315
+ **Technical Debt Status:**
316
+ - For each debt item from Epic {{prev_epic_num}}, check if it was addressed
317
+ - Did unaddressed debt cause problems in Epic {{epic_number}}?
318
+ - Did the debt grow or shrink?
319
+
320
+ <action>Prepare "continuity insights" for the retrospective discussion</action>
321
+
322
+ <action>Identify wins where previous lessons were applied successfully:</action>
323
+ - Document specific examples of applied learnings
324
+ - Note positive impact on Epic {{epic_number}} outcomes
325
+ - Celebrate team growth and improvement
326
+
327
+ <action>Identify missed opportunities where previous lessons were ignored:</action>
328
+ - Document where team repeated previous mistakes
329
+ - Note impact of not applying lessons (without blame)
330
+ - Explore barriers that prevented application
331
+
332
+ <output>
333
+
334
+ Bob (Scrum Master): "Interesting... in Epic {{prev_epic_num}}'s retro, we committed to {{action_count}} action items."
335
+
336
+ Alice (Product Owner): "How'd we do on those, Bob?"
337
+
338
+ Bob (Scrum Master): "We completed {{completed_count}}, made progress on {{in_progress_count}}, but didn't address {{not_addressed_count}}."
339
+
340
+ Charlie (Senior Dev): _looking concerned_ "Which ones didn't we address?"
341
+
342
+ Bob (Scrum Master): "We'll discuss that in the retro. Some of them might explain challenges we had this epic."
343
+
344
+ Elena (Junior Dev): "That's... actually pretty insightful."
345
+
346
+ Bob (Scrum Master): "That's why we track this stuff. Pattern recognition helps us improve."
347
+ </output>
107
348
 
108
- <action if="next epic exists">
109
- Analyze next epic for:
349
+ </check>
350
+
351
+ <check if="no previous retro found">
352
+ <output>
353
+ Bob (Scrum Master): "I don't see a retrospective for Epic {{prev_epic_num}}. Either we skipped it, or this is your first retro."
354
+
355
+ Alice (Product Owner): "Probably our first one. Good time to start the habit!"
356
+ </output>
357
+ <action>Set {{first_retrospective}} = true</action>
358
+ </check>
359
+ </check>
360
+
361
+ <check if="{{prev_epic_num}} < 1">
362
+ <output>
363
+ Bob (Scrum Master): "This is Epic 1, so naturally there's no previous retro to reference. We're starting fresh!"
364
+
365
+ Charlie (Senior Dev): "First epic, first retro. Let's make it count."
366
+ </output>
367
+ <action>Set {{first_retrospective}} = true</action>
368
+ </check>
369
+
370
+ </step>
371
+
372
+ <step n="4" goal="Preview Next Epic with Change Detection">
373
+
374
+ <action>Calculate next epic number: {{next_epic_num}} = {{epic_number}} + 1</action>
375
+
376
+ <output>
377
+ Bob (Scrum Master): "Before we dive into the discussion, let me take a quick look at Epic {{next_epic_num}} to understand what's coming."
378
+
379
+ Alice (Product Owner): "Good thinking - helps us connect what we learned to what we're about to do."
380
+ </output>
381
+
382
+ <action>Attempt to load next epic using selective loading strategy:</action>
383
+
384
+ **Try sharded first (more specific):**
385
+ <action>Check if file exists: {output*folder}/\_epic*/epic-{{next_epic_num}}.md</action>
386
+
387
+ <check if="sharded epic file found">
388
+ <action>Load {output_folder}/*epic*/epic-{{next_epic_num}}.md</action>
389
+ <action>Set {{next_epic_source}} = "sharded"</action>
390
+ </check>
391
+
392
+ **Fallback to whole document:**
393
+ <check if="sharded epic not found">
394
+ <action>Check if file exists: {output*folder}/\_epic*.md</action>
395
+
396
+ <check if="whole epic file found">
397
+ <action>Load entire epics document</action>
398
+ <action>Extract Epic {{next_epic_num}} section</action>
399
+ <action>Set {{next_epic_source}} = "whole"</action>
400
+ </check>
401
+ </check>
402
+
403
+ <check if="next epic found">
404
+ <action>Analyze next epic for:</action>
110
405
  - Epic title and objectives
111
- - Planned stories and complexity
112
- - Dependencies on completed epic work
406
+ - Planned stories and complexity estimates
407
+ - Dependencies on Epic {{epic_number}} work
113
408
  - New technical requirements or capabilities needed
114
409
  - Potential risks or unknowns
115
- </action>
410
+ - Business goals and success criteria
116
411
 
117
- <action>Identify dependencies on completed work:
412
+ <action>Identify dependencies on completed work:</action>
118
413
 
119
- - What components from Epic {{completed_number}} does Epic {{next_number}} rely on?
414
+ - What components from Epic {{epic_number}} does Epic {{next_epic_num}} rely on?
120
415
  - Are all prerequisites complete and stable?
121
416
  - Any incomplete work that creates blocking dependencies?
122
- </action>
123
417
 
124
- <action>Note potential gaps or preparation needed:
418
+ <action>Note potential gaps or preparation needed:</action>
125
419
 
126
420
  - Technical setup required (infrastructure, tools, libraries)
127
421
  - Knowledge gaps to fill (research, training, spikes)
128
422
  - Refactoring needed before starting next epic
129
423
  - Documentation or specifications to create
130
- </action>
131
424
 
132
- <action>Check for technical prerequisites:
425
+ <action>Check for technical prerequisites:</action>
133
426
 
134
427
  - APIs or integrations that must be ready
135
428
  - Data migrations or schema changes needed
136
429
  - Testing infrastructure requirements
137
430
  - Deployment or environment setup
138
- </action>
431
+
432
+ <output>
433
+ Bob (Scrum Master): "Alright, I've reviewed Epic {{next_epic_num}}: '{{next_epic_title}}'"
434
+
435
+ Alice (Product Owner): "What are we looking at?"
436
+
437
+ Bob (Scrum Master): "{{next_epic_num}} stories planned, building on the {{dependency_description}} from Epic {{epic_number}}."
438
+
439
+ Charlie (Senior Dev): "Dependencies concern me. Did we finish everything we need for that?"
440
+
441
+ Bob (Scrum Master): "Good question - that's exactly what we need to explore in this retro."
442
+ </output>
443
+
444
+ <action>Set {{next_epic_exists}} = true</action>
445
+ </check>
446
+
447
+ <check if="next epic NOT found">
448
+ <output>
449
+ Bob (Scrum Master): "Hmm, I don't see Epic {{next_epic_num}} defined yet."
450
+
451
+ Alice (Product Owner): "We might be at the end of the roadmap, or we haven't planned that far ahead yet."
452
+
453
+ Bob (Scrum Master): "No problem. We'll still do a thorough retro on Epic {{epic_number}}. The lessons will be valuable whenever we plan the next work."
454
+ </output>
455
+
456
+ <action>Set {{next_epic_exists}} = false</action>
457
+ </check>
139
458
 
140
459
  </step>
141
460
 
142
- <step n="3" goal="Initialize Retrospective with Context">
143
- <action>Scrum Master opens the retrospective with context</action>
144
- <action>Present formatted retrospective header:
461
+ <step n="5" goal="Initialize Retrospective with Rich Context">
145
462
 
146
- ```
147
- 🔄 TEAM RETROSPECTIVE - Epic {{epic_number}}: {{epic_title}}
463
+ <action>Load agent configurations from {agent_manifest}</action>
464
+ <action>Identify which agents participated in Epic {{epic_number}} based on story records</action>
465
+ <action>Ensure key roles present: Product Owner, Scrum Master (facilitating), Devs, Testing/QA, Architect</action>
148
466
 
149
- Scrum Master facilitating
467
+ <output>
468
+ Bob (Scrum Master): "Alright team, everyone's here. Let me set the stage for our retrospective."
150
469
 
470
+ ═══════════════════════════════════════════════════════════
471
+ 🔄 TEAM RETROSPECTIVE - Epic {{epic_number}}: {{epic_title}}
151
472
  ═══════════════════════════════════════════════════════════
152
473
 
153
- EPIC {{epic_number}} SUMMARY:
474
+ Bob (Scrum Master): "Here's what we accomplished together."
475
+
476
+ **EPIC {{epic_number}} SUMMARY:**
154
477
 
155
478
  Delivery Metrics:
479
+
156
480
  - Completed: {{completed_stories}}/{{total_stories}} stories ({{completion_percentage}}%)
157
- - Velocity: {{actual_points}} story points (planned: {{planned_points}})
158
- - Duration: {{actual_sprints}} sprints (planned: {{planned_sprints}})
481
+ - Velocity: {{actual_points}} story points{{#if planned_points}} (planned: {{planned_points}}){{/if}}
482
+ - Duration: {{actual_sprints}} sprints{{#if planned_sprints}} (planned: {{planned_sprints}}){{/if}}
159
483
  - Average velocity: {{points_per_sprint}} points/sprint
160
484
 
161
485
  Quality and Technical:
486
+
162
487
  - Blockers encountered: {{blocker_count}}
163
488
  - Technical debt items: {{debt_count}}
164
489
  - Test coverage: {{coverage_info}}
165
490
  - Production incidents: {{incident_count}}
166
491
 
167
492
  Business Outcomes:
493
+
168
494
  - Goals achieved: {{goals_met}}/{{total_goals}}
169
495
  - Success criteria: {{criteria_status}}
170
496
  - Stakeholder feedback: {{feedback_summary}}
171
497
 
172
- ═══════════════════════════════════════════════════════════
498
+ Alice (Product Owner): "Those numbers tell a good story. {{completion_percentage}}% completion is {{#if completion_percentage >= 90}}excellent{{else}}something we should discuss{{/if}}."
499
+
500
+ Charlie (Senior Dev): "I'm more interested in that technical debt number - {{debt_count}} items is {{#if debt_count > 10}}concerning{{else}}manageable{{/if}}."
173
501
 
174
- NEXT EPIC PREVIEW: Epic {{next_number}}: {{next_epic_title}}
502
+ Dana (QA Engineer): "{{incident_count}} production incidents - {{#if incident_count == 0}}clean epic!{{else}}we should talk about those{{/if}}."
503
+
504
+ {{#if next_epic_exists}}
505
+ ═══════════════════════════════════════════════════════════
506
+ **NEXT EPIC PREVIEW:** Epic {{next_epic_num}}: {{next_epic_title}}
507
+ ═══════════════════════════════════════════════════════════
175
508
 
176
509
  Dependencies on Epic {{epic_number}}:
177
510
  {{list_dependencies}}
@@ -182,298 +515,946 @@ Preparation Needed:
182
515
  Technical Prerequisites:
183
516
  {{list_technical_prereqs}}
184
517
 
518
+ Bob (Scrum Master): "And here's what's coming next. Epic {{next_epic_num}} builds on what we just finished."
519
+
520
+ Elena (Junior Dev): "Wow, that's a lot of dependencies on our work."
521
+
522
+ Charlie (Senior Dev): "Which means we better make sure Epic {{epic_number}} is actually solid before moving on."
523
+ {{/if}}
524
+
185
525
  ═══════════════════════════════════════════════════════════
186
526
 
187
- Team assembled for reflection:
188
- {{list_agents_based_on_story_records}}
527
+ Bob (Scrum Master): "Team assembled for this retrospective:"
528
+
529
+ {{list_participating_agents}}
530
+
531
+ Bob (Scrum Master): "{user_name}, you're joining us as Project Lead. Your perspective is crucial here."
532
+
533
+ {user_name} (Project Lead): [Participating in the retrospective]
534
+
535
+ Bob (Scrum Master): "Our focus today:"
189
536
 
190
- Focus Areas:
191
537
  1. Learning from Epic {{epic_number}} execution
192
- 2. Preparing for Epic {{next_number}} success
193
- ```
538
+ {{#if next_epic_exists}}2. Preparing for Epic {{next_epic_num}} success{{/if}}
539
+
540
+ Bob (Scrum Master): "Ground rules: psychological safety first. No blame, no judgment. We focus on systems and processes, not individuals. Everyone's voice matters. Specific examples are better than generalizations."
194
541
 
195
- </action>
542
+ Alice (Product Owner): "And everything shared here stays in this room - unless we decide together to escalate something."
543
+
544
+ Bob (Scrum Master): "Exactly. {user_name}, any questions before we dive in?"
545
+ </output>
546
+
547
+ <action>WAIT for {user_name} to respond or indicate readiness</action>
196
548
 
197
- <action>Load agent configurations from {agent-manifest}</action>
198
- <action>Ensure key roles present from the {agent_manifest}: Product Owner, Scrum Master (facilitating the retro), Devs, Testing or QA, Architect, Analyst</action>
199
549
  </step>
200
550
 
201
- <step n="4" goal="Epic Review Discussion">
202
- <action>Scrum Master facilitates Part 1: Reviewing the completed epic through natural, psychologically safe discussion</action>
203
- <action>Create space for each agent to share their perspective in their unique voice and communication style, grounded in actual story data and outcomes</action>
204
- <action>Maintain psychological safety throughout - focus on learning and systems, not blame or individual performance</action>
551
+ <step n="6" goal="Epic Review Discussion - What Went Well, What Didn't">
552
+
553
+ <output>
554
+ Bob (Scrum Master): "Let's start with the good stuff. What went well in Epic {{epic_number}}?"
205
555
 
206
- <action>Guide the retrospective conversation to naturally surface key themes across three dimensions:</action>
556
+ Bob (Scrum Master): _pauses, creating space_
207
557
 
208
- **1. Successes and Strengths:**
209
- <action>Facilitate discussion that helps agents share what worked well during the epic - encourage specific examples from completed stories, effective practices, velocity achievements, collaboration wins, and smart technical decisions</action>
210
- <action>Draw out concrete examples: "Can you share a specific story where that approach worked well?"</action>
558
+ Alice (Product Owner): "I'll start. The user authentication flow we delivered exceeded my expectations. The UX is smooth, and early user feedback has been really positive."
211
559
 
212
- **2. Challenges and Growth Areas:**
213
- <action>Create safe space for agents to explore challenges encountered - guide them to discuss blockers, process friction, technical debt decisions, and coordination issues with curiosity rather than judgment</action>
214
- <action>Probe for root causes: "What made that challenging? What pattern do we see here?"</action>
215
- <action>Keep focus on systems and processes, not individuals</action>
560
+ Charlie (Senior Dev): "I'll add to that - the caching strategy we implemented in Story {{breakthrough_story_num}} was a game-changer. We cut API calls by 60% and it set the pattern for the rest of the epic."
561
+
562
+ Dana (QA Engineer): "From my side, testing went smoother than usual. The dev team's documentation was way better this epic - actually usable test plans!"
563
+
564
+ Elena (Junior Dev): _smiling_ "That's because Charlie made me document everything after Story 1's code review!"
565
+
566
+ Charlie (Senior Dev): _laughing_ "Tough love pays off."
567
+ </output>
568
+
569
+ <action>Bob (Scrum Master) naturally turns to {user_name} to engage them in the discussion</action>
570
+
571
+ <output>
572
+ Bob (Scrum Master): "{user_name}, what stood out to you as going well in this epic?"
573
+ </output>
216
574
 
217
- **3. Insights and Learning:**
218
- <action>Help the team articulate what they learned from this epic - facilitate discovery of patterns to repeat or avoid, skills gained, and process improvements worth trying</action>
219
- <action>Connect insights to future application: "How might this insight help us in future epics?"</action>
575
+ <action>WAIT for {user_name} to respond - this is a KEY USER INTERACTION moment</action>
220
576
 
221
- <action>For each agent participating (loaded from {agent_manifest}):</action>
577
+ <action>After {user_name} responds, have 1-2 team members react to or build on what {user_name} shared</action>
222
578
 
223
- - Let them speak naturally in their role's voice and communication style
224
- - Encourage grounding in specific story records, metrics, and real outcomes
225
- - Allow themes to emerge organically rather than forcing a rigid structure
226
- - Follow interesting threads with adaptive questions
227
- - Balance celebration with honest assessment
579
+ <output>
580
+ Alice (Product Owner): [Responds naturally to what {user_name} said, either agreeing, adding context, or offering a different perspective]
581
+
582
+ Charlie (Senior Dev): [Builds on the discussion, perhaps adding technical details or connecting to specific stories]
583
+ </output>
584
+
585
+ <action>Continue facilitating natural dialogue, periodically bringing {user_name} back into the conversation</action>
586
+
587
+ <action>After covering successes, guide the transition to challenges with care</action>
588
+
589
+ <output>
590
+ Bob (Scrum Master): "Okay, we've celebrated some real wins. Now let's talk about challenges - where did we struggle? What slowed us down?"
591
+
592
+ Bob (Scrum Master): _creates safe space with tone and pacing_
593
+
594
+ Elena (Junior Dev): _hesitates_ "Well... I really struggled with the database migrations in Story {{difficult_story_num}}. The documentation wasn't clear, and I had to redo it three times. Lost almost a full sprint on that story alone."
595
+
596
+ Charlie (Senior Dev): _defensive_ "Hold on - I wrote those migration docs, and they were perfectly clear. The issue was that the requirements kept changing mid-story!"
597
+
598
+ Alice (Product Owner): _frustrated_ "That's not fair, Charlie. We only clarified requirements once, and that was because the technical team didn't ask the right questions during planning!"
599
+
600
+ Charlie (Senior Dev): _heat rising_ "We asked plenty of questions! You said the schema was finalized, then two days into development you wanted to add three new fields!"
601
+
602
+ Bob (Scrum Master): _intervening calmly_ "Let's take a breath here. This is exactly the kind of thing we need to unpack."
603
+
604
+ Bob (Scrum Master): "Elena, you spent almost a full sprint on Story {{difficult_story_num}}. Charlie, you're saying requirements changed. Alice, you feel the right questions weren't asked up front."
605
+
606
+ Bob (Scrum Master): "{user_name}, you have visibility across the whole project. What's your take on this situation?"
607
+ </output>
608
+
609
+ <action>WAIT for {user_name} to respond and help facilitate the conflict resolution</action>
610
+
611
+ <action>Use {user_name}'s response to guide the discussion toward systemic understanding rather than blame</action>
612
+
613
+ <output>
614
+ Bob (Scrum Master): [Synthesizes {user_name}'s input with what the team shared] "So it sounds like the core issue was {{root_cause_based_on_discussion}}, not any individual person's fault."
615
+
616
+ Elena (Junior Dev): "That makes sense. If we'd had {{preventive_measure}}, I probably could have avoided those redos."
617
+
618
+ Charlie (Senior Dev): _softening_ "Yeah, and I could have been clearer about assumptions in the docs. Sorry for getting defensive, Alice."
619
+
620
+ Alice (Product Owner): "I appreciate that. I could've been more proactive about flagging the schema additions earlier, too."
621
+
622
+ Bob (Scrum Master): "This is good. We're identifying systemic improvements, not assigning blame."
623
+ </output>
624
+
625
+ <action>Continue the discussion, weaving in patterns discovered from the deep story analysis (Step 2)</action>
626
+
627
+ <output>
628
+ Bob (Scrum Master): "Speaking of patterns, I noticed something when reviewing all the story records..."
629
+
630
+ Bob (Scrum Master): "{{pattern_1_description}} - this showed up in {{pattern_1_count}} out of {{total_stories}} stories."
631
+
632
+ Dana (QA Engineer): "Oh wow, I didn't realize it was that widespread."
633
+
634
+ Bob (Scrum Master): "Yeah. And there's more - {{pattern_2_description}} came up in almost every code review."
635
+
636
+ Charlie (Senior Dev): "That's... actually embarrassing. We should've caught that pattern earlier."
637
+
638
+ Bob (Scrum Master): "No shame, Charlie. Now we know, and we can improve. {user_name}, did you notice these patterns during the epic?"
639
+ </output>
640
+
641
+ <action>WAIT for {user_name} to share their observations</action>
642
+
643
+ <action>Continue the retrospective discussion, creating moments where:</action>
644
+
645
+ - Team members ask {user_name} questions directly
646
+ - {user_name}'s input shifts the discussion direction
647
+ - Disagreements arise naturally and get resolved
648
+ - Quieter team members are invited to contribute
649
+ - Specific stories are referenced with real examples
650
+ - Emotions are authentic (frustration, pride, concern, hope)
651
+
652
+ <check if="previous retrospective exists">
653
+ <output>
654
+ Bob (Scrum Master): "Before we move on, I want to circle back to Epic {{prev_epic_num}}'s retrospective."
655
+
656
+ Bob (Scrum Master): "We made some commitments in that retro. Let's see how we did."
657
+
658
+ Bob (Scrum Master): "Action item 1: {{prev_action_1}}. Status: {{prev_action_1_status}}"
659
+
660
+ Alice (Product Owner): {{#if prev_action_1_status == "completed"}}"We nailed that one!"{{else}}"We... didn't do that one."{{/if}}
661
+
662
+ Charlie (Senior Dev): {{#if prev_action_1_status == "completed"}}"And it helped! I noticed {{evidence_of_impact}}"{{else}}"Yeah, and I think that's why we had {{consequence_of_not_doing_it}} this epic."{{/if}}
663
+
664
+ Bob (Scrum Master): "Action item 2: {{prev_action_2}}. Status: {{prev_action_2_status}}"
665
+
666
+ Dana (QA Engineer): {{#if prev_action_2_status == "completed"}}"This one made testing so much easier this time."{{else}}"If we'd done this, I think testing would've gone faster."{{/if}}
667
+
668
+ Bob (Scrum Master): "{user_name}, looking at what we committed to last time and what we actually did - what's your reaction?"
669
+ </output>
670
+
671
+ <action>WAIT for {user_name} to respond</action>
672
+
673
+ <action>Use the previous retro follow-through as a learning moment about commitment and accountability</action>
674
+ </check>
675
+
676
+ <output>
677
+ Bob (Scrum Master): "Alright, we've covered a lot of ground. Let me summarize what I'm hearing..."
678
+
679
+ Bob (Scrum Master): "**Successes:**"
680
+ {{list_success_themes}}
681
+
682
+ Bob (Scrum Master): "**Challenges:**"
683
+ {{list_challenge_themes}}
684
+
685
+ Bob (Scrum Master): "**Key Insights:**"
686
+ {{list_insight_themes}}
687
+
688
+ Bob (Scrum Master): "Does that capture it? Anyone have something important we missed?"
689
+ </output>
690
+
691
+ <action>Allow team members to add any final thoughts on the epic review</action>
692
+ <action>Ensure {user_name} has opportunity to add their perspective</action>
228
693
 
229
- <action>As facilitator, actively synthesize common themes and patterns as the discussion unfolds</action>
230
- <action>Notice when multiple agents mention similar issues or successes - call these out to deepen the team's shared understanding</action>
231
- <action>Ensure every voice is heard, inviting quieter agents to contribute</action>
232
694
  </step>
233
695
 
234
- <step n="5" goal="Next Epic Preparation Discussion">
235
- <action>Scrum Master facilitates Part 2: Preparing for the next epic through forward-looking exploration</action>
236
- <action>Shift the team's focus from reflection to readiness - guide each agent to explore preparation needs from their domain perspective</action>
696
+ <step n="7" goal="Next Epic Preparation Discussion - Interactive and Collaborative">
697
+
698
+ <check if="{{next_epic_exists}} == false">
699
+ <output>
700
+ Bob (Scrum Master): "Normally we'd discuss preparing for the next epic, but since Epic {{next_epic_num}} isn't defined yet, let's skip to action items."
701
+ </output>
702
+ <action>Skip to Step 8</action>
703
+ </check>
704
+
705
+ <output>
706
+ Bob (Scrum Master): "Now let's shift gears. Epic {{next_epic_num}} is coming up: '{{next_epic_title}}'"
707
+
708
+ Bob (Scrum Master): "The question is: are we ready? What do we need to prepare?"
709
+
710
+ Alice (Product Owner): "From my perspective, we need to make sure {{dependency_concern_1}} from Epic {{epic_number}} is solid before we start building on it."
711
+
712
+ Charlie (Senior Dev): _concerned_ "I'm worried about {{technical_concern_1}}. We have {{technical_debt_item}} from this epic that'll blow up if we don't address it before Epic {{next_epic_num}}."
237
713
 
238
- <action>Facilitate discovery across critical preparation dimensions:</action>
714
+ Dana (QA Engineer): "And I need {{testing_infrastructure_need}} in place, or we're going to have the same testing bottleneck we had in Story {{bottleneck_story_num}}."
239
715
 
240
- **Dependencies and Continuity:**
241
- <action>Guide agents to explore connections between the completed epic and the upcoming one - help them identify what components, decisions, or work from Epic {{completed_number}} the next epic relies upon</action>
242
- <action>Probe for gaps: "What needs to be in place before we can start Epic {{next_number}}?"</action>
243
- <action>Surface hidden dependencies: "Are there integration points we need to verify?"</action>
716
+ Elena (Junior Dev): "I'm less worried about infrastructure and more about knowledge. I don't understand {{knowledge_gap}} well enough to work on Epic {{next_epic_num}}'s stories."
244
717
 
245
- **Readiness and Setup:**
246
- <action>Facilitate discussion about what preparation work is needed before the next epic can begin successfully - technical setup, knowledge development, refactoring, documentation, or infrastructure</action>
247
- <action>Draw out specific needs: "What do you need to feel ready to start Epic {{next_number}}?"</action>
248
- <action>Identify knowledge gaps: "What do we need to learn or research before diving in?"</action>
718
+ Bob (Scrum Master): "{user_name}, the team is surfacing some real concerns here. What's your sense of our readiness?"
719
+ </output>
720
+
721
+ <action>WAIT for {user_name} to share their assessment</action>
722
+
723
+ <action>Use {user_name}'s input to guide deeper exploration of preparation needs</action>
724
+
725
+ <output>
726
+ Alice (Product Owner): [Reacts to what {user_name} said] "I agree with {user_name} about {{point_of_agreement}}, but I'm still worried about {{lingering_concern}}."
727
+
728
+ Charlie (Senior Dev): "Here's what I think we need technically before Epic {{next_epic_num}} can start..."
729
+
730
+ Charlie (Senior Dev): "1. {{tech_prep_item_1}} - estimated {{hours_1}} hours"
731
+ Charlie (Senior Dev): "2. {{tech_prep_item_2}} - estimated {{hours_2}} hours"
732
+ Charlie (Senior Dev): "3. {{tech_prep_item_3}} - estimated {{hours_3}} hours"
733
+
734
+ Elena (Junior Dev): "That's like {{total_hours}} hours! That's a full sprint of prep work!"
735
+
736
+ Charlie (Senior Dev): "Exactly. We can't just jump into Epic {{next_epic_num}} on Monday."
737
+
738
+ Alice (Product Owner): _frustrated_ "But we have stakeholder pressure to keep shipping features. They're not going to be happy about a 'prep sprint.'"
739
+
740
+ Bob (Scrum Master): "Let's think about this differently. What happens if we DON'T do this prep work?"
741
+
742
+ Dana (QA Engineer): "We'll hit blockers in the middle of Epic {{next_epic_num}}, velocity will tank, and we'll ship late anyway."
743
+
744
+ Charlie (Senior Dev): "Worse - we'll ship something built on top of {{technical_concern_1}}, and it'll be fragile."
745
+
746
+ Bob (Scrum Master): "{user_name}, you're balancing stakeholder pressure against technical reality. How do you want to handle this?"
747
+ </output>
249
748
 
250
- **Risks and Mitigation:**
251
- <action>Create space for agents to voice concerns and uncertainties about the upcoming epic based on what they learned from this one</action>
252
- <action>Explore proactively: "Based on Epic {{completed_number}}, what concerns do you have about Epic {{next_number}}?"</action>
253
- <action>Develop mitigation thinking: "What could we do now to reduce that risk?"</action>
254
- <action>Identify early warning signs: "How will we know if we're heading for that problem again?"</action>
749
+ <action>WAIT for {user_name} to provide direction on preparation approach</action>
255
750
 
256
- <action>For each agent participating:</action>
751
+ <action>Create space for debate and disagreement about priorities</action>
257
752
 
258
- - Let them share preparation needs in their natural voice
259
- - Encourage domain-specific insights (Architect on technical setup, PM on requirements clarity, etc.)
260
- - Follow interesting preparation threads with adaptive questions
261
- - Help agents build on each other's observations
262
- - Surface quick wins that could de-risk the epic early
753
+ <output>
754
+ Alice (Product Owner): [Potentially disagrees with {user_name}'s approach] "I hear what you're saying, {user_name}, but from a business perspective, {{business_concern}}."
755
+
756
+ Charlie (Senior Dev): [Potentially supports or challenges Alice's point] "The business perspective is valid, but {{technical_counter_argument}}."
757
+
758
+ Bob (Scrum Master): "We have healthy tension here between business needs and technical reality. That's good - it means we're being honest."
759
+
760
+ Bob (Scrum Master): "Let's explore a middle ground. Charlie, which of your prep items are absolutely critical vs. nice-to-have?"
761
+
762
+ Charlie (Senior Dev): "{{critical_prep_item_1}} and {{critical_prep_item_2}} are non-negotiable. {{nice_to_have_prep_item}} can wait."
763
+
764
+ Alice (Product Owner): "And can any of the critical prep happen in parallel with starting Epic {{next_epic_num}}?"
765
+
766
+ Charlie (Senior Dev): _thinking_ "Maybe. If we tackle {{first_critical_item}} before the epic starts, we could do {{second_critical_item}} during the first sprint."
767
+
768
+ Dana (QA Engineer): "But that means Story 1 of Epic {{next_epic_num}} can't depend on {{second_critical_item}}."
769
+
770
+ Alice (Product Owner): _looking at epic plan_ "Actually, Stories 1 and 2 are about {{independent_work}}, so they don't depend on it. We could make that work."
771
+
772
+ Bob (Scrum Master): "{user_name}, the team is finding a workable compromise here. Does this approach make sense to you?"
773
+ </output>
774
+
775
+ <action>WAIT for {user_name} to validate or adjust the preparation strategy</action>
776
+
777
+ <action>Continue working through preparation needs across all dimensions:</action>
778
+
779
+ - Dependencies on Epic {{epic_number}} work
780
+ - Technical setup and infrastructure
781
+ - Knowledge gaps and research needs
782
+ - Documentation or specification work
783
+ - Testing infrastructure
784
+ - Refactoring or debt reduction
785
+ - External dependencies (APIs, integrations, etc.)
786
+
787
+ <action>For each preparation area, facilitate team discussion that:</action>
788
+
789
+ - Identifies specific needs with concrete examples
790
+ - Estimates effort realistically based on Epic {{epic_number}} experience
791
+ - Assigns ownership to specific agents
792
+ - Determines criticality and timing
793
+ - Surfaces risks of NOT doing the preparation
794
+ - Explores parallel work opportunities
795
+ - Brings {user_name} in for key decisions
796
+
797
+ <output>
798
+ Bob (Scrum Master): "I'm hearing a clear picture of what we need before Epic {{next_epic_num}}. Let me summarize..."
799
+
800
+ **CRITICAL PREPARATION (Must complete before epic starts):**
801
+ {{list_critical_prep_items_with_owners_and_estimates}}
802
+
803
+ **PARALLEL PREPARATION (Can happen during early stories):**
804
+ {{list_parallel_prep_items_with_owners_and_estimates}}
805
+
806
+ **NICE-TO-HAVE PREPARATION (Would help but not blocking):**
807
+ {{list_nice_to_have_prep_items}}
808
+
809
+ Bob (Scrum Master): "Total critical prep effort: {{critical_hours}} hours ({{critical_days}} days)"
810
+
811
+ Alice (Product Owner): "That's manageable. We can communicate that to stakeholders."
812
+
813
+ Bob (Scrum Master): "{user_name}, does this preparation plan work for you?"
814
+ </output>
815
+
816
+ <action>WAIT for {user_name} final validation of preparation plan</action>
263
817
 
264
- <action>As facilitator, identify dependencies between preparation tasks as they emerge</action>
265
- <action>Notice when preparation items from different agents connect or conflict - explore these intersections</action>
266
- <action>Build a shared understanding of what "ready to start Epic {{next_number}}" actually means</action>
267
818
  </step>
268
819
 
269
- <step n="6" goal="Synthesize Action Items">
270
- <action>Scrum Master identifies patterns across all agent feedback</action>
271
- <action>Synthesizes common themes into team agreements</action>
272
- <action>Creates specific, achievable action items with clear ownership</action>
273
- <action>Develops preparation sprint tasks if significant setup needed</action>
820
+ <step n="8" goal="Synthesize Action Items with Significant Change Detection">
821
+
822
+ <output>
823
+ Bob (Scrum Master): "Let's capture concrete action items from everything we've discussed."
824
+
825
+ Bob (Scrum Master): "I want specific, achievable actions with clear owners. Not vague aspirations."
826
+ </output>
827
+
828
+ <action>Synthesize themes from Epic {{epic_number}} review discussion into actionable improvements</action>
829
+
830
+ <action>Create specific action items with:</action>
831
+
832
+ - Clear description of the action
833
+ - Assigned owner (specific agent or role)
834
+ - Timeline or deadline
835
+ - Success criteria (how we'll know it's done)
836
+ - Category (process, technical, documentation, team, etc.)
274
837
 
275
- <action>Present comprehensive action plan:
838
+ <action>Ensure action items are SMART:</action>
839
+
840
+ - Specific: Clear and unambiguous
841
+ - Measurable: Can verify completion
842
+ - Achievable: Realistic given constraints
843
+ - Relevant: Addresses real issues from retro
844
+ - Time-bound: Has clear deadline
845
+
846
+ <output>
847
+ Bob (Scrum Master): "Based on our discussion, here are the action items I'm proposing..."
276
848
 
277
- ```
278
849
  ═══════════════════════════════════════════════════════════
279
- 📝 EPIC {{completed_number}} ACTION ITEMS:
850
+ 📝 EPIC {{epic_number}} ACTION ITEMS:
851
+ ═══════════════════════════════════════════════════════════
852
+
853
+ **Process Improvements:**
854
+
855
+ 1. {{action_item_1}}
856
+ Owner: {{agent_1}}
857
+ Deadline: {{timeline_1}}
858
+ Success criteria: {{criteria_1}}
859
+
860
+ 2. {{action_item_2}}
861
+ Owner: {{agent_2}}
862
+ Deadline: {{timeline_2}}
863
+ Success criteria: {{criteria_2}}
864
+
865
+ Charlie (Senior Dev): "I can own action item 1, but {{timeline_1}} is tight. Can we push it to {{alternative_timeline}}?"
866
+
867
+ Bob (Scrum Master): "What do others think? Does that timing still work?"
280
868
 
281
- Process Improvements:
282
- 1. {{action_item}} (Owner: {{agent}}, By: {{timeline}})
283
- 2. {{action_item}} (Owner: {{agent}}, By: {{timeline}})
284
- 3. {{action_item}} (Owner: {{agent}}, By: {{timeline}})
869
+ Alice (Product Owner): "{{alternative_timeline}} works for me, as long as it's done before Epic {{next_epic_num}} starts."
285
870
 
286
- Technical Debt:
287
- 1. {{debt_item}} (Owner: {{agent}}, Priority: {{high/medium/low}})
288
- 2. {{debt_item}} (Owner: {{agent}}, Priority: {{high/medium/low}})
871
+ Bob (Scrum Master): "Agreed. Updated to {{alternative_timeline}}."
872
+
873
+ **Technical Debt:**
874
+
875
+ 1. {{debt_item_1}}
876
+ Owner: {{agent_3}}
877
+ Priority: {{priority_1}}
878
+ Estimated effort: {{effort_1}}
879
+
880
+ 2. {{debt_item_2}}
881
+ Owner: {{agent_4}}
882
+ Priority: {{priority_2}}
883
+ Estimated effort: {{effort_2}}
884
+
885
+ Dana (QA Engineer): "For debt item 1, can we prioritize that as high? It caused testing issues in three different stories."
886
+
887
+ Charlie (Senior Dev): "I marked it medium because {{reasoning}}, but I hear your point."
888
+
889
+ Bob (Scrum Master): "{user_name}, this is a priority call. Testing impact vs. {{reasoning}} - how do you want to prioritize it?"
890
+ </output>
289
891
 
290
- Documentation:
291
- 1. {{doc_need}} (Owner: {{agent}}, By: {{timeline}})
892
+ <action>WAIT for {user_name} to help resolve priority discussions</action>
893
+
894
+ <output>
895
+ **Documentation:**
896
+ 1. {{doc_need_1}}
897
+ Owner: {{agent_5}}
898
+ Deadline: {{timeline_3}}
899
+
900
+ 2. {{doc_need_2}}
901
+ Owner: {{agent_6}}
902
+ Deadline: {{timeline_4}}
903
+
904
+ **Team Agreements:**
292
905
 
293
- Team Agreements:
294
906
  - {{agreement_1}}
295
907
  - {{agreement_2}}
296
908
  - {{agreement_3}}
297
909
 
910
+ Bob (Scrum Master): "These agreements are how we're committing to work differently going forward."
911
+
912
+ Elena (Junior Dev): "I like agreement 2 - that would've saved me on Story {{difficult_story_num}}."
913
+
914
+ ═══════════════════════════════════════════════════════════
915
+ 🚀 EPIC {{next_epic_num}} PREPARATION TASKS:
298
916
  ═══════════════════════════════════════════════════════════
299
- 🚀 EPIC {{next_number}} PREPARATION SPRINT:
300
917
 
301
- Technical Setup:
302
- [ ] {{setup_task}} (Owner: {{agent}}, Est: {{hours/days}})
303
- [ ] {{setup_task}} (Owner: {{agent}}, Est: {{hours/days}})
918
+ **Technical Setup:**
919
+ [ ] {{setup_task_1}}
920
+ Owner: {{owner_1}}
921
+ Estimated: {{est_1}}
304
922
 
305
- Knowledge Development:
306
- [ ] {{research_task}} (Owner: {{agent}}, Est: {{hours/days}})
307
- [ ] {{spike_task}} (Owner: {{agent}}, Est: {{hours/days}})
923
+ [ ] {{setup_task_2}}
924
+ Owner: {{owner_2}}
925
+ Estimated: {{est_2}}
308
926
 
309
- Cleanup/Refactoring:
310
- [ ] {{refactor_task}} (Owner: {{agent}}, Est: {{hours/days}})
311
- [ ] {{cleanup_task}} (Owner: {{agent}}, Est: {{hours/days}})
927
+ **Knowledge Development:**
928
+ [ ] {{research_task_1}}
929
+ Owner: {{owner_3}}
930
+ Estimated: {{est_3}}
312
931
 
313
- Documentation:
314
- [ ] {{doc_task}} (Owner: {{agent}}, Est: {{hours/days}})
932
+ **Cleanup/Refactoring:**
933
+ [ ] {{refactor_task_1}}
934
+ Owner: {{owner_4}}
935
+ Estimated: {{est_4}}
315
936
 
316
- Total Estimated Effort: {{total_hours}} hours ({{total_days}} days)
937
+ **Total Estimated Effort:** {{total_hours}} hours ({{total_days}} days)
317
938
 
318
939
  ═══════════════════════════════════════════════════════════
319
940
  ⚠️ CRITICAL PATH:
941
+ ═══════════════════════════════════════════════════════════
320
942
 
321
- Blockers to Resolve Before Epic {{next_number}}:
322
- 1. {{critical_item}} (Owner: {{agent}}, Must complete by: {{date}})
323
- 2. {{critical_item}} (Owner: {{agent}}, Must complete by: {{date}})
943
+ **Blockers to Resolve Before Epic {{next_epic_num}}:**
324
944
 
325
- Dependencies Timeline:
326
- {{timeline_visualization_of_critical_dependencies}}
945
+ 1. {{critical_item_1}}
946
+ Owner: {{critical_owner_1}}
947
+ Must complete by: {{critical_deadline_1}}
327
948
 
328
- Risk Mitigation:
329
- - {{risk}}: {{mitigation_strategy}}
330
- - {{risk}}: {{mitigation_strategy}}
331
- ```
949
+ 2. {{critical_item_2}}
950
+ Owner: {{critical_owner_2}}
951
+ Must complete by: {{critical_deadline_2}}
952
+ </output>
953
+
954
+ <action>CRITICAL ANALYSIS - Detect if discoveries require epic updates</action>
955
+
956
+ <action>Check if any of the following are true based on retrospective discussion:</action>
957
+
958
+ - Architectural assumptions from planning proven wrong during Epic {{epic_number}}
959
+ - Major scope changes or descoping occurred that affects next epic
960
+ - Technical approach needs fundamental change for Epic {{next_epic_num}}
961
+ - Dependencies discovered that Epic {{next_epic_num}} doesn't account for
962
+ - User needs significantly different than originally understood
963
+ - Performance/scalability concerns that affect Epic {{next_epic_num}} design
964
+ - Security or compliance issues discovered that change approach
965
+ - Integration assumptions proven incorrect
966
+ - Team capacity or skill gaps more severe than planned
967
+ - Technical debt level unsustainable without intervention
332
968
 
333
- </action>
969
+ <check if="significant discoveries detected">
970
+ <output>
971
+
972
+ ═══════════════════════════════════════════════════════════
973
+ 🚨 SIGNIFICANT DISCOVERY ALERT 🚨
974
+ ═══════════════════════════════════════════════════════════
975
+
976
+ Bob (Scrum Master): "{user_name}, we need to flag something important."
977
+
978
+ Bob (Scrum Master): "During Epic {{epic_number}}, the team uncovered findings that may require updating the plan for Epic {{next_epic_num}}."
979
+
980
+ **Significant Changes Identified:**
981
+
982
+ 1. {{significant_change_1}}
983
+ Impact: {{impact_description_1}}
984
+
985
+ 2. {{significant_change_2}}
986
+ Impact: {{impact_description_2}}
987
+
988
+ {{#if significant_change_3}} 3. {{significant_change_3}}
989
+ Impact: {{impact_description_3}}
990
+ {{/if}}
991
+
992
+ Charlie (Senior Dev): "Yeah, when we discovered {{technical_discovery}}, it fundamentally changed our understanding of {{affected_area}}."
993
+
994
+ Alice (Product Owner): "And from a product perspective, {{product_discovery}} means Epic {{next_epic_num}}'s stories are based on wrong assumptions."
995
+
996
+ Dana (QA Engineer): "If we start Epic {{next_epic_num}} as-is, we're going to hit walls fast."
997
+
998
+ **Impact on Epic {{next_epic_num}}:**
999
+
1000
+ The current plan for Epic {{next_epic_num}} assumes:
1001
+
1002
+ - {{wrong_assumption_1}}
1003
+ - {{wrong_assumption_2}}
1004
+
1005
+ But Epic {{epic_number}} revealed:
1006
+
1007
+ - {{actual_reality_1}}
1008
+ - {{actual_reality_2}}
1009
+
1010
+ This means Epic {{next_epic_num}} likely needs:
1011
+ {{list_likely_changes_needed}}
1012
+
1013
+ **RECOMMENDED ACTIONS:**
1014
+
1015
+ 1. Review and update Epic {{next_epic_num}} definition based on new learnings
1016
+ 2. Update affected stories in Epic {{next_epic_num}} to reflect reality
1017
+ 3. Consider updating architecture or technical specifications if applicable
1018
+ 4. Hold alignment session with Product Owner before starting Epic {{next_epic_num}}
1019
+ {{#if prd_update_needed}}5. Update PRD sections affected by new understanding{{/if}}
1020
+
1021
+ Bob (Scrum Master): "**Epic Update Required**: YES - Schedule epic planning review session"
1022
+
1023
+ Bob (Scrum Master): "{user_name}, this is significant. We need to address this before committing to Epic {{next_epic_num}}'s current plan. How do you want to handle it?"
1024
+ </output>
1025
+
1026
+ <action>WAIT for {user_name} to decide on how to handle the significant changes</action>
1027
+
1028
+ <action>Add epic review session to critical path if user agrees</action>
1029
+
1030
+ <output>
1031
+ Alice (Product Owner): "I agree with {user_name}'s approach. Better to adjust the plan now than fail mid-epic."
1032
+
1033
+ Charlie (Senior Dev): "This is why retrospectives matter. We caught this before it became a disaster."
1034
+
1035
+ Bob (Scrum Master): "Adding to critical path: Epic {{next_epic_num}} planning review session before epic kickoff."
1036
+ </output>
1037
+ </check>
1038
+
1039
+ <check if="no significant discoveries">
1040
+ <output>
1041
+ Bob (Scrum Master): "Good news - nothing from Epic {{epic_number}} fundamentally changes our plan for Epic {{next_epic_num}}. The plan is still sound."
1042
+
1043
+ Alice (Product Owner): "We learned a lot, but the direction is right."
1044
+ </output>
1045
+ </check>
1046
+
1047
+ <output>
1048
+ Bob (Scrum Master): "Let me show you the complete action plan..."
1049
+
1050
+ Bob (Scrum Master): "That's {{total_action_count}} action items, {{prep_task_count}} preparation tasks, and {{critical_count}} critical path items."
1051
+
1052
+ Bob (Scrum Master): "Everyone clear on what they own?"
1053
+ </output>
1054
+
1055
+ <action>Give each agent with assignments a moment to acknowledge their ownership</action>
1056
+
1057
+ <action>Ensure {user_name} approves the complete action plan</action>
334
1058
 
335
- <action>Ensure every action item has clear owner and timeline</action>
336
- <action>Prioritize preparation tasks by dependencies and criticality</action>
337
- <action>Identify which tasks can run in parallel vs. sequential</action>
338
1059
  </step>
339
1060
 
340
- <step n="7" goal="Critical Readiness Exploration">
341
- <action>Scrum Master leads a thoughtful exploration of whether Epic {{completed_number}} is truly complete and the team is ready for Epic {{next_number}}</action>
342
- <action>Approach this as discovery, not interrogation - help user surface any concerns or unfinished elements that could impact the next epic</action>
343
-
344
- <action>Guide a conversation exploring the completeness of Epic {{completed_number}} across critical dimensions:</action>
345
-
346
- **Testing and Quality:**
347
- <action>Explore the testing state of the epic - help user assess whether quality verification is truly complete</action>
348
- <action>Ask thoughtfully: "Walk me through the testing that's been done for Epic {{completed_number}}. Does anything still need verification?"</action>
349
- <action>Probe for gaps: "Are you confident the epic is production-ready from a quality perspective?"</action>
350
- <action if="testing concerns surface">Add to Critical Path: Complete necessary testing before Epic {{next_number}}</action>
351
-
352
- **Deployment and Release:**
353
- <action>Understand where the epic currently stands in the deployment pipeline</action>
354
- <action>Explore: "What's the deployment status for Epic {{completed_number}}? Is it live, scheduled, or still pending?"</action>
355
- <action>If not yet deployed, clarify timeline: "When is deployment planned? Does that timing work for starting Epic {{next_number}}?"</action>
356
- <action if="deployment must happen first">Add to Critical Path: Deploy Epic {{completed_number}} with clear timeline</action>
357
-
358
- **Stakeholder Acceptance:**
359
- <action>Guide user to reflect on business validation and stakeholder satisfaction</action>
360
- <action>Ask: "Have stakeholders seen and accepted the Epic {{completed_number}} deliverables? Any feedback pending?"</action>
361
- <action>Probe for risk: "Is there anything about stakeholder acceptance that could affect Epic {{next_number}}?"</action>
362
- <action if="acceptance incomplete">Add to Critical Path: Obtain stakeholder acceptance before proceeding</action>
363
-
364
- **Technical Health:**
365
- <action>Create space for honest assessment of codebase stability after the epic</action>
366
- <action>Explore: "How does the codebase feel after Epic {{completed_number}}? Stable and maintainable, or are there concerns?"</action>
367
- <action>If concerns arise, probe deeper: "What's causing those concerns? What would it take to address them?"</action>
368
- <action if="stability concerns exist">Document concerns and add to Preparation Sprint: Address stability issues before Epic {{next_number}}</action>
369
-
370
- **Unresolved Blockers:**
371
- <action>Help user surface any lingering issues that could create problems for the next epic</action>
372
- <action>Ask: "Are there any unresolved blockers or technical issues from Epic {{completed_number}} that we need to address before moving forward?"</action>
373
- <action>Explore impact: "How would these blockers affect Epic {{next_number}} if left unresolved?"</action>
374
- <action if="blockers exist">Document blockers and add to Critical Path with appropriate priority</action>
375
-
376
- <action>Synthesize the readiness discussion into a clear picture of what must happen before Epic {{next_number}} can safely begin</action>
377
- <action>Summarize any critical items identified and ensure user agrees with the assessment</action>
1061
+ <step n="9" goal="Critical Readiness Exploration - Interactive Deep Dive">
1062
+
1063
+ <output>
1064
+ Bob (Scrum Master): "Before we close, I want to do a final readiness check."
1065
+
1066
+ Bob (Scrum Master): "Epic {{epic_number}} is marked complete in sprint-status, but is it REALLY done?"
1067
+
1068
+ Alice (Product Owner): "What do you mean, Bob?"
1069
+
1070
+ Bob (Scrum Master): "I mean truly production-ready, stakeholders happy, no loose ends that'll bite us later."
1071
+
1072
+ Bob (Scrum Master): "{user_name}, let's walk through this together."
1073
+ </output>
1074
+
1075
+ <action>Explore testing and quality state through natural conversation</action>
1076
+
1077
+ <output>
1078
+ Bob (Scrum Master): "{user_name}, tell me about the testing for Epic {{epic_number}}. What verification has been done?"
1079
+ </output>
1080
+
1081
+ <action>WAIT for {user_name} to describe testing status</action>
1082
+
1083
+ <output>
1084
+ Dana (QA Engineer): [Responds to what {user_name} shared] "I can add to that - {{additional_testing_context}}."
1085
+
1086
+ Dana (QA Engineer): "But honestly, {{testing_concern_if_any}}."
1087
+
1088
+ Bob (Scrum Master): "{user_name}, are you confident Epic {{epic_number}} is production-ready from a quality perspective?"
1089
+ </output>
1090
+
1091
+ <action>WAIT for {user_name} to assess quality readiness</action>
1092
+
1093
+ <check if="{user_name} expresses concerns">
1094
+ <output>
1095
+ Bob (Scrum Master): "Okay, let's capture that. What specific testing is still needed?"
1096
+
1097
+ Dana (QA Engineer): "I can handle {{testing_work_needed}}, estimated {{testing_hours}} hours."
1098
+
1099
+ Bob (Scrum Master): "Adding to critical path: Complete {{testing_work_needed}} before Epic {{next_epic_num}}."
1100
+ </output>
1101
+ <action>Add testing completion to critical path</action>
1102
+ </check>
1103
+
1104
+ <action>Explore deployment and release status</action>
1105
+
1106
+ <output>
1107
+ Bob (Scrum Master): "{user_name}, what's the deployment status for Epic {{epic_number}}? Is it live in production, scheduled for deployment, or still pending?"
1108
+ </output>
1109
+
1110
+ <action>WAIT for {user_name} to provide deployment status</action>
1111
+
1112
+ <check if="not yet deployed">
1113
+ <output>
1114
+ Charlie (Senior Dev): "If it's not deployed yet, we need to factor that into Epic {{next_epic_num}} timing."
1115
+
1116
+ Bob (Scrum Master): "{user_name}, when is deployment planned? Does that timing work for starting Epic {{next_epic_num}}?"
1117
+ </output>
1118
+
1119
+ <action>WAIT for {user_name} to clarify deployment timeline</action>
1120
+
1121
+ <action>Add deployment milestone to critical path with agreed timeline</action>
1122
+ </check>
1123
+
1124
+ <action>Explore stakeholder acceptance</action>
1125
+
1126
+ <output>
1127
+ Bob (Scrum Master): "{user_name}, have stakeholders seen and accepted the Epic {{epic_number}} deliverables?"
1128
+
1129
+ Alice (Product Owner): "This is important - I've seen 'done' epics get rejected by stakeholders and force rework."
1130
+
1131
+ Bob (Scrum Master): "{user_name}, any feedback from stakeholders still pending?"
1132
+ </output>
1133
+
1134
+ <action>WAIT for {user_name} to describe stakeholder acceptance status</action>
1135
+
1136
+ <check if="acceptance incomplete or feedback pending">
1137
+ <output>
1138
+ Alice (Product Owner): "We should get formal acceptance before moving on. Otherwise Epic {{next_epic_num}} might get interrupted by rework."
1139
+
1140
+ Bob (Scrum Master): "{user_name}, how do you want to handle stakeholder acceptance? Should we make it a critical path item?"
1141
+ </output>
1142
+
1143
+ <action>WAIT for {user_name} decision</action>
1144
+
1145
+ <action>Add stakeholder acceptance to critical path if user agrees</action>
1146
+ </check>
1147
+
1148
+ <action>Explore technical health and stability</action>
1149
+
1150
+ <output>
1151
+ Bob (Scrum Master): "{user_name}, this is a gut-check question: How does the codebase feel after Epic {{epic_number}}?"
1152
+
1153
+ Bob (Scrum Master): "Stable and maintainable? Or are there concerns lurking?"
1154
+
1155
+ Charlie (Senior Dev): "Be honest, {user_name}. We've all shipped epics that felt... fragile."
1156
+ </output>
1157
+
1158
+ <action>WAIT for {user_name} to assess codebase health</action>
1159
+
1160
+ <check if="{user_name} expresses stability concerns">
1161
+ <output>
1162
+ Charlie (Senior Dev): "Okay, let's dig into that. What's causing those concerns?"
1163
+
1164
+ Charlie (Senior Dev): [Helps {user_name} articulate technical concerns]
1165
+
1166
+ Bob (Scrum Master): "What would it take to address these concerns and feel confident about stability?"
1167
+
1168
+ Charlie (Senior Dev): "I'd say we need {{stability_work_needed}}, roughly {{stability_hours}} hours."
1169
+
1170
+ Bob (Scrum Master): "{user_name}, is addressing this stability work worth doing before Epic {{next_epic_num}}?"
1171
+ </output>
1172
+
1173
+ <action>WAIT for {user_name} decision</action>
1174
+
1175
+ <action>Add stability work to preparation sprint if user agrees</action>
1176
+ </check>
1177
+
1178
+ <action>Explore unresolved blockers</action>
1179
+
1180
+ <output>
1181
+ Bob (Scrum Master): "{user_name}, are there any unresolved blockers or technical issues from Epic {{epic_number}} that we're carrying forward?"
1182
+
1183
+ Dana (QA Engineer): "Things that might create problems for Epic {{next_epic_num}} if we don't deal with them?"
1184
+
1185
+ Bob (Scrum Master): "Nothing is off limits here. If there's a problem, we need to know."
1186
+ </output>
1187
+
1188
+ <action>WAIT for {user_name} to surface any blockers</action>
1189
+
1190
+ <check if="blockers identified">
1191
+ <output>
1192
+ Bob (Scrum Master): "Let's capture those blockers and figure out how they affect Epic {{next_epic_num}}."
1193
+
1194
+ Charlie (Senior Dev): "For {{blocker_1}}, if we leave it unresolved, it'll {{impact_description_1}}."
1195
+
1196
+ Alice (Product Owner): "That sounds critical. We need to address that before moving forward."
1197
+
1198
+ Bob (Scrum Master): "Agreed. Adding to critical path: Resolve {{blocker_1}} before Epic {{next_epic_num}} kickoff."
1199
+
1200
+ Bob (Scrum Master): "Who owns that work?"
1201
+ </output>
1202
+
1203
+ <action>Assign blocker resolution to appropriate agent</action>
1204
+ <action>Add to critical path with priority and deadline</action>
1205
+ </check>
1206
+
1207
+ <action>Synthesize the readiness assessment</action>
1208
+
1209
+ <output>
1210
+ Bob (Scrum Master): "Okay {user_name}, let me synthesize what we just uncovered..."
1211
+
1212
+ **EPIC {{epic_number}} READINESS ASSESSMENT:**
1213
+
1214
+ Testing & Quality: {{quality_status}}
1215
+ {{#if quality_concerns}}⚠️ Action needed: {{quality_action_needed}}{{/if}}
1216
+
1217
+ Deployment: {{deployment_status}}
1218
+ {{#if deployment_pending}}⚠️ Scheduled for: {{deployment_date}}{{/if}}
1219
+
1220
+ Stakeholder Acceptance: {{acceptance_status}}
1221
+ {{#if acceptance_incomplete}}⚠️ Action needed: {{acceptance_action_needed}}{{/if}}
1222
+
1223
+ Technical Health: {{stability_status}}
1224
+ {{#if stability_concerns}}⚠️ Action needed: {{stability_action_needed}}{{/if}}
1225
+
1226
+ Unresolved Blockers: {{blocker_status}}
1227
+ {{#if blockers_exist}}⚠️ Must resolve: {{blocker_list}}{{/if}}
1228
+
1229
+ Bob (Scrum Master): "{user_name}, does this assessment match your understanding?"
1230
+ </output>
1231
+
1232
+ <action>WAIT for {user_name} to confirm or correct the assessment</action>
1233
+
1234
+ <output>
1235
+ Bob (Scrum Master): "Based on this assessment, Epic {{epic_number}} is {{#if all_clear}}fully complete and we're clear to proceed{{else}}complete from a story perspective, but we have {{critical_work_count}} critical items before Epic {{next_epic_num}}{{/if}}."
1236
+
1237
+ Alice (Product Owner): "This level of thoroughness is why retrospectives are valuable."
1238
+
1239
+ Charlie (Senior Dev): "Better to catch this now than three stories into the next epic."
1240
+ </output>
378
1241
 
379
1242
  </step>
380
1243
 
381
- <step n="8" goal="Retrospective Closure">
382
- <action>Scrum Master closes the retrospective with summary and next steps</action>
1244
+ <step n="10" goal="Retrospective Closure with Celebration and Commitment">
383
1245
 
384
- <action>Present closure summary:</action>
1246
+ <output>
1247
+ Bob (Scrum Master): "We've covered a lot of ground today. Let me bring this retrospective to a close."
385
1248
 
386
- ```
387
1249
  ═══════════════════════════════════════════════════════════
388
1250
  ✅ RETROSPECTIVE COMPLETE
1251
+ ═══════════════════════════════════════════════════════════
1252
+
1253
+ Bob (Scrum Master): "Epic {{epic_number}}: {{epic_title}} - REVIEWED"
389
1254
 
390
- Epic {{completed_number}}: {{epic_title}} - REVIEWED
1255
+ **Key Takeaways:**
391
1256
 
392
- Key Takeaways:
393
- - {{key_lesson_1}}
394
- - {{key_lesson_2}}
395
- - {{key_lesson_3}}
1257
+ 1. {{key_lesson_1}}
1258
+ 2. {{key_lesson_2}}
1259
+ 3. {{key_lesson_3}}
1260
+ {{#if key_lesson_4}}4. {{key_lesson_4}}{{/if}}
1261
+
1262
+ Alice (Product Owner): "That first takeaway is huge - {{impact_of_lesson_1}}."
1263
+
1264
+ Charlie (Senior Dev): "And lesson 2 is something we can apply immediately."
1265
+
1266
+ Bob (Scrum Master): "Commitments made today:"
1267
+
1268
+ - Action Items: {{action_count}}
1269
+ - Preparation Tasks: {{prep_task_count}}
1270
+ - Critical Path Items: {{critical_count}}
396
1271
 
397
- Action Items Committed: {{action_count}}
398
- Preparation Tasks Defined: {{prep_task_count}}
399
- Critical Path Items: {{critical_count}}
1272
+ Dana (QA Engineer): "That's a lot of commitments. We need to actually follow through this time."
1273
+
1274
+ Bob (Scrum Master): "Agreed. Which is why we'll review these action items in our next standup."
400
1275
 
401
1276
  ═══════════════════════════════════════════════════════════
402
1277
  🎯 NEXT STEPS:
1278
+ ═══════════════════════════════════════════════════════════
403
1279
 
404
1280
  1. Execute Preparation Sprint (Est: {{prep_days}} days)
405
- 2. Complete Critical Path items before Epic {{next_number}}
1281
+ 2. Complete Critical Path items before Epic {{next_epic_num}}
406
1282
  3. Review action items in next standup
407
- 4. Begin Epic {{next_number}} planning when preparation complete
1283
+ {{#if epic_update_needed}}4. Hold Epic {{next_epic_num}} planning review session{{else}}4. Begin Epic {{next_epic_num}} planning when preparation complete{{/if}}
1284
+
1285
+ Elena (Junior Dev): "{{prep_days}} days of prep work is significant, but necessary."
1286
+
1287
+ Alice (Product Owner): "I'll communicate the timeline to stakeholders. They'll understand if we frame it as 'ensuring Epic {{next_epic_num}} success.'"
1288
+
1289
+ ═══════════════════════════════════════════════════════════
1290
+
1291
+ Bob (Scrum Master): "Before we wrap, I want to take a moment to acknowledge the team."
1292
+
1293
+ Bob (Scrum Master): "Epic {{epic_number}} delivered {{completed_stories}} stories with {{velocity_description}} velocity. We overcame {{blocker_count}} blockers. We learned a lot. That's real work by real people."
1294
+
1295
+ Charlie (Senior Dev): "Hear, hear."
1296
+
1297
+ Alice (Product Owner): "I'm proud of what we shipped."
1298
+
1299
+ Dana (QA Engineer): "And I'm excited about Epic {{next_epic_num}} - especially now that we're prepared for it."
1300
+
1301
+ Bob (Scrum Master): "{user_name}, any final thoughts before we close?"
1302
+ </output>
1303
+
1304
+ <action>WAIT for {user_name} to share final reflections</action>
1305
+
1306
+ <output>
1307
+ Bob (Scrum Master): [Acknowledges what {user_name} shared] "Thank you for that, {user_name}."
1308
+
1309
+ Bob (Scrum Master): "Alright team - great work today. We learned a lot from Epic {{epic_number}}. Let's use these insights to make Epic {{next_epic_num}} even better."
1310
+
1311
+ Bob (Scrum Master): "See you all when prep work is done. Meeting adjourned!"
408
1312
 
409
1313
  ═══════════════════════════════════════════════════════════
410
- Scrum Master: "Great work team! We learned a lot from Epic {{completed_number}}.
411
- Let's use these insights to make Epic {{next_number}} even better.
412
- See you at sprint planning once prep work is done!"
413
- ```
1314
+ </output>
1315
+
1316
+ <action>Prepare to save retrospective summary document</action>
414
1317
 
415
- <action>Save retrospective summary to: {output_folder}/retrospectives/epic-{{completed_number}}-retro-{{date}}.md</action>
416
1318
  </step>
417
1319
 
418
- <step n="9" goal="Mark retrospective completed in sprint status" tag="sprint-status">
419
- <action>Load the FULL file: {output_folder}/sprint-status.yaml</action>
420
- <action>Find development_status key "epic-{{completed_number}}-retrospective"</action>
421
- <action>Verify current status is "optional" (expected previous state)</action>
422
- <action>Update development_status["epic-{{completed_number}}-retrospective"] = "completed"</action>
1320
+ <step n="11" goal="Save Retrospective and Update Sprint Status">
1321
+
1322
+ <action>Ensure retrospectives folder exists: {retrospectives_folder}</action>
1323
+ <action>Create folder if it doesn't exist</action>
1324
+
1325
+ <action>Generate comprehensive retrospective summary document including:</action>
1326
+
1327
+ - Epic summary and metrics
1328
+ - Team participants
1329
+ - Successes and strengths identified
1330
+ - Challenges and growth areas
1331
+ - Key insights and learnings
1332
+ - Previous retro follow-through analysis (if applicable)
1333
+ - Next epic preview and dependencies
1334
+ - Action items with owners and timelines
1335
+ - Preparation tasks for next epic
1336
+ - Critical path items
1337
+ - Significant discoveries and epic update recommendations (if any)
1338
+ - Readiness assessment
1339
+ - Commitments and next steps
1340
+
1341
+ <action>Format retrospective document as readable markdown with clear sections</action>
1342
+ <action>Set filename: {retrospectives_folder}/epic-{{epic_number}}-retro-{date}.md</action>
1343
+ <action>Save retrospective document</action>
1344
+
1345
+ <output>
1346
+ ✅ Retrospective document saved: {retrospectives_folder}/epic-{{epic_number}}-retro-{date}.md
1347
+ </output>
1348
+
1349
+ <action>Update sprint-status.yaml to mark retrospective as completed</action>
1350
+
1351
+ <action>Load the FULL file: {sprint_status_file}</action>
1352
+ <action>Find development_status key "epic-{{epic_number}}-retrospective"</action>
1353
+ <action>Verify current status (typically "optional" or "pending")</action>
1354
+ <action>Update development_status["epic-{{epic_number}}-retrospective"] = "done"</action>
423
1355
  <action>Save file, preserving ALL comments and structure including STATUS DEFINITIONS</action>
424
1356
 
425
1357
  <check if="update successful">
426
- <output>✅ Retrospective marked as completed in sprint-status.yaml
1358
+ <output>
1359
+ ✅ Retrospective marked as completed in sprint-status.yaml
427
1360
 
428
- Retrospective key: epic-{{completed_number}}-retrospective
429
- Status: optionalcompleted
1361
+ Retrospective key: epic-{{epic_number}}-retrospective
1362
+ Status: {{previous_status}}done
430
1363
  </output>
431
1364
  </check>
432
1365
 
433
1366
  <check if="retrospective key not found">
434
- <output>⚠️ Could not update retrospective status: epic-{{completed_number}}-retrospective not found
1367
+ <output>
1368
+ ⚠️ Could not update retrospective status: epic-{{epic_number}}-retrospective not found in sprint-status.yaml
435
1369
 
436
- Retrospective document was saved, but sprint-status.yaml may need manual update.
1370
+ Retrospective document was saved successfully, but sprint-status.yaml may need manual update.
437
1371
  </output>
438
1372
  </check>
1373
+
439
1374
  </step>
440
1375
 
441
- <step n="10" goal="Final summary">
442
- <action>Confirm all action items have been captured</action>
443
- <action>Remind user to schedule prep sprint if needed</action>
444
- <output>**✅ Retrospective Complete, {user_name}!**
1376
+ <step n="12" goal="Final Summary and Handoff">
1377
+
1378
+ <output>
1379
+ **✅ Retrospective Complete, {user_name}!**
445
1380
 
446
1381
  **Epic Review:**
447
1382
 
448
- - Epic {{completed_number}}: {{epic_title}} reviewed
1383
+ - Epic {{epic_number}}: {{epic_title}} reviewed
449
1384
  - Retrospective Status: completed
450
- - Retrospective saved: {output_folder}/retrospectives/epic-{{completed_number}}-retro-{{date}}.md
1385
+ - Retrospective saved: {retrospectives_folder}/epic-{{epic_number}}-retro-{date}.md
1386
+
1387
+ **Commitments Made:**
1388
+
451
1389
  - Action Items: {{action_count}}
452
1390
  - Preparation Tasks: {{prep_task_count}}
453
1391
  - Critical Path Items: {{critical_count}}
454
1392
 
455
1393
  **Next Steps:**
456
1394
 
457
- 1. Review retrospective summary: {output_folder}/retrospectives/epic-{{completed_number}}-retro-{{date}}.md
458
- 2. Execute preparation sprint (Est: {{prep_days}} days)
459
- 3. Complete critical path items before Epic {{next_number}}
460
- 4. Begin Epic {{next_number}} planning when preparation complete
461
- - Load PM agent and run `epic-tech-context` for next epic
1395
+ 1. **Review retrospective summary**: {retrospectives_folder}/epic-{{epic_number}}-retro-{date}.md
1396
+
1397
+ 2. **Execute preparation sprint** (Est: {{prep_days}} days)
1398
+ - Complete {{critical_count}} critical path items
1399
+ - Execute {{prep_task_count}} preparation tasks
1400
+ - Verify all action items are in progress
1401
+
1402
+ 3. **Review action items in next standup**
1403
+ - Ensure ownership is clear
1404
+ - Track progress on commitments
1405
+ - Adjust timelines if needed
1406
+
1407
+ {{#if epic_update_needed}} 4. **IMPORTANT: Schedule Epic {{next_epic_num}} planning review session**
1408
+
1409
+ - Significant discoveries from Epic {{epic_number}} require epic updates
1410
+ - Review and update affected stories
1411
+ - Align team on revised approach
1412
+ - Do NOT start Epic {{next_epic_num}} until review is complete
1413
+ {{else}}
1414
+
1415
+ 4. **Begin Epic {{next_epic_num}} planning when preparation complete**
1416
+ - Load PM agent and run `epic-tech-context` for Epic {{next_epic_num}}
462
1417
  - Or continue with existing contexted epics
463
- </output>
464
- </step>
1418
+ - Ensure all critical path items are done first
1419
+ {{/if}}
1420
+
1421
+ **Team Performance:**
1422
+ Epic {{epic_number}} delivered {{completed_stories}} stories with {{velocity_summary}}. The retrospective surfaced {{insight_count}} key insights and {{significant_discovery_count}} significant discoveries. The team is well-positioned for Epic {{next_epic_num}} success.
1423
+
1424
+ {{#if significant_discovery_count > 0}}
1425
+ ⚠️ **REMINDER**: Epic update required before starting Epic {{next_epic_num}}
1426
+ {{/if}}
1427
+
1428
+ ---
1429
+
1430
+ Bob (Scrum Master): "Great session today, {user_name}. The team did excellent work."
1431
+
1432
+ Alice (Product Owner): "See you at epic planning!"
1433
+
1434
+ Charlie (Senior Dev): "Time to knock out that prep work."
1435
+
1436
+ </output>
1437
+
1438
+ </step>
465
1439
 
466
1440
  </workflow>
467
1441
 
468
1442
  <facilitation-guidelines>
1443
+ <guideline>PARTY MODE REQUIRED: All agent dialogue uses "Name (Role): dialogue" format</guideline>
469
1444
  <guideline>Scrum Master maintains psychological safety throughout - no blame or judgment</guideline>
470
1445
  <guideline>Focus on systems and processes, not individual performance</guideline>
1446
+ <guideline>Create authentic team dynamics: disagreements, diverse perspectives, emotions</guideline>
1447
+ <guideline>User ({user_name}) is active participant, not passive observer</guideline>
471
1448
  <guideline>Encourage specific examples over general statements</guideline>
472
1449
  <guideline>Balance celebration of wins with honest assessment of challenges</guideline>
473
1450
  <guideline>Ensure every voice is heard - all agents contribute</guideline>
474
1451
  <guideline>Action items must be specific, achievable, and owned</guideline>
475
1452
  <guideline>Forward-looking mindset - how do we improve for next epic?</guideline>
476
- <guideline>Two-part structure ensures both reflection AND preparation</guideline>
1453
+ <guideline>Intent-based facilitation, not scripted phrases</guideline>
1454
+ <guideline>Deep story analysis provides rich material for discussion</guideline>
1455
+ <guideline>Previous retro integration creates accountability and continuity</guideline>
1456
+ <guideline>Significant change detection prevents epic misalignment</guideline>
477
1457
  <guideline>Critical verification prevents starting next epic prematurely</guideline>
478
1458
  <guideline>Document everything - retrospective insights are valuable for future reference</guideline>
1459
+ <guideline>Two-part structure ensures both reflection AND preparation</guideline>
479
1460
  </facilitation-guidelines>