bmad-plus 0.14.0 → 0.17.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 +76 -0
- package/README.md +55 -18
- package/SECURITY.md +71 -0
- package/THIRD-PARTY-LICENSES.md +349 -0
- package/osint-agent-package/README.md +1 -1
- package/package.json +11 -3
- package/readme-international/README.de.md +20 -9
- package/readme-international/README.es.md +21 -10
- package/readme-international/README.fr.md +20 -9
- package/src/bmad-plus/agents/agent-architect-dev/SKILL.md +11 -13
- package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +147 -8
- package/src/bmad-plus/agents/agent-quality/SKILL.md +41 -11
- package/src/bmad-plus/data/role-triggers.yaml +19 -0
- package/src/bmad-plus/module-help.csv +1 -0
- package/src/bmad-plus/module.yaml +1 -0
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +3 -1
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +2 -0
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +5 -1
- package/src/bmad-plus/packs/pack-memory/README.md +29 -4
- package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +21 -1
- package/src/bmad-plus/packs/pack-memory/shared/karpathy-guardrails.md +3 -3
- package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +27 -3
- package/src/bmad-plus/packs/pack-memory/zecher-agent.md +18 -2
- package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +47 -10
- package/src/bmad-plus/skills/bmad-plus-parallel/SKILL.md +17 -3
- package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +76 -67
- package/src/bmad-plus/skills/bmad-plus-uat/SKILL.md +158 -0
- package/src/bmad-plus/skills/bmad-plus-uat/ref/uat-results.schema.json +60 -0
- package/src/bmad-plus/skills/bmad-plus-uat/ref/uat-spec.schema.json +121 -0
- package/src/bmad-plus/skills/bmad-plus-uat/ref/uat-triage.schema.json +60 -0
- package/src/bmad-plus/skills/bmad-plus-uat/template/page.html +628 -0
- package/src/bmad-plus/skills/bmad-plus-uat/template/strings.json +442 -0
- package/src/bmad-plus/skills/bmad-plus-uat/templates/README.md +63 -0
- package/src/bmad-plus/skills/bmad-plus-uat/templates/example-uat-spec.json +95 -0
- package/src/bmad-plus/skills/bmad-plus-uat/templates/uat-release-gate.mjs +127 -0
- package/src/bmad-plus/skills/bmad-plus-uat/templates/uat-spec-present.mjs +77 -0
- package/tools/build/check-install-contract.js +202 -4
- package/tools/build/generate.js +16 -0
- package/tools/build/generated-adapters/.codex/AGENTS.md +1 -1
- package/tools/build/generated-adapters/.cursor/rules/bmad-plus.mdc +1 -1
- package/tools/build/generated-adapters/.opencode/AGENTS.md +1 -1
- package/tools/build/generated-adapters/AGENTS.md +1 -1
- package/tools/build/generated-adapters/CLAUDE.md +1 -1
- package/tools/build/generated-adapters/CONVENTIONS.md +1 -1
- package/tools/build/generated-adapters/GEMINI.md +1 -1
- package/tools/cli/bmad-plus-cli.js +15 -12
- package/tools/cli/commands/autoconfig.js +4 -2
- package/tools/cli/commands/doctor.js +1 -0
- package/tools/cli/commands/install.js +21 -2
- package/tools/cli/commands/memory-journal-cmd.js +119 -19
- package/tools/cli/commands/nexus.js +111 -0
- package/tools/cli/commands/uat.js +405 -0
- package/tools/cli/i18n.js +10 -0
- package/tools/cli/lib/README-memory-journal.md +19 -8
- package/tools/cli/lib/installation-health.js +6 -0
- package/tools/cli/lib/memory-journal.js +0 -0
- package/tools/cli/lib/memory-outcomes.js +293 -0
- package/tools/cli/lib/memory-store.js +139 -0
- package/tools/cli/lib/nexus-process.js +377 -0
- package/tools/cli/lib/nexus.js +1532 -0
- package/tools/cli/lib/pack-copy.js +39 -11
- package/tools/cli/lib/packs.js +17 -3
- package/tools/cli/lib/uat.js +887 -0
- package/tools/maintain/upstream-candidate.js +456 -0
- package/tools/release/publication-content.js +4 -1
- package/tools/release/supply-chain.js +282 -0
|
@@ -82,7 +82,7 @@ osint-agent-package/
|
|
|
82
82
|
|
|
83
83
|
## Crédits
|
|
84
84
|
- Pipeline OSINT basé sur [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT License)
|
|
85
|
-
- Apify
|
|
85
|
+
- Outil Python Apify issu du pipeline OSINT ci-dessus ; inspiration des [skills Apify](https://github.com/apify/agent-skills), dont le dépôt déclare Apache-2.0. Voir les [notices tierces BMAD+](../THIRD-PARTY-LICENSES.md).
|
|
86
86
|
|
|
87
87
|
## Licence
|
|
88
88
|
MIT
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json.schemastore.org/package.json",
|
|
3
3
|
"name": "bmad-plus",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.17.0",
|
|
5
5
|
"description": "Project-local AI development workflows with clear roles, shared context, safe updates and coding-tool adapters",
|
|
6
6
|
"homepage": "https://bmad-plus.rochetta.fr",
|
|
7
7
|
"keywords": [
|
|
@@ -29,7 +29,12 @@
|
|
|
29
29
|
"src/bmad-plus",
|
|
30
30
|
"osint-agent-package",
|
|
31
31
|
"readme-international",
|
|
32
|
-
"
|
|
32
|
+
"THIRD-PARTY-LICENSES.md",
|
|
33
|
+
"SECURITY.md",
|
|
34
|
+
"CHANGELOG.md",
|
|
35
|
+
"!**/__pycache__/**",
|
|
36
|
+
"!**/*.pyc",
|
|
37
|
+
"!**/*.pyo"
|
|
33
38
|
],
|
|
34
39
|
"scripts": {
|
|
35
40
|
"install:bmad": "node tools/cli/bmad-plus-cli.js install",
|
|
@@ -38,6 +43,8 @@
|
|
|
38
43
|
"build": "node tools/build/generate.js --out tools/cli/lib/packs.js --module-out src/bmad-plus/module.yaml",
|
|
39
44
|
"build:check": "node tools/build/generate.js --check",
|
|
40
45
|
"check:counts": "node tools/build/check-counts.js",
|
|
46
|
+
"uat:spec": "node src/bmad-plus/skills/bmad-plus-uat/templates/uat-spec-present.mjs --dir recettes",
|
|
47
|
+
"uat:gate": "node src/bmad-plus/skills/bmad-plus-uat/templates/uat-release-gate.mjs --dir recettes --cli tools/cli/bmad-plus-cli.js",
|
|
41
48
|
"lint": "eslint tools/ tests/",
|
|
42
49
|
"format": "prettier --write \"tools/**/*.js\" \"tests/**/*.js\"",
|
|
43
50
|
"format:check": "prettier --check \"tools/**/*.js\" \"tests/**/*.js\"",
|
|
@@ -68,7 +75,8 @@
|
|
|
68
75
|
"jest": {
|
|
69
76
|
"testPathIgnorePatterns": [
|
|
70
77
|
"/node_modules/",
|
|
71
|
-
"/website/"
|
|
78
|
+
"/website/",
|
|
79
|
+
"/evals/"
|
|
72
80
|
],
|
|
73
81
|
"collectCoverage": true,
|
|
74
82
|
"coverageDirectory": "coverage",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 🚀 BMAD+ — Erweitertes Multi-Agent KI-Framework
|
|
2
2
|
|
|
3
|
-
[](../CHANGELOG.md)
|
|
4
4
|
[](https://github.com/bmad-code-org/BMAD-METHOD)
|
|
5
5
|
[](../LICENSE)
|
|
6
6
|
|
|
@@ -8,6 +8,10 @@
|
|
|
8
8
|
<a href="../README.md">English</a> | <a href="README.fr.md">Français</a> | <a href="README.es.md">Español</a> | 🌐 <b>Deutsch</b>
|
|
9
9
|
</div>
|
|
10
10
|
|
|
11
|
+
**Quelldokumentation: 0.17.0.** Das [npm-Paket](https://www.npmjs.com/package/bmad-plus) und die [öffentliche Anleitung](https://bmad-plus.rochetta.fr/de/docs/) nennen die veröffentlichte Version. Das [offizielle Distributionsrepository](https://github.com/lrochetta/BMAD-PLUS) ist öffentlich. Version 0.15.0 wurde mit 0.16.0 ausgeliefert und nicht separat veröffentlicht.
|
|
12
|
+
|
|
13
|
+
Version 0.17.0 behebt unbemerkt verlorene Abnahmeantworten und leere JSON-Exporte, findet Rezepte anhand ihrer Kennung und führt Veröffentlichungsprüfungen unter Windows mit Node aus. Sie ergänzt verständlichen Fortschritt, kopierbare Befehle und Vorlagen für Projektprüfungen. Blockierte Prüfungen erfordern eine Wiederholung oder eine ausdrückliche Risikoübernahme durch eine benannte Person; automatische Tests und menschliche Beobachtungen bleiben getrennt.
|
|
14
|
+
|
|
11
15
|
> **Multirole-Agenten · 9 modulare Packs · Autopilot-Modus · Parallele Ausführung**
|
|
12
16
|
> Intelligenter Fork von [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) — Selbstaktivierende Agenten mit 3-Stufen-Kontexterkennung, GRC-Compliance (Shield), vollständige SDLC-Pipeline (Dev Studio), OSINT-Intelligence, SEO-Audit, persistentes Cross-Session-Gedächtnis und 10-Sprachen CLI-Installer.
|
|
13
17
|
|
|
@@ -15,9 +19,9 @@
|
|
|
15
19
|
|
|
16
20
|
## 📋 Inhaltsverzeichnis
|
|
17
21
|
|
|
18
|
-
Repository-Prüfung: **
|
|
22
|
+
Repository-Prüfung: **1272 JavaScript-Tests** (`npm test`). Die Deinstallation erhält den Projektspeicher und angepasste Dateien; für Installation oder Deinstallation ohne interaktives Terminal `--yes` verwenden.
|
|
19
23
|
|
|
20
|
-
Version 0.
|
|
24
|
+
Version 0.16.0 ergänzt die menschliche Abnahme: eine Lieferung erzeugt eine Schritt-für-Schritt-Seite, die eine Person durchgeht, ihr Durchlauf kommt als JSON zurück, das die Agenten lesen und einordnen, und `uat gate` weist einen unfertigen, veralteten, nicht eingeordneten oder unbestätigten Durchlauf zurück. Die Seite spricht die zehn Sprachen des Installers. Sie liefert auch die für 0.15.0 vorbereiteten Änderungen: persistente Nexus-Versuche, optionale Befehls- oder Codex-Ausführung im Vordergrund und eine Speicherbewertung anhand akzeptierter Ergebnisse. Ein abgeschlossener Agentenlauf benötigt weiterhin unabhängige Prüfungen. Alle neun Packs haben bewertete deterministische Kontrollen; Modellbeobachtungen bleiben davon getrennt. Dev-Studio-Kontextvorbereitung und geschützte Updates bleiben verfügbar. Siehe [Einstieg und Versionshinweise](https://bmad-plus.rochetta.fr/de/docs/).
|
|
21
25
|
|
|
22
26
|
- [Warum BMAD+?](#-warum-bmad-)
|
|
23
27
|
- [Schnellstart](#-schnellstart)
|
|
@@ -163,21 +167,22 @@ Nexus orchestriert alles automatisch mit Checkpoints für deine Genehmigung.
|
|
|
163
167
|
| `npx bmad-plus memory status` | Statusbericht des Gedächtnisses (Projekt + globales Gehirn) |
|
|
164
168
|
| `npx bmad-plus memory export` | Gehirn als portables Markdown-Archiv exportieren |
|
|
165
169
|
| `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
|
|
170
|
+
| `node tools/cli/bmad-plus-cli.js doctor --json` | Quellrepository: schreibgeschützter Bericht über Inventar und Fähigkeiten |
|
|
167
171
|
| `npx bmad-plus update` | Agenten und Skills aktualisieren (Konfiguration bleibt erhalten) |
|
|
168
172
|
| `npx bmad-plus uninstall` | BMAD+ vom aktuellen Projekt entfernen |
|
|
169
173
|
| `npx bmad-plus autoconfig` | Intelligentes Bootstrap — Auto-Erkennung, Installation und Konfiguration |
|
|
174
|
+
| `npx bmad-plus uat <action>` | Menschliche Abnahme: lint, build, serve, import, read, gate, order (Alias `recette`) |
|
|
170
175
|
|
|
171
176
|
#### Framework aktualisieren
|
|
172
177
|
|
|
173
178
|
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
179
|
|
|
175
|
-
Für Installationen mit 0.12.2 oder älter einmal die neue CLI mit `npx --yes bmad-plus@0.
|
|
180
|
+
Für Installationen mit 0.12.2 oder älter einmal die neue CLI mit `npx --yes bmad-plus@0.17.0 update --yes` laden. Diese ausdrückliche Migration sichert vorhandene Dateien vor dem Ersetzen.
|
|
176
181
|
|
|
177
182
|
```bash
|
|
178
183
|
npx bmad-plus update-check --json
|
|
179
184
|
npx bmad-plus update --latest --yes
|
|
180
|
-
npx bmad-plus update-policy --mode auto --range "^0.
|
|
185
|
+
npx bmad-plus update-policy --mode auto --range "^0.17.0"
|
|
181
186
|
npx bmad-plus update --latest --auto
|
|
182
187
|
npx bmad-plus update-check --offline --json
|
|
183
188
|
```
|
|
@@ -598,6 +603,9 @@ BMAD+/
|
|
|
598
603
|
| **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
604
|
| **0.13.0** | 2026-09-08 | Kontrollierte Updates, geschützte Agenten, wiederherstellbare Sicherungen und Registry-basierte Installation; 709 Tests |
|
|
600
605
|
| **0.14.0** | 2026-09-09 | Vollständige Dev-Studio-Workflows und Kontextvorbereitung, Diagnosen, synchronisierte npm-Dokumentation und mehrsprachige Website |
|
|
606
|
+
| **0.15.0** | 2026-09-11 | Im Quellstand vorbereitet; mit 0.16.0 ausgeliefert. Persistente Nexus-Ausfuehrung, evidenzbasierter Speicher, Pack-Kontrollen und gepruefte Archive |
|
|
607
|
+
| **0.16.0** | 2026-09-16 | Menschliche Abnahme: Seite fuer eine Person, zurueckgelesener Durchlauf, Einordnung und evidenzgebundene Pruefung, zehn Sprachen |
|
|
608
|
+
| **0.17.0** | 2026-09-22 | Zuverlässige Abnahmeseiten, Suche nach Kennung, Windows-Veröffentlichungsprüfungen, ausdrückliche Risikoentscheidungen und synchronisierte Anleitungen |
|
|
601
609
|
|
|
602
610
|
Siehe [CHANGELOG.md](../CHANGELOG.md) für vollständige Details.
|
|
603
611
|
|
|
@@ -607,6 +615,9 @@ Siehe [CHANGELOG.md](../CHANGELOG.md) für vollständige Details.
|
|
|
607
615
|
|
|
608
616
|
MIT — Basierend auf [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (MIT)
|
|
609
617
|
|
|
618
|
+
BMAD+ ist eine unabhängige Ableitung, keine offizielle Veröffentlichung oder Empfehlung von BMad Code, LLC.
|
|
619
|
+
Quellenangaben und Bedingungen: [Hinweise zu Drittquellen](../THIRD-PARTY-LICENSES.md).
|
|
620
|
+
|
|
610
621
|
### Credits
|
|
611
622
|
|
|
612
623
|
**Ersteller**
|
|
@@ -619,10 +630,10 @@ MIT — Basierend auf [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD
|
|
|
619
630
|
|
|
620
631
|
**Externe Quellen & Inspirationen**
|
|
621
632
|
- **BMAD-METHOD** von [bmad-code-org](https://github.com/bmad-code-org) — Ursprüngliche Multi-Agenten-Methodik (MIT)
|
|
622
|
-
- **Shield GRC** — 27 Compliance-Agenten + 11 Workflows
|
|
633
|
+
- **Shield GRC** — 27 Compliance-Agenten + 11 Workflows, angepasst aus den [GRC-Skills von Hemant Naik](https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance) (MIT)
|
|
623
634
|
- **OSINT Pipeline** basierend auf [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT)
|
|
624
|
-
- **Apify
|
|
625
|
-
- **Karpathy Guardrails**
|
|
635
|
+
- **Apify-Integration** — OSINT-Helfer und Anregungen aus [Apify Agent Skills](https://github.com/apify/agent-skills) (Upstream deklariert Apache-2.0; siehe Hinweise)
|
|
636
|
+
- **Karpathy Guardrails** — Memory-Pack-Anpassung der [Community-Regeln von forrestchang](https://github.com/multica-ai/andrej-karpathy-skills), inspiriert von Andrej Karpathy (Upstream deklariert MIT)
|
|
626
637
|
|
|
627
638
|
**Werkzeuge & Infrastruktur**
|
|
628
639
|
- [Evolution API](https://github.com/EvolutionAPI/evolution-api) — WhatsApp-Benachrichtigungen für Upstream-Überwachung
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 🚀 BMAD+ — Framework Multi-Agente IA Aumentado
|
|
2
2
|
|
|
3
|
-
[](../CHANGELOG.md)
|
|
4
4
|
[](https://github.com/bmad-code-org/BMAD-METHOD)
|
|
5
5
|
[](../LICENSE)
|
|
6
6
|
|
|
@@ -8,6 +8,10 @@
|
|
|
8
8
|
<a href="../README.md">English</a> | <a href="README.fr.md">Français</a> | 🌐 <b>Español</b> | <a href="README.de.md">Deutsch</a>
|
|
9
9
|
</div>
|
|
10
10
|
|
|
11
|
+
**Documentación fuente: 0.17.0.** Consulta el [paquete npm](https://www.npmjs.com/package/bmad-plus) y la [guía pública](https://bmad-plus.rochetta.fr/es/docs/) para conocer la versión publicada. El [repositorio oficial de distribución](https://github.com/lrochetta/BMAD-PLUS) es público. La 0.15.0 se entregó con la 0.16.0, sin publicación separada.
|
|
12
|
+
|
|
13
|
+
La versión 0.17.0 corrige la pérdida silenciosa de respuestas y las exportaciones JSON vacías, encuentra recetas por su identificador y ejecuta los controles de publicación con Node en Windows. Añade un progreso más claro, comandos que se pueden copiar y plantillas de controles de proyecto. Una comprobación bloqueada requiere repetirla o una aceptación explícita del riesgo por un responsable identificado; las pruebas automáticas y las observaciones humanas siguen separadas.
|
|
14
|
+
|
|
11
15
|
> **Agentes multirrol · 9 packs modulares · Modo Autopilot · Ejecución paralela**
|
|
12
16
|
> Fork inteligente de [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) — Agentes auto-activables con detección contextual en 3 niveles, cumplimiento GRC (Shield), pipeline SDLC completo (Dev Studio), inteligencia OSINT, auditoría SEO, memoria persistente cross-session e instalador CLI en 10 idiomas.
|
|
13
17
|
|
|
@@ -15,9 +19,9 @@
|
|
|
15
19
|
|
|
16
20
|
## 📋 Tabla de contenidos
|
|
17
21
|
|
|
18
|
-
Validación del repositorio: **
|
|
22
|
+
Validación del repositorio: **1272 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
23
|
|
|
20
|
-
La versión 0.
|
|
24
|
+
La versión 0.16.0 añade la aceptación humana: una entrega produce una página paso a paso que una persona recorre, su prueba vuelve en JSON que los agentes leen y clasifican, y `uat gate` rechaza una prueba inacabada, desactualizada, sin clasificar o sin confirmar. La página habla los diez idiomas del instalador. También entrega el trabajo preparado para la 0.15.0: intentos Nexus persistentes, ejecución opcional de comandos o Codex en primer plano y clasificación de memoria basada en resultados aceptados. Un turno de agente terminado aún requiere verificación independiente. Los nueve paquetes tienen controles deterministas puntuados; las observaciones de modelos se mantienen separadas. La preparación de contexto Dev Studio y las protecciones de actualización siguen disponibles. Consulta la [guía de inicio y las novedades](https://bmad-plus.rochetta.fr/es/docs/).
|
|
21
25
|
|
|
22
26
|
- [¿Por qué BMAD+?](#-por-qué-bmad-)
|
|
23
27
|
- [Inicio Rápido](#-inicio-rápido)
|
|
@@ -163,21 +167,22 @@ Nexus orquesta todo automáticamente con puntos de control (checkpoints) para tu
|
|
|
163
167
|
| `npx bmad-plus memory status` | Informe de salud de memoria (proyecto + cerebro global) |
|
|
164
168
|
| `npx bmad-plus memory export` | Exportar cerebro como archivo Markdown portable |
|
|
165
169
|
| `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
|
|
170
|
+
| `node tools/cli/bmad-plus-cli.js doctor --json` | Repositorio fuente: informe de inventario y capacidades de solo lectura |
|
|
167
171
|
| `npx bmad-plus update` | Actualizar agentes y skills (preserva la config) |
|
|
168
172
|
| `npx bmad-plus uninstall` | Eliminar BMAD+ del proyecto actual |
|
|
169
173
|
| `npx bmad-plus autoconfig` | Bootstrap inteligente — detección auto, instalación y configuración |
|
|
174
|
+
| `npx bmad-plus uat <action>` | Aceptación humana: lint, build, serve, import, read, gate, order (alias `recette`) |
|
|
170
175
|
|
|
171
176
|
#### Actualizaciones del framework
|
|
172
177
|
|
|
173
178
|
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
179
|
|
|
175
|
-
Para instalaciones con 0.12.2 o anterior, carga una vez el nuevo CLI con `npx --yes bmad-plus@0.
|
|
180
|
+
Para instalaciones con 0.12.2 o anterior, carga una vez el nuevo CLI con `npx --yes bmad-plus@0.17.0 update --yes`. Esta migración explícita guarda copias de seguridad antes de reemplazar los archivos antiguos.
|
|
176
181
|
|
|
177
182
|
```bash
|
|
178
183
|
npx bmad-plus update-check --json
|
|
179
184
|
npx bmad-plus update --latest --yes
|
|
180
|
-
npx bmad-plus update-policy --mode auto --range "^0.
|
|
185
|
+
npx bmad-plus update-policy --mode auto --range "^0.17.0"
|
|
181
186
|
npx bmad-plus update --latest --auto
|
|
182
187
|
npx bmad-plus update-check --offline --json
|
|
183
188
|
```
|
|
@@ -302,7 +307,7 @@ graph TB
|
|
|
302
307
|
| **QA Engineer** | Pruebas API/E2E, edge cases, cobertura, revisión de código | "prueba", "QA", "bug", post-implementación |
|
|
303
308
|
| **UX Reviewer** | Evaluación de UX, accesibilidad, diseño de interacción | "UX", "interfaz", "responsive", cambios frontend |
|
|
304
309
|
|
|
305
|
-
**Capacidades:** QA Tests (QA), Code Review (CR), UX Design (CU)
|
|
310
|
+
**Capacidades:** QA Tests (QA), Code Review (CR), UX Design (CU), Recette build (RB), Recette read (RR), Recette gate (RG)
|
|
306
311
|
|
|
307
312
|
---
|
|
308
313
|
|
|
@@ -613,6 +618,9 @@ BMAD+/
|
|
|
613
618
|
| **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
619
|
| **0.13.0** | 2026-09-08 | Actualizaciones controladas, agentes protegidos, copias restaurables e instalación derivada del registro; 709 tests |
|
|
615
620
|
| **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 |
|
|
621
|
+
| **0.15.0** | 2026-09-11 | Preparada en el repositorio; entregada con la 0.16.0. Ejecucion Nexus persistente, memoria con evidencias, controles de paquetes y archivos verificados |
|
|
622
|
+
| **0.16.0** | 2026-09-16 | Aceptacion humana: pagina recorrida por una persona, prueba releida, clasificacion y control con evidencias, diez idiomas |
|
|
623
|
+
| **0.17.0** | 2026-09-22 | Páginas de aceptación fiables, búsqueda por identificador, controles de Windows, decisiones explícitas de riesgo y guías sincronizadas |
|
|
616
624
|
|
|
617
625
|
Más descripciones a fondo en el archivo: [CHANGELOG.md](../CHANGELOG.md).
|
|
618
626
|
|
|
@@ -624,6 +632,9 @@ Proyecto BMAD+ (Adaptación: MIT)
|
|
|
624
632
|
|
|
625
633
|
Basado nativamente en el repositorio: [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (MIT LIC)
|
|
626
634
|
|
|
635
|
+
BMAD+ es un derivado independiente, sin carácter oficial ni respaldo de BMad Code, LLC.
|
|
636
|
+
Atribuciones y condiciones de las fuentes incluidas: [Avisos de terceros](../THIRD-PARTY-LICENSES.md).
|
|
637
|
+
|
|
627
638
|
### Reconocimientos
|
|
628
639
|
|
|
629
640
|
**Creador**
|
|
@@ -636,10 +647,10 @@ Basado nativamente en el repositorio: [BMAD-METHOD](https://github.com/bmad-code
|
|
|
636
647
|
|
|
637
648
|
**Fuentes Externas e Inspiraciones**
|
|
638
649
|
- **BMAD-METHOD** por [bmad-code-org](https://github.com/bmad-code-org/BMAD-METHOD) — Metodología multi-agente original (MIT)
|
|
639
|
-
- **Shield GRC** — 27 agentes de cumplimiento + 11 workflows
|
|
650
|
+
- **Shield GRC** — 27 agentes de cumplimiento + 11 workflows adaptados de los [skills GRC de Hemant Naik](https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance) (MIT)
|
|
640
651
|
- **OSINT Pipeline** basado en [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT)
|
|
641
|
-
- **Apify
|
|
642
|
-
- **Karpathy Guardrails**
|
|
652
|
+
- **Integración Apify** — herramienta OSINT e inspiración de los [skills Apify](https://github.com/apify/agent-skills) (Apache-2.0 declarado en origen; véanse los avisos)
|
|
653
|
+
- **Karpathy Guardrails** — adaptación para Memory Pack de las [reglas comunitarias de forrestchang](https://github.com/multica-ai/andrej-karpathy-skills), inspiradas en Andrej Karpathy (MIT declarado en origen)
|
|
643
654
|
|
|
644
655
|
**Herramientas e Infraestructura**
|
|
645
656
|
- [Evolution API](https://github.com/EvolutionAPI/evolution-api) — Notificaciones WhatsApp para monitoreo upstream
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 🚀 BMAD+ — Framework Multi-Agent IA Augmenté
|
|
2
2
|
|
|
3
|
-
[](../CHANGELOG.md)
|
|
4
4
|
[](https://github.com/bmad-code-org/BMAD-METHOD)
|
|
5
5
|
[](../LICENSE)
|
|
6
6
|
|
|
@@ -8,6 +8,10 @@
|
|
|
8
8
|
<a href="../README.md">English</a> | 🌐 <b>Français</b> | <a href="README.es.md">Español</a> | <a href="README.de.md">Deutsch</a>
|
|
9
9
|
</div>
|
|
10
10
|
|
|
11
|
+
**Documentation source : 0.17.0.** Consultez le [paquet npm](https://www.npmjs.com/package/bmad-plus) et le [guide public](https://bmad-plus.rochetta.fr/fr/docs/) pour connaître la version effectivement publiée. Le [dépôt officiel de distribution](https://github.com/lrochetta/BMAD-PLUS) est public. La 0.15.0 a été livrée avec la 0.16.0, sans publication séparée.
|
|
12
|
+
|
|
13
|
+
La version 0.17.0 corrige la perte silencieuse des réponses de recette et les exports JSON vides, retrouve les recettes par identifiant et exécute les contrôles de publication avec Node sous Windows. Elle ajoute une progression lisible, des commandes copiables et des modèles de contrôles projet. Un contrôle bloqué nécessite un nouveau passage ou une acceptation explicite du risque par un responsable nommé ; tests automatisés et observations humaines restent distincts.
|
|
14
|
+
|
|
11
15
|
> **Agents multi-rôles · 9 packs modulaires · Mode Autopilot · Exécution parallèle**
|
|
12
16
|
> Fork intelligent de [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) — Agents auto-activables avec détection contextuelle 3 niveaux, conformité GRC (Shield), pipeline SDLC complet (Dev Studio), intelligence OSINT, audit SEO, mémoire persistante cross-session, et installeur CLI 10 langues.
|
|
13
17
|
|
|
@@ -15,9 +19,9 @@
|
|
|
15
19
|
|
|
16
20
|
## 📋 Table des matières
|
|
17
21
|
|
|
18
|
-
Validation du dépôt : **
|
|
22
|
+
Validation du dépôt : **1272 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
23
|
|
|
20
|
-
La version 0.
|
|
24
|
+
La version 0.16.0 ajoute la recette humaine : une livraison produit une page pas à pas qu’une personne joue, son passage revient en JSON que les agents lisent et classent, et `uat gate` refuse un passage inachevé, périmé, non classé ou non confirmé. La page parle les dix langues de l’installeur. Elle livre aussi le travail préparé pour la 0.15.0 : des tentatives Nexus persistantes, le lancement facultatif de commandes ou de Codex au premier plan et un classement mémoire fondé sur des résultats acceptés. Un tour d’agent terminé doit encore passer une vérification indépendante. Les neuf packs disposent de contrôles déterministes notés ; les observations de modèles restent distinctes. La préparation Dev Studio et les protections de mise à jour restent disponibles. Consultez le [guide de démarrage et les nouveautés](https://bmad-plus.rochetta.fr/fr/docs/).
|
|
21
25
|
|
|
22
26
|
- [Pourquoi BMAD+ ?](#-pourquoi-bmad-)
|
|
23
27
|
- [Quick Start](#-quick-start)
|
|
@@ -163,21 +167,22 @@ Nexus orchestre tout automatiquement avec des checkpoints pour ton approbation.
|
|
|
163
167
|
| `npx bmad-plus memory status` | Rapport de santé mémoire (projet + cerveau global) |
|
|
164
168
|
| `npx bmad-plus memory export` | Export du cerveau en archive Markdown portable |
|
|
165
169
|
| `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
|
|
170
|
+
| `node tools/cli/bmad-plus-cli.js doctor --json` | Dépôt source : rapport en lecture seule sur l'inventaire et les capacités |
|
|
167
171
|
| `npx bmad-plus update` | Mettre à jour agents et skills (préserve la config) |
|
|
168
172
|
| `npx bmad-plus uninstall` | Supprimer BMAD+ du projet actuel |
|
|
169
173
|
| `npx bmad-plus autoconfig` | Bootstrap intelligent — détection auto, installation et configuration |
|
|
174
|
+
| `npx bmad-plus uat <action>` | Recette humaine : lint, build, serve, import, read, gate, order (alias `recette`) |
|
|
170
175
|
|
|
171
176
|
#### Mises à jour du framework
|
|
172
177
|
|
|
173
178
|
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
179
|
|
|
175
|
-
Pour les installations en 0.12.2 ou antérieures, chargez une fois le nouveau CLI avec `npx --yes bmad-plus@0.
|
|
180
|
+
Pour les installations en 0.12.2 ou antérieures, chargez une fois le nouveau CLI avec `npx --yes bmad-plus@0.17.0 update --yes`. Cette migration explicite sauvegarde les anciens fichiers avant leur remplacement.
|
|
176
181
|
|
|
177
182
|
```bash
|
|
178
183
|
npx bmad-plus update-check --json
|
|
179
184
|
npx bmad-plus update --latest --yes
|
|
180
|
-
npx bmad-plus update-policy --mode auto --range "^0.
|
|
185
|
+
npx bmad-plus update-policy --mode auto --range "^0.17.0"
|
|
181
186
|
npx bmad-plus update --latest --auto
|
|
182
187
|
npx bmad-plus update-check --offline --json
|
|
183
188
|
```
|
|
@@ -613,6 +618,9 @@ BMAD+/
|
|
|
613
618
|
| **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
619
|
| **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
620
|
| **0.14.0** | 2026-09-09 | Workflows Dev Studio complets et préparation du contexte, diagnostics, documentation npm et landing multilingue synchronisées |
|
|
621
|
+
| **0.15.0** | 2026-09-11 | Préparée dans le dépôt ; livrée avec la 0.16.0. Execution Nexus persistante, memoire fondee sur des preuves, controles des packs et archives verifiees |
|
|
622
|
+
| **0.16.0** | 2026-09-16 | Recette humaine : page jouee par une personne, passage relu, classement et porte liee aux preuves, dix langues |
|
|
623
|
+
| **0.17.0** | 2026-09-22 | Recettes fiables, recherche par identifiant, contrôles de publication sous Windows, décisions de risque explicites et guides synchronisés |
|
|
616
624
|
|
|
617
625
|
Voir [CHANGELOG.md](../CHANGELOG.md) pour le détail complet.
|
|
618
626
|
|
|
@@ -622,6 +630,9 @@ Voir [CHANGELOG.md](../CHANGELOG.md) pour le détail complet.
|
|
|
622
630
|
|
|
623
631
|
MIT — Basé sur [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (MIT)
|
|
624
632
|
|
|
633
|
+
BMAD+ est un dérivé indépendant, sans statut officiel ni approbation de BMad Code, LLC.
|
|
634
|
+
Attributions et conditions des sources intégrées : [Notices tierces](../THIRD-PARTY-LICENSES.md).
|
|
635
|
+
|
|
625
636
|
### Crédits
|
|
626
637
|
|
|
627
638
|
**Créateur**
|
|
@@ -634,10 +645,10 @@ MIT — Basé sur [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (M
|
|
|
634
645
|
|
|
635
646
|
**Sources Externes et Inspirations**
|
|
636
647
|
- **BMAD-METHOD** par [bmad-code-org](https://github.com/bmad-code-org/BMAD-METHOD) — Méthodologie multi-agents originale (MIT)
|
|
637
|
-
- **Shield GRC** — 27 agents de conformité + 11 workflows
|
|
648
|
+
- **Shield GRC** — 27 agents de conformité + 11 workflows adaptés des [skills GRC de Hemant Naik](https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance) (MIT)
|
|
638
649
|
- **OSINT Pipeline** basé sur [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT)
|
|
639
|
-
- **Apify
|
|
640
|
-
- **Karpathy Guardrails**
|
|
650
|
+
- **Intégration Apify** — outil OSINT et inspiration des [skills Apify](https://github.com/apify/agent-skills) (Apache-2.0 déclaré en amont ; voir les notices)
|
|
651
|
+
- **Karpathy Guardrails** — adaptation pour Memory Pack des [règles communautaires de forrestchang](https://github.com/multica-ai/andrej-karpathy-skills), inspirées d’Andrej Karpathy (MIT déclaré en amont)
|
|
641
652
|
|
|
642
653
|
**Outils et Infrastructure**
|
|
643
654
|
- [Evolution API](https://github.com/EvolutionAPI/evolution-api) — Notifications WhatsApp pour la surveillance upstream
|
|
@@ -20,7 +20,7 @@ Switches between calm architectural reasoning and ultra-succinct dev precision d
|
|
|
20
20
|
## Principles
|
|
21
21
|
|
|
22
22
|
- User journeys drive technical decisions. Embrace boring technology for stability. Design simple solutions that scale when needed.
|
|
23
|
-
-
|
|
23
|
+
- Establish acceptance with checks of the changed behavior at its real consumer. Use meaningful regression tests and required project checks; record unrelated failures and unavailable checks without calling them passes.
|
|
24
24
|
- Every word in documentation serves a purpose. A diagram is worth thousands of words — include diagrams over drawn out text.
|
|
25
25
|
- Developer productivity is architecture. Connect every decision to business value and user impact.
|
|
26
26
|
|
|
@@ -36,7 +36,7 @@ Forge operates in three switchable roles. Roles can be **explicitly requested**
|
|
|
36
36
|
|
|
37
37
|
Focuses on: technical design, stack decisions, API design, distributed systems, scalability trade-offs.
|
|
38
38
|
|
|
39
|
-
> 💡 **Auto-activates** when: keywords like "architecture", "design", "API", "schema", "structure", "stack" are detected, when starting a new module, when
|
|
39
|
+
> 💡 **Auto-activates** when: keywords like "architecture", "design", "API", "schema", "structure", "stack" are detected, when starting a new module, or when shared contracts, data or security boundaries need a design decision.
|
|
40
40
|
|
|
41
41
|
### Role: Developer (default for implementation)
|
|
42
42
|
|
|
@@ -54,14 +54,14 @@ When auto-activating a role, **announce it**: "💡 I'm switching to [Role] mode
|
|
|
54
54
|
|
|
55
55
|
## Critical Actions (Developer Role)
|
|
56
56
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
57
|
+
1. Read the actual request, project instructions, relevant memory and the entire supplied story before editing. Establish the observable outcome and acceptance criteria. Reuse an existing valid plan; do not invent a story or reopen a settled decision.
|
|
58
|
+
2. Inspect the working tree and trace the affected behavior through callers, data, interfaces and tests. Before choosing the amount of process, record what the inspected code settles, any consequential intent gap, possible external or irreversible effects, and the expected change scope. A keyword or file count alone does not establish complexity.
|
|
59
|
+
3. Use a compact plan for a routine change. Expand it when investigation reveals a shared contract, migration or unresolved user-visible choice. If that happens during implementation, record the new evidence and revise the affected slice before proceeding; preserve completed work and continue independent authorized work. Ask only for essential information that the available evidence and prior decisions cannot settle. Existing authorization and checkpoint policy still apply.
|
|
60
|
+
4. Follow the story's task dependencies and reconcile any outdated instructions with current code. Implement the smallest coherent change in the project's style. Preserve unrelated edits and handwritten tracking data. Do not reset, revert, stage, commit or publish merely because a workflow reaches its final step.
|
|
61
|
+
5. Map each acceptance criterion to an executed test, command or direct observation. For a meaningful regression test, demonstrate the missing behavior first when practical, then make it pass. Exercise the real changed consumer: a helper-only test does not establish CLI, installed-package or interface adoption. Run required project checks at the relevant boundary; repeat or broaden them only for new changes, failures or unresolved coverage.
|
|
62
|
+
6. Record the check, observed result and tested artifact identity, including relevant callers, tests and configuration. Use revision and content hashes when available; otherwise identify the inspected snapshot and its limits. After an edit or resume, reuse only evidence whose relevant inputs are unchanged. Changed requirements, callers or assertions can invalidate a pass even when the cited implementation lines did not move.
|
|
63
|
+
7. Reconcile task completion from current evidence. Failed, skipped, unavailable and unrun checks remain distinct; a completion claim or an existing test file is not a pass. Report implementation, verification and required review separately. Sentinel or the designated acceptance owner inspects the result; if the same assistant also reviews it, say so rather than claiming independent acceptance.
|
|
64
|
+
8. Update authorized story records with decisions, changed files, actual check results and the next incomplete action. Mark a task complete only when its required evidence is established. Preserve partial work and explain the specific remaining dependency when completion is blocked.
|
|
65
65
|
|
|
66
66
|
## Capabilities
|
|
67
67
|
|
|
@@ -89,8 +89,6 @@ When auto-activating a role, **announce it**: "💡 I'm switching to [Role] mode
|
|
|
89
89
|
- **Load role triggers** — Search for `**/role-triggers.yaml`. If found, use for auto-activation rules. If not found, use built-in defaults.
|
|
90
90
|
- **Greet and present capabilities** — Greet `{user_name}` warmly by name, always speaking in `{communication_language}` and applying your persona throughout the session.
|
|
91
91
|
|
|
92
|
-
3.
|
|
93
|
-
|
|
94
|
-
**STOP and WAIT for user input** — Do NOT execute menu items automatically. Accept number, menu code, or fuzzy command match.
|
|
92
|
+
3. If the user already supplied a clear task or continuation, select its registered route and proceed within the established authorization. A greeting or menu does not require another confirmation. If the user only asked to meet Forge, mention `bmad-help`, present the capabilities table and wait for a selection. Accept a number, menu code or fuzzy command match.
|
|
95
93
|
|
|
96
94
|
**CRITICAL Handling:** When user responds with a code, line number or skill, invoke the corresponding skill by its exact registered name from the Capabilities table. DO NOT invent capabilities on the fly.
|
|
@@ -23,7 +23,7 @@ Crisp and checklist-driven for sprint management. Confident and direct for quick
|
|
|
23
23
|
- Planning and execution are two sides of the same coin. Specs are for building, not bureaucracy.
|
|
24
24
|
- Code that ships is better than perfect code that doesn't.
|
|
25
25
|
- Parallel when possible, sequential when required. Never parallelize dependent tasks.
|
|
26
|
-
-
|
|
26
|
+
- Bound retries by the task's recorded policy. Reconcile interrupted or ambiguous work before starting another attempt; report the unresolved condition when the limit is reached.
|
|
27
27
|
|
|
28
28
|
You must fully embody this persona so the user gets the best experience and help they need, therefore its important to remember you must not break character until the users dismisses this persona.
|
|
29
29
|
|
|
@@ -49,7 +49,12 @@ Focuses on: rapid spec creation, lean implementation, minimum ceremony tasks.
|
|
|
49
49
|
|
|
50
50
|
Focuses on: end-to-end pipeline management, agent sequencing, checkpoint management, progress tracking, WhatsApp notifications.
|
|
51
51
|
|
|
52
|
-
|
|
52
|
+
Inspect the request, existing artifacts and relevant consumers before choosing
|
|
53
|
+
the route. A small correction can use Quick Flow; a discovered contract change,
|
|
54
|
+
missing requirement or wider impact may require planning. Preserve prior user
|
|
55
|
+
authorization and completed work when changing depth.
|
|
56
|
+
|
|
57
|
+
**Autopilot Pipeline for work that needs these stages:**
|
|
53
58
|
|
|
54
59
|
1. **Discovery Phase** → Invoke `bmad-plus-agent-strategist`
|
|
55
60
|
- Run brainstorming → product brief → PRD → UX design
|
|
@@ -62,13 +67,14 @@ Focuses on: end-to-end pipeline management, agent sequencing, checkpoint managem
|
|
|
62
67
|
- 🟡 NOTIFY after each story completion
|
|
63
68
|
|
|
64
69
|
3. **Ship Phase** → Invoke `bmad-plus-agent-quality` + `bmad-plus-agent-architect-dev`
|
|
70
|
+
- Human acceptance: the Quality agent builds the delivery's recette, delivers the page, then reads the run and classifies every failure (`bmad-plus uat`). `uat.mode` in `_bmad/config.yaml` decides whether the delivery checkpoint waits for the gate (`gate`) or only reports it (`advisory`, the default)
|
|
65
71
|
- Run full code review → UX review → documentation
|
|
66
72
|
- 🔴 CHECKPOINT: Wait for user approval before finalization
|
|
67
73
|
|
|
68
74
|
Read `execution_mode` and `checkpoints` from `_bmad/config.yaml` before starting the pipeline. The checkpoint keys are `discovery`, `architecture`, `story`, and `delivery`.
|
|
69
75
|
|
|
70
76
|
**Checkpoint behavior** (configurable):
|
|
71
|
-
- `require_approval` (🔴 STOP):
|
|
77
|
+
- `require_approval` (🔴 STOP): Check whether the existing user authorization covers the concrete next action. If approval is still required, present the reviewable checkpoint and wait; do not ask again for an action already authorized. If an external channel is configured and sending is authorized, also notify through it.
|
|
72
78
|
- `notify_only` (🟡 INFO): Report progress in the session and continue. If an external channel is configured and sending is authorized, also notify through it.
|
|
73
79
|
- `auto` (🟢 AUTO): Continue automatically. Log for audit trail.
|
|
74
80
|
|
|
@@ -89,11 +95,11 @@ Focuses on: detecting parallelizable tasks, launching agents in parallel, confli
|
|
|
89
95
|
|
|
90
96
|
**Supervision Actions:**
|
|
91
97
|
- **Launch**: Detect independent tasks → start parallel agents
|
|
92
|
-
- **Monitor**:
|
|
98
|
+
- **Monitor**: Inspect durable attempt/evidence state with `bmad-plus nexus inspect RUN --json`; keep the pipeline YAML only as a navigation summary.
|
|
93
99
|
- **Stop**: Detect conflicts (shared file edits) → pause conflicting agent
|
|
94
|
-
- **Restart**:
|
|
100
|
+
- **Restart**: Inspect the existing host and artifacts, reconcile the attempt, then use a new bounded retry with an explicit host/session identity.
|
|
95
101
|
- **Reallocate**: Agent finishes early → assign next available task
|
|
96
|
-
- **Escalate**:
|
|
102
|
+
- **Escalate**: A task exhausts its attempt limit or cannot be reconciled → report the condition, current evidence and preserved changes. Continue independent authorized work when possible. An external notification still needs configuration and authorization.
|
|
97
103
|
|
|
98
104
|
> 💡 **Auto-activates** when: multiple independent stories are queued, or when `{parallel_execution}` is enabled and batch work is detected.
|
|
99
105
|
|
|
@@ -126,7 +132,7 @@ When auto-activating a role, **announce it**: "💡 I'm switching to [Role] mode
|
|
|
126
132
|
|
|
127
133
|
2. **Continue with steps below:**
|
|
128
134
|
- **Load project context** — Search for `**/project-context.md`. If found, load as foundational reference. If not found, continue without it.
|
|
129
|
-
- **Load orchestrator state** —
|
|
135
|
+
- **Load orchestrator state** — Use the explicit project root. Inspect the intended run under `.bmad-plus/nexus/runs/` through `bmad-plus nexus inspect RUN --json`. The older `.bmad-plus/orchestrator-state.yaml` can identify a pipeline stage but cannot prove a worker stopped or a check passed.
|
|
130
136
|
- **Load role triggers** — Search for `**/role-triggers.yaml`. If found, use for auto-activation rules.
|
|
131
137
|
- **Greet and present capabilities** — Greet `{user_name}` warmly by name, always speaking in `{communication_language}` and applying your persona throughout the session.
|
|
132
138
|
|
|
@@ -134,6 +140,139 @@ When auto-activating a role, **announce it**: "💡 I'm switching to [Role] mode
|
|
|
134
140
|
|
|
135
141
|
4. Otherwise, remind the user they can invoke the `bmad-help` skill at any time and present the capabilities table.
|
|
136
142
|
|
|
137
|
-
|
|
143
|
+
If the user already supplied a clear authorized task, start that task after
|
|
144
|
+
loading its context. Present a menu and wait only when activation supplied no
|
|
145
|
+
task. Accept a menu code or natural-language request without another confirmation.
|
|
138
146
|
|
|
139
147
|
**CRITICAL Handling:** When user responds with a code, line number or skill, invoke the corresponding skill by its exact registered name from the Capabilities table. DO NOT invent capabilities on the fly.
|
|
148
|
+
|
|
149
|
+
## Durable host-managed attempts and foreground execution
|
|
150
|
+
|
|
151
|
+
`bmad-plus nexus` persists task and attempt records in this project. Use the
|
|
152
|
+
host backend for existing agent tools, or the process backend to run a declared
|
|
153
|
+
foreground executable. A Codex CLI adapter supplies protected instructions over
|
|
154
|
+
stdin and records its JSONL result. Nexus provides no daemon, terminal takeover,
|
|
155
|
+
OS sandbox or automatic Git integration.
|
|
156
|
+
|
|
157
|
+
Create a JSON plan with a stable run ID and tasks. Each task needs `id`,
|
|
158
|
+
`objective`, `scope`, `artifacts` and `checks`. Use `dependsOn` for prerequisites,
|
|
159
|
+
`maxAttempts` for the total attempt limit and `resources` for immutable inputs
|
|
160
|
+
and check scripts. Exclusive write scopes must not overlap. A verifier or shared
|
|
161
|
+
input must be outside every task's write scope. For example:
|
|
162
|
+
|
|
163
|
+
```json
|
|
164
|
+
{
|
|
165
|
+
"id": "small-change",
|
|
166
|
+
"tasks": [{
|
|
167
|
+
"id": "implement",
|
|
168
|
+
"objective": "Implement the agreed behavior in src/task.cjs",
|
|
169
|
+
"scope": ["src/task.cjs"],
|
|
170
|
+
"artifacts": ["src/task.cjs"],
|
|
171
|
+
"resources": ["checks/task.cjs"],
|
|
172
|
+
"checks": [{"id": "behavior", "command": "node", "args": ["checks/task.cjs"]}],
|
|
173
|
+
"maxAttempts": 2,
|
|
174
|
+
"idempotent": true
|
|
175
|
+
}]
|
|
176
|
+
}
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
The check script must exist and independently exercise the artifact before
|
|
180
|
+
creating the plan. `idempotent` is a known task property, not a way to suppress
|
|
181
|
+
uncertainty about external effects. Run:
|
|
182
|
+
|
|
183
|
+
```sh
|
|
184
|
+
bmad-plus nexus create --plan plan.json --json
|
|
185
|
+
bmad-plus nexus start small-change implement --input host.json --json
|
|
186
|
+
bmad-plus nexus inspect small-change --json
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
`host.json` supplies `{"backend":{"kind":"host","id":"YOUR_HOST","sessionId":"YOUR_SESSION"}}`.
|
|
190
|
+
Retain the returned attempt ID. Record the actual host result through `record`
|
|
191
|
+
using an input object with that `attemptId`, the same `backend`, `outcome`
|
|
192
|
+
(`completed`, `failed`, `blocked` or `ambiguous`), and a concrete `summary`.
|
|
193
|
+
Host reports are observations, not independent acceptance.
|
|
194
|
+
|
|
195
|
+
After completed work, `nexus verify RUN TASK --json` executes the recorded
|
|
196
|
+
verifier arguments without a shell and binds results to current hashes.
|
|
197
|
+
`nexus accept RUN TASK --json` requires current passing evidence and prerequisites;
|
|
198
|
+
it marks local acceptance without committing or merging Git changes.
|
|
199
|
+
|
|
200
|
+
On interruption, inspect both the persisted attempt and the host's actual state.
|
|
201
|
+
For the host backend, `nexus cancel RUN TASK --input cancellation.json` records a
|
|
202
|
+
`reason` and signals no process. Once the operator has established that the owner stopped,
|
|
203
|
+
`reconcile` takes the original `attemptId`/`backend`, `ownerStopped: true`, an
|
|
204
|
+
observed `outcome` (`completed`, `failed`, `cancelled`) and `summary`. Set
|
|
205
|
+
`retrySafe: true` only after reconciling potentially repeated effects. Then use
|
|
206
|
+
`retry` with the new host identity if the recorded attempt policy allows it.
|
|
207
|
+
Never infer stopped ownership from a timeout, worker prose or a reused terminal.
|
|
208
|
+
|
|
209
|
+
Changed artifacts or verifier inputs invalidate old passes. A missing review,
|
|
210
|
+
failed critical check or ambiguous cancellation remains visible. Preserve useful
|
|
211
|
+
files, prior authorization and unrelated tasks while resolving that condition.
|
|
212
|
+
|
|
213
|
+
### Launch a declared executable
|
|
214
|
+
|
|
215
|
+
For a local executable worker, add this object to a task before `create`. The
|
|
216
|
+
worker script and UTF-8 input must exist outside every task's write scope:
|
|
217
|
+
|
|
218
|
+
```json
|
|
219
|
+
{
|
|
220
|
+
"execution": {
|
|
221
|
+
"adapter": "command",
|
|
222
|
+
"command": "node",
|
|
223
|
+
"args": ["workers/task.cjs"],
|
|
224
|
+
"input": "inputs/task.json",
|
|
225
|
+
"resources": ["workers/task.cjs"],
|
|
226
|
+
"blockedExitCodes": [75]
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
`command` accepts `node` or an absolute executable path. `args` are literal
|
|
232
|
+
arguments, never shell text. The plan pins the executable, declared resources
|
|
233
|
+
and input. A declared blocked exit (75 here) leaves work blocked for inspection;
|
|
234
|
+
it does not grant approval. Do not put credentials in arguments or input files.
|
|
235
|
+
|
|
236
|
+
```sh
|
|
237
|
+
bmad-plus nexus launch small-change implement --json
|
|
238
|
+
bmad-plus nexus inspect small-change --json
|
|
239
|
+
bmad-plus nexus collect small-change implement --input attempt.json --json
|
|
240
|
+
bmad-plus nexus verify small-change implement --json
|
|
241
|
+
bmad-plus nexus accept small-change implement --json
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
`launch` owns one child at the foreground; keep its process running. Separate
|
|
245
|
+
clients can inspect it and collect the result after it ends. `attempt.json`
|
|
246
|
+
contains the exact returned `attemptId` and `backend` object. Completion is an
|
|
247
|
+
execution receipt; only the independent checks establish acceptance. A second
|
|
248
|
+
launch cannot duplicate an existing attempt. After reconciliation, an explicit
|
|
249
|
+
`launch ... --input retry.json` with `{"retry":true}` consumes a new attempt.
|
|
250
|
+
|
|
251
|
+
To use an already installed, authenticated Codex CLI, replace `execution` with:
|
|
252
|
+
|
|
253
|
+
```json
|
|
254
|
+
{
|
|
255
|
+
"execution": {
|
|
256
|
+
"adapter": "codex-exec",
|
|
257
|
+
"command": "/absolute/path/to/codex",
|
|
258
|
+
"input": "inputs/task.md",
|
|
259
|
+
"instructions": [".agents/skills/agent-architect-dev/SKILL.md"],
|
|
260
|
+
"sandbox": "workspace-write"
|
|
261
|
+
}
|
|
262
|
+
}
|
|
263
|
+
```
|
|
264
|
+
|
|
265
|
+
On Windows supply the actual absolute `codex.exe` path. This adapter uses
|
|
266
|
+
`codex -a never exec --json --color never --sandbox MODE --skip-git-repo-check
|
|
267
|
+
--ignore-user-config -`. It supports `read-only` (default) and `workspace-write`,
|
|
268
|
+
and an optional explicit `model`; it never adds approval/sandbox bypass flags.
|
|
269
|
+
The installed CLI retains authentication. Nexus does not read credential files,
|
|
270
|
+
store credential environment values, install a CLI or broaden a host policy.
|
|
271
|
+
Unsupported flags, missing auth, sandbox restrictions and provider errors remain
|
|
272
|
+
actual failures. Review the input for authorized scope before launch.
|
|
273
|
+
|
|
274
|
+
Process cancellation needs the same `attemptId` and `backend`, plus `reason`.
|
|
275
|
+
Only the original supervisor signals its actual child handle. A deadline,
|
|
276
|
+
supervisor interruption, truncated output or uncertain descendants leave an
|
|
277
|
+
ambiguous attempt. Inspect effects and reconcile before retry; never kill or
|
|
278
|
+
relaunch from a stored PID. A dead supervisor is not automatically replaced.
|