bmad-plus 0.16.0 → 0.17.1

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 +114 -29
  2. package/README.md +45 -27
  3. package/SECURITY.md +9 -1
  4. package/osint-agent-package/README.md +13 -0
  5. package/osint-agent-package/SETUP_KEYS.md +13 -0
  6. package/package.json +32 -8
  7. package/readme-international/README.de.md +134 -537
  8. package/readme-international/README.es.md +136 -556
  9. package/readme-international/README.fr.md +135 -553
  10. package/src/bmad-plus/agents/agent-shadow/SKILL.md +6 -0
  11. package/src/bmad-plus/packs/pack-memory/README.md +1 -1
  12. package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +1 -1
  13. package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +1 -1
  14. package/src/bmad-plus/packs/pack-shield/README.md +2 -0
  15. package/src/bmad-plus/packs/pack-shield/SKILL.md +2 -0
  16. package/src/bmad-plus/packs/pack-shield/shared/audit-report-template.md +6 -0
  17. package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +4 -0
  18. package/src/bmad-plus/skills/bmad-plus-uat/SKILL.md +18 -4
  19. package/src/bmad-plus/skills/bmad-plus-uat/template/page.html +95 -19
  20. package/src/bmad-plus/skills/bmad-plus-uat/template/strings.json +90 -10
  21. package/src/bmad-plus/skills/bmad-plus-uat/templates/README.md +63 -0
  22. package/src/bmad-plus/skills/bmad-plus-uat/templates/example-uat-spec.json +95 -0
  23. package/src/bmad-plus/skills/bmad-plus-uat/templates/uat-release-gate.mjs +127 -0
  24. package/src/bmad-plus/skills/bmad-plus-uat/templates/uat-spec-present.mjs +77 -0
  25. package/tools/build/adapters.config.js +1 -1
  26. package/tools/build/generate-adapters.js +186 -60
  27. package/tools/build/generate.js +49 -13
  28. package/tools/cli/bmad-plus-cli.js +3 -6
  29. package/tools/cli/commands/autoconfig.js +66 -24
  30. package/tools/cli/commands/install.js +620 -356
  31. package/tools/cli/commands/memory.js +40 -13
  32. package/tools/cli/commands/scan.js +94 -30
  33. package/tools/cli/commands/uat.js +21 -5
  34. package/tools/cli/commands/uninstall.js +65 -16
  35. package/tools/cli/commands/update-check.js +8 -3
  36. package/tools/cli/commands/update-policy.js +14 -5
  37. package/tools/cli/commands/update.js +89 -20
  38. package/tools/cli/i18n.js +128 -66
  39. package/tools/cli/lib/ide-config.js +3 -1
  40. package/tools/cli/lib/install-manifest.js +13 -6
  41. package/tools/cli/lib/installation-health.js +33 -1
  42. package/tools/cli/lib/installed-adapters.js +29 -6
  43. package/tools/cli/lib/memory-init.js +19 -4
  44. package/tools/cli/lib/packs.js +17 -28
  45. package/tools/cli/lib/path-hash.js +5 -1
  46. package/tools/cli/lib/python-provision.js +51 -12
  47. package/tools/cli/lib/stack-detect.js +51 -25
  48. package/tools/cli/lib/uat.js +18 -0
  49. package/tools/cli/lib/update-check.js +132 -34
  50. package/tools/cli/lib/update-dispatch.js +2 -2
  51. package/tools/cli/lib/update-policy.js +57 -19
  52. package/tools/cli/lib/update-transaction.js +439 -85
  53. package/tools/build/README.md +0 -78
  54. package/tools/build/check-counts.js +0 -626
  55. package/tools/build/check-install-contract.js +0 -648
  56. package/tools/build/generated-adapters/.codex/AGENTS.md +0 -134
  57. package/tools/build/generated-adapters/.cursor/rules/bmad-plus.mdc +0 -139
  58. package/tools/build/generated-adapters/.opencode/AGENTS.md +0 -134
  59. package/tools/build/generated-adapters/AGENTS.md +0 -132
  60. package/tools/build/generated-adapters/CLAUDE.md +0 -135
  61. package/tools/build/generated-adapters/CONVENTIONS.md +0 -134
  62. package/tools/build/generated-adapters/GEMINI.md +0 -139
  63. package/tools/build/generated-adapters/README.md +0 -79
  64. package/tools/maintain/upstream-candidate.js +0 -456
  65. package/tools/release/publication-content.js +0 -903
  66. package/tools/release/supply-chain.js +0 -282
