bmad-plus 0.7.5 → 0.8.0

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 (294) hide show
  1. package/CHANGELOG.md +450 -425
  2. package/LICENSE +21 -21
  3. package/README.md +555 -447
  4. package/osint-agent-package/README.md +88 -88
  5. package/osint-agent-package/SETUP_KEYS.md +108 -108
  6. package/osint-agent-package/agents/osint-investigator.md +80 -80
  7. package/osint-agent-package/install.ps1 +87 -87
  8. package/osint-agent-package/install.sh +76 -76
  9. package/osint-agent-package/skills/bmad-osint-investigate/SKILL.md +147 -147
  10. package/osint-agent-package/skills/bmad-osint-investigate/osint/SKILL.md +452 -452
  11. package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/dossier-template.md +116 -116
  12. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/content-extraction.md +100 -100
  13. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/enrichment-databases-fr.md +148 -148
  14. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/platforms.md +130 -130
  15. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/psychoprofile.md +69 -69
  16. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/tools.md +281 -281
  17. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/_http.py +101 -101
  18. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/apify.py +266 -260
  19. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/brightdata.py +101 -101
  20. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/diagnose.py +141 -141
  21. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/exa.py +79 -79
  22. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/jina.py +71 -71
  23. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/mcp-client.py +136 -136
  24. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/parallel.py +85 -85
  25. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/perplexity.py +102 -102
  26. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/tavily.py +72 -72
  27. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/volley.py +208 -208
  28. package/osint-agent-package/skills/bmad-osint-investigator/SKILL.md +15 -15
  29. package/package.json +62 -57
  30. package/readme-international/README.de.md +576 -426
  31. package/readme-international/README.es.md +578 -518
  32. package/readme-international/README.fr.md +576 -516
  33. package/src/bmad-plus/agents/agent-architect-dev/SKILL.md +96 -96
  34. package/src/bmad-plus/agents/agent-architect-dev/bmad-skill-manifest.yaml +13 -13
  35. package/src/bmad-plus/agents/agent-maker/SKILL.md +201 -201
  36. package/src/bmad-plus/agents/agent-maker/bmad-skill-manifest.yaml +13 -13
  37. package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +137 -137
  38. package/src/bmad-plus/agents/agent-orchestrator/bmad-skill-manifest.yaml +13 -13
  39. package/src/bmad-plus/agents/agent-quality/SKILL.md +83 -83
  40. package/src/bmad-plus/agents/agent-quality/bmad-skill-manifest.yaml +13 -13
  41. package/src/bmad-plus/agents/agent-shadow/SKILL.md +71 -71
  42. package/src/bmad-plus/agents/agent-shadow/bmad-skill-manifest.yaml +13 -13
  43. package/src/bmad-plus/agents/agent-strategist/SKILL.md +80 -80
  44. package/src/bmad-plus/agents/agent-strategist/bmad-skill-manifest.yaml +13 -13
  45. package/src/bmad-plus/agents/pack-animated/animated-website-agent.md +325 -325
  46. package/src/bmad-plus/agents/pack-animated/templates/animated-website-workflow.md +55 -55
  47. package/src/bmad-plus/agents/pack-backup/backup-agent.md +71 -71
  48. package/src/bmad-plus/agents/pack-backup/templates/backup-workflow.md +51 -51
  49. package/src/bmad-plus/agents/pack-seo/SKILL.md +171 -171
  50. package/src/bmad-plus/agents/pack-seo/checklist.md +140 -140
  51. package/src/bmad-plus/agents/pack-seo/pagespeed-playbook.md +320 -320
  52. package/src/bmad-plus/agents/pack-seo/ref/audit-schema.json +187 -187
  53. package/src/bmad-plus/agents/pack-seo/ref/cwv-thresholds.md +87 -87
  54. package/src/bmad-plus/agents/pack-seo/ref/eeat-criteria.md +123 -123
  55. package/src/bmad-plus/agents/pack-seo/ref/geo-signals.md +167 -167
  56. package/src/bmad-plus/agents/pack-seo/ref/hreflang-rules.md +153 -153
  57. package/src/bmad-plus/agents/pack-seo/ref/quality-gates.md +133 -133
  58. package/src/bmad-plus/agents/pack-seo/ref/schema-catalog.md +91 -91
  59. package/src/bmad-plus/agents/pack-seo/ref/schema-templates.json +356 -356
  60. package/src/bmad-plus/agents/pack-seo/seo-chief.md +294 -294
  61. package/src/bmad-plus/agents/pack-seo/seo-judge.md +241 -241
  62. package/src/bmad-plus/agents/pack-seo/seo-scout.md +171 -171
  63. package/src/bmad-plus/agents/pack-seo/templates/seo-audit-workflow.md +241 -241
  64. package/src/bmad-plus/data/role-triggers.yaml +209 -209
  65. package/src/bmad-plus/module-help.csv +10 -10
  66. package/src/bmad-plus/module.yaml +283 -280
  67. package/src/bmad-plus/packs/pack-animated/animated-website-agent.md +325 -0
  68. package/src/bmad-plus/packs/pack-animated/templates/animated-website-workflow.md +55 -0
  69. package/src/bmad-plus/packs/pack-backup/backup-agent.md +71 -0
  70. package/src/bmad-plus/packs/pack-backup/templates/backup-workflow.md +51 -0
  71. package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -162
  72. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +73 -73
  73. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +61 -61
  74. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +95 -95
  75. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +95 -95
  76. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +134 -134
  77. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +80 -80
  78. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +73 -73
  79. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +95 -95
  80. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +73 -73
  81. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +73 -73
  82. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +92 -92
  83. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +80 -80
  84. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +90 -90
  85. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -153
  86. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -173
  87. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -224
  88. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -329
  89. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -318
  90. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -359
  91. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -379
  92. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -361
  93. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +81 -81
  94. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +67 -67
  95. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -85
  96. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -35
  97. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -49
  98. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +131 -131
  99. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +89 -89
  100. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +300 -300
  101. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +428 -428
  102. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +73 -73
  103. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -80
  104. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +484 -484
  105. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +193 -193
  106. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +175 -175
  107. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +110 -110
  108. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1511 -1511
  109. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +298 -298
  110. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +296 -296
  111. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +29 -29
  112. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +74 -74
  113. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +29 -29
  114. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +73 -73
  115. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +89 -89
  116. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +73 -73
  117. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +29 -29
  118. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +141 -141
  119. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -37
  120. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -75
  121. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -6
  122. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +110 -110
  123. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +176 -176
  124. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -67
  125. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -86
  126. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -179
  127. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -66
  128. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +127 -127
  129. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -105
  130. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -120
  131. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -12
  132. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -328
  133. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -32
  134. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -81
  135. package/src/bmad-plus/packs/pack-memory/README.md +106 -106
  136. package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +79 -79
  137. package/src/bmad-plus/packs/pack-memory/shared/karpathy-guardrails.md +86 -86
  138. package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +143 -143
  139. package/src/bmad-plus/packs/pack-memory/templates/context.md +39 -39
  140. package/src/bmad-plus/packs/pack-memory/templates/decisions.md +25 -25
  141. package/src/bmad-plus/packs/pack-memory/templates/identity.yaml +39 -39
  142. package/src/bmad-plus/packs/pack-memory/templates/lessons.md +31 -31
  143. package/src/bmad-plus/packs/pack-memory/templates/patterns.md +24 -24
  144. package/src/bmad-plus/packs/pack-memory/templates/session-handoff.md +25 -25
  145. package/src/bmad-plus/packs/pack-memory/zecher-agent.md +157 -157
  146. package/src/bmad-plus/packs/pack-seo/SKILL.md +171 -0
  147. package/src/bmad-plus/packs/pack-seo/checklist.md +140 -0
  148. package/src/bmad-plus/packs/pack-seo/pagespeed-playbook.md +320 -0
  149. package/src/bmad-plus/packs/pack-seo/ref/audit-schema.json +187 -0
  150. package/src/bmad-plus/packs/pack-seo/ref/cwv-thresholds.md +87 -0
  151. package/src/bmad-plus/packs/pack-seo/ref/eeat-criteria.md +123 -0
  152. package/src/bmad-plus/packs/pack-seo/ref/geo-signals.md +167 -0
  153. package/src/bmad-plus/packs/pack-seo/ref/hreflang-rules.md +153 -0
  154. package/src/bmad-plus/packs/pack-seo/ref/quality-gates.md +133 -0
  155. package/src/bmad-plus/packs/pack-seo/ref/schema-catalog.md +91 -0
  156. package/src/bmad-plus/packs/pack-seo/ref/schema-templates.json +356 -0
  157. package/src/bmad-plus/packs/pack-seo/seo-chief.md +294 -0
  158. package/src/bmad-plus/packs/pack-seo/seo-judge.md +241 -0
  159. package/src/bmad-plus/packs/pack-seo/seo-scout.md +171 -0
  160. package/src/bmad-plus/packs/pack-seo/templates/seo-audit-workflow.md +241 -0
  161. package/src/bmad-plus/packs/pack-shield/README.md +110 -110
  162. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/csrd-agent.md +262 -262
  163. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/section508-agent.md +179 -179
  164. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/wcag-agent.md +201 -201
  165. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/eu-ai-act-agent.md +97 -97
  166. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/iso42001-agent.md +251 -251
  167. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/nist-ai-rmf-agent.md +133 -133
  168. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/cis-controls-agent.md +221 -221
  169. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/ism-agent.md +150 -150
  170. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/iso27001-agent.md +167 -167
  171. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nis2-agent.md +83 -83
  172. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-800-53-agent.md +250 -250
  173. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-csf-agent.md +218 -218
  174. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/ccpa-agent.md +94 -94
  175. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/dpdpa-agent.md +136 -136
  176. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/gdpr-agent.md +296 -296
  177. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/iso27701-agent.md +134 -134
  178. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/lgpd-agent.md +129 -129
  179. package/src/bmad-plus/packs/pack-shield/categories/defense-export/cmmc-agent.md +127 -127
  180. package/src/bmad-plus/packs/pack-shield/categories/defense-export/ear-agent.md +272 -272
  181. package/src/bmad-plus/packs/pack-shield/categories/defense-export/itar-agent.md +202 -202
  182. package/src/bmad-plus/packs/pack-shield/categories/defense-export/tsa-agent.md +367 -367
  183. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/dora-agent.md +510 -510
  184. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/fedramp-agent.md +247 -247
  185. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/hipaa-agent.md +173 -173
  186. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/pci-dss-agent.md +239 -239
  187. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/soc2-agent.md +266 -266
  188. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/swift-csp-agent.md +164 -164
  189. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-classifier.md +131 -131
  190. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-fria.md +155 -155
  191. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-incidents.md +187 -187
  192. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-roles.md +113 -113
  193. package/src/bmad-plus/packs/pack-shield/categories/workflows/breach-sentinel.md +197 -197
  194. package/src/bmad-plus/packs/pack-shield/categories/workflows/cookie-policy-gen.md +180 -180
  195. package/src/bmad-plus/packs/pack-shield/categories/workflows/dpia-sentinel.md +235 -235
  196. package/src/bmad-plus/packs/pack-shield/categories/workflows/legitimate-interest.md +159 -159
  197. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-advisor.md +133 -133
  198. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-notice-gen.md +160 -160
  199. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-policy-gen.md +135 -135
  200. package/src/bmad-plus/packs/pack-shield/references/ccpa/ccpa-gdpr-comparison.md +117 -117
  201. package/src/bmad-plus/packs/pack-shield/references/ccpa/consumer-rights-workflows.md +177 -177
  202. package/src/bmad-plus/packs/pack-shield/references/cis-controls/framework-mappings.md +162 -162
  203. package/src/bmad-plus/packs/pack-shield/references/cis-controls/implementation-guidance.md +235 -235
  204. package/src/bmad-plus/packs/pack-shield/references/cis-controls/safeguards-detail.md +252 -252
  205. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-assessment.md +170 -170
  206. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-levels.md +113 -113
  207. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-practices.md +211 -211
  208. package/src/bmad-plus/packs/pack-shield/references/csrd/compliance-program.md +281 -281
  209. package/src/bmad-plus/packs/pack-shield/references/csrd/double-materiality.md +253 -253
  210. package/src/bmad-plus/packs/pack-shield/references/csrd/esrs-standards.md +401 -401
  211. package/src/bmad-plus/packs/pack-shield/references/dora/article-reference.md +441 -441
  212. package/src/bmad-plus/packs/pack-shield/references/dora/incident-classification.md +297 -297
  213. package/src/bmad-plus/packs/pack-shield/references/dora/rts-its-guide.md +306 -306
  214. package/src/bmad-plus/packs/pack-shield/references/dora/third-party-risk.md +349 -349
  215. package/src/bmad-plus/packs/pack-shield/references/dpdpa/gdpr-comparison.md +173 -173
  216. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rights-and-obligations.md +426 -426
  217. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rules-2025.md +599 -599
  218. package/src/bmad-plus/packs/pack-shield/references/dpdpa/sections-reference.md +319 -319
  219. package/src/bmad-plus/packs/pack-shield/references/ear/ccl-eccn-guide.md +250 -250
  220. package/src/bmad-plus/packs/pack-shield/references/ear/compliance-program.md +280 -280
  221. package/src/bmad-plus/packs/pack-shield/references/ear/license-exceptions.md +207 -207
  222. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/gpai-governance.md +267 -267
  223. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/obligations-high-risk.md +287 -287
  224. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/risk-classification.md +182 -182
  225. package/src/bmad-plus/packs/pack-shield/references/fedramp/appendices-guide.md +209 -209
  226. package/src/bmad-plus/packs/pack-shield/references/fedramp/control-families.md +281 -281
  227. package/src/bmad-plus/packs/pack-shield/references/fedramp/poam-guide.md +93 -93
  228. package/src/bmad-plus/packs/pack-shield/references/fedramp/readiness-checklist.md +134 -134
  229. package/src/bmad-plus/packs/pack-shield/references/fedramp/sap-sar-guide.md +86 -86
  230. package/src/bmad-plus/packs/pack-shield/references/fedramp/ssp-guide.md +129 -129
  231. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/documents.md +192 -192
  232. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/dpa-template.md +121 -121
  233. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/privacy-notice.md +87 -87
  234. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/breach-notification.md +293 -293
  235. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/privacy-rule.md +276 -276
  236. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/security-rule.md +299 -299
  237. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/templates.md +568 -568
  238. package/src/bmad-plus/packs/pack-shield/references/ism/control-applicability.md +181 -181
  239. package/src/bmad-plus/packs/pack-shield/references/ism/guidelines-overview.md +183 -183
  240. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2013.md +203 -203
  241. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2022.md +132 -132
  242. package/src/bmad-plus/packs/pack-shield/references/iso27001/control-mapping.md +153 -153
  243. package/src/bmad-plus/packs/pack-shield/references/iso27701/annex-a-controls.md +195 -195
  244. package/src/bmad-plus/packs/pack-shield/references/iso27701/regulatory-mapping.md +229 -229
  245. package/src/bmad-plus/packs/pack-shield/references/iso27701/transition-guide.md +219 -219
  246. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-ai-risk-assessment.md +258 -258
  247. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-clauses-requirements.md +279 -279
  248. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-controls-annex-a.md +155 -155
  249. package/src/bmad-plus/packs/pack-shield/references/itar/compliance-program.md +174 -174
  250. package/src/bmad-plus/packs/pack-shield/references/itar/licensing-guide.md +146 -146
  251. package/src/bmad-plus/packs/pack-shield/references/itar/usml-categories.md +93 -93
  252. package/src/bmad-plus/packs/pack-shield/references/lgpd/anpd-enforcement.md +147 -147
  253. package/src/bmad-plus/packs/pack-shield/references/lgpd/compliance-program.md +272 -272
  254. package/src/bmad-plus/packs/pack-shield/references/lgpd/lgpd-articles.md +271 -271
  255. package/src/bmad-plus/packs/pack-shield/references/nis2/article-21-measures.md +153 -153
  256. package/src/bmad-plus/packs/pack-shield/references/nis2/iso27001-nis2-mapping.md +68 -68
  257. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/assessment-rmf.md +349 -349
  258. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/baselines-tailoring.md +277 -277
  259. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/control-families.md +450 -450
  260. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-core.md +361 -361
  261. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-profiles.md +192 -192
  262. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-10-to-20-mapping.md +143 -143
  263. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-20-functions-categories.md +278 -278
  264. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-implementation-tiers.md +135 -135
  265. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-requirements.md +366 -366
  266. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-saq-guide.md +217 -217
  267. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-v4-changes.md +190 -190
  268. package/src/bmad-plus/packs/pack-shield/references/section-508/wcag-mapping.md +160 -160
  269. package/src/bmad-plus/packs/pack-shield/references/soc2/controls.md +241 -241
  270. package/src/bmad-plus/packs/pack-shield/references/soc2/evidence.md +236 -236
  271. package/src/bmad-plus/packs/pack-shield/references/soc2/policies.md +254 -254
  272. package/src/bmad-plus/packs/pack-shield/references/soc2/vendor.md +276 -276
  273. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-assessment.md +202 -202
  274. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-controls.md +545 -545
  275. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-crmp-requirements.md +359 -359
  276. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-directives-overview.md +187 -187
  277. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-incident-reporting.md +187 -187
  278. package/src/bmad-plus/packs/pack-shield/references/wcag/criteria-detail.md +510 -510
  279. package/src/bmad-plus/packs/pack-shield/shared/audit-report-template.md +103 -103
  280. package/src/bmad-plus/packs/pack-shield/shared/cross-framework-mapper.md +103 -103
  281. package/src/bmad-plus/packs/pack-shield/shared/gap-analysis-template.md +83 -83
  282. package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +229 -229
  283. package/src/bmad-plus/packs/pack-shield/upstream-sync.yaml +68 -68
  284. package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +99 -99
  285. package/src/bmad-plus/skills/bmad-plus-parallel/SKILL.md +93 -93
  286. package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +69 -69
  287. package/tools/cli/commands/autoconfig.js +498 -489
  288. package/tools/cli/commands/doctor.js +222 -222
  289. package/tools/cli/commands/install.js +739 -739
  290. package/tools/cli/commands/memory.js +194 -194
  291. package/tools/cli/commands/scan.js +360 -350
  292. package/tools/cli/commands/uninstall.js +96 -96
  293. package/tools/cli/commands/update.js +174 -174
  294. package/tools/cli/i18n.js +763 -763
