bmad-plus 0.12.1 → 0.13.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 (176) hide show
  1. package/CHANGELOG.md +637 -580
  2. package/README.md +123 -120
  3. package/osint-agent-package/agents/osint-investigator.md +12 -0
  4. package/osint-agent-package/skills/bmad-osint-investigate/osint/SKILL.md +491 -482
  5. package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/dossier-template.md +126 -126
  6. package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/lawful-basis-record.md +48 -48
  7. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/content-extraction.md +100 -100
  8. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/gdpr-osint.md +48 -48
  9. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/platforms.md +130 -130
  10. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/psychoprofile.md +69 -69
  11. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/tools.md +281 -281
  12. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/mcp-client.py +136 -136
  13. package/package.json +106 -91
  14. package/readme-international/README.de.md +625 -594
  15. package/readme-international/README.es.md +642 -611
  16. package/readme-international/README.fr.md +640 -609
  17. package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +2 -0
  18. package/src/bmad-plus/agents/agent-shadow/SKILL.md +18 -0
  19. package/src/bmad-plus/data/role-triggers.yaml +52 -0
  20. package/src/bmad-plus/module.yaml +333 -283
  21. package/src/bmad-plus/packs/pack-animated/animated-website-agent.md +325 -325
  22. package/src/bmad-plus/packs/pack-animated/templates/animated-website-workflow.md +55 -55
  23. package/src/bmad-plus/packs/pack-backup/backup-agent.md +71 -71
  24. package/src/bmad-plus/packs/pack-backup/templates/backup-workflow.md +51 -51
  25. package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -162
  26. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +73 -73
  27. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +61 -61
  28. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +95 -95
  29. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +95 -95
  30. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +134 -134
  31. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +80 -80
  32. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +73 -73
  33. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +95 -95
  34. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +73 -73
  35. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +73 -73
  36. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +92 -92
  37. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +80 -80
  38. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +90 -90
  39. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -153
  40. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -173
  41. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -224
  42. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -329
  43. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -318
  44. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -359
  45. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -379
  46. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -361
  47. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +81 -81
  48. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +67 -67
  49. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -85
  50. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -35
  51. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -49
  52. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +131 -131
  53. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +89 -89
  54. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +300 -300
  55. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +428 -428
  56. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +73 -73
  57. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -80
  58. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +484 -484
  59. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +193 -193
  60. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +175 -175
  61. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +110 -110
  62. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1511 -1511
  63. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +298 -298
  64. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +296 -296
  65. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +29 -29
  66. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +74 -74
  67. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +29 -29
  68. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +73 -73
  69. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +89 -89
  70. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +73 -73
  71. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +29 -29
  72. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +141 -141
  73. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -37
  74. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -75
  75. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -6
  76. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +110 -110
  77. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +176 -176
  78. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -67
  79. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -86
  80. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -179
  81. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -66
  82. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +127 -127
  83. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -105
  84. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -120
  85. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -12
  86. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -328
  87. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -32
  88. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -81
  89. package/src/bmad-plus/packs/pack-seo/SKILL.md +171 -171
  90. package/src/bmad-plus/packs/pack-seo/checklist.md +140 -140
  91. package/src/bmad-plus/packs/pack-seo/pagespeed-playbook.md +320 -320
  92. package/src/bmad-plus/packs/pack-seo/ref/audit-schema.json +187 -187
  93. package/src/bmad-plus/packs/pack-seo/ref/cwv-thresholds.md +87 -87
  94. package/src/bmad-plus/packs/pack-seo/ref/eeat-criteria.md +123 -123
  95. package/src/bmad-plus/packs/pack-seo/ref/geo-signals.md +167 -167
  96. package/src/bmad-plus/packs/pack-seo/ref/hreflang-rules.md +153 -153
  97. package/src/bmad-plus/packs/pack-seo/ref/quality-gates.md +133 -133
  98. package/src/bmad-plus/packs/pack-seo/ref/schema-catalog.md +91 -91
  99. package/src/bmad-plus/packs/pack-seo/ref/schema-templates.json +356 -356
  100. package/src/bmad-plus/packs/pack-seo/requirements.txt +17 -0
  101. package/src/bmad-plus/packs/pack-seo/scripts/seo_apis.py +456 -0
  102. package/src/bmad-plus/packs/pack-seo/scripts/seo_crawl.py +359 -0
  103. package/src/bmad-plus/packs/pack-seo/scripts/seo_fetch.py +303 -0
  104. package/src/bmad-plus/packs/pack-seo/scripts/seo_parse.py +255 -0
  105. package/src/bmad-plus/packs/pack-seo/scripts/seo_report.py +409 -0
  106. package/src/bmad-plus/packs/pack-seo/scripts/seo_screenshot.py +202 -0
  107. package/src/bmad-plus/packs/pack-seo/seo-chief.md +294 -294
  108. package/src/bmad-plus/packs/pack-seo/seo-judge.md +241 -241
  109. package/src/bmad-plus/packs/pack-seo/seo-scout.md +171 -171
  110. package/src/bmad-plus/packs/pack-seo/templates/seo-audit-workflow.md +241 -241
  111. package/src/bmad-plus/packs/pack-shield/README.md +6 -6
  112. package/src/bmad-plus/packs/pack-shield/SKILL.md +2 -2
  113. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/csrd-agent.md +11 -11
  114. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/section508-agent.md +11 -11
  115. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/wcag-agent.md +11 -11
  116. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/eu-ai-act-agent.md +11 -11
  117. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/iso42001-agent.md +11 -11
  118. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/nist-ai-rmf-agent.md +11 -11
  119. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/cis-controls-agent.md +11 -11
  120. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/ism-agent.md +11 -11
  121. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/iso27001-agent.md +11 -11
  122. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nis2-agent.md +11 -11
  123. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-800-53-agent.md +11 -11
  124. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-csf-agent.md +11 -11
  125. package/src/bmad-plus/packs/pack-shield/categories/defense-export/cmmc-agent.md +11 -11
  126. package/src/bmad-plus/packs/pack-shield/categories/defense-export/ear-agent.md +11 -11
  127. package/src/bmad-plus/packs/pack-shield/categories/defense-export/itar-agent.md +11 -11
  128. package/src/bmad-plus/packs/pack-shield/categories/defense-export/tsa-agent.md +11 -11
  129. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/dora-agent.md +11 -11
  130. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/fedramp-agent.md +11 -11
  131. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/hipaa-agent.md +11 -11
  132. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/pci-dss-agent.md +11 -11
  133. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/soc2-agent.md +11 -11
  134. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/swift-csp-agent.md +11 -11
  135. package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +1 -1
  136. package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +1 -1
  137. package/tools/bmad-plus-npx.js +4 -2
  138. package/tools/build/adapters.config.js +60 -51
  139. package/tools/build/check-counts.js +626 -0
  140. package/tools/build/check-install-contract.js +298 -0
  141. package/tools/build/generate-adapters.js +252 -56
  142. package/tools/build/generate.js +187 -10
  143. package/tools/build/generated-adapters/.codex/AGENTS.md +20 -7
  144. package/tools/build/generated-adapters/.cursor/rules/bmad-plus.mdc +20 -7
  145. package/tools/build/generated-adapters/.opencode/AGENTS.md +20 -7
  146. package/tools/build/generated-adapters/AGENTS.md +20 -7
  147. package/tools/build/generated-adapters/CLAUDE.md +20 -7
  148. package/tools/build/generated-adapters/CONVENTIONS.md +20 -7
  149. package/tools/build/generated-adapters/GEMINI.md +20 -7
  150. package/tools/build/module.template.yaml +82 -0
  151. package/tools/cli/bmad-plus-cli.js +16 -1
  152. package/tools/cli/commands/autoconfig.js +470 -470
  153. package/tools/cli/commands/doctor.js +205 -233
  154. package/tools/cli/commands/install.js +543 -501
  155. package/tools/cli/commands/memory-journal-cmd.js +311 -311
  156. package/tools/cli/commands/memory.js +195 -195
  157. package/tools/cli/commands/scan.js +348 -348
  158. package/tools/cli/commands/uninstall.js +209 -101
  159. package/tools/cli/commands/update-check.js +31 -0
  160. package/tools/cli/commands/update-policy.js +39 -0
  161. package/tools/cli/commands/update.js +123 -134
  162. package/tools/cli/i18n.js +905 -845
  163. package/tools/cli/lib/README-memory-journal.md +125 -125
  164. package/tools/cli/lib/ide-config.js +10 -259
  165. package/tools/cli/lib/install-manifest.js +17 -0
  166. package/tools/cli/lib/installed-adapters.js +89 -0
  167. package/tools/cli/lib/npm-runner.js +177 -0
  168. package/tools/cli/lib/pack-copy.js +62 -66
  169. package/tools/cli/lib/packs.js +437 -3
  170. package/tools/cli/lib/python-provision.js +508 -508
  171. package/tools/cli/lib/stack-detect.js +102 -102
  172. package/tools/cli/lib/update-check.js +153 -0
  173. package/tools/cli/lib/update-dispatch.js +182 -0
  174. package/tools/cli/lib/update-policy.js +90 -0
  175. package/tools/cli/lib/update-transaction.js +334 -0
  176. package/tools/cli/lib/validate.js +50 -50
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 🚀 BMAD+ — Augmented Multi-Agent AI Framework
2
2
 