@@ -1,652 +1,232 @@
1
- # 🚀 BMAD+ — Framework Multi-Agente IA Aumentado
2
-
3
- [![Version](https://img.shields.io/badge/version-0.16.0-blue.svg)](../CHANGELOG.md)
4
- [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
5
- [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
1
+ # BMAD+
6
2
 
7
3
  <div align="center">
8
4
  <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
5
  </div>
10
6
 
11
- > **Agentes multirrol · 9 packs modulares · Modo Autopilot · Ejecución paralela**
12
- > 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
-
14
- ---
15
-
16
- ## 📋 Tabla de contenidos
7
+ [![Version](https://img.shields.io/badge/version-0.17.1-blue)](https://www.npmjs.com/package/bmad-plus)
17
8
 
18
- Validación del repositorio: **1254 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.
9
+ **Versión 0.17.1** · Node.js `>=20.0.0` · MIT
19
10
 
20
- 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. La versión 0.15.0 añade 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/).
11
+ Flujos de desarrollo con IA propios de cada proyecto, con roles claros, contexto compartido, actualizaciones seguras y adaptadores para herramientas de programación.
21
12
 
22
- - [¿Por qué BMAD+?](#-por-qué-bmad-)
23
- - [Inicio Rápido](#-inicio-rápido)
24
- - [Arquitectura](#-arquitectura)
25
- - [Los 47 Agentes](#los-47-agentes)
26
- - [Sistema de Packs](#-sistema-de-packs)
27
- - [Innovaciones](#-innovaciones)
28
- - [IDE Soportados](#-ide-soportados)
29
- - [Monitorización Upstream](#-monitorización-upstream)
30
- - [Estructura del Proyecto](#-estructura-del-proyecto)
31
- - [Configuración](#-configuración)
32
- - [Historial de Versiones](#-historial-de-versiones)
33
- - [Licencia](#-licencia)
13
+ [Sitio web](https://bmad-plus.rochetta.fr/es/) · [Empezar](https://bmad-plus.rochetta.fr/es/docs/#start) · [Ejemplos](https://bmad-plus.rochetta.fr/es/docs/#examples) · [Novedades](https://bmad-plus.rochetta.fr/es/docs/#news)
34
14
 
35
- ---
15
+ BMAD+ instala instrucciones de proyecto, roles y flujos de trabajo para la herramienta de programación con IA que ya utilizas. Por defecto, la ejecución la gestiona el anfitrión: tu herramienta aporta el modelo, los permisos, la ejecución de comandos y, si existe, la capacidad de agentes en paralelo. Nexus también puede lanzar un comando local o un proceso de Codex CLI planificado explícitamente bajo un supervisor en primer plano, registrar su resultado y exigir comprobaciones independientes antes de aceptarlo. Los permisos del anfitrión siguen aplicándose; no hay planificador en segundo plano ni integración universal con el ciclo de vida del anfitrión. Las suscripciones a modelos y el acceso a las API son independientes.
36
16
 
37
- ## 💡 ¿Por qué BMAD+?
17
+ Adaptadores: Claude Code, Gemini CLI, Antigravity, Cursor, Codex CLI, OpenCode, Aider.
38
18
 
39
- BMAD-METHOD es un excelente framework con 9 agentes especializados. Pero para un desarrollador en solitario o un equipo pequeño, 9 agentes está demasiado fragmentado. BMAD+ resuelve este problema:
19
+ ## Empezar
40
20
 
41
- | BMAD-METHOD | BMAD+ |
42
- |---|---|
43
- | 9 agentes especializados | **47 agentes** en 9 packs |
44
- | Activación manual únicamente | **Auto-activación inteligente** en 3 niveles |
45
- | Sin pipeline automatizado | **Modo Autopilot**: idea → entrega |
46
- | Ejecución secuencial | **Paralelismo supervisado** |
47
- | Sin seguimiento upstream | **Monitorización semanal** con WhatsApp |
48
- | 1-2 IDEs soportados | **7 IDEs** con auto-detección |
21
+ Requiere Node.js `>=20.0.0`. Algunos paquetes opcionales pueden necesitar otros entornos de ejecución o acceso a API. Ejecuta los comandos de terminal desde la carpeta de tu proyecto.
49
22
 
50
- ---
23
+ ### 1. Abrir la carpeta del proyecto
51
24
 
52
- ## ⚡ Inicio Rápido
25
+ Abre una terminal en el repositorio en el que quieres trabajar y comprueba la versión de Node.js. Mantén tu flujo habitual de control de versiones.
53
26
 
54
- ### Instalación en un proyecto existente
27
+ **En la terminal del proyecto:**
55
28
 
56
- ```bash
57
- npx bmad-plus install
29
+ ```sh
30
+ node --version
58
31
  ```
59
32
 
60
- El instalador:
61
- 1. Detecta automáticamente los IDE instalados (Claude Code, Gemini CLI, Codex, etc.)
62
- 2. Ofrece los packs a instalar (Core, OSINT, Maker, Audit)
63
- 3. Genera los archivos de configuración adaptados
64
- 4. Crea las carpetas de artefactos
33
+ La salida debe indicar v20 o posterior. Instala o actualiza Node.js por separado si hace falta.
65
34
 
66
- ### Uso después de la instalación
35
+ ### 2. Instalar BMAD+ y elegir herramientas
67
36
 
68
- #### 💬 ¿Con quién hablar?
37
+ Ejecuta el instalador. Selecciona los adaptadores de tus herramientas de IA y los packs que necesita tu proyecto. Core incluye Atlas, Forge, Sentinel y Nexus.
69
38
 
70
- **📊 Estrategia & Descubrimiento**
39
+ **En la terminal del proyecto:**
71
40
 
72
- | Quieres... | Habla con | Ejemplo |
73
- |---|---|---|
74
- | Brainstorming de una idea | **Atlas** 🎯 | `Atlas, tengo una idea de proyecto: un SaaS de facturación` |
75
- | Investigación de mercado/dominio | **Atlas** 🎯 | `Atlas, analiza el mercado de apps de notas con IA` |
76
- | Crear un PRD / Product Brief | **Atlas** 🎯 | `Atlas, crea el PRD para mi proyecto` |
77
- | Diseñar wireframes UX | **Atlas** 🎯 | `Atlas, diseña la UX del flujo de onboarding` |
41
+ ```sh
42
+ npx bmad-plus@0.17.1 install
43
+ ```
78
44
 
79
- **🏗️ Arquitectura & Desarrollo**
45
+ El instalador crea las instrucciones de los agentes, la base compartida y los adaptadores seleccionados. Algunos packs opcionales necesitan otros entornos o acceso a API.
80
46
 
81
- | Quieres... | Habla con | Ejemplo |
82
- |---|---|---|
83
- | Diseñar arquitectura técnica | **Forge** 🏗️ | `Forge, propón una arquitectura para la app` |
84
- | Implementar una user story | **Forge** 🏗️ | `Forge, implementa la historia AUTH-001` |
85
- | Escribir/actualizar documentación | **Forge** 🏗️ | `Forge, documenta la API` |
86
- | Hotfix rápido o cambio pequeño | **Forge** 🏗️ | `Forge, quick dev: agrega un spinner de carga` |
47
+ ### 3. Iniciar una sesión en la misma carpeta
87
48
 
88
- **🔍 Calidad & Revisión**
49
+ Abre o reinicia tu asistente de programación con IA en este proyecto para que cargue su adaptador y AGENTS.md. Pídele los agentes y flujos instalados.
89
50
 
90
- | Quieres... | Habla con | Ejemplo |
91
- |---|---|---|
92
- | Revisión de código | **Sentinel** 🔍 | `Sentinel, revisa el módulo auth` |
93
- | Escribir tests (unit/E2E) | **Sentinel** 🔍 | `Sentinel, escribe tests E2E para el checkout` |
94
- | Auditoría UX / accesibilidad | **Sentinel** 🔍 | `Sentinel, revisa la UX del dashboard` |
51
+ **En tu asistente de IA:**
95
52
 
96
- **🎼 Gestión de Proyecto**
53
+ ```text
54
+ bmad-help
55
+ ```
97
56
 
98
- | Quieres... | Habla con | Ejemplo |
99
- |---|---|---|
100
- | Planificar un sprint | **Nexus** 🎼 | `Nexus, crea épicas e historias para el MVP` |
101
- | Automatizar todo (A a Z) | **Nexus** 🎼 | `autopilot` luego describe tu proyecto |
102
- | Ejecutar tareas en paralelo | **Nexus** 🎼 | `parallel` — detecta auto tareas independientes |
103
- | Retrospectiva de sprint | **Nexus** 🎼 | `Nexus, ejecuta una retro del Sprint 3` |
57
+ No hay un comando adicional de inicialización de BMAD+. bmad-help es un mensaje para el asistente, no un comando de terminal.
104
58
 
105
- **🕵️ Inteligencia & Packs Especializados**
59
+ ### 4. Asignar una tarea concreta a un rol
106
60
 
107
- | Quieres... | Habla con | Ejemplo |
108
- |---|---|---|
109
- | Investigar a una persona (OSINT) | **Shadow** 🕵️ | `Shadow, investiga a John Doe` |
110
- | Crear un nuevo agente BMAD+ | **Maker** 🧬 | `Maker, crea un agente de soporte al cliente` |
111
- | Recordar decisiones pasadas | **Zecher** 🧠 | `Zecher, ¿qué decidimos sobre la estrategia de auth?` |
112
- | Resumen de sesión (handoff) | **Zecher** 🧠 | `Zecher, crea un handoff para la próxima sesión` |
61
+ Describe tu objetivo, las restricciones y el resultado esperado. Para una idea nueva, empieza con Atlas. Para modificar código existente, empieza con Forge.
113
62
 
114
- #### 🚀 Flujo de trabajo típico (modo manual)
63
+ **En tu asistente de IA:**
115
64
 
65
+ ```text
66
+ Atlas, ayúdame a definir una pequeña aplicación de facturación para autónomos. Pregunta por los usuarios, identifica el primer flujo útil y redacta un brief con criterios de aceptación.
116
67
  ```
117
- 1. "Atlas, haz una lluvia de ideas sobre mi [proyecto]"
118
- → Atlas analiza, hace preguntas, propone enfoques
119
-
120
- 2. "Atlas, crea el product brief"
121
- → Entregable: _bmad-output/discovery/product-brief.md
122
68
 
123
- 3. "Atlas, redacta el PRD"
124
- → Entregable: _bmad-output/discovery/prd.md
69
+ Revisa el brief antes de pedir a Forge que implemente una historia. Un entregable concreto facilita comprobar el progreso.
125
70
 
126
- 4. "Forge, propón la arquitectura"
127
- → Entregable: _bmad-output/discovery/architecture.md
71
+ ### 5. Revisar el resultado y guardar el contexto
128
72
 
129
- 5. "Nexus, divide en épicas e historias"
130
- → Entregable: _bmad-output/build/stories/
131
-
132
- 6. "Forge, implementa la historia [X]"
133
- → Código generado + pruebas
134
-
135
- 7. "Sentinel, prueba y revisa"
136
- → Informe de QA + sugerencias
137
- ```
73
+ Pide a Sentinel que compruebe el cambio según los criterios de aceptación. Solicita resultados de pruebas y un breve resumen para continuar en otra sesión.
138
74
 
139
- #### ⚡ Flujo de trabajo automático (modo autopilot)
75
+ **En tu asistente de IA:**
140
76
 
77
+ ```text
78
+ Sentinel, revisa este cambio según los criterios de aceptación. Comprueba los principales casos de éxito y fallo, informa de los problemas pendientes y resume lo que necesita saber la próxima sesión.
141
79
  ```
142
- > autopilot
143
- > "Un SaaS de facturación para pymes con gestión de presupuestos"
144
- ```
145
-
146
- Nexus orquesta todo automáticamente con puntos de control (checkpoints) para tu aprobación.
147
80
 
148
- #### 💬 Comandos clave
81
+ Lee los cambios y los resultados de las pruebas. El asistente sigue los permisos y las capacidades de su herramienta anfitriona.
149
82
 
150
- | Comando | Descripción |
151
- |----------|-------------|
152
- | `bmad-help` | Ver todos los agentes y habilidades disponibles |
153
- | `autopilot` | Nexus toma el control del pipeline completo |
154
- | `parallel` | Iniciar ejecución multi-agente en paralelo |
83
+ ## Roles principales
155
84
 
85
+ | Rol | Ámbito | Propósito |
86
+ | --- | --- | --- |
87
+ | Atlas | Estrategia y producto | Decidir qué merece la pena construir. |
88
+ | Forge | Arquitectura y desarrollo | Convertir el plan en algo concreto. |
89
+ | Sentinel | Calidad y revisión | Encontrar lo que pasó desapercibido. |
90
+ | Nexus | Planificación y coordinación | Hacer que el trabajo avance en conjunto. |
156
91
 
157
- #### 🔧 Comandos CLI
92
+ ## Paquetes
158
93
 
159
- | Comando | Descripción |
160
- |---------|-------------|
161
- | `npx bmad-plus install` | Instalador interactivo con selección de packs y detección IDE |
162
- | `npx bmad-plus scan [ruta]` | Descubrir e indexar proyectos en el cerebro global |
163
- | `npx bmad-plus memory status` | Informe de salud de memoria (proyecto + cerebro global) |
164
- | `npx bmad-plus memory export` | Exportar cerebro como archivo Markdown portable |
165
- | `npx bmad-plus doctor` | Verificar integridad de la instalación |
166
- | `node tools/cli/bmad-plus-cli.js doctor --json` | Repositorio fuente: informe de inventario y capacidades de solo lectura (próxima versión) |
167
- | `npx bmad-plus update` | Actualizar agentes y skills (preserva la config) |
168
- | `npx bmad-plus uninstall` | Eliminar BMAD+ del proyecto actual |
169
- | `npx bmad-plus autoconfig` | Bootstrap inteligente — detección auto, instalación y configuración |
170
- | `npx bmad-plus uat <action>` | Aceptación humana: lint, build, serve, import, read, gate, order (alias `recette`) |
94
+ | Paquete | Qué aporta |
95
+ | --- | --- |
96
+ | Core | Estrategia, arquitectura, desarrollo, calidad y coordinación con los cuatro roles principales. |
97
+ | OSINT | Flujos de investigación para recopilar información pública y evaluar las fuentes. |
98
+ | Maker | Un flujo para diseñar, validar y distribuir tus propios agentes BMAD+. |
99
+ | Shield | Flujos especializados de cumplimiento y gobernanza, incluidos RGPD e ISO 27001. |
100
+ | SEO | Inspección técnica, análisis de contenido y optimización para buscadores con herramientas de apoyo. |
101
+ | Memory | Notas del proyecto, registro de decisiones y traspasos entre sesiones para conservar el contexto útil. |
102
+ | Dev Studio | Roles y flujos especializados en producto, diseño, ingeniería y documentación. |
103
+ | Backup | Instrucciones y utilidades para copias con fecha, restauración y rotación. |
104
+ | Animated | Un flujo centrado en crear sitios cuyo desplazamiento utiliza vídeo. |
171
105
 
172
- #### Actualizaciones del framework
106
+ ## Ejemplos
173
107
 
174
- 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.
108
+ ### Convertir una idea en una primera versión
175
109
 
176
- Para instalaciones con 0.12.2 o anterior, carga una vez el nuevo CLI con `npx --yes bmad-plus@0.16.0 update --yes`. Esta migración explícita guarda copias de seguridad antes de reemplazar los archivos antiguos.
110
+ Úsalo después de describir los usuarios y el problema.
177
111
 
178
- ```bash
179
- npx bmad-plus update-check --json
180
- npx bmad-plus update --latest --yes
181
- npx bmad-plus update-policy --mode auto --range "^0.16.0"
182
- npx bmad-plus update --latest --auto
183
- npx bmad-plus update-check --offline --json
112
+ ```text
113
+ Nexus, planifica la primera versión utilizable de mi aplicación de reservas. Pide a Atlas que defina el alcance, a Forge que proponga la implementación mínima y a Sentinel que defina las comprobaciones de aceptación. Enumera las dependencias y detente en la revisión del plan antes de implementar.
184
114
  ```
185
115
 
186
- El modo predeterminado solo avisa. Para desactivar las comprobaciones: `update-policy --mode off`. Se conservan los agentes y adaptadores personalizados; los conflictos bloquean el modo automático. Las instalaciones antiguas sin huellas requieren una migración manual explícita con copias de seguridad. Cada actualización muestra un identificador; utiliza `update --restore <receipt-id> --yes` para restaurarla y vuelve a cargar las instrucciones.
187
-
188
- #### 🔬 Opciones de instalación avanzadas
116
+ Resultado esperado: un plan priorizado, una primera historia pequeña y puntos de revisión explícitos.
189
117
 
190
- ```bash
191
- # Instalación no-interactiva — todos los packs, auto-detección IDE
192
- npx bmad-plus install --packs all --yes
118
+ ### Corregir un error en un proyecto existente
193
119
 
194
- # Instalar sin sobrescribir configs IDE (CLAUDE.md, GEMINI.md, etc.)
195
- npx bmad-plus install --tools none
120
+ Incluye el comportamiento observado, los pasos para reproducirlo y los mensajes de error relevantes.
196
121
 
197
- # Instalar packs específicos
198
- npx bmad-plus install --packs core,memory,osint
199
-
200
- # Instalar en otro directorio
201
- npx bmad-plus install --directory /ruta/al/proyecto
122
+ ```text
123
+ Forge, investiga por qué guardar una factura editada crea un duplicado. Reproduce el problema, localiza la causa y propone la corrección mínima. Añade una prueba de regresión que cubra el fallo real y pide a Sentinel que revise el flujo afectado.
202
124
  ```
203
125
 
204
- > **💡 Consejo dogfooding:** Usa `--tools none` cuando BMAD+ se instala en un proyecto que ya tiene configs IDE manuales. Instala agentes, skills y memoria sin sobrescribir tus `CLAUDE.md`, `GEMINI.md` o `AGENTS.md`.
205
-
206
- #### 🔍 Opciones de scan
207
-
208
- ```bash
209
- # Escanear un disco o directorio
210
- npx bmad-plus scan D:\DEV
126
+ Resultado esperado: un fallo reproducido, una corrección concreta y evidencia de cobertura de la regresión.
211
127
 
212
- # Umbrales personalizados para el estado del proyecto
213
- npx bmad-plus scan . --active-days 7 --paused-days 90
128
+ ### Coordinar trabajo independiente
214
129
 
215
- # Auto-indexar todo sin confirmación
216
- npx bmad-plus scan D:\DEV --yes --depth 6
217
- ```
218
-
219
- > Leyenda de estados: 🟢 **activo** (modificado < 30 días), 🟡 **en pausa** (30–180 días), ⚪ **archivado** (> 180 días). Umbrales personalizables con `--active-days` y `--paused-days`.
220
-
221
- ---
130
+ Úsalo cuando tu herramienta admita agentes en paralelo y las tareas no escriban en los mismos archivos.
222
131
 
223
- ## 🏗️ Arquitectura
224
-
225
- ```mermaid
226
- graph TB
227
- subgraph Core["⚙️ Core Pack"]
228
- AT["Atlas 🎯"]
229
- FG["Forge 🏗️"]
230
- SN["Sentinel 🔍"]
231
- NX["Nexus 🎼"]
232
- end
233
-
234
- subgraph Packs["📦 Modular Packs"]
235
- SH["Shadow 🕵️ OSINT"]
236
- MK["Maker 🧬"]
237
- ZC["Zecher 🧠 Memory"]
238
- SD["Shield 🛡️ GRC 27 agents"]
239
- DS["Dev Studio 🏗️ SDLC 6 agents"]
240
- SEO["SEO Engine 🔎 3 agents"]
241
- BK["Backup 🗂️"]
242
- AN["Animated 🎬"]
243
- end
244
-
245
- subgraph Skills["⚡ Core Skills"]
246
- AP[Autopilot]
247
- PL[Parallel]
248
- end
249
-
250
- NX -->|orchestrates| AT
251
- NX -->|orchestrates| FG
252
- NX -->|orchestrates| SN
253
- NX -->|invokes| SH
254
- NX -->|invokes| MK
255
- NX --> AP
256
- NX --> PL
257
- ZC -.->|context| NX
132
+ ```text
133
+ Nexus, divide el trabajo aprobado en tareas independientes. Asigna a cada rol un alcance, archivos a su cargo y una definición de terminado. Usa agentes en paralelo solo si esta herramienta lo permite; si no, ejecuta las tareas en secuencia. Integra los resultados y pide a Sentinel que compruebe todo el recorrido del usuario.
258
134
  ```
259
135
 
260
- ---
261
-
262
- ## 🎭 Los 47 Agentes
263
-
264
- ### Atlas — Strategist 🎯
265
-
266
- **Fusiona:** Analyst (Mary) + Product Manager (John)
267
-
268
- | Rol | Especialidad | Auto-activación |
269
- |------|-----------|-----------------|
270
- | **Analyst** | Investigación de mercado, FODA, benchmarks | "analiza", "mercado", "benchmark", nuevo proyecto |
271
- | **Product Manager** | PRD, product briefs, historias de usuario, roadmaps | "PRD", "roadmap", "MVP", fase de planificación |
272
-
273
- **Capacidades:** Brainstorming (BP), Market Research (MR), Domain Research (DR), Technical Research (TR), Product Brief (CB), PRD (PR), UX Design (CU), Document Project (DP)
274
-
275
- ---
276
-
277
- ### Forge — Architect-Dev 🏗️
278
-
279
- **Fusiona:** Architect (Winston) + Developer (Amelia) + Tech Writer (Paige)
280
-
281
- | Rol | Especialidad | Auto-activación |
282
- |------|-----------|-----------------|
283
- | **Architect** | Diseño técnico, API, escalabilidad, elección de stack | "arquitectura", "API", "schema", +5 archivos modificados |
284
- | **Developer** | Implementación TDD, revisión de código, historias | "implementa", "código", "fix", post-arquitectura |
285
- | **Tech Writer** | Documentación, diagramas Mermaid, changelogs | "documenta", "README", post-implementación |
286
-
287
- **Capacidades:** Architecture (CA), Implementation Readiness (IR), Dev Story (DS), Code Review (CR), Quick Spec (QS), Quick Dev (QD), Document Project (DP)
288
-
289
- **Acciones críticas (rol Dev):**
290
- - Leer TODA la historia ANTES de implementar
291
- - Ejecutar las tareas EN ORDEN
292
- - 100% pruebas aprobadas ANTES de avanzar
293
- - NUNCA mentir sobre las pruebas
294
-
295
- ---
296
-
297
- ### Sentinel — Quality 🔍
298
-
299
- **Fusiona:** QA Engineer (Quinn) + UX Designer (Sally)
300
-
301
- | Rol | Especialidad | Auto-activación |
302
- |------|-----------|-----------------|
303
- | **QA Engineer** | Pruebas API/E2E, edge cases, cobertura, revisión de código | "prueba", "QA", "bug", post-implementación |
304
- | **UX Reviewer** | Evaluación de UX, accesibilidad, diseño de interacción | "UX", "interfaz", "responsive", cambios frontend |
305
-
306
- **Capacidades:** QA Tests (QA), Code Review (CR), UX Design (CU), Recette build (RB), Recette read (RR), Recette gate (RG)
307
-
308
- ---
309
-
310
- ### Nexus — Orchestrator 🎼
311
-
312
- **Fusiona:** Scrum Master (Bob) + Quick-Flow Solo Dev (Barry) + **Autopilot** (nuevo) + **Parallel Supervisor** (nuevo)
313
-
314
- | Rol | Especialidad | Auto-activación |
315
- |------|-----------|-----------------|
316
- | **Scrum Master** | Planificación de sprints, historias, retrospectivas | "sprint", "planificación", "backlog" |
317
- | **Quick Flow** | Specs rápidas, hotfixes, mínima ceremonia | "rápido", "hotfix", "pequeño fix" |
318
- | **Autopilot** | Pipeline automatizado idea→entrega con checkpoints | "autopilot", "gestiona todo", modo autopilot |
319
- | **Parallel Supervisor** | Múltiples agentes en concurrencia, reasignación | "paralelo", tareas independientes detectadas |
320
-
321
- **Capacidades:** Sprint Planning (SP), Create Story (CS), Epics & Stories (ES), Retrospective (ER), Course Correction (CC), Sprint Status (SS), Quick Spec (QS), Quick Dev (QD), **Autopilot (AP)**, **Parallel (PL)**
322
-
323
- ---
324
-
325
- ### Shadow — OSINT Intelligence 🔍 *(Pack OSINT)*
326
-
327
- **Agente completo de investigación OSINT.**
328
-
329
- | Capacidad | Descripción |
330
- |-----------|-------------|
331
- | **INV** | Investigación completa Fase 0→6 con informe puntuado |
332
- | **QS** | Búsqueda rápida multi-motor |
333
- | **LI/IG/FB** | Scraping de LinkedIn, Instagram, Facebook |
334
- | **PP** | Psicoperfil MBTI / Big Five |
335
- | **CE** | Enriquecimiento de contactos (email, teléfono) |
336
- | **DG** | Diagnóstico de herramientas/APIs disponibles |
337
-
338
- **Tecnología:** MÁS de 55 actores de Apify, 7 APIs de búsqueda, python estándar 100%, grados A/B/C/D
339
-
340
- ---
341
-
342
- ### Maker — Agent Creator 🧬 *(Pack Maker)*
343
-
344
- **Meta-agente que crea otros agentes.** Dale una descripción → genera un paquete completo.
345
-
346
- | Capacidad | Descripción |
347
- |------|-------------|
348
- | **CA** | Create Agent — creación guiada en 4 fases |
349
- | **QA** | Quick Agent — creación rápida con valores por defecto con sentido |
350
- | **EA** | Edit Agent — modificar un SKILL.md existente |
351
- | **VA** | Validate Agent — verificar cumplimiento BMAD+ |
352
- | **PA** | Package Agent — generar carpeta de integración |
353
-
354
- **Pipeline:** Discovery → Design (aprobación del usuario) → Generación → Validación
355
- **Salida:** `_bmad-output/ready-to-integrate/` — listo para copiar a BMAD+
356
-
357
- ---
358
-
359
- ### Zecher — Guardián de la Memoria 🧠 *(Pack Memory)*
360
-
361
- **Agente de memoria persistente cross-session.** Mantiene el conocimiento del proyecto entre conversaciones.
136
+ Resultado esperado: tareas delimitadas, dependencias explícitas y una revisión integrada. La herramienta anfitriona proporciona la ejecución en paralelo.
362
137
 
363
- | Capacidad | Descripción |
364
- |-----------|-------------|
365
- | **Session Handoff** | Crea automáticamente resúmenes de sesión con decisiones, patrones y lecciones |
366
- | **Context Recall** | Recupera decisiones/patrones relevantes al inicio de cada conversación |
367
- | **Brain Health** | Monitorea la integridad de los archivos de memoria y detecta obsolescencia |
368
- | **Cross-Project** | Vincula la memoria del proyecto al cerebro global (`~/.bmad-plus/brain/`) |
369
- | **Karpathy Guardrails** | Previene memorias alucinadas — cada entrada necesita evidencia fuente |
138
+ ### Hacer que una persona confirme una entrega
370
139
 
371
- **Archivos de memoria:** `decisions.md`, `lessons.md`, `patterns.md`, `context.md`, `sessions/`
140
+ Úselo cuando una versión llegue a su entorno de pruebas y alguien deba comprobarla en pantalla.
372
141
 
373
- ## 📦 Sistema de Packs
374
-
375
- BMAD+ utiliza un sistema modular por packs. El Core siempre está instalado, y los demás packs son opcionales.
376
-
377
- ```
378
- npx bmad-plus install
379
-
380
- 🎛️ ¿Qué packs instalar?
381
- Core (Atlas, Forge, Sentinel, Nexus) siempre incluido.
382
-
383
- 🔍 OSINT — Shadow (investigación, scraping, psicoperfil)
384
- 🧬 Agent Creator — Maker (diseño, desarrollo, empaque)
385
- 🛡️ Shield GRC — 27 agentes de cumplimiento + 11 workflows (GDPR, ISO 27001, SOC 2, HIPAA...)
386
- 🏗️ Dev Studio — 6 agentes SDLC (ciclo de vida completo: diseño a despliegue)
387
- 🔎 SEO — Scout, Chief, Judge (auditoría 6 fases, PageSpeed)
388
- 🧠 Memory — Zecher (cerebro persistente, handoff sessions)
389
- 🗂️ Backup — Archivo inteligente con versionado
390
- 🎬 Animated — Sitios web animados scroll-driven
391
- 🤖 Instalar todo
392
- Ninguno — Solo Core
142
+ ```text
143
+ Sentinel, escribe la receta de aceptación de esta entrega en nuestro entorno de pruebas. Un paso por gesto, un hecho verificable por línea, las etiquetas citadas desde el código y marca los pasos que escriben de verdad. Construye la página y dime el enlace, cuánto dura y qué no debo saltarme. Usa datos de prueba desechables cuando sea posible, indica la carpeta y los archivos que modifica cada comando y distingue las evidencias automáticas de las respuestas de la persona.
393
144
  ```
394
145
 
395
- | Pack | Agentes | Descripción | Estado |
396
- |------|--------|-------------|--------|
397
- | ⚙️ **Core** | Atlas, Forge, Sentinel, Nexus | Ciclo de vida dev completo: estrategia → arquitectura → código → QA | ✅ Estable |
398
- | 🔍 **OSINT** | Shadow | Investigación, scraping social, psicoperfil (55+ actores Apify) | ✅ Estable |
399
- | 🧬 **Maker** | Maker | Diseñar, construir, validar y empaquetar nuevos agentes BMAD+ | ✅ Estable |
400
- | 🛡️ **Shield** | 27 agentes de cumplimiento + 11 workflows | GRC en 25+ frameworks: GDPR, ISO 27001, SOC 2, HIPAA, PCI DSS, EU AI Act, DORA, NIS2 | ✅ Estable |
401
- | 🏗️ **Dev Studio** | 6 agentes specialized SDLC | SDLC completo: brainstorm → PRD → arquitectura → TDD → review (38 workflows) | ✅ Estable |
402
- | 🔍 **SEO** | Scout, Chief, Judge | Auditoría SEO 6 fases, bucle PageSpeed, APIs Google, benchmark competitivo | ✅ Estable |
403
- | 🗂️ **Backup** | Backup Agent | ZIP con marca de tiempo y exclusiones inteligentes | ✅ Estable |
404
- | 🎬 **Animated** | Animated Website Agent | Sitio web lujoso scroll-driven desde video | ✅ Estable |
405
- | 🧠 **Memory** | Zecher | Cerebro cross-session, scanner de proyectos, guardrails Karpathy | ✅ Estable |
406
-
407
- Cada pack define:
408
- - Sus agentes, habilidades y workflows
409
- - Llaves de API obligatorias/opcionales
410
- - Paquete externo (si aplica)
411
- - Reglas de cohabitación con otros packs
412
-
413
- ---
414
-
415
- ## ✨ Innovaciones
416
-
417
- ### 1. Auto-Activación Inteligente a 3 Niveles
418
-
419
- Cada agente puede **automáticamente** cambiar de rol según el contexto:
420
-
421
- | Nivel | Mecanismo | Ejemplo |
422
- |--------|-----------|---------|
423
- | 🔤 **Patrón** | Palabras clave en el pedido | "revisa" → QA activado |
424
- | 🌐 **Contexto** | Detecta el tipo de tarea | Cálculos financieros detectados → QA auto-activado tras escribir código |
425
- | 🧠 **Razonamiento** | Cadena lógica | Inconsistencia de arquitectura → Architect auto-activado |
146
+ Resultado esperado: una página que una persona no técnica puede recorrer y una prueba que el agente relee para clasificar cada fallo antes de corregir nada.
426
147
 
427
- El agente **anuncia** el cambio: *"💡 I'm switching to QA mode — financial calculations detected. Say 'skip' to stay in current mode."*
148
+ ### Guardar una sesión con Zecher
428
149
 
429
- Configuración: `src/bmad-plus/data/role-triggers.yaml`
150
+ Úsalo antes de terminar una sesión, con el paquete opcional Memory instalado.
430
151
 
431
- ### 2. Modo Autopilot
432
-
433
- Introduce una idea → Nexus gestionará todo:
434
-
435
- ```
436
- 📋 Discovery (Atlas)
437
- └→ Brainstorming → Product Brief → PRD → UX Design
438
- 🔴 CHECKPOINT: Aprobación del PRD
439
-
440
- 🏗️ Build (Forge + Sentinel)
441
- └→ Arquitectura → Épicas → Historias → Sprint
442
- 🔴 CHECKPOINT: Aprobación de Arquitectura
443
- └→ Por historia: Código → Pruebas → (reintentos si falla, máximo 3)
444
- 🟡 NOTIFY: Estado de la historia
445
-
446
- 🚀 Ship (Sentinel + Forge)
447
- └→ Revisión de Código → UX → Documentación → Retrospectiva
448
- 🔴 CHECKPOINT: Aprobación final
152
+ ```text
153
+ Zecher, actualiza la memoria de este proyecto a partir de los cambios y comprobaciones realmente realizados. Distingue el trabajo implementado, probado, publicado y pendiente. Registra las decisiones y evidencias útiles, archiva las notas sustituidas sin borrarlas y escribe un breve prompt para la próxima sesión. Mantén la memoria en este proyecto y excluye los secretos.
449
154
  ```
450
155
 
451
- **Puntos de control (checkpoints) configurables:**
452
- Configura `execution_mode` y `checkpoints` en `_bmad/config.yaml` (`discovery`, `architecture`, `story`, `delivery`).
453
-
454
- - `require_approval` (🔴) — Mostrar el punto de control en la sesión y esperar; las notificaciones externas requieren un canal configurado y autorización.
455
- - `notify_only` (🟡) — Notifica, continúa (a menos que el usuario intervenga)
456
- - `auto` (🟢) — Totalmente automático
457
-
458
- ### 3. Ejecución Paralela Supervisada
459
-
460
- El orquestador divide las tareas asíncronas para ejecutarlas de forma paralela:
461
-
462
- | Proceso paralelo ✅ | Proceso secuencial 🚫 |
463
- |---|---|
464
- | Múltiples historias sin dependencia | Tareas en el mismo archivo |
465
- | Research + revisión técnica de arquitectura | Historia B depende de A |
466
- | Tests QA + documentación en docs | Arquitectura antes que el código |
467
-
468
- **Supervisión en ejecución:** Iniciar, Detener, Reiniciar, Escalar (si un agente falla más de 3 veces, avisa al desarrollador)
469
-
470
- ---
471
-
472
- ## 🖥️ IDE Soportados
473
-
474
- El instalador detecta automáticamente los IDE y genera sus adaptadores con una base de instrucciones común en `AGENTS.md`, en la raíz del proyecto:
156
+ Resultado esperado: un contexto actual conciso, un registro de sesión fechado y un prompt de reanudación que identifique la siguiente tarea pendiente.
475
157
 
476
- | IDE | Archivo de Config. | Detección |
477
- |-----|---------------|-----------|
478
- | Claude Code | `CLAUDE.md` | `.claude/` |
479
- | Gemini CLI | `GEMINI.md` | `.gemini/` |
480
- | Antigravity | `GEMINI.md` | `.gemini/antigravity/` |
481
- | Cursor | `.cursor/rules/bmad-plus.mdc` | `.cursor/` |
482
- | Codex CLI | `.codex/AGENTS.md` | `.codex/` |
483
- | OpenCode | `.opencode/AGENTS.md` | `.opencode/` |
484
- | Aider | `CONVENTIONS.md` | Archivo `.aider.conf.yml` |
158
+ ### Revisar una prueba sin adivinar
485
159
 
486
- Para Aider, añade `read: CONVENTIONS.md` a `.aider.conf.yml` o ejecuta `/read CONVENTIONS.md` para cargar las instrucciones generadas.
160
+ Úsalo cuando una persona haya terminado o interrumpido una prueba de aceptación.
487
161
 
488
- ---
489
-
490
- ## 📡 Monitorización Upstream
491
-
492
- ### Pipeline semanal (cron VPS, lunes 9 AM)
493
-
494
- ```
495
- 1. Obtiene actualizaciones del proyecto raíz BMAD-METHOD
496
- 2. Análisis "diff" sobre los archivos locales
497
- 3. Procesado por Inteligencia Artificial "Gemini API"
498
- 🟢 Compatible | 🟡 Revisar manualmente | 🔴 Incompatible o "Breaking Change"
499
- 4. Envía la actualización usando el WhatsApp registrado (Evolution API)
500
- 5. Auto-PR en GH
162
+ ```text
163
+ Sentinel, lee la última prueba de aceptación y compara su huella con la receta actual. Pregunta qué se hizo realmente cuando las respuestas y las evidencias no coincidan. Clasifica los fallos antes de proponer cambios, verifica los pasos de escritura en solo lectura y distingue las observaciones humanas, las comprobaciones automáticas y cualquier aceptación explícita de riesgo por su responsable identificado. Nunca apruebes un paso que no se realizó.
501
164
  ```
502
165
 
503
- ### Stack
504
- - **weekly-check.py** — Archivo base usado mediante cron semanal
505
- - **ai_analyzer.py** — LLM de análisis (Gemini 2.0 Flash)
506
- - **notifier.py** — WhatsApp (API Evolution auto-hosteado) / fallback a correo local
507
- - **mcp_bridge.py** — Acceso Server para las API operativas.
166
+ Resultado esperado: un veredicto claro, evidencias de las escrituras confirmadas y una lista breve de las comprobaciones pendientes.
508
167
 
509
- ---
168
+ ### Retomar sin perder decisiones
510
169
 
511
- ## 📁 Estructura del Proyecto
170
+ Úsalo al comenzar una sesión posterior en el mismo proyecto; no requiere ningún paquete opcional.
512
171
 
513
- ```
514
- BMAD+/
515
- ├── README.md ← Este archivo (Inglés)
516
- ├── readme-international/ ← Versiones traducidas (es, fr, de)
517
- ├── CHANGELOG.md ← Versiones de proyecto
518
- ├── CLAUDE.md ← Config IDE: Claude
519
- ├── GEMINI.md ← Config Gemini CLI / Antigravity
520
- ├── AGENTS.md ← Base de instrucciones común
521
- ├── .codex/AGENTS.md ← Adaptador Codex CLI
522
- ├── .opencode/AGENTS.md ← Adaptador OpenCode
523
- ├── .cursor/rules/bmad-plus.mdc ← Adaptador Cursor
524
- ├── CONVENTIONS.md ← Adaptador Aider
525
- ├── .gitignore
526
- │
527
- ├── src/
528
- │ └── bmad-plus/ ⭐ MODULO PERSONALIZADO
529
- │ ├── module.yaml ← Packs de entorno BMAD
530
- │ ├── module-help.csv ← Ayuda rápida base de datos
531
- │ ├── agents/
532
- │ │ ├── agent-strategist/ ← Atlas (analyst + pm)
533
- │ │ ├── agent-architect-dev/ ← Forge (architect + dev + tw)
534
- │ │ ├── agent-quality/ ← Sentinel (qa + ux)
535
- │ │ ├── agent-orchestrator/ ← Nexus (sm + qf + autopilot + parallel)
536
- │ │ ├── agent-maker/ ← Maker (meta-agente creativo) [pack: maker]
537
- │ │ └── agent-shadow/ ← Shadow (osint) [pack: osint]
538
- │ ├── skills/
539
- │ │ ├── bmad-plus-autopilot/ ← Orquestación completa
540
- │ │ ├── bmad-plus-parallel/ ← Supervisión concurrente
541
- │ │ └── bmad-plus-sync/ ← Sincronización automatizada código
542
- │ └── data/
543
- │ └── role-triggers.yaml ← Lógica de variables y keywords
544
- │
545
- ├── monitor/ 🤖 CONTROL PARA VPS DE CAMBIOS DE BMAD-METHOD
546
- │ ├── weekly-check.py ← Base Cron
547
- │ ├── ai_analyzer.py ← IA Análisis (Gemini API)
548
- │ ├── notifier.py ← WhatsApp (Evolution API) y correos
549
- │ ├── mcp_bridge.py ← Puerto de servidor
550
- │ ├── config.example.yaml ← Base de las contraseñas
551
- │ └── docker-compose.yml ← Config para arrancar Evolution API
552
- │
553
- ├── mcp-server/ 🛡️ AUDITOR / MCP BRIDGE
554
- │ ├── server.py ← Acceso general y de herramientas.
555
- │ └── tools/ ← git, github operations
556
- │
557
- ├── osint-agent-package/ 🔍 MODULO INDEPENDIENTE DE OSINT
558
- │ ├── agents/ ← Agente Shadow (version root)
559
- │ ├── skills/ ← Apify actores 55+
560
- │ └── install.ps1 ← Script de instalación
561
- │
562
- └── upstream/ 📦 CLONE ORIGINAL (EXCLUIDO DEL REGISTRO LOCAL)
563
- └── (BMAD-METHOD original)
172
+ ```text
173
+ Lee AGENTS.md y la memoria de proyecto disponible. Resume el último estado verificado, las decisiones abiertas y la siguiente tarea pendiente. Distingue las funciones publicadas de las candidatas locales, y las comprobaciones automáticas de la aceptación humana. Comprueba que las notas siguen coincidiendo con el código antes de continuar.
564
174
  ```
565
175
 
566
- ---
176
+ Resultado esperado: una reanudación breve y fundamentada. Las notas aportan contexto que debe contrastarse con el trabajo actual.
567
177
 
568
- ## ⚙️ Configuración Módulo Central
178
+ ## Novedades de la 0.17.1
569
179
 
570
- ### Archivo principal (`module.yaml`)
180
+ Instalaciones más seguras y actualizaciones más limpias
571
181
 
572
- | Variable | Descripción | Valores Disponibles |
573
- |----------|-------------|---------|
574
- | `project_name` | Nombre del proyecto | Autodetectado |
575
- | `user_skill_level` | Nivel del equipo/persona | beginner, intermediate, expert |
576
- | `execution_mode` | Modo de uso general | manual, autopilot, hybrid |
577
- | `auto_role_activation` | Cambio al predecir contexto | true, false |
578
- | `parallel_execution` | Trabajos Multiagente | true, false |
579
- | `install_packs` | Packs Seleccionados a Integrar | core, osint, maker, audit, all |
182
+ Instalar sobre otra versión ahora se detiene y remite a update, una reinstalación conserva tus ajustes y las actualizaciones eliminan los archivos que una versión ya no incluye, con una copia restaurable. Algunos comportamientos de instalación cambian: revisa tus scripts antes de volver a ejecutarlos.
580
183
 
581
- ### Integración Personalizada (Apikey/Hooks)
184
+ - install se niega a sobrescribir otra versión instalada. Volver a una versión anterior se rechaza; para pasar a una versión más reciente, ejecuta bmad-plus update, que conserva copias de seguridad y recibos restaurables. Reinstalar la misma versión solo añade los archivos que faltan.
185
+ - Una reinstalación conserva los ajustes de _bmad/config.yaml y solo añade los valores predeterminados que faltan. El manifiesto y la configuración se escriben de forma atómica.
186
+ - --packs y --tools se suman a la instalación anterior en lugar de sustituirla. Un identificador de paquete o de herramienta desconocido falla antes de escribir nada y muestra la lista de identificadores válidos.
187
+ - update elimina los archivos sin modificar que la nueva versión ya no incluye, los guarda en el recibo de actualización y los restaura con --restore. Los archivos que editaste se conservan y se indican.
188
+ - Un bloqueo de proyecto que dejó un proceso interrumpido se recupera automáticamente cuando consta que su proceso propietario ya no se ejecuta en esta máquina; doctor informa de los demás bloqueos caducados con la solución manual.
189
+ - Sin terminal, la instalación usa --lang, después el idioma del sistema y, por último, el inglés. --yes sin ninguna herramienta de IA detectada no escribe adaptadores. uninstall acepta -d/--directory.
190
+ - El paquete npm ya no incluye los scripts de publicación de los mantenedores. OSINT y Shield incluyen avisos legales y marcan el contenido generado por IA; Shadow se describe como investigación controlada en fuentes públicas.
191
+ - Los README traducidos reflejan el README público, que añade un aviso de no afiliación y una comparación basada en hechos. La web muestra el comando de instalación desde la portada y ofrece un tema oscuro.
582
192
 
583
- | KEY Sistema | Entorno / Pack | Actuación |
584
- |-----|------|-------|
585
- | `GEMINI_API_KEY` | Monitor | Comparación lógica de ramas Upstream |
586
- | `EVOLUTION_API_KEY` | Monitor | Sistema WhatsApp Notifier Server |
587
- | `APIFY_API_TOKEN` | OSINT | Extracción, Web Mining |
588
- | `PERPLEXITY_API_KEY` | OSINT | Buscador Complejo AI |
193
+ ## Historial de versiones
589
194
 
590
- ---
195
+ Estas fechas identifican las notas revisadas del CHANGELOG, no las fechas de publicación en npm. El sitio web verifica por separado las fechas de publicación en npm.
591
196
 
592
- ## 📜 Historial de Versiones
593
-
594
- | Versión | Fecha | Descripción |
595
- |---------|------|-------------|
596
- | **0.1.0** | 2026-03-17 | 🎉 Fundación base de proyecto (6 agentes / 3 entornos de skills / Auto-detección IDEs locales). Se incorporó el Maker y paquete OSINT |
597
- | **0.2.0** | 2026-03-18 | 🔀 Fusión Oveanet — 3 nuevos packs utilitarios: SEO Audit 360, Universal Backup, Animated Website |
598
- | **0.3.0** | 2026-03-19 | 🚀 SEO Engine v2.0 — 3 agentes multirrol, 4 scripts Python, flujo 6 fases, bucle PageSpeed, análisis GEO |
599
- | **0.4.0** | 2026-03-19 | 🏢 SEO Engine v2.1 — Orquestador SKILL.md, APIs Google, informes HTML, benchmark competitivo, 50 tests, extensiones GSC + GA4 |
600
- | **0.4.1** | 2026-03-19 | 🌐 CLI 10 idiomas, pipeline CI/CD, `.npmignore`, endurecimiento de seguridad |
601
- | **0.4.2** | 2026-03-19 | 📦 Packs públicos — SEO/Backup/Animated en npm |
602
- | **0.4.3** | 2026-05-17 | 🔧 Comandos update + doctor, i18n completa, corrección de créditos |
603
- | **0.4.4** | 2026-05-17 | 🔧 Corrección codificación UTF-8, i18n completa 10 idiomas, 62 tests unitarios |
604
- | **0.5.0** | 2026-05-17 | 🛡️ **Pack Shield** — 27 agentes de cumplimiento GRC + 11 workflows, 6 categorías, 25+ frameworks (GDPR, ISO 27001, SOC 2, EU AI Act...) |
605
- | **0.6.0** | 2026-05-17 | 🏗️ **Pack Dev Studio** — 6 agentes SDLC (Miriam, Yosef, Bezalel...) + 30 flujos de trabajo SDLC, BWML DSL |
606
- | **0.8.0** | 2026-06-24 | 🚀 **Aumentado** — 3 nuevos packs (animated, backup, seo), pase de remediación de seguridad, sync i18n |
607
- | **0.9.0** | 2026-06-24 | 🔒 **Seguro** — ciclo de remediación de auditoría, npm audit limpio, registro de packs compartido (`lib/packs.js`) |
608
- | **0.9.1** | 2026-07-01 | ✅ **Credibilidad** — CI real en push/PR, arnés Jest ESM reparado, config ESLint flat, badges falsos retirados |
609
- | **0.9.2** | 2026-07-01 | 🔐 **Seguridad** — RCE (allowlist ci_cd), SSRF, XSS almacenado/DOM, XXE, bumps CVE Python (~30 hallazgos) |
610
- | **0.10.0** | 2026-07-02 | 🧭 **Columna vertebral de plataforma** — SSOT `registry.yaml` (`packs.js` generado + gate anti-drift en CI), provisioning Python, fundaciones eval + memoria |
611
- | **0.11.0** | 2026-07-02 | 🧠 **Bucle Karpathy** — `bmad mem` recall/write/reinforce, generador de adapters multi-CLI, gate de base legal OSINT (CG-02) |
612
- | **0.12.0** | 2026-07-02 | 🏛️ **Load-bearing** — adapters raíz adoptados desde el registry, memoria vía MCP, gateway eval multi-proveedor; 333 tests |
613
- | **0.12.1** | 2026-07-12 | 🧩 **Cerebro portfolio** — fix de detección de cerebro memory-init, monitor migrado al SDK google-genai, sincronización de versión |
614
- | **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 |
615
- | **0.13.0** | 2026-09-08 | Actualizaciones controladas, agentes protegidos, copias restaurables e instalación derivada del registro; 709 tests |
616
- | **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 |
617
- | **0.15.0** | 2026-09-11 | Ejecucion Nexus persistente, memoria con evidencias, controles de paquetes y archivos verificados |
618
- | **0.16.0** | 2026-09-16 | Aceptacion humana: pagina recorrida por una persona, prueba releida, clasificacion y control con evidencias, diez idiomas |
619
-
620
- Más descripciones a fondo en el archivo: [CHANGELOG.md](../CHANGELOG.md).
197
+ | Versión | Fecha de las notas | Resumen revisado |
198
+ | --- | --- | --- |
199
+ | 0.17.1 | 2026-09-24 | Instalar sobre otra versión ahora se detiene y remite a update, una reinstalación conserva tus ajustes y las actualizaciones eliminan los archivos que una versión ya no incluye, con una copia restaurable. Algunos comportamientos de instalación cambian: revisa tus scripts antes de volver a ejecutarlos. |
200
+ | 0.17.0 | 2026-09-22 | Las páginas de aceptación evitan la pérdida silenciosa de respuestas y las exportaciones vacías. Las recetas se generan por su identificador y los controles de publicación usan Node directamente en Windows. Las guías añaden prompts para revisar resultados y conservar el contexto del proyecto. |
201
+ | 0.16.0 | 2026-09-16 | Una entrega produce ahora una página paso a paso que una persona recorre, y su prueba vuelve como evidencia que los agentes leen, clasifican y convierten en control. Esta versión incluye además lo que preparó la 0.15.0 sin llegar a publicarse: ejecución Nexus persistente, memoria clasificada por evidencias y controles puntuados de cada paquete. |
202
+ | 0.14.0 | 2026-09-09 | Dev Studio incorpora instrucciones completas y carga verificable del contexto; la documentación sigue al paquete publicado. |
621
203
 
622
- ---
204
+ [Historial de versiones y guía de actualización](https://bmad-plus.rochetta.fr/es/docs/#changelog) · [Todas las versiones publicadas en npm](https://www.npmjs.com/package/bmad-plus?activeTab=versions)
623
205
 
624
- ## 📄 Licencias Integradas
206
+ ---
625
207
 
626
- Proyecto BMAD+ (Adaptación: MIT)
208
+ ## Licencia
627
209
 
628
- Basado nativamente en el repositorio: [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (MIT LIC)
210
+ MIT — Basado en [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (MIT)
629
211
 
630
- BMAD+ es un derivado independiente, sin carácter oficial ni respaldo de BMad Code, LLC.
212
+ BMAD+ es un proyecto comunitario independiente derivado de BMAD-METHOD (MIT) de BMad Code, LLC. No está afiliado a BMad Code, LLC ni cuenta con su aprobación o certificación. BMad™ y BMad Method™ son marcas de BMad Code, LLC; consulta las [directrices de marca de BMad](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/TRADEMARK.md).
631
213
  Atribuciones y condiciones de las fuentes incluidas: [Avisos de terceros](../THIRD-PARTY-LICENSES.md).
632
214
 
633
- ### Reconocimientos
215
+ El paquete OSINT está regulado: investigar a una persona identificada exige una finalidad y una base jurídica registradas. Consulta el [aviso legal OSINT](../osint-agent-package/skills/bmad-osint-investigate/osint/references/gdpr-osint.md) (en inglés).
216
+
217
+ ### Créditos
634
218
 
635
219
  **Creador**
636
- - **BMAD+** Creado por [Laurent Rochetta](https://github.com/lrochetta) ([LinkedIn](https://www.linkedin.com/in/laurentrochetta/))
637
-
638
- **Packs Originales** (creados por Laurent Rochetta)
639
- - **Dev Studio** — 6 agentes SDLC especializados: Miriam (analista de negocios), Huldah (redactora técnica), Yosef (gerente de producto), Rachel (diseñadora UX), Bezalel (arquitecto de sistemas), Oholiab (ingeniero senior) — 38 workflows que cubren todo el ciclo de vida desde la lluvia de ideas hasta el despliegue
640
- - **SEO Engine** — 3 agentes (Scout, Chief, Judge), pipeline de auditoría de 6 fases, bucle PageSpeed, integraciones con Google Search Console y GA4
641
- - **Memory Pack** — Agente Zecher para cerebro persistente cross-session con escáner de proyectos
642
-
643
- **Fuentes Externas e Inspiraciones**
644
- - **BMAD-METHOD** por [bmad-code-org](https://github.com/bmad-code-org/BMAD-METHOD) — Metodología multi-agente original (MIT)
645
- - **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)
646
- - **OSINT Pipeline** basado en [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT)
647
- - **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)
648
- - **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)
649
-
650
- **Herramientas e Infraestructura**
651
- - [Evolution API](https://github.com/EvolutionAPI/evolution-api) — Notificaciones WhatsApp para monitoreo upstream
652
- - [Gemini API](https://ai.google.dev/) — Análisis IA para clasificación de cambios upstream
220
+ - **BMAD+** creado por [Laurent Rochetta](https://github.com/lrochetta) ([LinkedIn](https://www.linkedin.com/in/laurentrochetta/))
221
+
222
+ **Paquetes originales** (creados por Laurent Rochetta)
223
+ - **Dev Studio** — 6 agentes SDLC especializados: Miriam (analista de negocio), Huldah (redactora técnica), Yosef (product manager), Rachel (diseñadora UX), Bezalel (arquitecto de sistemas), Oholiab (ingeniero sénior) — 38 workflows que cubren todo el ciclo, de la lluvia de ideas al despliegue
224
+ - **SEO Engine** — 3 agentes (Scout, Chief, Judge), pipeline de auditoría en 6 fases, bucle de optimización PageSpeed, integraciones con Google Search Console y GA4
225
+ - **Memory Pack** — agente Zecher para una memoria persistente entre sesiones, con escáner de proyectos
226
+
227
+ **Fuentes externas e inspiraciones**
228
+ - **BMAD-METHOD** de [bmad-code-org](https://github.com/bmad-code-org/BMAD-METHOD) — metodología multiagente original (MIT)
229
+ - **Shield GRC** — 27 agentes de cumplimiento y 11 workflows adaptados de las [habilidades GRC de Hemant Naik](https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance) (MIT)
230
+ - **Pipeline OSINT** basado en [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT)
231
+ - **Integración con Apify** — asistente OSINT inspirado en las [habilidades de agente de Apify](https://github.com/apify/agent-skills) (el origen declara Apache-2.0; consulta los avisos)
232
+ - **Karpathy Guardrails** — adaptación para el Memory Pack de las [pautas comunitarias de forrestchang](https://github.com/multica-ai/andrej-karpathy-skills), inspiradas en Andrej Karpathy (MIT declarada en el origen)