@@ -1,301 +1,301 @@
1
- ---
2
- name: bmad-correct-course
3
- description: 'Manage significant changes during sprint execution. Use when the user says "correct course" or "propose sprint change"'
4
- ---
5
-
6
- # Correct Course - Sprint Change Management Workflow
7
-
8
- **Goal:** Manage significant changes during sprint execution by analyzing impact across all project artifacts and producing a structured Sprint Change Proposal.
9
-
10
- **Your Role:** You are a Developer navigating change management. Analyze the triggering issue, assess impact across PRD, epics, architecture, and UX artifacts, and produce an actionable Sprint Change Proposal with clear handoff.
11
-
12
- ## Conventions
13
-
14
- - Bare paths (e.g. `checklist.md`) resolve from the skill root.
15
- - `this skill directory` resolves to this skill's installed directory (where `agent configuration` lives).
16
- - `{project-root}`-prefixed paths resolve from the project working directory.
17
- - `{skill-name}` resolves to the skill directory's basename.
18
-
19
- ## On Activation
20
-
21
- ### Step 1: Resolve the Workflow Block
22
-
23
- <!-- Adapted for BMAD+: original script dependency removed -->
24
-
25
- **If the script fails**, resolve the `workflow` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
26
-
27
- 1. `this skill file` — defaults
28
- 2. `{project-root}/custom/{skill-name}.toml` — team overrides
29
- 3. `{project-root}/custom/{skill-name}.user.toml` — personal overrides
30
-
31
- Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.
32
-
33
- ### Step 2: Execute Prepend Steps
34
-
35
- Execute each entry in `{workflow.activation_steps_prepend}` in order before proceeding.
36
-
37
- ### Step 3: Load Persistent Facts
38
-
39
- Treat every entry in `{workflow.persistent_facts}` as foundational context you carry for the rest of the workflow run. Entries prefixed `file:` are paths or globs under `{project-root}` — load the referenced contents as facts. All other entries are facts verbatim.
40
-
41
- ### Step 4: Load Config
42
-
43
- Load config from `{project-root}/project config` and resolve:
44
-
45
- - `project_name`, `user_name`
46
- - `communication_language`, `document_output_language`
47
- - `user_skill_level`
48
- - `implementation_artifacts`
49
- - `planning_artifacts`
50
- - `project_knowledge`
51
- - `date` as system-generated current datetime
52
- - YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the config `{communication_language}`
53
- - Language MUST be tailored to `{user_skill_level}`
54
- - Generate all documents in `{document_output_language}`
55
- - DOCUMENT OUTPUT: Updated epics, stories, or PRD sections. Clear, actionable changes. User skill level (`{user_skill_level}`) affects conversation style ONLY, not document updates.
56
-
57
- ### Step 5: Greet the User
58
-
59
- Greet `{user_name}`, speaking in `{communication_language}`.
60
-
61
- ### Step 6: Execute Append Steps
62
-
63
- Execute each entry in `{workflow.activation_steps_append}` in order.
64
-
65
- Activation is complete. Begin the workflow below.
66
-
67
- ## Paths
68
-
69
- - `default_output_file` = `{planning_artifacts}/sprint-change-proposal-{date}.md`
70
-
71
- ## Input Files
72
-
73
- | Input | Path | Load Strategy |
74
- |-------|------|---------------|
75
- | PRD | `{planning_artifacts}/*prd*.md` (whole) or `{planning_artifacts}/*prd*/*.md` (sharded) | FULL_LOAD |
76
- | Epics | `{planning_artifacts}/*epic*.md` (whole) or `{planning_artifacts}/*epic*/*.md` (sharded) | FULL_LOAD |
77
- | Architecture | `{planning_artifacts}/*architecture*.md` (whole) or `{planning_artifacts}/*architecture*/*.md` (sharded) | FULL_LOAD |
78
- | UX Design | `{planning_artifacts}/*ux*.md` (whole) or `{planning_artifacts}/*ux*/*.md` (sharded) | FULL_LOAD |
79
- | Spec | `{planning_artifacts}/*spec-*.md` (whole) | FULL_LOAD |
80
- | Document Project | `{project_knowledge}/index.md` (sharded) | INDEX_GUIDED |
81
-
82
- ## Execution
83
-
84
- ### Document Discovery - Loading Project Artifacts
85
-
86
- **Strategy**: Course correction needs broad project context to assess change impact accurately. Load all available planning artifacts.
87
-
88
- **Discovery Process for FULL_LOAD documents (PRD, Epics, Architecture, UX Design, Spec):**
89
-
90
- 1. **Search for whole document first** - Look for files matching the whole-document pattern (e.g., `*prd*.md`, `*epic*.md`, `*architecture*.md`, `*ux*.md`, `*spec-*.md`)
91
- 2. **Check for sharded version** - If whole document not found, look for a directory with `index.md` (e.g., `prd/index.md`, `epics/index.md`)
92
- 3. **If sharded version found**:
93
- - Read `index.md` to understand the document structure
94
- - Read ALL section files listed in the index
95
- - Process the combined content as a single document
96
- 4. **Priority**: If both whole and sharded versions exist, use the whole document
97
-
98
- **Discovery Process for INDEX_GUIDED documents (Document Project):**
99
-
100
- 1. **Search for index file** - Look for `{project_knowledge}/index.md`
101
- 2. **If found**: Read the index to understand available documentation sections
102
- 3. **Selectively load sections** based on relevance to the change being analyzed — do NOT load everything, only sections that relate to the impacted areas
103
- 4. **This document is optional** — skip if `{project_knowledge}` does not exist (greenfield projects)
104
-
105
- **Fuzzy matching**: Be flexible with document names — users may use variations like `prd.md`, `bmm-prd.md`, `product-requirements.md`, etc.
106
-
107
- **Missing documents**: Not all documents may exist. PRD and Epics are essential; Architecture, UX Design, Spec, and Document Project are loaded if available. HALT if PRD or Epics cannot be found.
108
-
109
- <workflow>
110
-
111
- <step n="1" goal="Initialize Change Navigation">
112
- <action>Confirm change trigger and gather user description of the issue</action>
113
- <action>Ask: "What specific issue or change has been identified that requires navigation?"</action>
114
- <action>Verify access to project documents:</action>
115
- - PRD (Product Requirements Document) — required
116
- - Current Epics and Stories — required
117
- - Architecture documentation — optional, load if available
118
- - UI/UX specifications — optional, load if available
119
- <action>Ask user for mode preference:</action>
120
- - **Incremental** (recommended): Refine each edit collaboratively
121
- - **Batch**: Present all changes at once for review
122
- <action>Store mode selection for use throughout workflow</action>
123
-
124
- <action if="change trigger is unclear">HALT: "Cannot navigate change without clear understanding of the triggering issue. Please provide specific details about what needs to change and why."</action>
125
-
126
- <action if="PRD or Epics are unavailable">HALT: "Need access to PRD and Epics to assess change impact. Please ensure these documents are accessible. Architecture and UI/UX will be used if available."</action>
127
- </step>
128
-
129
- <step n="2" goal="Execute Change Analysis Checklist">
130
- <action>Read fully and follow the systematic analysis from: checklist.md</action>
131
- <action>Work through each checklist section interactively with the user</action>
132
- <action>Record status for each checklist item:</action>
133
- - [x] Done - Item completed successfully
134
- - [N/A] Skip - Item not applicable to this change
135
- - [!] Action-needed - Item requires attention or follow-up
136
- <action>Maintain running notes of findings and impacts discovered</action>
137
- <action>Present checklist progress after each major section</action>
138
-
139
- <action if="checklist cannot be completed">Identify blocking issues and work with user to resolve before continuing</action>
140
- </step>
141
-
142
- <step n="3" goal="Draft Specific Change Proposals">
143
- <action>Based on checklist findings, create explicit edit proposals for each identified artifact</action>
144
-
145
- <action>For Story changes:</action>
146
-
147
- - Show old → new text format
148
- - Include story ID and section being modified
149
- - Provide rationale for each change
150
- - Example format:
151
-
152
- ```
153
- Story: [STORY-123] User Authentication
154
- Section: Acceptance Criteria
155
-
156
- OLD:
157
- - User can log in with email/password
158
-
159
- NEW:
160
- - User can log in with email/password
161
- - User can enable 2FA via authenticator app
162
-
163
- Rationale: Security requirement identified during implementation
164
- ```
165
-
166
- <action>For PRD modifications:</action>
167
-
168
- - Specify exact sections to update
169
- - Show current content and proposed changes
170
- - Explain impact on MVP scope and requirements
171
-
172
- <action>For Architecture changes:</action>
173
-
174
- - Identify affected components, patterns, or technology choices
175
- - Describe diagram updates needed
176
- - Note any ripple effects on other components
177
-
178
- <action>For UI/UX specification updates:</action>
179
-
180
- - Reference specific screens or components
181
- - Show wireframe or flow changes needed
182
- - Connect changes to user experience impact
183
-
184
- <check if="mode is Incremental">
185
- <action>Present each edit proposal individually</action>
186
- <ask>Review and refine this change? Options: Approve [a], Edit [e], Skip [s]</ask>
187
- <action>Iterate on each proposal based on user feedback</action>
188
- </check>
189
-
190
- <action if="mode is Batch">Collect all edit proposals and present together at end of step</action>
191
-
192
- </step>
193
-
194
- <step n="4" goal="Generate Sprint Change Proposal">
195
- <action>Compile comprehensive Sprint Change Proposal document with following sections:</action>
196
-
197
- <action>Section 1: Issue Summary</action>
198
-
199
- - Clear problem statement describing what triggered the change
200
- - Context about when/how the issue was discovered
201
- - Evidence or examples demonstrating the issue
202
-
203
- <action>Section 2: Impact Analysis</action>
204
-
205
- - Epic Impact: Which epics are affected and how
206
- - Story Impact: Current and future stories requiring changes
207
- - Artifact Conflicts: PRD, Architecture, UI/UX documents needing updates
208
- - Technical Impact: Code, infrastructure, or deployment implications
209
-
210
- <action>Section 3: Recommended Approach</action>
211
-
212
- - Present chosen path forward from checklist evaluation:
213
- - Direct Adjustment: Modify/add stories within existing plan
214
- - Potential Rollback: Revert completed work to simplify resolution
215
- - MVP Review: Reduce scope or modify goals
216
- - Provide clear rationale for recommendation
217
- - Include effort estimate, risk assessment, and timeline impact
218
-
219
- <action>Section 4: Detailed Change Proposals</action>
220
-
221
- - Include all refined edit proposals from Step 3
222
- - Group by artifact type (Stories, PRD, Architecture, UI/UX)
223
- - Ensure each change includes before/after and justification
224
-
225
- <action>Section 5: Implementation Handoff</action>
226
-
227
- - Categorize change scope:
228
- - Minor: Direct implementation by Developer agent
229
- - Moderate: Backlog reorganization needed (PO/DEV)
230
- - Major: Fundamental replan required (PM/Architect)
231
- - Specify handoff recipients and their responsibilities
232
- - Define success criteria for implementation
233
-
234
- <action>Present complete Sprint Change Proposal to user</action>
235
- <action>Write Sprint Change Proposal document to {default_output_file}</action>
236
- <ask>Review complete proposal. Continue [c] or Edit [e]?</ask>
237
- </step>
238
-
239
- <step n="5" goal="Finalize and Route for Implementation">
240
- <action>Get explicit user approval for complete proposal</action>
241
- <ask>Do you approve this Sprint Change Proposal for implementation? (yes/no/revise)</ask>
242
-
243
- <check if="no or revise">
244
- <action>Gather specific feedback on what needs adjustment</action>
245
- <action>Return to appropriate step to address concerns</action>
246
- <goto step="3">If changes needed to edit proposals</goto>
247
- <goto step="4">If changes needed to overall proposal structure</goto>
248
-
249
- </check>
250
-
251
- <check if="yes the proposal is approved by the user">
252
- <action>Finalize Sprint Change Proposal document</action>
253
- <action>Determine change scope classification:</action>
254
-
255
- - **Minor**: Can be implemented directly by Developer agent
256
- - **Moderate**: Requires backlog reorganization and PO/DEV coordination
257
- - **Major**: Needs fundamental replan with PM/Architect involvement
258
-
259
- <action>Provide appropriate handoff based on scope:</action>
260
-
261
- </check>
262
-
263
- <check if="Minor scope">
264
- <action>Route to: Developer agent for direct implementation</action>
265
- <action>Deliverables: Finalized edit proposals and implementation tasks</action>
266
- </check>
267
-
268
- <check if="Moderate scope">
269
- <action>Route to: Product Owner / Developer agents</action>
270
- <action>Deliverables: Sprint Change Proposal + backlog reorganization plan</action>
271
- </check>
272
-
273
- <check if="Major scope">
274
- <action>Route to: Product Manager / Solution Architect</action>
275
- <action>Deliverables: Complete Sprint Change Proposal + escalation notice</action>
276
-
277
- <action>Confirm handoff completion and next steps with user</action>
278
- <action>Document handoff in workflow execution log</action>
279
- </check>
280
-
281
- </step>
282
-
283
- <step n="6" goal="Workflow Completion">
284
- <action>Summarize workflow execution:</action>
285
- - Issue addressed: {{change_trigger}}
286
- - Change scope: {{scope_classification}}
287
- - Artifacts modified: {{list_of_artifacts}}
288
- - Routed to: {{handoff_recipients}}
289
-
290
- <action>Confirm all deliverables produced:</action>
291
-
292
- - Sprint Change Proposal document
293
- - Specific edit proposals with before/after
294
- - Implementation handoff plan
295
-
296
- <action>Report workflow completion to user with personalized message: "Correct Course workflow complete, {user_name}!"</action>
297
- <action>Remind user of success criteria and next steps for Developer agent</action>
298
- <!-- Adapted for BMAD+: original script dependency removed -->
299
- </step>
300
-
1
+ ---
2
+ name: bmad-correct-course
3
+ description: 'Manage significant changes during sprint execution. Use when the user says "correct course" or "propose sprint change"'
4
+ ---
5
+
6
+ # Correct Course - Sprint Change Management Workflow
7
+
8
+ **Goal:** Manage significant changes during sprint execution by analyzing impact across all project artifacts and producing a structured Sprint Change Proposal.
9
+
10
+ **Your Role:** You are a Developer navigating change management. Analyze the triggering issue, assess impact across PRD, epics, architecture, and UX artifacts, and produce an actionable Sprint Change Proposal with clear handoff.
11
+
12
+ ## Conventions
13
+
14
+ - Bare paths (e.g. `checklist.md`) resolve from the skill root.
15
+ - `this skill directory` resolves to this skill's installed directory (where `agent configuration` lives).
16
+ - `{project-root}`-prefixed paths resolve from the project working directory.
17
+ - `{skill-name}` resolves to the skill directory's basename.
18
+
19
+ ## On Activation
20
+
21
+ ### Step 1: Resolve the Workflow Block
22
+
23
+ <!-- Adapted for BMAD+: original script dependency removed -->
24
+
25
+ **If the script fails**, resolve the `workflow` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
26
+
27
+ 1. `this skill file` — defaults
28
+ 2. `{project-root}/custom/{skill-name}.toml` — team overrides
29
+ 3. `{project-root}/custom/{skill-name}.user.toml` — personal overrides
30
+
31
+ Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.
32
+
33
+ ### Step 2: Execute Prepend Steps
34
+
35
+ Execute each entry in `{workflow.activation_steps_prepend}` in order before proceeding.
36
+
37
+ ### Step 3: Load Persistent Facts
38
+
39
+ Treat every entry in `{workflow.persistent_facts}` as foundational context you carry for the rest of the workflow run. Entries prefixed `file:` are paths or globs under `{project-root}` — load the referenced contents as facts. All other entries are facts verbatim.
40
+
41
+ ### Step 4: Load Config
42
+
43
+ Load config from `{project-root}/project config` and resolve:
44
+
45
+ - `project_name`, `user_name`
46
+ - `communication_language`, `document_output_language`
47
+ - `user_skill_level`
48
+ - `implementation_artifacts`
49
+ - `planning_artifacts`
50
+ - `project_knowledge`
51
+ - `date` as system-generated current datetime
52
+ - YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the config `{communication_language}`
53
+ - Language MUST be tailored to `{user_skill_level}`
54
+ - Generate all documents in `{document_output_language}`
55
+ - DOCUMENT OUTPUT: Updated epics, stories, or PRD sections. Clear, actionable changes. User skill level (`{user_skill_level}`) affects conversation style ONLY, not document updates.
56
+
57
+ ### Step 5: Greet the User
58
+
59
+ Greet `{user_name}`, speaking in `{communication_language}`.
60
+
61
+ ### Step 6: Execute Append Steps
62
+
63
+ Execute each entry in `{workflow.activation_steps_append}` in order.
64
+
65
+ Activation is complete. Begin the workflow below.
66
+
67
+ ## Paths
68
+
69
+ - `default_output_file` = `{planning_artifacts}/sprint-change-proposal-{date}.md`
70
+
71
+ ## Input Files
72
+
73
+ | Input | Path | Load Strategy |
74
+ |-------|------|---------------|
75
+ | PRD | `{planning_artifacts}/*prd*.md` (whole) or `{planning_artifacts}/*prd*/*.md` (sharded) | FULL_LOAD |
76
+ | Epics | `{planning_artifacts}/*epic*.md` (whole) or `{planning_artifacts}/*epic*/*.md` (sharded) | FULL_LOAD |
77
+ | Architecture | `{planning_artifacts}/*architecture*.md` (whole) or `{planning_artifacts}/*architecture*/*.md` (sharded) | FULL_LOAD |
78
+ | UX Design | `{planning_artifacts}/*ux*.md` (whole) or `{planning_artifacts}/*ux*/*.md` (sharded) | FULL_LOAD |
79
+ | Spec | `{planning_artifacts}/*spec-*.md` (whole) | FULL_LOAD |
80
+ | Document Project | `{project_knowledge}/index.md` (sharded) | INDEX_GUIDED |
81
+
82
+ ## Execution
83
+
84
+ ### Document Discovery - Loading Project Artifacts
85
+
86
+ **Strategy**: Course correction needs broad project context to assess change impact accurately. Load all available planning artifacts.
87
+
88
+ **Discovery Process for FULL_LOAD documents (PRD, Epics, Architecture, UX Design, Spec):**
89
+
90
+ 1. **Search for whole document first** - Look for files matching the whole-document pattern (e.g., `*prd*.md`, `*epic*.md`, `*architecture*.md`, `*ux*.md`, `*spec-*.md`)
91
+ 2. **Check for sharded version** - If whole document not found, look for a directory with `index.md` (e.g., `prd/index.md`, `epics/index.md`)
92
+ 3. **If sharded version found**:
93
+ - Read `index.md` to understand the document structure
94
+ - Read ALL section files listed in the index
95
+ - Process the combined content as a single document
96
+ 4. **Priority**: If both whole and sharded versions exist, use the whole document
97
+
98
+ **Discovery Process for INDEX_GUIDED documents (Document Project):**
99
+
100
+ 1. **Search for index file** - Look for `{project_knowledge}/index.md`
101
+ 2. **If found**: Read the index to understand available documentation sections
102
+ 3. **Selectively load sections** based on relevance to the change being analyzed — do NOT load everything, only sections that relate to the impacted areas
103
+ 4. **This document is optional** — skip if `{project_knowledge}` does not exist (greenfield projects)
104
+
105
+ **Fuzzy matching**: Be flexible with document names — users may use variations like `prd.md`, `bmm-prd.md`, `product-requirements.md`, etc.
106
+
107
+ **Missing documents**: Not all documents may exist. PRD and Epics are essential; Architecture, UX Design, Spec, and Document Project are loaded if available. HALT if PRD or Epics cannot be found.
108
+
109
+ <workflow>
110
+
111
+ <step n="1" goal="Initialize Change Navigation">
112
+ <action>Confirm change trigger and gather user description of the issue</action>
113
+ <action>Ask: "What specific issue or change has been identified that requires navigation?"</action>
114
+ <action>Verify access to project documents:</action>
115
+ - PRD (Product Requirements Document) — required
116
+ - Current Epics and Stories — required
117
+ - Architecture documentation — optional, load if available
118
+ - UI/UX specifications — optional, load if available
119
+ <action>Ask user for mode preference:</action>
120
+ - **Incremental** (recommended): Refine each edit collaboratively
121
+ - **Batch**: Present all changes at once for review
122
+ <action>Store mode selection for use throughout workflow</action>
123
+
124
+ <action if="change trigger is unclear">HALT: "Cannot navigate change without clear understanding of the triggering issue. Please provide specific details about what needs to change and why."</action>
125
+
126
+ <action if="PRD or Epics are unavailable">HALT: "Need access to PRD and Epics to assess change impact. Please ensure these documents are accessible. Architecture and UI/UX will be used if available."</action>
127
+ </step>
128
+
129
+ <step n="2" goal="Execute Change Analysis Checklist">
130
+ <action>Read fully and follow the systematic analysis from: checklist.md</action>
131
+ <action>Work through each checklist section interactively with the user</action>
132
+ <action>Record status for each checklist item:</action>
133
+ - [x] Done - Item completed successfully
134
+ - [N/A] Skip - Item not applicable to this change
135
+ - [!] Action-needed - Item requires attention or follow-up
136
+ <action>Maintain running notes of findings and impacts discovered</action>
137
+ <action>Present checklist progress after each major section</action>
138
+
139
+ <action if="checklist cannot be completed">Identify blocking issues and work with user to resolve before continuing</action>
140
+ </step>
141
+
142
+ <step n="3" goal="Draft Specific Change Proposals">
143
+ <action>Based on checklist findings, create explicit edit proposals for each identified artifact</action>
144
+
145
+ <action>For Story changes:</action>
146
+
147
+ - Show old → new text format
148
+ - Include story ID and section being modified
149
+ - Provide rationale for each change
150
+ - Example format:
151
+
152
+ ```
153
+ Story: [STORY-123] User Authentication
154
+ Section: Acceptance Criteria
155
+
156
+ OLD:
157
+ - User can log in with email/password
158
+
159
+ NEW:
160
+ - User can log in with email/password
161
+ - User can enable 2FA via authenticator app
162
+
163
+ Rationale: Security requirement identified during implementation
164
+ ```
165
+
166
+ <action>For PRD modifications:</action>
167
+
168
+ - Specify exact sections to update
169
+ - Show current content and proposed changes
170
+ - Explain impact on MVP scope and requirements
171
+
172
+ <action>For Architecture changes:</action>
173
+
174
+ - Identify affected components, patterns, or technology choices
175
+ - Describe diagram updates needed
176
+ - Note any ripple effects on other components
177
+
178
+ <action>For UI/UX specification updates:</action>
179
+
180
+ - Reference specific screens or components
181
+ - Show wireframe or flow changes needed
182
+ - Connect changes to user experience impact
183
+
184
+ <check if="mode is Incremental">
185
+ <action>Present each edit proposal individually</action>
186
+ <ask>Review and refine this change? Options: Approve [a], Edit [e], Skip [s]</ask>
187
+ <action>Iterate on each proposal based on user feedback</action>
188
+ </check>
189
+
190
+ <action if="mode is Batch">Collect all edit proposals and present together at end of step</action>
191
+
192
+ </step>
193
+
194
+ <step n="4" goal="Generate Sprint Change Proposal">
195
+ <action>Compile comprehensive Sprint Change Proposal document with following sections:</action>
196
+
197
+ <action>Section 1: Issue Summary</action>
198
+
199
+ - Clear problem statement describing what triggered the change
200
+ - Context about when/how the issue was discovered
201
+ - Evidence or examples demonstrating the issue
202
+
203
+ <action>Section 2: Impact Analysis</action>
204
+
205
+ - Epic Impact: Which epics are affected and how
206
+ - Story Impact: Current and future stories requiring changes
207
+ - Artifact Conflicts: PRD, Architecture, UI/UX documents needing updates
208
+ - Technical Impact: Code, infrastructure, or deployment implications
209
+
210
+ <action>Section 3: Recommended Approach</action>
211
+
212
+ - Present chosen path forward from checklist evaluation:
213
+ - Direct Adjustment: Modify/add stories within existing plan
214
+ - Potential Rollback: Revert completed work to simplify resolution
215
+ - MVP Review: Reduce scope or modify goals
216
+ - Provide clear rationale for recommendation
217
+ - Include effort estimate, risk assessment, and timeline impact
218
+
219
+ <action>Section 4: Detailed Change Proposals</action>
220
+
221
+ - Include all refined edit proposals from Step 3
222
+ - Group by artifact type (Stories, PRD, Architecture, UI/UX)
223
+ - Ensure each change includes before/after and justification
224
+
225
+ <action>Section 5: Implementation Handoff</action>
226
+
227
+ - Categorize change scope:
228
+ - Minor: Direct implementation by Developer agent
229
+ - Moderate: Backlog reorganization needed (PO/DEV)
230
+ - Major: Fundamental replan required (PM/Architect)
231
+ - Specify handoff recipients and their responsibilities
232
+ - Define success criteria for implementation
233
+
234
+ <action>Present complete Sprint Change Proposal to user</action>
235
+ <action>Write Sprint Change Proposal document to {default_output_file}</action>
236
+ <ask>Review complete proposal. Continue [c] or Edit [e]?</ask>
237
+ </step>
238
+
239
+ <step n="5" goal="Finalize and Route for Implementation">
240
+ <action>Get explicit user approval for complete proposal</action>
241
+ <ask>Do you approve this Sprint Change Proposal for implementation? (yes/no/revise)</ask>
242
+
243
+ <check if="no or revise">
244
+ <action>Gather specific feedback on what needs adjustment</action>
245
+ <action>Return to appropriate step to address concerns</action>
246
+ <goto step="3">If changes needed to edit proposals</goto>
247
+ <goto step="4">If changes needed to overall proposal structure</goto>
248
+
249
+ </check>
250
+
251
+ <check if="yes the proposal is approved by the user">
252
+ <action>Finalize Sprint Change Proposal document</action>
253
+ <action>Determine change scope classification:</action>
254
+
255
+ - **Minor**: Can be implemented directly by Developer agent
256
+ - **Moderate**: Requires backlog reorganization and PO/DEV coordination
257
+ - **Major**: Needs fundamental replan with PM/Architect involvement
258
+
259
+ <action>Provide appropriate handoff based on scope:</action>
260
+
261
+ </check>
262
+
263
+ <check if="Minor scope">
264
+ <action>Route to: Developer agent for direct implementation</action>
265
+ <action>Deliverables: Finalized edit proposals and implementation tasks</action>
266
+ </check>
267
+
268
+ <check if="Moderate scope">
269
+ <action>Route to: Product Owner / Developer agents</action>
270
+ <action>Deliverables: Sprint Change Proposal + backlog reorganization plan</action>
271
+ </check>
272
+
273
+ <check if="Major scope">
274
+ <action>Route to: Product Manager / Solution Architect</action>
275
+ <action>Deliverables: Complete Sprint Change Proposal + escalation notice</action>
276
+
277
+ <action>Confirm handoff completion and next steps with user</action>
278
+ <action>Document handoff in workflow execution log</action>
279
+ </check>
280
+
281
+ </step>
282
+
283
+ <step n="6" goal="Workflow Completion">
284
+ <action>Summarize workflow execution:</action>
285
+ - Issue addressed: {{change_trigger}}
286
+ - Change scope: {{scope_classification}}
287
+ - Artifacts modified: {{list_of_artifacts}}
288
+ - Routed to: {{handoff_recipients}}
289
+
290
+ <action>Confirm all deliverables produced:</action>
291
+
292
+ - Sprint Change Proposal document
293
+ - Specific edit proposals with before/after
294
+ - Implementation handoff plan
295
+
296
+ <action>Report workflow completion to user with personalized message: "Correct Course workflow complete, {user_name}!"</action>
297
+ <action>Remind user of success criteria and next steps for Developer agent</action>
298
+ <!-- Adapted for BMAD+: original script dependency removed -->
299
+ </step>
300
+
301
301
  </workflow>