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.
Files changed (66) hide show
  1. package/CHANGELOG.md +76 -0
  2. package/README.md +55 -18
  3. package/SECURITY.md +71 -0
  4. package/THIRD-PARTY-LICENSES.md +349 -0
  5. package/osint-agent-package/README.md +1 -1
  6. package/package.json +11 -3
  7. package/readme-international/README.de.md +20 -9
  8. package/readme-international/README.es.md +21 -10
  9. package/readme-international/README.fr.md +20 -9
  10. package/src/bmad-plus/agents/agent-architect-dev/SKILL.md +11 -13
  11. package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +147 -8
  12. package/src/bmad-plus/agents/agent-quality/SKILL.md +41 -11
  13. package/src/bmad-plus/data/role-triggers.yaml +19 -0
  14. package/src/bmad-plus/module-help.csv +1 -0
  15. package/src/bmad-plus/module.yaml +1 -0
  16. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +3 -1
  17. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +2 -0
  18. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +5 -1
  19. package/src/bmad-plus/packs/pack-memory/README.md +29 -4
  20. package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +21 -1
  21. package/src/bmad-plus/packs/pack-memory/shared/karpathy-guardrails.md +3 -3
  22. package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +27 -3
  23. package/src/bmad-plus/packs/pack-memory/zecher-agent.md +18 -2
  24. package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +47 -10
  25. package/src/bmad-plus/skills/bmad-plus-parallel/SKILL.md +17 -3
  26. package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +76 -67
  27. package/src/bmad-plus/skills/bmad-plus-uat/SKILL.md +158 -0
  28. package/src/bmad-plus/skills/bmad-plus-uat/ref/uat-results.schema.json +60 -0
  29. package/src/bmad-plus/skills/bmad-plus-uat/ref/uat-spec.schema.json +121 -0
  30. package/src/bmad-plus/skills/bmad-plus-uat/ref/uat-triage.schema.json +60 -0
  31. package/src/bmad-plus/skills/bmad-plus-uat/template/page.html +628 -0
  32. package/src/bmad-plus/skills/bmad-plus-uat/template/strings.json +442 -0
  33. package/src/bmad-plus/skills/bmad-plus-uat/templates/README.md +63 -0
  34. package/src/bmad-plus/skills/bmad-plus-uat/templates/example-uat-spec.json +95 -0
  35. package/src/bmad-plus/skills/bmad-plus-uat/templates/uat-release-gate.mjs +127 -0
  36. package/src/bmad-plus/skills/bmad-plus-uat/templates/uat-spec-present.mjs +77 -0
  37. package/tools/build/check-install-contract.js +202 -4
  38. package/tools/build/generate.js +16 -0
  39. package/tools/build/generated-adapters/.codex/AGENTS.md +1 -1
  40. package/tools/build/generated-adapters/.cursor/rules/bmad-plus.mdc +1 -1
  41. package/tools/build/generated-adapters/.opencode/AGENTS.md +1 -1
  42. package/tools/build/generated-adapters/AGENTS.md +1 -1
  43. package/tools/build/generated-adapters/CLAUDE.md +1 -1
  44. package/tools/build/generated-adapters/CONVENTIONS.md +1 -1
  45. package/tools/build/generated-adapters/GEMINI.md +1 -1
  46. package/tools/cli/bmad-plus-cli.js +15 -12
  47. package/tools/cli/commands/autoconfig.js +4 -2
  48. package/tools/cli/commands/doctor.js +1 -0
  49. package/tools/cli/commands/install.js +21 -2
  50. package/tools/cli/commands/memory-journal-cmd.js +119 -19
  51. package/tools/cli/commands/nexus.js +111 -0
  52. package/tools/cli/commands/uat.js +405 -0
  53. package/tools/cli/i18n.js +10 -0
  54. package/tools/cli/lib/README-memory-journal.md +19 -8
  55. package/tools/cli/lib/installation-health.js +6 -0
  56. package/tools/cli/lib/memory-journal.js +0 -0
  57. package/tools/cli/lib/memory-outcomes.js +293 -0
  58. package/tools/cli/lib/memory-store.js +139 -0
  59. package/tools/cli/lib/nexus-process.js +377 -0
  60. package/tools/cli/lib/nexus.js +1532 -0
  61. package/tools/cli/lib/pack-copy.js +39 -11
  62. package/tools/cli/lib/packs.js +17 -3
  63. package/tools/cli/lib/uat.js +887 -0
  64. package/tools/maintain/upstream-candidate.js +456 -0
  65. package/tools/release/publication-content.js +4 -1
  66. 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 Actor Runner intégré de [apify/agent-skills](https://github.com/apify/agent-skills) (MIT License)
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.14.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
- "CHANGELOG.md"
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
- [![Version](https://img.shields.io/badge/version-0.14.0-blue.svg)](../CHANGELOG.md)
3
+ [![Version](https://img.shields.io/badge/version-0.17.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
 
@@ -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: **980 JavaScript-Tests** (`npm test`). Die Deinstallation erhält den Projektspeicher und angepasste Dateien; für Installation oder Deinstallation ohne interaktives Terminal `--yes` verwenden.
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.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/).
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 (nächste Version) |
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.14.0 update --yes` laden. Diese ausdrückliche Migration sichert vorhandene Dateien vor dem Ersetzen.
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.14.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 basierend auf öffentlichen Regulierungstexten (DSGVO, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIST, CMMC, usw.)
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 Actor Runner** integriert von [apify/agent-skills](https://github.com/apify/agent-skills) (MIT)
625
- - **Karpathy Guardrails** adaptiert von [Andrej Karpathy](https://github.com/multica-ai/andrej-karpathy-skills) (MIT) — Verhaltensregeln für das Memory Pack
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
- [![Version](https://img.shields.io/badge/version-0.14.0-blue.svg)](../CHANGELOG.md)
3
+ [![Version](https://img.shields.io/badge/version-0.17.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
 
@@ -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: **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.
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.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/).
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 (próxima versión) |
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.14.0 update --yes`. Esta migración explícita guarda copias de seguridad antes de reemplazar los archivos antiguos.
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.14.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 basados en textos regulatorios públicos (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIST, CMMC, etc.)
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 Actor Runner** integrado desde [apify/agent-skills](https://github.com/apify/agent-skills) (MIT)
642
- - **Karpathy Guardrails** adaptado de [Andrej Karpathy](https://github.com/multica-ai/andrej-karpathy-skills) (MIT) — Reglas de comportamiento para Memory Pack
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
- [![Version](https://img.shields.io/badge/version-0.14.0-blue.svg)](../CHANGELOG.md)
3
+ [![Version](https://img.shields.io/badge/version-0.17.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
 
@@ -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 : **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.
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.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/).
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 (prochaine version) |
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.14.0 update --yes`. Cette migration explicite sauvegarde les anciens fichiers avant leur remplacement.
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.14.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 basés sur des textes réglementaires publics (RGPD, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIST, CMMC, etc.)
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 Actor Runner** intégré de [apify/agent-skills](https://github.com/apify/agent-skills) (MIT)
640
- - **Karpathy Guardrails** adapté de [Andrej Karpathy](https://github.com/multica-ai/andrej-karpathy-skills) (MIT) — Règles comportementales pour Memory Pack
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
- - All existing and new tests must pass 100% before any story is ready for review. Every task/subtask must be covered by comprehensive unit tests.
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 security is involved, or when changes span 5+ files.
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
- - READ the entire story file BEFORE any implementation — tasks/subtasks sequence is your authoritative implementation guide
58
- - Execute tasks/subtasks IN ORDER as written in story file — no skipping, no reordering
59
- - Mark task/subtask [x] ONLY when both implementation AND tests are complete and passing
60
- - Run full test suite after each task — NEVER proceed with failing tests
61
- - Execute continuously without pausing until all tasks/subtasks are complete
62
- - Document in story file Dev Agent Record what was implemented, tests created, and any decisions made
63
- - Update story file File List with ALL changed files after each task completion
64
- - NEVER lie about tests being written or passing — tests must actually exist and pass 100%
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. Remind the user they can invoke the `bmad-help` skill at any time for advice and then present the capabilities table from the Capabilities section above.
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
- - Escalate to human when 3 automatic retries fail. Transparency over silent failure.
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
- **Autopilot Pipeline:**
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): 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.
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**: Track progress of all running agents via orchestrator-state.yaml
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**: After conflict resolution → restart with merged context
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**: 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.
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** — Search for `**/.bmad-plus/orchestrator-state.yaml`. If found, resume from last known state (supports `--resume`).
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
- **STOP and WAIT for user input** — Do NOT execute menu items automatically. Accept number, menu code, or fuzzy command match.
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.