bmad-plus 0.12.2 → 0.14.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 (127) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.md +96 -461
  3. package/package.json +12 -5
  4. package/readme-international/README.de.md +42 -9
  5. package/readme-international/README.es.md +43 -10
  6. package/readme-international/README.fr.md +42 -9
  7. package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +5 -3
  8. package/src/bmad-plus/module.yaml +270 -220
  9. package/src/bmad-plus/packs/pack-dev-studio/README.md +133 -141
  10. package/src/bmad-plus/packs/pack-dev-studio/SKILL.md +49 -0
  11. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +35 -60
  12. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +59 -59
  13. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +55 -93
  14. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +58 -93
  15. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +55 -132
  16. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +63 -78
  17. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +54 -69
  18. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +54 -93
  19. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +32 -60
  20. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +67 -71
  21. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +61 -90
  22. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +56 -78
  23. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +55 -88
  24. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +20 -153
  25. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +20 -173
  26. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +14 -220
  27. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +20 -329
  28. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +15 -314
  29. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +15 -355
  30. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +15 -375
  31. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +14 -357
  32. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +13 -78
  33. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +52 -65
  34. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +14 -81
  35. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +14 -31
  36. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +14 -45
  37. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +13 -128
  38. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +61 -87
  39. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +55 -298
  40. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +52 -426
  41. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +48 -69
  42. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +22 -80
  43. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +60 -482
  44. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +50 -184
  45. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +57 -173
  46. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +56 -108
  47. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +54 -1509
  48. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +54 -296
  49. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +41 -283
  50. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +58 -18
  51. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +103 -72
  52. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +55 -27
  53. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +34 -60
  54. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +46 -87
  55. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/steps/step-01-init.md +10 -0
  56. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +30 -60
  57. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +57 -27
  58. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +47 -138
  59. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +48 -34
  60. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +51 -68
  61. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +46 -3
  62. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +68 -109
  63. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +53 -174
  64. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +39 -53
  65. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +45 -83
  66. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +45 -176
  67. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +45 -63
  68. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +53 -124
  69. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +44 -100
  70. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +56 -116
  71. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +49 -12
  72. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +51 -328
  73. package/src/bmad-plus/packs/pack-dev-studio/shared/catalog.json +489 -0
  74. package/src/bmad-plus/packs/pack-dev-studio/shared/execution.md +69 -0
  75. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +39 -32
  76. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +85 -14
  77. package/src/bmad-plus/packs/pack-memory/README.md +6 -0
  78. package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +12 -5
  79. package/src/bmad-plus/packs/pack-seo/SKILL.md +27 -1
  80. package/src/bmad-plus/packs/pack-seo/scripts/seo_apis.py +8 -8
  81. package/src/bmad-plus/packs/pack-seo/scripts/seo_fetch.py +1 -2
  82. package/src/bmad-plus/packs/pack-seo/scripts/seo_report.py +0 -1
  83. package/src/bmad-plus/packs/pack-seo/seo-chief.md +16 -1
  84. package/src/bmad-plus/packs/pack-seo/seo-judge.md +12 -0
  85. package/src/bmad-plus/packs/pack-seo/seo-scout.md +12 -0
  86. package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +4 -4
  87. package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +5 -3
  88. package/src/bmad-plus/skills/dev-studio/SKILL.md +19 -0
  89. package/tools/bmad-plus-npx.js +4 -2
  90. package/tools/build/adapters.config.js +60 -51
  91. package/tools/build/check-counts.js +52 -54
  92. package/tools/build/check-install-contract.js +450 -0
  93. package/tools/build/generate-adapters.js +252 -56
  94. package/tools/build/generate.js +364 -14
  95. package/tools/build/generated-adapters/.codex/AGENTS.md +20 -7
  96. package/tools/build/generated-adapters/.cursor/rules/bmad-plus.mdc +20 -7
  97. package/tools/build/generated-adapters/.opencode/AGENTS.md +20 -7
  98. package/tools/build/generated-adapters/AGENTS.md +20 -7
  99. package/tools/build/generated-adapters/CLAUDE.md +20 -7
  100. package/tools/build/generated-adapters/CONVENTIONS.md +20 -7
  101. package/tools/build/generated-adapters/GEMINI.md +20 -7
  102. package/tools/build/module.template.yaml +82 -0
  103. package/tools/build/pack-delivery.js +78 -0
  104. package/tools/cli/bmad-plus-cli.js +16 -1
  105. package/tools/cli/commands/doctor.js +49 -217
  106. package/tools/cli/commands/install.js +109 -164
  107. package/tools/cli/commands/studio.js +68 -0
  108. package/tools/cli/commands/uninstall.js +173 -65
  109. package/tools/cli/commands/update-check.js +31 -0
  110. package/tools/cli/commands/update-policy.js +39 -0
  111. package/tools/cli/commands/update.js +102 -113
  112. package/tools/cli/i18n.js +60 -0
  113. package/tools/cli/lib/ide-config.js +4 -261
  114. package/tools/cli/lib/install-manifest.js +17 -0
  115. package/tools/cli/lib/installation-health.js +360 -0
  116. package/tools/cli/lib/installed-adapters.js +89 -0
  117. package/tools/cli/lib/npm-runner.js +177 -0
  118. package/tools/cli/lib/pack-copy.js +62 -66
  119. package/tools/cli/lib/packs.js +546 -3
  120. package/tools/cli/lib/python-health.js +233 -0
  121. package/tools/cli/lib/python-provision.js +2 -2
  122. package/tools/cli/lib/studio.js +310 -0
  123. package/tools/cli/lib/update-check.js +153 -0
  124. package/tools/cli/lib/update-dispatch.js +182 -0
  125. package/tools/cli/lib/update-policy.js +90 -0
  126. package/tools/cli/lib/update-transaction.js +334 -0
  127. package/tools/release/publication-content.js +901 -0