3
- [![Version](https://img.shields.io/badge/version-0.12.1-blue.svg)](CHANGELOG.md)
3
+ [![Version](https://img.shields.io/badge/version-0.13.0-blue.svg)](CHANGELOG.md)
4
4
  [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
5
5
  [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
6
6
 
@@ -15,80 +15,34 @@
15
15
 
16
16
  ## 📋 Table of Contents
17
17
 
18
- - [What is BMAD+?](#-what-is-bmad)
18
+ Repository validation: **709 JavaScript tests** (`npm test`). Uninstall preserves project memory and customized files; use `--yes` for installation or removal without a terminal.
19
+
20
+ - [Why BMAD+?](#-why-bmad-)
19
21
  - [Quick Start](#-quick-start)
20
- - [The 56+ Agents](#the-56-agents)
22
+ - [Architecture](#-architecture)
23
+ - [The 47 Agents](#the-47-agents)
21
24
  - [Pack System](#-pack-system)
22
25
  - [Innovations](#-innovations)
23
- - [CLI Reference](#-cli-commands)
24
26
  - [Supported IDEs](#-supported-ides)
27
+ - [Project Structure](#-project-structure)
25
28
  - [Configuration](#-configuration)
26
29
  - [Version History](#-version-history)
27
30
  - [License](#-license)
28
31
 
29
32
  ---
30
33
 
31
- ## 💡 What is BMAD+?
32
-
33
- BMAD+ is a **multi-agent AI framework** that turns your AI coding assistant into a full team. Install it in any project, talk to specialized agents by name, and let them handle strategy, architecture, code, testing, compliance, OSINT, SEO — everything from idea to production.
34
-
35
- ### At a Glance
36
-
37
- ```
38
- ┌─────────────────────────────────────────────────────────────────────┐
39
- │ 🚀 BMAD+ — What You Get │
40
- ├─────────────────────────────────────────────────────────────────────┤
41
- │ │
42
- │ 56+ Agents Talk to Atlas, Forge, Sentinel, Nexus, │
43
- │ Shadow, Zecher — each handles multiple roles │
44
- │ │
45
- │ 9 Packs Core dev · OSINT · GRC compliance · SDLC │
46
- │ · SEO audit · Memory · Backup · Maker · Animated │
47
- │ │
48
- │ Autopilot Say "autopilot" → Nexus orchestrates │
49
- │ idea → PRD → architecture → code → tests → ship │
50
- │ │
51
- │ Parallel Independent tasks run concurrently │
52
- │ with conflict detection and supervision │
53
- │ │
54
- │ Memory Persistent brain across sessions │
55
- │ with project scanner and Karpathy guardrails │
56
- │ │
57
- │ 5 IDEs Claude Code · Gemini CLI · Antigravity │
58
- │ · Codex CLI · OpenCode — auto-detected │
59
- │ │
60
- │ 10 Languages CLI installer in EN, FR, ES, DE, IT, PT, │
61
- │ NL, RU, ZH, JA │
62
- │ │
63
- │ 333 Tests Full functional + unit test coverage │
64
- │ │
65
- └─────────────────────────────────────────────────────────────────────┘
66
- ```
67
-
68
- ### Not Just Development
69
-
70
- | Domain | What BMAD+ Does | Agent/Pack |
71
- |--------|----------------|------------|
72
- | 📊 **Strategy** | Market research, SWOT, product briefs, PRDs, UX design | Atlas (Core) |
73
- | 🏗️ **Development** | Architecture, TDD, code generation, documentation | Forge (Core) |
74
- | 🔍 **Quality** | Code review, E2E tests, UX audit, accessibility | Sentinel (Core) |
75
- | 🎼 **Management** | Sprint planning, story breakdown, retrospectives | Nexus (Core) |
76
- | 🕵️ **OSINT** | Person investigation, social scraping, psychoprofiling | Shadow (OSINT Pack) |
77
- | 🛡️ **Compliance** | GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act — 25+ frameworks | 38 agents (Shield Pack) |
78
- | 🔎 **SEO** | 6-phase audit, PageSpeed loop, Google APIs, competitor analysis | Scout/Chief/Judge (SEO Pack) |
79
- | 🧠 **Memory** | Cross-session brain, decision recall, session handoffs | Zecher (Memory Pack) |
80
- | 🧬 **Agent Creation** | Design, build, validate and package new agents | Maker (Maker Pack) |
34
+ ## 💡 Why BMAD+?
81
35
 
82
- ### Why BMAD+ over BMAD-METHOD?
36
+ BMAD-METHOD is an excellent framework with 9 specialized agents. But for a solo developer or a small team, 9 agents is too fragmented. BMAD+ solves this problem:
83
37
 
84
38
  | BMAD-METHOD | BMAD+ |
85
39
  |---|---|
86
- | 9 specialized agents | **56+ agents** (12 roles total) |
40
+ | 9 specialized agents | **47 agents** across 9 packs |
87
41
  | Manual activation only | **Intelligent auto-activation** at 3 levels |
88
42
  | No automated pipeline | **Autopilot Mode**: idea → delivery |
89
43
  | Sequential execution | **Supervised parallelism** |
90
44
  | No persistent memory | **Cross-session brain** with project scanner |
91
- | 1-2 IDEs supported | **5 IDEs** with auto-detection |
45
+ | 1-2 IDEs supported | **7 IDEs** with auto-detection |
92
46
  | 1 module | **9 modular packs** (Core, OSINT, Shield, Dev Studio, SEO, Memory...) |
93
47
 
94
48
  ---
@@ -155,7 +109,6 @@ The installer:
155
109
  | Recall past decisions/context | **Zecher** 🧠 | `Zecher, what did we decide about the auth strategy?` |
156
110
  | Session handoff summary | **Zecher** 🧠 | `Zecher, create a handoff for the next session` |
157
111
 
158
-
159
112
  #### 🚀 Typical Workflow (manual mode)
160
113
 
161
114
  ```
@@ -212,6 +165,22 @@ Nexus automatically orchestrates everything with checkpoints for your approval.
212
165
  | `npx bmad-plus uninstall` | Remove BMAD+ from current project |
213
166
  | `npx bmad-plus autoconfig` | Smart project bootstrap — auto-detect, install, and configure |
214
167
 
168
+ #### Framework updates
169
+
170
+ The installed instructions ask the LLM to check once per session. Discovery uses a 24-hour cache; offline results remain unknown. Automatic updates require an explicit policy and unchanged managed files.
171
+
172
+ For installations using 0.12.2 or earlier, load the new CLI once with `npx --yes bmad-plus@0.13.0 update --yes`. This explicit migration saves backups before replacing legacy files.
173
+
174
+ ```bash
175
+ npx bmad-plus update-check --json
176
+ npx bmad-plus update --latest --yes
177
+ npx bmad-plus update-policy --mode auto --range "^0.13.0"
178
+ npx bmad-plus update --latest --auto
179
+ npx bmad-plus update-check --offline --json
180
+ ```
181
+
182
+ Notification is the default. To stop checks, use `update-policy --mode off`. Customized agents and adapters are preserved; conflicts block automatic application. Older installations without file hashes require an explicit manual migration with backups. Each applied update reports a receipt; use `update --restore <receipt-id> --yes` to recover it, then reload the agent instructions.
183
+
215
184
  #### 🔬 Advanced Install Options
216
185
 
217
186
  ```bash
@@ -252,21 +221,21 @@ npx bmad-plus scan D:\DEV --yes --depth 6
252
221
  ```mermaid
253
222
  graph TB
254
223
  subgraph Core["⚙️ Core Pack"]
255
- AT["Atlas 🎯<br/>Strategy & Product"]
256
- FG["Forge 🏗️<br/>Architecture & Code"]
257
- SN["Sentinel 🔍<br/>QA & UX Review"]
258
- NX["Nexus 🎼<br/>Orchestrator"]
224
+ AT["Atlas 🎯"]
225
+ FG["Forge 🏗️"]
226
+ SN["Sentinel 🔍"]
227
+ NX["Nexus 🎼"]
259
228
  end
260
229
 
261
230
  subgraph Packs["📦 Modular Packs"]
262
- SH["Shadow 🕵️<br/>OSINT Intelligence"]
263
- MK["Maker 🧬<br/>Agent Creator"]
264
- ZC["Zecher 🧠<br/>Memory Guardian"]
265
- SD["Shield 🛡️<br/>GRC Compliance (38 agents)"]
266
- DS["Dev Studio 🏗️<br/>Full SDLC (6 agents)"]
267
- SEO["SEO Engine 🔎<br/>3 agents · 6 phases"]
268
- BK["Backup 🗂️<br/>Smart Archive"]
269
- AN["Animated 🎬<br/>Scroll-Driven Sites"]
231
+ SH["Shadow 🕵️ OSINT"]
232
+ MK["Maker 🧬"]
233
+ ZC["Zecher 🧠 Memory"]
234
+ SD["Shield 🛡️ GRC 27 agents"]
235
+ DS["Dev Studio 🏗️ SDLC 6 agents"]
236
+ SEO["SEO Engine 🔎 3 agents"]
237
+ BK["Backup 🗂️"]
238
+ AN["Animated 🎬"]
270
239
  end
271
240
 
272
241
  subgraph Skills["⚡ Core Skills"]
@@ -286,7 +255,7 @@ graph TB
286
255
 
287
256
  ---
288
257
 
289
- ## 🎭 The 56+ Agents
258
+ ## 🎭 The 47 Agents
290
259
 
291
260
  ### Atlas — Strategist 🎯
292
261
 
@@ -383,22 +352,6 @@ graph TB
383
352
 
384
353
  ---
385
354
 
386
- ### Zecher — Memory Guardian 🧠 *(Memory Pack)*
387
-
388
- **Persistent cross-session brain agent.** Maintains project knowledge across conversations.
389
-
390
- | Capability | Description |
391
- |-----------|-------------|
392
- | **Session Handoff** | Auto-creates session summaries with decisions, patterns, and lessons learned |
393
- | **Context Recall** | Retrieves relevant past decisions/patterns at conversation start |
394
- | **Brain Health** | Monitors memory files integrity and detects staleness |
395
- | **Cross-Project** | Links project memory to the global brain (`~/.bmad-plus/brain/`) |
396
- | **Karpathy Guardrails** | Prevents hallucinated memories — every entry needs source evidence |
397
-
398
- **Memory files:** `decisions.md`, `lessons.md`, `patterns.md`, `context.md`, `sessions/`
399
-
400
- ---
401
-
402
355
  ## 📦 Pack System
403
356
 
404
357
  BMAD+ uses a modular pack system. Core is always installed, additional packs are optional.
@@ -411,28 +364,32 @@ npx bmad-plus install
411
364
 
412
365
  🔍 OSINT — Shadow (investigation, scraping, psychoprofiling)
413
366
  🧬 Agent Creator — Maker (design, build, package)
414
- 🛡️ Security AuditShield (vulnerability scan)
367
+ 🛡️ Shield GRC27 compliance agents + 11 workflows (GDPR, ISO 27001, SOC 2, HIPAA...)
368
+ 🏗️ Dev Studio — 6 SDLC agents (full lifecycle: design to deploy)
369
+ 🔎 SEO Engine — Scout, Chief, Judge (6-phase audit, PageSpeed)
370
+ 🧠 Memory — Zecher (persistent brain, session handoffs)
371
+ 🗂️ Backup — Smart archive with versioning
372
+ 🎬 Animated — Scroll-driven animated websites
415
373
  🤖 Install everything
416
374
  None — Core only
417
375
  ```
418
376
 
419
- | Pack | Agents | What it does | Status |
377
+ | Pack | Agents | Description | Status |
420
378
  |------|--------|-------------|--------|
421
- | ⚙️ **Core** | Atlas, Forge, Sentinel, Nexus | Full dev lifecycle: strategy → architecture → code → QA | ✅ Stable |
422
- | 🔍 **OSINT** | Shadow | Person investigation, social scraping, psychoprofiling (55+ Apify actors) | ✅ Stable |
423
- | 🧬 **Maker** | Maker | Design, build, validate, and package new BMAD+ agents | ✅ Stable |
424
- | 🛡️ **Shield** | 38 compliance agents | GRC across 25+ frameworks: GDPR, ISO 27001, SOC 2, HIPAA, PCI DSS, EU AI Act, DORA, NIS2 | ✅ Stable |
425
- | 🏗️ **Dev Studio** | 6 specialized SDLC agents | Full SDLC: brainstorm PRD → architecture → TDD → review (30 workflows, BWML DSL) | ✅ Stable |
426
- | 🔍 **SEO** | Scout, Chief, Judge | 6-phase SEO audit, PageSpeed perfection loop, Google APIs, competitor benchmark | ✅ Stable |
427
- | 🗂️ **Backup** | Backup Agent | Timestamped ZIP with smart exclusions (node_modules, .git, dist...) | ✅ Stable |
428
- | 🎬 **Animated** | Animated Website Agent | Luxury scroll-driven website from video input | ✅ Stable |
429
- | 🧠 **Memory** | Zecher | Cross-session brain, project scanner, Karpathy guardrails | ✅ Stable |
379
+ | ⚙️ **Core** | Atlas, Forge, Sentinel, Nexus | Strategy, dev, QA, orchestration | ✅ Stable |
380
+ | 🔍 **OSINT** | Shadow | OSINT intelligence, 55+ Apify actors, 7 APIs | ✅ Stable |
381
+ | 🧬 **Maker** | Maker | Design, build, validate new BMAD+ agents | ✅ Stable |
382
+ | 🛡️ **Shield** | 27 GRC agents + 11 workflows | GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act | ✅ Stable |
383
+ | 🏗️ **Dev Studio** | 6 SDLC agents | Full lifecycle: design to deploy | ✅ Stable |
384
+ | 🔎 **SEO** | Scout, Chief, Judge | 6-phase audit, PageSpeed loop, Google APIs | ✅ Stable |
385
+ | 🧠 **Memory** | Zecher | Cross-session brain, decision recall, handoffs | ✅ Stable |
386
+ | 🗂️ **Backup** | Backup Agent | Smart archive with versioning | ✅ Stable |
387
+ | 🎬 **Animated** | Creative Agent | Scroll-driven animated websites | ✅ Stable |
430
388
 
431
389
  Each pack defines:
432
- - Its agents, skills, and workflows
433
- - Required/optional API keys
434
- - External packages (if applicable)
435
- - Cohabitation rules with other packs
390
+ - Its agents and skills
391
+ - Its required/optional API keys
392
+ - Its external package (if applicable)
436
393
 
437
394
  ---
438
395
 
@@ -473,7 +430,9 @@ Give a project idea → Nexus orchestrates the complete pipeline:
473
430
  ```
474
431
 
475
432
  **Configurable checkpoints:**
476
- - `require_approval` (🔴) Pause, WhatsApp notification, wait
433
+ Configure `execution_mode` and `checkpoints` in `_bmad/config.yaml` (`discovery`, `architecture`, `story`, `delivery`).
434
+
435
+ - `require_approval` (🔴) — Pause, wait for approval
477
436
  - `notify_only` (🟡) — Notification, continues unless intervened
478
437
  - `auto` (🟢) — Continues automatically
479
438
 
@@ -493,18 +452,69 @@ The Orchestrator detects independent tasks and launches them in parallel:
493
452
 
494
453
  ## 🖥️ Supported IDEs
495
454
 
496
- The installer automatically detects IDEs and generates configs:
455
+ The installer automatically detects IDEs and generates their adapters around a shared `AGENTS.md` instruction spine at the project root:
497
456
 
498
457
  | IDE | Config File | Detection |
499
458
  |-----|---------------|-----------|
500
459
  | Claude Code | `CLAUDE.md` | `.claude/` folder |
501
460
  | Gemini CLI | `GEMINI.md` | `.gemini/` folder |
502
- | Antigravity | `.gemini/` + `.agents/` | Antigravity Extension |
503
- | Codex CLI | `AGENTS.md` | `.codex/` folder |
504
- | OpenCode | `OPENCODE.md` | opencode config |
461
+ | Antigravity | `GEMINI.md` | `.gemini/antigravity/` folder |
462
+ | Cursor | `.cursor/rules/bmad-plus.mdc` | `.cursor/` folder |
463
+ | Codex CLI | `.codex/AGENTS.md` | `.codex/` folder |
464
+ | OpenCode | `.opencode/AGENTS.md` | `.opencode/` folder |
465
+ | Aider | `CONVENTIONS.md` | `.aider.conf.yml` file |
466
+
467
+ For Aider, add `read: CONVENTIONS.md` to `.aider.conf.yml` or run `/read CONVENTIONS.md` to load the generated instructions.
505
468
 
469
+ ---
506
470
 
471
+ ## 📁 Project Structure
507
472
 
473
+ ```
474
+ BMAD+/
475
+ ├── README.md ← This file (English)
476
+ ├── readme-international/ ← Translated READMEs (fr, es, de)
477
+ ├── CHANGELOG.md ← Version history
478
+ ├── CLAUDE.md ← Claude Code Config
479
+ ├── GEMINI.md ← Gemini CLI / Antigravity Config
480
+ ├── AGENTS.md ← Shared instruction spine
481
+ ├── .codex/AGENTS.md ← Codex CLI adapter
482
+ ├── .opencode/AGENTS.md ← OpenCode adapter
483
+ ├── .cursor/rules/bmad-plus.mdc ← Cursor adapter
484
+ ├── CONVENTIONS.md ← Aider adapter
485
+ ├── .gitignore
486
+
487
+ ├── src/
488
+ │ └── bmad-plus/ ⭐ CUSTOM MODULE
489
+ │ ├── module.yaml ← Module + packs config
490
+ │ ├── module-help.csv ← Contextual help
491
+ │ ├── agents/
492
+ │ │ ├── agent-strategist/ ← Atlas (analyst + pm)
493
+ │ │ ├── agent-architect-dev/ ← Forge (architect + dev + tw)
494
+ │ │ ├── agent-quality/ ← Sentinel (qa + ux)
495
+ │ │ ├── agent-orchestrator/ ← Nexus (sm + qf + autopilot + parallel)
496
+ │ │ ├── agent-maker/ ← Maker (meta-agent) [pack: maker]
497
+ │ │ └── agent-shadow/ ← Shadow (osint) [pack: osint]
498
+ │ ├── skills/
499
+ │ │ ├── bmad-plus-autopilot/ ← Automated pipeline
500
+ │ │ └── bmad-plus-parallel/ ← Parallel execution
501
+ │ └── data/
502
+ │ └── role-triggers.yaml ← Auto-activation rules
503
+
504
+ ├── tools/
505
+ │ └── cli/ 🛠️ NPX INSTALLER
506
+ │ └── install.js ← npx bmad-plus install
507
+
508
+ ├── osint-agent-package/ 🔍 OSINT PACKAGE
509
+ │ ├── agents/ ← Shadow Agent (OSINT investigator)
510
+ │ ├── skills/ ← 55+ Apify actors
511
+ │ └── install.ps1 ← Installation script
512
+
513
+ └── upstream/ 📦 UPSTREAM REFERENCE
514
+ └── (clone of BMAD-METHOD) ← Excluded from repo (.gitignore)
515
+ ```
516
+
517
+ ---
508
518
 
509
519
  ## ⚙️ Configuration
510
520
 
@@ -523,8 +533,6 @@ The installer automatically detects IDEs and generates configs:
523
533
 
524
534
  | Key | Pack | Usage |
525
535
  |-----|------|-------|
526
- | `GEMINI_API_KEY` | Monitor | AI Analysis of upstream diffs |
527
- | `EVOLUTION_API_KEY` | Monitor | WhatsApp Notifications |
528
536
  | `APIFY_API_TOKEN` | OSINT | Social media scraping |
529
537
  | `PERPLEXITY_API_KEY` | OSINT | Enriched search |
530
538
 
@@ -534,23 +542,18 @@ The installer automatically detects IDEs and generates configs:
534
542
 
535
543
  | Version | Date | Description |
536
544
  |---------|------|-------------|
537
- | **0.1.0** | 2026-03-17 | 🎉 Foundation — 56+ agents (Atlas, Forge, Sentinel, Nexus, Shadow, Maker), 3 skills, pack system, monitoring, multi-IDE support |
545
+ | **0.1.0** | 2026-03-17 | 🎉 Foundation — 6 agents (Atlas, Forge, Sentinel, Nexus, Shadow, Maker), 3 skills, pack system, multi-IDE support |
538
546
  | **0.2.0** | 2026-03-18 | 🔀 Oveanet Fusion — 3 new utility packs: SEO Audit 360, Universal Backup, Animated Website |
539
547
  | **0.3.0** | 2026-03-19 | 🚀 SEO Engine v2.0 — 3 multi-role agents, 4 Python scripts, 6-phase workflow, PageSpeed loop, GEO analysis |
540
548
  | **0.4.0** | 2026-03-19 | 🏢 SEO Engine v2.1 — SKILL.md orchestrator, Google APIs, HTML reports, competitor benchmark, 50 tests, GSC + GA4 extensions |
541
- | **0.4.1** | 2026-03-19 | 📦 Public packs — SEO/Backup/Animated agents now in npm package |
542
- | **0.4.2** | 2026-03-19 | 🌐 10-language CLI, CI/CD pipeline, `.npmignore`, `/deploy` workflow, security hardening |
549
+ | **0.4.1** | 2026-03-19 | 🌐 10-language CLI, CI/CD pipeline, `.npmignore`, security hardening |
550
+ | **0.4.2** | 2026-03-19 | 📦 Public packs — SEO/Backup/Animated agents now in npm package |
543
551
  | **0.4.3** | 2026-05-17 | 🔧 update + doctor commands, i18n complete, credits fix |
544
552
  | **0.4.4** | 2026-05-17 | 🔧 UTF-8 encoding fix, complete i18n 10 languages, 62 unit tests |
545
- | **0.5.0** | 2026-05-17 | 🛡️ **Pack Shield** — 38 GRC compliance agents, 7 categories, 25+ frameworks (GDPR, ISO 27001, SOC 2, EU AI Act...) |
553
+ | **0.5.0** | 2026-05-17 | 🛡️ **Pack Shield** — 27 GRC compliance agents + 11 workflows, 6 categories, 25+ frameworks (GDPR, ISO 27001, SOC 2, EU AI Act...) |
546
554
  | **0.6.0** | 2026-05-17 | 🏗️ **Pack Dev Studio** — 6 SDLC agents (Miriam, Yosef, Bezalel...) + 30 SDLC workflows, BWML DSL |
547
555
  | **0.8.0** | 2026-06-24 | 🚀 **Augmented** — 3 new packs (animated, backup, seo), security remediation pass, i18n sync |
548
556
  | **0.9.0** | 2026-06-24 | 🔒 **Secure** — audit remediation cycle, npm audit clean, shared pack registry (`lib/packs.js`) |
549
- | **0.9.1** | 2026-07-01 | ✅ **Credibility** — real CI on every push/PR, Jest ESM harness fixed, ESLint flat config, fake badges removed |
550
- | **0.9.2** | 2026-07-01 | 🔐 **Security** — RCE (ci_cd allowlist), SSRF, stored/DOM XSS, XXE, Python CVE bumps (~30 findings) |
551
- | **0.10.0** | 2026-07-02 | 🧭 **Platform spine** — `registry.yaml` SSOT (generated `packs.js` + CI drift gate), Python provisioning, eval + memory foundations |
552
- | **0.11.0** | 2026-07-02 | 🧠 **Karpathy loop** — `bmad mem` recall/write/reinforce, multi-CLI adapter generator, OSINT lawful-basis gate (CG-02) |
553
- | **0.12.0** | 2026-07-02 | 🏛️ **Load-bearing** — root adapters adopted from registry, memory over MCP, provider-neutral eval gateway; 333 tests |
554
557
 
555
558
  See [CHANGELOG.md](CHANGELOG.md) for full details.
556
559
 
@@ -566,13 +569,13 @@ MIT — Based on [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (MI
566
569
  - **BMAD+** Created by [Laurent Rochetta](https://github.com/lrochetta) ([LinkedIn](https://www.linkedin.com/in/laurentrochetta/))
567
570
 
568
571
  **Original Packs** (created by Laurent Rochetta)
569
- - **Dev Studio** — 6 specialized SDLC agents: Miriam (business analyst), Huldah (tech writer), Yosef (product manager), Rachel (UX designer), Bezalel (system architect), Oholiab (senior engineer) — 44 workflows covering the full lifecycle from brainstorming to deployment
572
+ - **Dev Studio** — 6 specialized SDLC agents: Miriam (business analyst), Huldah (tech writer), Yosef (product manager), Rachel (UX designer), Bezalel (system architect), Oholiab (senior engineer) — 38 workflows covering the full lifecycle from brainstorming to deployment
570
573
  - **SEO Engine** — 3 agents (Scout, Chief, Judge), 6-phase audit pipeline, PageSpeed perfection loop, Google Search Console & GA4 integrations
571
574
  - **Memory Pack** — Zecher agent for persistent cross-session brain with project scanner
572
575
 
573
576
  **External Sources & Inspirations**
574
577
  - **BMAD-METHOD** by [bmad-code-org](https://github.com/bmad-code-org/BMAD-METHOD) — Original multi-agent methodology (MIT)
575
- - **Shield GRC** — 38 compliance agents built on public regulatory texts (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIST, CMMC, etc.)
578
+ - **Shield GRC** — 27 compliance agents + 11 workflows built on public regulatory texts (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIST, CMMC, etc.)
576
579
  - **OSINT Pipeline** based on [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT)
577
580
  - **Apify Actor Runner** integrated from [apify/agent-skills](https://github.com/apify/agent-skills) (MIT)
578
581
  - **Karpathy Guardrails** adapted from [Andrej Karpathy](https://github.com/multica-ai/andrej-karpathy-skills) (MIT) — Behavioral rules for Memory Pack
@@ -62,6 +62,18 @@ You must fully embody this agent's persona and follow all activation instruction
62
62
  </principles>
63
63
  </persona>
64
64
 
65
+ <lawful-basis-gate>
66
+ MANDATORY — [INV], [LI], [IG], [FB], [PP], [CE] process personal data on a named
67
+ natural person ([PP] infers special-category data, GDPR Art. 9). Before executing
68
+ ANY of them, run the Phase −1 Lawful Basis Gate defined in the
69
+ bmad-osint-investigate skill: establish and record the lawful basis (Art. 6, plus
70
+ an Art. 9 condition for [PP]), the specific purpose, and retention/rights using
71
+ assets/lawful-basis-record.md. If the operator cannot state a lawful basis and
72
+ purpose → DECLINE and offer the non-personal alternatives (company/product/market
73
+ research). No menu item is removed — the gate governs, it does not restrict lawful
74
+ authorized use. [MH], [CH], [DG], [PM], [DA] are exempt.
75
+ </lawful-basis-gate>
76
+
65
77
  <menu>
66
78
  <item cmd="MH or fuzzy match on menu or help">[MH] Redisplay Menu Help</item>
67
79
  <item cmd="CH or fuzzy match on chat">[CH] Chat with the Agent about anything</item>