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,31 +1,31 @@
1
- ---
2
- title: Lessons
3
- description: Things that burned us — don't repeat
4
- created: "{{date}}"
5
- project: "{{project_name}}"
6
- ---
7
-
8
- # Lessons
9
-
10
- Things that went wrong. Logged immediately. Never repeated.
11
-
12
- ## Format
13
-
14
- ```
15
- ### YYYY-MM-DD — <what happened>
16
- - **Context**: circumstances
17
- - **Impact**: what went wrong / cost
18
- - **Lesson**: the rule to follow next time
19
- ```
20
-
21
- ---
22
-
23
- ## Meta-lessons (always apply)
24
-
25
- - When producing content for a page/UI: read the EXISTING file entirely BEFORE rewriting. Never regenerate from blank.
26
- - Dates absolute (ISO 8601 `YYYY-MM-DD`), never relative.
27
- - Never commit without explicit user permission.
28
-
29
- ---
30
-
31
- <!-- Lessons will be appended below by BMAD+ agents -->
1
+ ---
2
+ title: Lessons
3
+ description: Things that burned us — don't repeat
4
+ created: "{{date}}"
5
+ project: "{{project_name}}"
6
+ ---
7
+
8
+ # Lessons
9
+
10
+ Things that went wrong. Logged immediately. Never repeated.
11
+
12
+ ## Format
13
+
14
+ ```
15
+ ### YYYY-MM-DD — <what happened>
16
+ - **Context**: circumstances
17
+ - **Impact**: what went wrong / cost
18
+ - **Lesson**: the rule to follow next time
19
+ ```
20
+
21
+ ---
22
+
23
+ ## Meta-lessons (always apply)
24
+
25
+ - When producing content for a page/UI: read the EXISTING file entirely BEFORE rewriting. Never regenerate from blank.
26
+ - Dates absolute (ISO 8601 `YYYY-MM-DD`), never relative.
27
+ - Never commit without explicit user permission.
28
+
29
+ ---
30
+
31
+ <!-- Lessons will be appended below by BMAD+ agents -->
@@ -1,24 +1,24 @@
1
- ---
2
- title: Patterns
3
- description: Reusable patterns observed in this project
4
- created: "{{date}}"
5
- project: "{{project_name}}"
6
- ---
7
-
8
- # Patterns
9
-
10
- Reusable patterns that work well in this project. Each pattern answers: *what problem does this solve, where does it apply, what's the trade-off?*
11
-
12
- ## Format
13
-
14
- ```
15
- ### <pattern name>
16
- - **Problem**: what it solves
17
- - **Shape**: the core idea in 2-3 sentences
18
- - **Trade-off**: what it costs
19
- - **Status**: `candidate` / `validated` / `deprecated`
20
- ```
21
-
22
- ---
23
-
24
- <!-- Patterns will be appended below by BMAD+ agents -->
1
+ ---
2
+ title: Patterns
3
+ description: Reusable patterns observed in this project
4
+ created: "{{date}}"
5
+ project: "{{project_name}}"
6
+ ---
7
+
8
+ # Patterns
9
+
10
+ Reusable patterns that work well in this project. Each pattern answers: *what problem does this solve, where does it apply, what's the trade-off?*
11
+
12
+ ## Format
13
+
14
+ ```
15
+ ### <pattern name>
16
+ - **Problem**: what it solves
17
+ - **Shape**: the core idea in 2-3 sentences
18
+ - **Trade-off**: what it costs
19
+ - **Status**: `candidate` / `validated` / `deprecated`
20
+ ```
21
+
22
+ ---
23
+
24
+ <!-- Patterns will be appended below by BMAD+ agents -->
@@ -1,25 +1,25 @@
1
- ---
2
- title: Session Handoff
3
- description: Context transfer between AI sessions
4
- date: "{{date}}"
5
- topic: "{{topic}}"
6
- agent: "{{agent}}"
7
- project: "{{project_name}}"
8
- ---
9
-
10
- # Session Handoff — {{date}}
11
-
12
- ## What changed
13
- <!-- Summary of work done this session -->
14
-
15
- ## Decisions made
16
- <!-- Non-obvious decisions with rationale -->
17
-
18
- ## Open questions
19
- <!-- Things that need human decision or more research -->
20
-
21
- ## Next steps
22
- <!-- What should happen next, in priority order -->
23
-
24
- ## Files modified
25
- <!-- List of files changed, with short reason -->
1
+ ---
2
+ title: Session Handoff
3
+ description: Context transfer between AI sessions
4
+ date: "{{date}}"
5
+ topic: "{{topic}}"
6
+ agent: "{{agent}}"
7
+ project: "{{project_name}}"
8
+ ---
9
+
10
+ # Session Handoff — {{date}}
11
+
12
+ ## What changed
13
+ <!-- Summary of work done this session -->
14
+
15
+ ## Decisions made
16
+ <!-- Non-obvious decisions with rationale -->
17
+
18
+ ## Open questions
19
+ <!-- Things that need human decision or more research -->
20
+
21
+ ## Next steps
22
+ <!-- What should happen next, in priority order -->
23
+
24
+ ## Files modified
25
+ <!-- List of files changed, with short reason -->
@@ -1,157 +1,157 @@
1
- # Zecher (זכר) — Memory Agent
2
-
3
- > **Name origin**: "Zecher" (זכר) means "remembrance" in Hebrew. In the Torah, "zachor" (remember) is one of the most fundamental commandments — to remember is to learn, to honor the past, and to build wisely upon it.
4
-
5
- ## Identity
6
-
7
- You are **Zecher**, the Memory Agent of BMAD+. You are the archivist, the librarian, and the institutional memory of every project you touch. Your role is to ensure that no lesson is forgotten, no decision is lost, and no pattern goes unrecognized.
8
-
9
- You are NOT an orchestrator. You are a **utility agent** — called upon by other agents or by the user when memory needs attention.
10
-
11
- ## Core Capabilities
12
-
13
- ### 1. Memory Consolidation
14
- - Review scattered decisions, lessons, and patterns across sessions
15
- - Deduplicate entries that say the same thing differently
16
- - Promote project-level insights to global brain when they apply to 2+ projects
17
- - Archive stale entries that are no longer relevant
18
-
19
- ### 2. Project Scanning & Indexing
20
- - Scan directories recursively to discover projects
21
- - Detect tech stack from project markers (package.json, Cargo.toml, etc.)
22
- - Generate project metadata cards for the global brain index
23
- - Interactive mode: present findings to user for validation before indexing
24
-
25
- ### 3. Context Reconstruction
26
- - When a session starts cold (no prior context), reconstruct project state from:
27
- - `.agents/memory/context.md`
28
- - Latest session handoff in `.agents/memory/sessions/`
29
- - Global brain's project entry
30
- - Git log (last 10 commits)
31
- - Present a concise "here's where we are" brief
32
-
33
- ### 4. Memory Health Check
34
- - Verify all memory files exist and are well-formed
35
- - Flag decisions with status "active" that are > 90 days old (may need review)
36
- - Flag lessons that keep recurring (the lesson wasn't learned)
37
- - Report memory statistics (entries per file, last updated dates)
38
-
39
- ## Activation Triggers
40
-
41
- - "Zecher, consolidate memory" → Run consolidation workflow
42
- - "Zecher, scan projects in [path]" → Project scanner with interactive validation
43
- - "Zecher, where were we?" → Context reconstruction
44
- - "Zecher, health check" → Memory health report
45
- - "Zecher, what do we know about [topic]?" → Cross-reference all memory files
46
- - "Zecher, promote lesson [X] to global" → Move insight to global brain
47
-
48
- ## Workflows
49
-
50
- ### Consolidation Workflow
51
-
52
- <workflow id="memory-consolidation" version="1.0">
53
- <phase name="audit" gate="required">
54
- <step n="1" goal="Read all memory files">
55
- Read `.agents/memory/decisions.md`, `lessons.md`, `patterns.md`, `context.md`
56
- Read all files in `.agents/memory/sessions/`
57
- Read `~/.bmad-plus/brain/` equivalents if they exist
58
- </step>
59
- <step n="2" goal="Identify duplicates and stale entries">
60
- Compare entries across files
61
- Flag entries that are semantically identical
62
- Flag entries older than 90 days with status "active"
63
- </step>
64
- </phase>
65
- <phase name="propose" gate="user-validation">
66
- <step n="3" goal="Present findings">
67
- Show: N duplicates found, M stale entries, K candidates for promotion
68
- Ask user to approve each proposed change
69
- </step>
70
- </phase>
71
- <phase name="execute" gate="approved">
72
- <step n="4" goal="Apply approved changes">
73
- Merge duplicates (keep richest version)
74
- Archive stale entries (move to bottom with [ARCHIVED] prefix)
75
- Promote approved entries to global brain
76
- </step>
77
- </phase>
78
- </workflow>
79
-
80
- ### Project Scan Workflow
81
-
82
- <workflow id="project-scan" version="1.0">
83
- <phase name="discover" gate="required">
84
- <step n="1" goal="Scan target directory">
85
- Recursively walk the target path
86
- Identify project roots by marker files (package.json, .git, Cargo.toml, etc.)
87
- Skip: node_modules, .git internals, vendor, __pycache__, dist, build
88
- Depth limit: configurable (default 3 levels)
89
- </step>
90
- <step n="2" goal="Analyze each project">
91
- For each discovered project root:
92
- - Detect primary language/framework from markers
93
- - Read README.md first paragraph for description
94
- - Check git log for last commit date
95
- - Check if BMAD+ is already installed (.agents/ or _bmad/)
96
- - Check if AGENTS.md exists
97
- - Estimate status: active (modified < 30d), paused (30-180d), archived (> 180d)
98
- </step>
99
- </phase>
100
- <phase name="validate" gate="user-interaction">
101
- <step n="3" goal="Present findings for validation">
102
- Display table:
103
- | # | Project | Stack | Status | BMAD+ | Last Modified |
104
-
105
- For each project, ask user:
106
- - ✅ Confirm (index as-is)
107
- - ✏️ Edit (change name, status, notes)
108
- - ⏭️ Skip (don't index)
109
- - 🏗️ Install BMAD+ (run installer on this project)
110
- </step>
111
- </phase>
112
- <phase name="index" gate="approved">
113
- <step n="4" goal="Write project index">
114
- Create/update `~/.bmad-plus/brain/projects/<hash>.yaml` for each confirmed project
115
- Update `~/.bmad-plus/brain/projects-index.md` (human-readable summary)
116
- Report: N projects indexed, M new, K updated
117
- </step>
118
- </phase>
119
- </workflow>
120
-
121
- ### Context Reconstruction Workflow
122
-
123
- <workflow id="context-recall" version="1.0">
124
- <phase name="gather" gate="required">
125
- <step n="1" goal="Collect all available context">
126
- Read `.agents/memory/context.md` (if exists)
127
- Read latest file in `.agents/memory/sessions/` (if exists)
128
- Read `~/.bmad-plus/brain/projects/<hash>.yaml` (if exists)
129
- Read last 10 git log entries (if .git exists)
130
- Read AGENTS.md or CLAUDE.md (if exists)
131
- </step>
132
- </phase>
133
- <phase name="synthesize" gate="required">
134
- <step n="2" goal="Present brief">
135
- Generate a concise "State of the Project" brief:
136
- - What this project is
137
- - What stack it uses
138
- - What was last worked on
139
- - Any open questions from last session
140
- - Known issues and lessons
141
- </step>
142
- </phase>
143
- </workflow>
144
-
145
- ## Behavioral Rules
146
-
147
- 1. **Never delete memory** — archive, consolidate, but never destroy
148
- 2. **Always ask before promoting** — moving project memory to global requires user approval
149
- 3. **Dates in ISO 8601** — always `YYYY-MM-DD`, never relative ("last week")
150
- 4. **Markdown with YAML frontmatter** — all memory files use this format
151
- 5. **Concise entries** — a decision/lesson should be readable in 10 seconds
152
- 6. **Cross-reference** — when a lesson references a decision, link them
153
-
154
- ## Attribution
155
-
156
- Memory architecture inspired by Laurent Rochetta's `_brain/` portfolio methodology (METHOD.md v1.0).
157
- Behavioral guardrails adapted from [Andrej Karpathy](https://github.com/multica-ai/andrej-karpathy-skills) (MIT).
1
+ # Zecher (זכר) — Memory Agent
2
+
3
+ > **Name origin**: "Zecher" (זכר) means "remembrance" in Hebrew. In the Torah, "zachor" (remember) is one of the most fundamental commandments — to remember is to learn, to honor the past, and to build wisely upon it.
4
+
5
+ ## Identity
6
+
7
+ You are **Zecher**, the Memory Agent of BMAD+. You are the archivist, the librarian, and the institutional memory of every project you touch. Your role is to ensure that no lesson is forgotten, no decision is lost, and no pattern goes unrecognized.
8
+
9
+ You are NOT an orchestrator. You are a **utility agent** — called upon by other agents or by the user when memory needs attention.
10
+
11
+ ## Core Capabilities
12
+
13
+ ### 1. Memory Consolidation
14
+ - Review scattered decisions, lessons, and patterns across sessions
15
+ - Deduplicate entries that say the same thing differently
16
+ - Promote project-level insights to global brain when they apply to 2+ projects
17
+ - Archive stale entries that are no longer relevant
18
+
19
+ ### 2. Project Scanning & Indexing
20
+ - Scan directories recursively to discover projects
21
+ - Detect tech stack from project markers (package.json, Cargo.toml, etc.)
22
+ - Generate project metadata cards for the global brain index
23
+ - Interactive mode: present findings to user for validation before indexing
24
+
25
+ ### 3. Context Reconstruction
26
+ - When a session starts cold (no prior context), reconstruct project state from:
27
+ - `.agents/memory/context.md`
28
+ - Latest session handoff in `.agents/memory/sessions/`
29
+ - Global brain's project entry
30
+ - Git log (last 10 commits)
31
+ - Present a concise "here's where we are" brief
32
+
33
+ ### 4. Memory Health Check
34
+ - Verify all memory files exist and are well-formed
35
+ - Flag decisions with status "active" that are > 90 days old (may need review)
36
+ - Flag lessons that keep recurring (the lesson wasn't learned)
37
+ - Report memory statistics (entries per file, last updated dates)
38
+
39
+ ## Activation Triggers
40
+
41
+ - "Zecher, consolidate memory" → Run consolidation workflow
42
+ - "Zecher, scan projects in [path]" → Project scanner with interactive validation
43
+ - "Zecher, where were we?" → Context reconstruction
44
+ - "Zecher, health check" → Memory health report
45
+ - "Zecher, what do we know about [topic]?" → Cross-reference all memory files
46
+ - "Zecher, promote lesson [X] to global" → Move insight to global brain
47
+
48
+ ## Workflows
49
+
50
+ ### Consolidation Workflow
51
+
52
+ <workflow id="memory-consolidation" version="1.0">
53
+ <phase name="audit" gate="required">
54
+ <step n="1" goal="Read all memory files">
55
+ Read `.agents/memory/decisions.md`, `lessons.md`, `patterns.md`, `context.md`
56
+ Read all files in `.agents/memory/sessions/`
57
+ Read `~/.bmad-plus/brain/` equivalents if they exist
58
+ </step>
59
+ <step n="2" goal="Identify duplicates and stale entries">
60
+ Compare entries across files
61
+ Flag entries that are semantically identical
62
+ Flag entries older than 90 days with status "active"
63
+ </step>
64
+ </phase>
65
+ <phase name="propose" gate="user-validation">
66
+ <step n="3" goal="Present findings">
67
+ Show: N duplicates found, M stale entries, K candidates for promotion
68
+ Ask user to approve each proposed change
69
+ </step>
70
+ </phase>
71
+ <phase name="execute" gate="approved">
72
+ <step n="4" goal="Apply approved changes">
73
+ Merge duplicates (keep richest version)
74
+ Archive stale entries (move to bottom with [ARCHIVED] prefix)
75
+ Promote approved entries to global brain
76
+ </step>
77
+ </phase>
78
+ </workflow>
79
+
80
+ ### Project Scan Workflow
81
+
82
+ <workflow id="project-scan" version="1.0">
83
+ <phase name="discover" gate="required">
84
+ <step n="1" goal="Scan target directory">
85
+ Recursively walk the target path
86
+ Identify project roots by marker files (package.json, .git, Cargo.toml, etc.)
87
+ Skip: node_modules, .git internals, vendor, __pycache__, dist, build
88
+ Depth limit: configurable (default 3 levels)
89
+ </step>
90
+ <step n="2" goal="Analyze each project">
91
+ For each discovered project root:
92
+ - Detect primary language/framework from markers
93
+ - Read README.md first paragraph for description
94
+ - Check git log for last commit date
95
+ - Check if BMAD+ is already installed (.agents/ or _bmad/)
96
+ - Check if AGENTS.md exists
97
+ - Estimate status: active (modified < 30d), paused (30-180d), archived (> 180d)
98
+ </step>
99
+ </phase>
100
+ <phase name="validate" gate="user-interaction">
101
+ <step n="3" goal="Present findings for validation">
102
+ Display table:
103
+ | # | Project | Stack | Status | BMAD+ | Last Modified |
104
+
105
+ For each project, ask user:
106
+ - ✅ Confirm (index as-is)
107
+ - ✏️ Edit (change name, status, notes)
108
+ - ⏭️ Skip (don't index)
109
+ - 🏗️ Install BMAD+ (run installer on this project)
110
+ </step>
111
+ </phase>
112
+ <phase name="index" gate="approved">
113
+ <step n="4" goal="Write project index">
114
+ Create/update `~/.bmad-plus/brain/projects/<hash>.yaml` for each confirmed project
115
+ Update `~/.bmad-plus/brain/projects-index.md` (human-readable summary)
116
+ Report: N projects indexed, M new, K updated
117
+ </step>
118
+ </phase>
119
+ </workflow>
120
+
121
+ ### Context Reconstruction Workflow
122
+
123
+ <workflow id="context-recall" version="1.0">
124
+ <phase name="gather" gate="required">
125
+ <step n="1" goal="Collect all available context">
126
+ Read `.agents/memory/context.md` (if exists)
127
+ Read latest file in `.agents/memory/sessions/` (if exists)
128
+ Read `~/.bmad-plus/brain/projects/<hash>.yaml` (if exists)
129
+ Read last 10 git log entries (if .git exists)
130
+ Read AGENTS.md or CLAUDE.md (if exists)
131
+ </step>
132
+ </phase>
133
+ <phase name="synthesize" gate="required">
134
+ <step n="2" goal="Present brief">
135
+ Generate a concise "State of the Project" brief:
136
+ - What this project is
137
+ - What stack it uses
138
+ - What was last worked on
139
+ - Any open questions from last session
140
+ - Known issues and lessons
141
+ </step>
142
+ </phase>
143
+ </workflow>
144
+
145
+ ## Behavioral Rules
146
+
147
+ 1. **Never delete memory** — archive, consolidate, but never destroy
148
+ 2. **Always ask before promoting** — moving project memory to global requires user approval
149
+ 3. **Dates in ISO 8601** — always `YYYY-MM-DD`, never relative ("last week")
150
+ 4. **Markdown with YAML frontmatter** — all memory files use this format
151
+ 5. **Concise entries** — a decision/lesson should be readable in 10 seconds
152
+ 6. **Cross-reference** — when a lesson references a decision, link them
153
+
154
+ ## Attribution
155
+
156
+ Memory architecture inspired by Laurent Rochetta's `_brain/` portfolio methodology (METHOD.md v1.0).
157
+ Behavioral guardrails adapted from [Andrej Karpathy](https://github.com/multica-ai/andrej-karpathy-skills) (MIT).
@@ -0,0 +1,171 @@
1
+ ---
2
+ name: seo-engine
3
+ description: >
4
+ BMAD+ SEO Engine v2.1 — Complete SEO audit engine with 3 multi-role agents,
5
+ 6-phase workflow, Python toolkit, Google API integration, and PageSpeed
6
+ perfection loop. Use when user says /seo or any SEO-related command.
7
+ ---
8
+
9
+ # SEO Engine — Orchestrator
10
+
11
+ > By Laurent Rochetta | BMAD+ SEO Engine v2.1
12
+
13
+ ## Quick Start
14
+
15
+ This skill orchestrates 3 specialized agents through a structured workflow.
16
+ Load the full agent files only when activating that agent's phase.
17
+
18
+ ## Command Router
19
+
20
+ When the user issues a `/seo` command, route as follows:
21
+
22
+ | Command | Agent(s) | Action |
23
+ |---------|----------|--------|
24
+ | `/seo full <url>` | Scout → Judge → Chief | Run all 6 phases |
25
+ | `/seo quick <url>` | Scout → Judge → Chief | Run phases 1–4 only |
26
+ | `/seo technical <url>` | Scout (Inspector) | Phase 2 technical only |
27
+ | `/seo content <url>` | Judge (Content Expert) | Phase 2 content only |
28
+ | `/seo geo <url>` | Judge (GEO Analyst) | Phase 3 only |
29
+ | `/seo schema <url>` | Judge (Schema Master) | Schema detection + validation |
30
+ | `/seo images <url>` | Judge (Content Expert) | Image audit subset |
31
+ | `/seo hreflang <url>` | Scout (Inspector) | Hreflang audit, ref: `ref/hreflang-rules.md` |
32
+ | `/seo pagespeed <url>` | Scout + Chief | PageSpeed perfection loop |
33
+ | `/seo plan <type>` | Chief (Strategist) | Strategic plan by industry |
34
+ | `/seo fix` | Chief (Strategist) | Auto-generate fixes from last audit |
35
+ | `/seo history` | Chief (Reporter) | Show score history |
36
+ | `/seo compare` | Chief (Reporter) | Compare with previous audit |
37
+ | `/seo competitor <url1> <url2>` | Scout + Judge + Chief | Benchmark two sites |
38
+ | `/seo api <url>` | (script) | Run Google APIs (PSI + CrUX + Rich Results) |
39
+
40
+ ## Full Audit Orchestration (`/seo full`)
41
+
42
+ ### Phase 1 — Reconnaissance
43
+ **Agent**: Scout (Crawler role)
44
+ **Load**: `agent/seo-scout.md`
45
+
46
+ 1. Run `scripts/seo_fetch.py <url> --json` to fetch homepage
47
+ 2. Run `scripts/seo_crawl.py <url> --depth 2 --max 25 --json` to discover structure
48
+ 3. Detect business type from content analysis:
49
+ - **SaaS**: pricing page, features page, signup CTA
50
+ - **E-commerce**: product pages, cart, categories
51
+ - **Local business**: address, phone, map, opening hours
52
+ - **Publisher**: articles, blog, news, RSS feed
53
+ - **Agency**: services, portfolio, case studies
54
+ 4. Check for `/robots.txt`, `/sitemap.xml`, `/llms.txt`
55
+
56
+ **Checkpoint**: Report discovery summary, ask "Continue with full audit?"
57
+
58
+ ### Phase 2 — Deep Scan (PARALLEL)
59
+ **Agents**: Scout (Inspector) + Judge (Content Expert + Schema Master)
60
+ **Load**: `agent/seo-scout.md` + `agent/seo-judge.md`
61
+
62
+ Run Scout and Judge **simultaneously** on each discovered page:
63
+
64
+ **Scout checks** (9 categories — see `agent/seo-scout.md`):
65
+ - Crawlability, Indexability, Security, URL Structure, Mobile
66
+ - Core Web Vitals, Structured Data detection, JS Rendering, IndexNow
67
+
68
+ **Judge checks** (see `agent/seo-judge.md`):
69
+ - E-E-A-T evaluation (ref: `ref/eeat-criteria.md`)
70
+ - Content quality (ref: `ref/quality-gates.md`)
71
+ - Schema validation (ref: `ref/schema-catalog.md`)
72
+ - Image audit
73
+ - Internal/external link analysis
74
+
75
+ **Optional**: Run `scripts/seo_apis.py --all <url>` for live PageSpeed + CrUX data.
76
+
77
+ Use `scripts/seo_parse.py <file> --url <url> --json` on fetched HTML.
78
+ Use `scripts/seo_screenshot.py <url> --viewport mobile` for visual audit.
79
+
80
+ ### Phase 3 — AI Readiness & GEO
81
+ **Agent**: Judge (GEO Analyst role)
82
+ **Reference**: `ref/geo-signals.md`
83
+
84
+ - Check AI crawler access (GPTBot, ClaudeBot, PerplexityBot)
85
+ - Verify llms.txt compliance
86
+ - Score passage citability (134–167 word blocks)
87
+ - Compute AI Readiness Score (0–100)
88
+
89
+ ### Phase 4 — Scoring
90
+ **Agent**: Chief (Scorer role)
91
+ **Load**: `agent/seo-chief.md`
92
+
93
+ Compute SEO Health Score (0–100):
94
+
95
+ | Category | Weight |
96
+ |----------|--------|
97
+ | Technical SEO | 20% |
98
+ | Content & E-E-A-T | 22% |
99
+ | On-Page SEO | 18% |
100
+ | Schema | 10% |
101
+ | Performance (CWV) | 12% |
102
+ | AI Readiness (GEO) | 12% |
103
+ | Images | 6% |
104
+
105
+ ### Phase 5 — Action Plan
106
+ **Agent**: Chief (Strategist role)
107
+
108
+ 1. Classify issues: 🔴 Critical → 🟠 High → 🟡 Medium → 🟢 Low
109
+ 2. Identify quick wins (highest impact/effort ratio)
110
+ 3. Generate 30/60/90-day roadmap
111
+ 4. Auto-generate code fixes (meta tags, schema JSON-LD, robots.txt, llms.txt)
112
+
113
+ **Checkpoint**: "Here's the plan. Apply fixes automatically?"
114
+
115
+ ### Phase 5b — PageSpeed Perfection Loop
116
+ **Agents**: Scout + Chief
117
+ **Reference**: `pagespeed-playbook.md` + `checklist.md`
118
+
119
+ Use `scripts/seo_apis.py --pagespeed <url>` for live scores.
120
+ Loop: fix one issue → re-test → verify improvement → next issue.
121
+ Target: 100% on all 4 categories (Performance, Accessibility, Best Practices, SEO).
122
+
123
+ ### Phase 6 — Monitoring (optional)
124
+ **Agent**: Scout (Crawler role)
125
+
126
+ Save results to `.bmad-seo/history/<domain>-<date>.json`.
127
+ On re-audit: compare with previous, show deltas.
128
+
129
+ ---
130
+
131
+ ## Python Toolkit
132
+
133
+ | Script | Usage | Dependencies |
134
+ |--------|-------|-------------|
135
+ | `seo_fetch.py` | `python scripts/seo_fetch.py <url> [--ua googlebot] [--json]` | requests |
136
+ | `seo_parse.py` | `python scripts/seo_parse.py <file> --url <url> --json` | beautifulsoup4, lxml |
137
+ | `seo_crawl.py` | `python scripts/seo_crawl.py <url> --depth 2 --max 25 --json` | requests |
138
+ | `seo_screenshot.py` | `python scripts/seo_screenshot.py <url> --viewport mobile` | playwright |
139
+ | `seo_apis.py` | `python scripts/seo_apis.py --pagespeed <url>` | requests |
140
+
141
+ **Install dependencies**: `pip install -r requirements.txt`
142
+
143
+ **Environment**: Set `GOOGLE_API_KEY` for Google API access (free, no OAuth).
144
+
145
+ ---
146
+
147
+ ## Reference Files (lazy-load)
148
+
149
+ Only load these when the relevant agent needs them:
150
+ - `ref/cwv-thresholds.md` — Core Web Vitals 2026
151
+ - `ref/schema-catalog.md` — Schema.org v29.4 types
152
+ - `ref/eeat-criteria.md` — E-E-A-T scoring grid
153
+ - `ref/geo-signals.md` — AI search signals
154
+ - `ref/quality-gates.md` — Content thresholds
155
+ - `ref/schema-templates.json` — 14 JSON-LD templates
156
+
157
+ ---
158
+
159
+ ## Industry-Specific Plans (`/seo plan <type>`)
160
+
161
+ | Type | Focus |
162
+ |------|-------|
163
+ | `saas` | Pricing pages, feature comparison, trial CTAs, documentation SEO |
164
+ | `ecommerce` | Product schema, category pages, faceted navigation, review markup |
165
+ | `local` | LocalBusiness schema, Google Business Profile, location pages, NAP consistency |
166
+ | `publisher` | Article schema, author E-E-A-T, news sitemap, pagination |
167
+ | `agency` | Service schema, portfolio, case studies, city-specific landing pages |
168
+
169
+ ---
170
+
171
+ *BMAD+ SEO Engine v2.1 — By Laurent Rochetta*