package/package.json CHANGED
@@ -1,8 +1,9 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "bmad-plus",
4
- "version": "0.12.2",
5
- "description": "BMAD+ — Augmented AI-Driven Development Framework with multi-role agents, autopilot, and parallel execution",
4
+ "version": "0.14.0",
5
+ "description": "Project-local AI development workflows with clear roles, shared context, safe updates and coding-tool adapters",
6
+ "homepage": "https://bmad-plus.rochetta.fr",
6
7
  "keywords": [
7
8
  "bmad",
8
9
  "ai",
@@ -34,13 +35,14 @@
34
35
  "install:bmad": "node tools/cli/bmad-plus-cli.js install",
35
36
  "update:bmad": "node tools/cli/bmad-plus-cli.js update",
36
37
  "doctor:bmad": "node tools/cli/bmad-plus-cli.js doctor",
37
- "build": "node tools/build/generate.js --out tools/cli/lib/packs.js",
38
+ "build": "node tools/build/generate.js --out tools/cli/lib/packs.js --module-out src/bmad-plus/module.yaml",
38
39
  "build:check": "node tools/build/generate.js --check",
39
40
  "check:counts": "node tools/build/check-counts.js",
40
41
  "lint": "eslint tools/ tests/",
41
42
  "format": "prettier --write \"tools/**/*.js\" \"tests/**/*.js\"",
42
43
  "format:check": "prettier --check \"tools/**/*.js\" \"tests/**/*.js\"",
43
44
  "test": "jest --coverage",
45
+ "test:install-contract": "node tools/build/check-install-contract.js",
44
46
  "prepare": "husky || true",
45
47
  "uninstall:bmad": "node tools/cli/bmad-plus-cli.js uninstall"
46
48
  },
@@ -48,8 +50,9 @@
48
50
  "@clack/prompts": "^1.4.0",
49
51
  "commander": "^14.0.0",
50
52
  "fs-extra": "^11.3.6",
51
- "js-yaml": "^5.2.1",
52
- "picocolors": "^1.1.1"
53
+ "js-yaml": "^5.2.2",
54
+ "picocolors": "^1.1.1",
55
+ "semver": "^7.8.5"
53
56
  },
54
57
  "engines": {
55
58
  "node": ">=20.0.0"
@@ -63,6 +66,10 @@
63
66
  "access": "public"
64
67
  },
