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.
- package/CHANGELOG.md +637 -580
- package/README.md +123 -120
- package/osint-agent-package/agents/osint-investigator.md +12 -0
- package/osint-agent-package/skills/bmad-osint-investigate/osint/SKILL.md +491 -482
- package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/dossier-template.md +126 -126
- package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/lawful-basis-record.md +48 -48
- package/osint-agent-package/skills/bmad-osint-investigate/osint/references/content-extraction.md +100 -100
- package/osint-agent-package/skills/bmad-osint-investigate/osint/references/gdpr-osint.md +48 -48
- package/osint-agent-package/skills/bmad-osint-investigate/osint/references/platforms.md +130 -130
- package/osint-agent-package/skills/bmad-osint-investigate/osint/references/psychoprofile.md +69 -69
- package/osint-agent-package/skills/bmad-osint-investigate/osint/references/tools.md +281 -281
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/mcp-client.py +136 -136
- package/package.json +106 -91
- package/readme-international/README.de.md +625 -594
- package/readme-international/README.es.md +642 -611
- package/readme-international/README.fr.md +640 -609
- package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +2 -0
- package/src/bmad-plus/agents/agent-shadow/SKILL.md +18 -0
- package/src/bmad-plus/data/role-triggers.yaml +52 -0
- package/src/bmad-plus/module.yaml +333 -283
- package/src/bmad-plus/packs/pack-animated/animated-website-agent.md +325 -325
- package/src/bmad-plus/packs/pack-animated/templates/animated-website-workflow.md +55 -55
- package/src/bmad-plus/packs/pack-backup/backup-agent.md +71 -71
- package/src/bmad-plus/packs/pack-backup/templates/backup-workflow.md +51 -51
- package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -162
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +61 -61
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +95 -95
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +95 -95
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +134 -134
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +80 -80
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +95 -95
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +92 -92
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +80 -80
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +90 -90
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -153
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -173
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -224
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -329
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -318
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -359
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -379
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -361
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +81 -81
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +67 -67
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -85
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -35
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -49
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +131 -131
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +89 -89
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +300 -300
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +428 -428
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -80
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +484 -484
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +193 -193
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +175 -175
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +110 -110
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1511 -1511
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +298 -298
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +296 -296
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +29 -29
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +74 -74
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +29 -29
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +89 -89
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +29 -29
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +141 -141
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -37
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -75
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -6
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +110 -110
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +176 -176
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -67
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -86
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -179
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -66
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +127 -127
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -105
- package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -120
- package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -12
- package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -328
- package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -32
- package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -81
- package/src/bmad-plus/packs/pack-seo/SKILL.md +171 -171
- package/src/bmad-plus/packs/pack-seo/checklist.md +140 -140
- package/src/bmad-plus/packs/pack-seo/pagespeed-playbook.md +320 -320
- package/src/bmad-plus/packs/pack-seo/ref/audit-schema.json +187 -187
- package/src/bmad-plus/packs/pack-seo/ref/cwv-thresholds.md +87 -87
- package/src/bmad-plus/packs/pack-seo/ref/eeat-criteria.md +123 -123
- package/src/bmad-plus/packs/pack-seo/ref/geo-signals.md +167 -167
- package/src/bmad-plus/packs/pack-seo/ref/hreflang-rules.md +153 -153
- package/src/bmad-plus/packs/pack-seo/ref/quality-gates.md +133 -133
- package/src/bmad-plus/packs/pack-seo/ref/schema-catalog.md +91 -91
- package/src/bmad-plus/packs/pack-seo/ref/schema-templates.json +356 -356
- package/src/bmad-plus/packs/pack-seo/requirements.txt +17 -0
- package/src/bmad-plus/packs/pack-seo/scripts/seo_apis.py +456 -0
- package/src/bmad-plus/packs/pack-seo/scripts/seo_crawl.py +359 -0
- package/src/bmad-plus/packs/pack-seo/scripts/seo_fetch.py +303 -0
- package/src/bmad-plus/packs/pack-seo/scripts/seo_parse.py +255 -0
- package/src/bmad-plus/packs/pack-seo/scripts/seo_report.py +409 -0
- package/src/bmad-plus/packs/pack-seo/scripts/seo_screenshot.py +202 -0
- package/src/bmad-plus/packs/pack-seo/seo-chief.md +294 -294
- package/src/bmad-plus/packs/pack-seo/seo-judge.md +241 -241
- package/src/bmad-plus/packs/pack-seo/seo-scout.md +171 -171
- package/src/bmad-plus/packs/pack-seo/templates/seo-audit-workflow.md +241 -241
- package/src/bmad-plus/packs/pack-shield/README.md +6 -6
- package/src/bmad-plus/packs/pack-shield/SKILL.md +2 -2
- package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/csrd-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/section508-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/wcag-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/ai-governance/eu-ai-act-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/ai-governance/iso42001-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/ai-governance/nist-ai-rmf-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/cis-controls-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/ism-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/iso27001-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nis2-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-800-53-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-csf-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/defense-export/cmmc-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/defense-export/ear-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/defense-export/itar-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/defense-export/tsa-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/dora-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/fedramp-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/hipaa-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/pci-dss-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/soc2-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/swift-csp-agent.md +11 -11
- package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +1 -1
- package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +1 -1
- package/tools/bmad-plus-npx.js +4 -2
- package/tools/build/adapters.config.js +60 -51
- package/tools/build/check-counts.js +626 -0
- package/tools/build/check-install-contract.js +298 -0
- package/tools/build/generate-adapters.js +252 -56
- package/tools/build/generate.js +187 -10
- package/tools/build/generated-adapters/.codex/AGENTS.md +20 -7
- package/tools/build/generated-adapters/.cursor/rules/bmad-plus.mdc +20 -7
- package/tools/build/generated-adapters/.opencode/AGENTS.md +20 -7
- package/tools/build/generated-adapters/AGENTS.md +20 -7
- package/tools/build/generated-adapters/CLAUDE.md +20 -7
- package/tools/build/generated-adapters/CONVENTIONS.md +20 -7
- package/tools/build/generated-adapters/GEMINI.md +20 -7
- package/tools/build/module.template.yaml +82 -0
- package/tools/cli/bmad-plus-cli.js +16 -1
- package/tools/cli/commands/autoconfig.js +470 -470
- package/tools/cli/commands/doctor.js +205 -233
- package/tools/cli/commands/install.js +543 -501
- package/tools/cli/commands/memory-journal-cmd.js +311 -311
- package/tools/cli/commands/memory.js +195 -195
- package/tools/cli/commands/scan.js +348 -348
- package/tools/cli/commands/uninstall.js +209 -101
- package/tools/cli/commands/update-check.js +31 -0
- package/tools/cli/commands/update-policy.js +39 -0
- package/tools/cli/commands/update.js +123 -134
- package/tools/cli/i18n.js +905 -845
- package/tools/cli/lib/README-memory-journal.md +125 -125
- package/tools/cli/lib/ide-config.js +10 -259
- package/tools/cli/lib/install-manifest.js +17 -0
- package/tools/cli/lib/installed-adapters.js +89 -0
- package/tools/cli/lib/npm-runner.js +177 -0
- package/tools/cli/lib/pack-copy.js +62 -66
- package/tools/cli/lib/packs.js +437 -3
- package/tools/cli/lib/python-provision.js +508 -508
- package/tools/cli/lib/stack-detect.js +102 -102
- package/tools/cli/lib/update-check.js +153 -0
- package/tools/cli/lib/update-dispatch.js +182 -0
- package/tools/cli/lib/update-policy.js +90 -0
- package/tools/cli/lib/update-transaction.js +334 -0
- 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
|
-
[](CHANGELOG.md)
|
|
4
4
|
[](https://github.com/bmad-code-org/BMAD-METHOD)
|
|
5
5
|
[](LICENSE)
|
|
6
6
|
|
|
@@ -15,80 +15,34 @@
|
|
|
15
15
|
|
|
16
16
|
## 📋 Table of Contents
|
|
17
17
|
|
|
18
|
-
|
|
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
|
-
- [
|
|
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
|
-
## 💡
|
|
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
|
-
|
|
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 | **
|
|
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 | **
|
|
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
|
|
256
|
-
FG["Forge
|
|
257
|
-
SN["Sentinel
|
|
258
|
-
NX["Nexus
|
|
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
|
|
263
|
-
MK["Maker
|
|
264
|
-
ZC["Zecher
|
|
265
|
-
SD["Shield
|
|
266
|
-
DS["Dev Studio
|
|
267
|
-
SEO["SEO Engine
|
|
268
|
-
BK["Backup
|
|
269
|
-
AN["Animated
|
|
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
|
|
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
|
-
🛡️
|
|
367
|
+
🛡️ Shield GRC — 27 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 |
|
|
377
|
+
| Pack | Agents | Description | Status |
|
|
420
378
|
|------|--------|-------------|--------|
|
|
421
|
-
| ⚙️ **Core** | Atlas, Forge, Sentinel, Nexus |
|
|
422
|
-
| 🔍 **OSINT** | Shadow |
|
|
423
|
-
| 🧬 **Maker** | Maker | Design, build, validate
|
|
424
|
-
| 🛡️ **Shield** |
|
|
425
|
-
| 🏗️ **Dev Studio** | 6
|
|
426
|
-
|
|
|
427
|
-
|
|
|
428
|
-
|
|
|
429
|
-
|
|
|
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
|
|
433
|
-
-
|
|
434
|
-
-
|
|
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
|
-
|
|
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
|
|
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 |
|
|
503
|
-
|
|
|
504
|
-
|
|
|
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 —
|
|
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 |
|
|
542
|
-
| **0.4.2** | 2026-03-19 |
|
|
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** —
|
|
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) —
|
|
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** —
|
|
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>
|