65
68
  "jest": {
69
+ "testPathIgnorePatterns": [
70
+ "/node_modules/",
71
+ "/website/"
72
+ ],
66
73
  "collectCoverage": true,
67
74
  "coverageDirectory": "coverage",
68
75
  "moduleNameMapper": {
@@ -1,6 +1,6 @@
1
1
  # 🚀 BMAD+ — Erweitertes Multi-Agent KI-Framework
2
2
 
3
- [![Version](https://img.shields.io/badge/version-0.12.2-blue.svg)](../CHANGELOG.md)
3
+ [![Version](https://img.shields.io/badge/version-0.14.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,6 +15,10 @@
15
15
 
16
16
  ## 📋 Inhaltsverzeichnis
17
17
 
18
+ Repository-Prüfung: **980 JavaScript-Tests** (`npm test`). Die Deinstallation erhält den Projektspeicher und angepasste Dateien; für Installation oder Deinstallation ohne interaktives Terminal `--yes` verwenden.
19
+
20
+ Version 0.14.0 vervollständigt die Dev-Studio-Workflows und ergänzt `bmad-plus studio list --json` sowie `bmad-plus studio prepare create-prd --request "Eine Offline-Aufgabenliste definieren" --json`. In einem Projekt mit installiertem Dev Studio lädt die Vorbereitung die tatsächlichen Anweisungen, Konfiguration und Eingaben für deinen KI-Assistenten; sie führt die Arbeit nicht aus. `doctor --json` prüft den installierten Ressourcengraphen. Siehe [Einstieg und Versionshinweise](https://bmad-plus.rochetta.fr/de/docs/).
21
+
18
22
  - [Warum BMAD+?](#-warum-bmad-)
19
23
  - [Schnellstart](#-schnellstart)
20
24
  - [Architektur](#-architektur)
@@ -41,7 +45,7 @@ BMAD-METHOD ist ein exzellentes Framework mit 9 spezialisierten Agenten. Für ei
41
45
  | Keine automatisierte Pipeline | **Autopilot-Modus**: Idee → Fertigstellung |
42
46
  | Sequentielle Ausführung | **Überwachte parallele Ausführung** |
43
47
  | Kein Upstream-Tracking | **Wöchentliches Monitoring** mit WhatsApp |
44
- | 1-2 unterstützte IDEs | **5 IDEs** mit automatischer Erkennung |
48
+ | 1-2 unterstützte IDEs | **7 IDEs** mit automatischer Erkennung |
45
49
 
46
50
  ---
47
51
 
@@ -159,10 +163,27 @@ Nexus orchestriert alles automatisch mit Checkpoints für deine Genehmigung.
159
163
  | `npx bmad-plus memory status` | Statusbericht des Gedächtnisses (Projekt + globales Gehirn) |
160
164
  | `npx bmad-plus memory export` | Gehirn als portables Markdown-Archiv exportieren |
161
165
  | `npx bmad-plus doctor` | Installationsintegrität prüfen |
166
+ | `node tools/cli/bmad-plus-cli.js doctor --json` | Quellrepository: schreibgeschützter Bericht über Inventar und Fähigkeiten (nächste Version) |
162
167
  | `npx bmad-plus update` | Agenten und Skills aktualisieren (Konfiguration bleibt erhalten) |
163
168
  | `npx bmad-plus uninstall` | BMAD+ vom aktuellen Projekt entfernen |
164
169
  | `npx bmad-plus autoconfig` | Intelligentes Bootstrap — Auto-Erkennung, Installation und Konfiguration |
165
170
 
171
+ #### Framework aktualisieren
172
+
173
+ Die installierten Anweisungen bitten das LLM um eine Prüfung pro Sitzung. Das Ergebnis wird 24 Stunden zwischengespeichert; offline bleibt die veröffentlichte Version unbekannt. Automatische Updates erfordern eine ausdrückliche Richtlinie und unveränderte verwaltete Dateien.
174
+
175
+ Für Installationen mit 0.12.2 oder älter einmal die neue CLI mit `npx --yes bmad-plus@0.14.0 update --yes` laden. Diese ausdrückliche Migration sichert vorhandene Dateien vor dem Ersetzen.
176
+
177
+ ```bash
178
+ npx bmad-plus update-check --json
179
+ npx bmad-plus update --latest --yes
180
+ npx bmad-plus update-policy --mode auto --range "^0.14.0"
181
+ npx bmad-plus update --latest --auto
182
+ npx bmad-plus update-check --offline --json
183
+ ```
184
+
185
+ Standardmäßig werden Updates nur gemeldet. Mit `update-policy --mode off` lassen sich Prüfungen deaktivieren. Angepasste Agenten und Adapter bleiben erhalten; Konflikte blockieren automatische Updates. Ältere Installationen ohne Prüfsummen brauchen eine ausdrückliche manuelle Migration mit Sicherungen. Jedes Update meldet eine Sicherungskennung; `update --restore <receipt-id> --yes` stellt sie wieder her. Danach die Agentenanweisungen neu laden.
186
+
166
187
  #### 🔬 Erweiterte Installationsoptionen
167
188
 
168
189
  ```bash
@@ -423,7 +444,9 @@ Eine Projektidee eingeben → Nexus orchestriert die komplette Pipeline:
423
444
  ```
424
445
 
425
446
  **Konfigurierbare Checkpoints:**
426
- - `require_approval` (🔴) Pause, WhatsApp-Benachrichtigung, warten
447
+ Konfiguriere `execution_mode` und `checkpoints` in `_bmad/config.yaml` (`discovery`, `architecture`, `story`, `delivery`).
448
+
449
+ - `require_approval` (🔴) — Kontrollpunkt in der Sitzung anzeigen und warten; externe Benachrichtigungen benötigen einen konfigurierten Kanal und eine Genehmigung.
427
450
  - `notify_only` (🟡) — Benachrichtigung, wird fortgesetzt, sofern nicht eingegriffen wird
428
451
  - `auto` (🟢) — Wird automatisch fortgesetzt
429
452
 
@@ -441,15 +464,19 @@ Eine Projektidee eingeben → Nexus orchestriert die komplette Pipeline:
441
464
 
442
465
  ## 🖥️ Unterstützte IDEs
443
466
 
444
- Das Installationsprogramm erkennt IDEs automatisch und generiert Konfigurationen:
467
+ Das Installationsprogramm erkennt IDEs automatisch und generiert ihre Adapter mit `AGENTS.md` im Projektstamm als gemeinsame Anweisungsdatei:
445
468
 
446
469
  | IDE | Konfigurationsdatei | Erkennung |
447
470
  |-----|---------------|-----------|
448
471
  | Claude Code | `CLAUDE.md` | `.claude/` Ordner |
449
472
  | Gemini CLI | `GEMINI.md` | `.gemini/` Ordner |
450
- | Antigravity | `.gemini/` + `.agents/` | Antigravity-Erweiterung |
451
- | Codex CLI | `AGENTS.md` | `.codex/` Ordner |
452
- | OpenCode | `OPENCODE.md` | opencode-Konfiguration |
473
+ | Antigravity | `GEMINI.md` | `.gemini/antigravity/` Ordner |
474
+ | Cursor | `.cursor/rules/bmad-plus.mdc` | `.cursor/` Ordner |
475
+ | Codex CLI | `.codex/AGENTS.md` | `.codex/` Ordner |
476
+ | OpenCode | `.opencode/AGENTS.md` | `.opencode/` Ordner |
477
+ | Aider | `CONVENTIONS.md` | Datei `.aider.conf.yml` |
478
+
479
+ Für Aider ergänze `read: CONVENTIONS.md` in `.aider.conf.yml` oder führe `/read CONVENTIONS.md` aus, um die generierten Anweisungen zu laden.
453
480
 
454
481
  ---
455
482
 
@@ -473,8 +500,12 @@ BMAD+/
473
500
  ├── readme-international/ ← Übersetzungen in andere Sprachen
474
501
  ├── CHANGELOG.md ← Versionshistorie
475
502
  ├── CLAUDE.md ← Claude Code Konfiguration
476
- ├── GEMINI.md ← Gemini CLI Konfiguration
477
- ├── AGENTS.md ← Codex CLI / OpenCode Konfiguration
503
+ ├── GEMINI.md ← Gemini CLI / Antigravity Konfiguration
504
+ ├── AGENTS.md ← Gemeinsame Anweisungsdatei
505
+ ├── .codex/AGENTS.md ← Codex CLI Adapter
506
+ ├── .opencode/AGENTS.md ← OpenCode Adapter
507
+ ├── .cursor/rules/bmad-plus.mdc ← Cursor Adapter
508
+ ├── CONVENTIONS.md ← Aider Adapter
478
509
  ├── .gitignore
479
510
 
480
511
  ├── src/
@@ -565,6 +596,8 @@ BMAD+/
565
596
  | **0.12.0** | 2026-07-02 | 🏛️ **Load-bearing** — Root-Adapter aus dem Registry adoptiert, Memory über MCP, provider-neutrales Eval-Gateway; 333 Tests |
566
597
  | **0.12.1** | 2026-07-12 | 🧩 **Portfolio-Brain** — memory-init Brain-Erkennung behoben, Monitor auf google-genai SDK migriert, Versions-Sync |
567
598
  | **0.12.2** | 2026-07-16 | 🚚 **Fähigkeiten ausgeliefert** — SEO-Toolkit in-pack ausgeliefert (funktioniert von npm), OSINT-Rechtsgrundlagen-Gate auf jedem Pfad, Monitor rebuildbar, Crawler-SSRF geschlossen, mcp-server + CLI Testabdeckung; 483 Tests |
599
+ | **0.13.0** | 2026-09-08 | Kontrollierte Updates, geschützte Agenten, wiederherstellbare Sicherungen und Registry-basierte Installation; 709 Tests |
600
+ | **0.14.0** | 2026-09-09 | Vollständige Dev-Studio-Workflows und Kontextvorbereitung, Diagnosen, synchronisierte npm-Dokumentation und mehrsprachige Website |
568
601
 
569
602
  Siehe [CHANGELOG.md](../CHANGELOG.md) für vollständige Details.
570
603
 
@@ -1,6 +1,6 @@
1
1
  # 🚀 BMAD+ — Framework Multi-Agente IA Aumentado
2
2
 
3
- [![Version](https://img.shields.io/badge/version-0.12.2-blue.svg)](../CHANGELOG.md)
3
+ [![Version](https://img.shields.io/badge/version-0.14.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,6 +15,10 @@
15
15
 
16
16
  ## 📋 Tabla de contenidos
17
17
 
18
+ Validación del repositorio: **980 tests JavaScript** (`npm test`). La desinstalación conserva la memoria del proyecto y los archivos personalizados; utiliza `--yes` para instalar o desinstalar sin un terminal interactivo.
19
+
20
+ La versión 0.14.0 repara la entrega completa de Dev Studio y añade `bmad-plus studio list --json` y `bmad-plus studio prepare create-prd --request "Definir una lista de tareas sin conexión" --json`. En un proyecto con Dev Studio instalado, la preparación carga instrucciones reales, configuración y entradas para tu asistente de IA; no ejecuta el trabajo. `doctor --json` verifica el grafo de recursos instalados. Consulta la [guía de inicio y las novedades](https://bmad-plus.rochetta.fr/es/docs/).
21
+
18
22
  - [¿Por qué BMAD+?](#-por-qué-bmad-)
19
23
  - [Inicio Rápido](#-inicio-rápido)
20
24
  - [Arquitectura](#-arquitectura)
@@ -41,7 +45,7 @@ BMAD-METHOD es un excelente framework con 9 agentes especializados. Pero para un
41
45
  | Sin pipeline automatizado | **Modo Autopilot**: idea → entrega |
42
46
  | Ejecución secuencial | **Paralelismo supervisado** |
43
47
  | Sin seguimiento upstream | **Monitorización semanal** con WhatsApp |
44
- | 1-2 IDEs soportados | **5 IDEs** con auto-detección |
48
+ | 1-2 IDEs soportados | **7 IDEs** con auto-detección |
45
49
 
46
50
  ---
47
51
 
@@ -159,10 +163,27 @@ Nexus orquesta todo automáticamente con puntos de control (checkpoints) para tu
159
163
  | `npx bmad-plus memory status` | Informe de salud de memoria (proyecto + cerebro global) |
160
164
  | `npx bmad-plus memory export` | Exportar cerebro como archivo Markdown portable |
161
165
  | `npx bmad-plus doctor` | Verificar integridad de la instalación |
166
+ | `node tools/cli/bmad-plus-cli.js doctor --json` | Repositorio fuente: informe de inventario y capacidades de solo lectura (próxima versión) |
162
167
  | `npx bmad-plus update` | Actualizar agentes y skills (preserva la config) |
163
168
  | `npx bmad-plus uninstall` | Eliminar BMAD+ del proyecto actual |
164
169
  | `npx bmad-plus autoconfig` | Bootstrap inteligente — detección auto, instalación y configuración |
165
170
 
171
+ #### Actualizaciones del framework
172
+
173
+ Las instrucciones instaladas piden al LLM una comprobación por sesión. El resultado se conserva durante 24 horas; sin conexión, la versión publicada permanece desconocida. Las actualizaciones automáticas requieren una política explícita y archivos administrados sin cambios locales.
174
+
175
+ Para instalaciones con 0.12.2 o anterior, carga una vez el nuevo CLI con `npx --yes bmad-plus@0.14.0 update --yes`. Esta migración explícita guarda copias de seguridad antes de reemplazar los archivos antiguos.
176
+
177
+ ```bash
178
+ npx bmad-plus update-check --json
179
+ npx bmad-plus update --latest --yes
180
+ npx bmad-plus update-policy --mode auto --range "^0.14.0"
181
+ npx bmad-plus update --latest --auto
182
+ npx bmad-plus update-check --offline --json
183
+ ```
184
+
185
+ El modo predeterminado solo avisa. Para desactivar las comprobaciones: `update-policy --mode off`. Se conservan los agentes y adaptadores personalizados; los conflictos bloquean el modo automático. Las instalaciones antiguas sin huellas requieren una migración manual explícita con copias de seguridad. Cada actualización muestra un identificador; utiliza `update --restore <receipt-id> --yes` para restaurarla y vuelve a cargar las instrucciones.
186
+
166
187
  #### 🔬 Opciones de instalación avanzadas
167
188
 
168
189
  ```bash
@@ -427,7 +448,9 @@ Introduce una idea → Nexus gestionará todo:
427
448
  ```
428
449
 
429
450
  **Puntos de control (checkpoints) configurables:**
430
- - `require_approval` (🔴) Pausa, notifica por WhatsApp, espera
451
+ Configura `execution_mode` y `checkpoints` en `_bmad/config.yaml` (`discovery`, `architecture`, `story`, `delivery`).
452
+
453
+ - `require_approval` (🔴) — Mostrar el punto de control en la sesión y esperar; las notificaciones externas requieren un canal configurado y autorización.
431
454
  - `notify_only` (🟡) — Notifica, continúa (a menos que el usuario intervenga)
432
455
  - `auto` (🟢) — Totalmente automático
433
456
 
@@ -447,15 +470,19 @@ El orquestador divide las tareas asíncronas para ejecutarlas de forma paralela:
447
470
 
448
471
  ## 🖥️ IDE Soportados
449
472
 
450
- El instalador detecta automáticamente el IDE actual para generar la configuración nativa que conecte a BMAD+:
473
+ El instalador detecta automáticamente los IDE y genera sus adaptadores con una base de instrucciones común en `AGENTS.md`, en la raíz del proyecto:
451
474
 
452
- | IDE | Archivo de Config. | Detección (carpeta) |
475
+ | IDE | Archivo de Config. | Detección |
453
476
  |-----|---------------|-----------|
454
477
  | Claude Code | `CLAUDE.md` | `.claude/` |
455
478
  | Gemini CLI | `GEMINI.md` | `.gemini/` |
456
- | Antigravity | `.gemini/` + `.agents/` | Antigravity Extensión |
457
- | Codex CLI | `AGENTS.md` | `.codex/` |
458
- | OpenCode | `OPENCODE.md` | Opciones de opencode |
479
+ | Antigravity | `GEMINI.md` | `.gemini/antigravity/` |
480
+ | Cursor | `.cursor/rules/bmad-plus.mdc` | `.cursor/` |
481
+ | Codex CLI | `.codex/AGENTS.md` | `.codex/` |
482
+ | OpenCode | `.opencode/AGENTS.md` | `.opencode/` |
483
+ | Aider | `CONVENTIONS.md` | Archivo `.aider.conf.yml` |
484
+
485
+ Para Aider, añade `read: CONVENTIONS.md` a `.aider.conf.yml` o ejecuta `/read CONVENTIONS.md` para cargar las instrucciones generadas.
459
486
 
460
487
  ---
461
488
 
@@ -488,8 +515,12 @@ BMAD+/
488
515
  ├── readme-international/ ← Versiones traducidas (es, fr, de)
489
516
  ├── CHANGELOG.md ← Versiones de proyecto
490
517
  ├── CLAUDE.md ← Config IDE: Claude
491
- ├── GEMINI.md ← Config IDE: Gemini
492
- ├── AGENTS.md ← Config IDE: Codex / Opencode
518
+ ├── GEMINI.md ← Config Gemini CLI / Antigravity
519
+ ├── AGENTS.md ← Base de instrucciones común
520
+ ├── .codex/AGENTS.md ← Adaptador Codex CLI
521
+ ├── .opencode/AGENTS.md ← Adaptador OpenCode
522
+ ├── .cursor/rules/bmad-plus.mdc ← Adaptador Cursor
523
+ ├── CONVENTIONS.md ← Adaptador Aider
493
524
  ├── .gitignore
494
525
 
495
526
  ├── src/
@@ -580,6 +611,8 @@ BMAD+/
580
611
  | **0.12.0** | 2026-07-02 | 🏛️ **Load-bearing** — adapters raíz adoptados desde el registry, memoria vía MCP, gateway eval multi-proveedor; 333 tests |
581
612
  | **0.12.1** | 2026-07-12 | 🧩 **Cerebro portfolio** — fix de detección de cerebro memory-init, monitor migrado al SDK google-genai, sincronización de versión |
582
613
  | **0.12.2** | 2026-07-16 | 🚚 **Capacidades entregadas** — toolkit SEO embarcado in-pack (funciona desde npm), gate de base legal OSINT en cada ruta, monitor reconstruible, SSRF del crawler cerrado, cobertura de tests mcp-server + CLI; 483 tests |
614
+ | **0.13.0** | 2026-09-08 | Actualizaciones controladas, agentes protegidos, copias restaurables e instalación derivada del registro; 709 tests |
615
+ | **0.14.0** | 2026-09-09 | Flujos completos de Dev Studio y preparación del contexto, diagnósticos, documentación npm y web multilingüe sincronizadas |
583
616
 
584
617
  Más descripciones a fondo en el archivo: [CHANGELOG.md](../CHANGELOG.md).
585
618
 
@@ -1,6 +1,6 @@
1
1
  # 🚀 BMAD+ — Framework Multi-Agent IA Augmenté
2
2
 
3
- [![Version](https://img.shields.io/badge/version-0.12.2-blue.svg)](../CHANGELOG.md)
3
+ [![Version](https://img.shields.io/badge/version-0.14.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,6 +15,10 @@
15
15
 
16
16
  ## 📋 Table des matières
17
17
 
18
+ Validation du dépôt : **980 tests JavaScript** (`npm test`). La désinstallation conserve la mémoire du projet et les fichiers personnalisés ; utilisez `--yes` pour installer ou désinstaller sans terminal interactif.
19
+
20
+ La version 0.14.0 répare la livraison complète de Dev Studio et ajoute `bmad-plus studio list --json` et `bmad-plus studio prepare create-prd --request "Définir une liste de tâches hors ligne" --json`. Dans un projet où Dev Studio est installé, la préparation charge les instructions réelles, la configuration et les entrées pour votre assistant IA ; elle n’exécute pas le travail. `doctor --json` vérifie le graphe des ressources installées. Consultez le [guide de démarrage et les nouveautés](https://bmad-plus.rochetta.fr/fr/docs/).
21
+
18
22
  - [Pourquoi BMAD+ ?](#-pourquoi-bmad-)
19
23
  - [Quick Start](#-quick-start)
20
24
  - [Architecture](#-architecture)
@@ -41,7 +45,7 @@ BMAD-METHOD est un excellent framework avec 9 agents spécialisés. Mais pour un
41
45
  | Pas de pipeline automatisé | **Mode Autopilot** : idée → livraison |
42
46
  | Exécution séquentielle | **Parallélisme supervisé** |
43
47
  | Pas de suivi upstream | **Monitoring hebdomadaire** avec WhatsApp |
44
- | 1-2 IDE supportés | **5 IDE** avec détection automatique |
48
+ | 1-2 IDE supportés | **7 IDE** avec détection automatique |
45
49
 
46
50
  ---
47
51
 
@@ -159,10 +163,27 @@ Nexus orchestre tout automatiquement avec des checkpoints pour ton approbation.
159
163
  | `npx bmad-plus memory status` | Rapport de santé mémoire (projet + cerveau global) |
160
164
  | `npx bmad-plus memory export` | Export du cerveau en archive Markdown portable |
161
165
  | `npx bmad-plus doctor` | Vérifier l'intégrité de l'installation |
166
+ | `node tools/cli/bmad-plus-cli.js doctor --json` | Dépôt source : rapport en lecture seule sur l'inventaire et les capacités (prochaine version) |
162
167
  | `npx bmad-plus update` | Mettre à jour agents et skills (préserve la config) |
163
168
  | `npx bmad-plus uninstall` | Supprimer BMAD+ du projet actuel |
164
169
  | `npx bmad-plus autoconfig` | Bootstrap intelligent — détection auto, installation et configuration |
165
170
 
171
+ #### Mises à jour du framework
172
+
173
+ Les instructions installées demandent au LLM une vérification par session. Le résultat est conservé 24 heures ; hors connexion, la version publiée reste inconnue. Les mises à jour automatiques exigent une politique explicite et des fichiers gérés sans modification locale.
174
+
175
+ Pour les installations en 0.12.2 ou antérieures, chargez une fois le nouveau CLI avec `npx --yes bmad-plus@0.14.0 update --yes`. Cette migration explicite sauvegarde les anciens fichiers avant leur remplacement.
176
+
177
+ ```bash
178
+ npx bmad-plus update-check --json
179
+ npx bmad-plus update --latest --yes
180
+ npx bmad-plus update-policy --mode auto --range "^0.14.0"
181
+ npx bmad-plus update --latest --auto
182
+ npx bmad-plus update-check --offline --json
183
+ ```
184
+
185
+ Le mode par défaut signale les mises à jour. Pour désactiver les vérifications : `update-policy --mode off`. Les agents et adaptateurs personnalisés sont conservés ; les conflits bloquent le mode automatique. Les anciennes installations sans empreintes exigent une migration manuelle explicite avec sauvegardes. Chaque mise à jour fournit un identifiant de sauvegarde ; utilisez `update --restore <receipt-id> --yes` pour la restaurer, puis rechargez les instructions des agents.
186
+
166
187
  #### 🔬 Options d'installation avancées
167
188
 
168
189
  ```bash
@@ -427,7 +448,9 @@ Donnez une idée projet → Nexus orchestre le pipeline complet :
427
448
  ```
428
449
 
429
450
  **Checkpoints configurables :**
430
- - `require_approval` (🔴) Pause, notification WhatsApp, attente
451
+ Configurez `execution_mode` et `checkpoints` dans `_bmad/config.yaml` (`discovery`, `architecture`, `story`, `delivery`).
452
+
453
+ - `require_approval` (🔴) — Présenter le point de contrôle dans la session et attendre ; les notifications externes nécessitent un canal configuré et une autorisation.
431
454
  - `notify_only` (🟡) — Notification, continue sauf intervention
432
455
  - `auto` (🟢) — Continue automatiquement
433
456
 
@@ -447,15 +470,19 @@ L'Orchestrateur détecte les tâches indépendantes et les lance en parallèle :
447
470
 
448
471
  ## 🖥️ IDE Supportés
449
472
 
450
- L'installeur détecte automatiquement les IDE et génère les configs :
473
+ L'installeur détecte automatiquement les IDE et génère leurs adaptateurs autour d'un socle d'instructions commun `AGENTS.md` à la racine du projet :
451
474
 
452
475
  | IDE | Fichier Config | Détection |
453
476
  |-----|---------------|-----------|
454
477
  | Claude Code | `CLAUDE.md` | Dossier `.claude/` |
455
478
  | Gemini CLI | `GEMINI.md` | Dossier `.gemini/` |
456
- | Antigravity | `.gemini/` + `.agents/` | Extension Antigravity |
457
- | Codex CLI | `AGENTS.md` | Dossier `.codex/` |
458
- | OpenCode | `OPENCODE.md` | Config opencode |
479
+ | Antigravity | `GEMINI.md` | Dossier `.gemini/antigravity/` |
480
+ | Cursor | `.cursor/rules/bmad-plus.mdc` | Dossier `.cursor/` |
481
+ | Codex CLI | `.codex/AGENTS.md` | Dossier `.codex/` |
482
+ | OpenCode | `.opencode/AGENTS.md` | Dossier `.opencode/` |
483
+ | Aider | `CONVENTIONS.md` | Fichier `.aider.conf.yml` |
484
+
485
+ Pour Aider, ajoutez `read: CONVENTIONS.md` dans `.aider.conf.yml` ou lancez `/read CONVENTIONS.md` pour charger les instructions générées.
459
486
 
460
487
  ---
461
488
 
@@ -488,8 +515,12 @@ BMAD+/
488
515
  ├── readme-international/ ← Traductions en autres langues
489
516
  ├── CHANGELOG.md ← Historique des versions
490
517
  ├── CLAUDE.md ← Config Claude Code
491
- ├── GEMINI.md ← Config Gemini CLI
492
- ├── AGENTS.md ← Config Codex CLI / OpenCode
518
+ ├── GEMINI.md ← Config Gemini CLI / Antigravity
519
+ ├── AGENTS.md ← Socle d'instructions commun
520
+ ├── .codex/AGENTS.md ← Adaptateur Codex CLI
521
+ ├── .opencode/AGENTS.md ← Adaptateur OpenCode
522
+ ├── .cursor/rules/bmad-plus.mdc ← Adaptateur Cursor
523
+ ├── CONVENTIONS.md ← Adaptateur Aider
493
524
  ├── .gitignore
494
525
 
495
526
  ├── src/
@@ -580,6 +611,8 @@ BMAD+/
580
611
  | **0.12.0** | 2026-07-02 | 🏛️ **Load-bearing** — adapters racine adoptés depuis le registry, mémoire via MCP, gateway eval multi-provider ; 333 tests |
581
612
  | **0.12.1** | 2026-07-12 | 🧩 **Cerveau portfolio** — fix détection de cerveau memory-init, monitor migré vers le SDK google-genai, sync version |
582
613
  | **0.12.2** | 2026-07-16 | 🚚 **Capacités livrées** — toolkit SEO embarqué in-pack (fonctionne depuis npm), gate base légale OSINT sur tout chemin, monitor reconstructible, SSRF crawler fermé, couverture de tests mcp-server + CLI ; 483 tests |
614
+ | **0.13.0** | 2026-09-08 | Mises à jour contrôlées, agents protégés, sauvegardes restaurables et installation issue du registre ; 709 tests |
615
+ | **0.14.0** | 2026-09-09 | Workflows Dev Studio complets et préparation du contexte, diagnostics, documentation npm et landing multilingue synchronisées |
583
616
 
584
617
  Voir [CHANGELOG.md](../CHANGELOG.md) pour le détail complet.
585
618
 
@@ -65,9 +65,11 @@ Focuses on: end-to-end pipeline management, agent sequencing, checkpoint managem
65
65
  - Run full code review → UX review → documentation
66
66
  - 🔴 CHECKPOINT: Wait for user approval before finalization
67
67
 
68
+ Read `execution_mode` and `checkpoints` from `_bmad/config.yaml` before starting the pipeline. The checkpoint keys are `discovery`, `architecture`, `story`, and `delivery`.
69
+
68
70
  **Checkpoint behavior** (configurable):
69
- - `require_approval` (🔴 STOP): Pause and wait for user input. Notify via WhatsApp if configured.
70
- - `notify_only` (🟡 INFO): Send notification, continue unless user intervenes within timeout.
71
+ - `require_approval` (🔴 STOP): Present the checkpoint in the session and wait for user input. If an external channel is configured and sending is authorized, also notify through it.
72
+ - `notify_only` (🟡 INFO): Report progress in the session and continue. If an external channel is configured and sending is authorized, also notify through it.
71
73
  - `auto` (🟢 AUTO): Continue automatically. Log for audit trail.
72
74
 
73
75
  > 💡 **Auto-activates** when: keywords like "autopilot", "gère tout", "lance le projet", "full pipeline" are detected, or when `{execution_mode}` is set to "autopilot".
@@ -91,7 +93,7 @@ Focuses on: detecting parallelizable tasks, launching agents in parallel, confli
91
93
  - **Stop**: Detect conflicts (shared file edits) → pause conflicting agent
92
94
  - **Restart**: After conflict resolution → restart with merged context
93
95
  - **Reallocate**: Agent finishes early → assign next available task
94
- - **Escalate**: 3 consecutive failures → notify human via WhatsApp
96
+ - **Escalate**: 3 consecutive failures → report the failure and evidence in the session. If an external channel is configured and sending is authorized, also notify through it.
95
97
 
96
98
  > 💡 **Auto-activates** when: multiple independent stories are queued, or when `{parallel_execution}` is enabled and batch work is detected.
97
99