# Documentación de BMAD+ — Inicio, ejemplos y versiones
> Instala BMAD+, inicia tu primer flujo de agentes, prueba prompts prácticos y mantén tu proyecto actualizado. Guía paso a paso e historial de versiones publicadas.
Canonical: https://bmad-plus.rochetta.fr/es/docs/
Language: es
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT
De la instalación al primer flujo de trabajo.
Empieza con una tarea pequeña en tu proyecto. Esta guía explica qué ejecutar en la terminal, qué pedir a tu asistente de IA y cómo mantener BMAD+ actualizado.
- [Empezar, paso a paso](#start)
- [Ejemplos para adaptar](#examples)
- [Comprobar y aplicar actualizaciones](#updates)
- [Novedades](#news)
- [Historial de versiones](#changelog)
- [Si tienes dudas](#help)
## Explorar por tema
- [Conceptos](https://bmad-plus.rochetta.fr/es/docs/concepts/): Qué es BMAD+ y las ideas que lo sostienen: agentes, skills, packs y memoria, y cómo encajan.
- [Cómo funciona BMAD+](https://bmad-plus.rochetta.fr/es/docs/concepts/how-bmad-plus-works/): Qué instala BMAD+ en tu proyecto, quién ejecuta qué y cómo una petición como «Atlas, ...» se convierte en archivos: ejecución en el anfitrión, columna AGENTS.md, packs, agentes, habilidades.
- [Intake: preguntar primero, actuar después](https://bmad-plus.rochetta.fr/es/docs/concepts/intake/): Por qué un pack pregunta antes de actuar, cómo un intake.yaml define sus preguntas campo a campo, cómo las respuestas reciben un estado y un design read completo con salida real.
- [Enjambres de subagentes](https://bmad-plus.rochetta.fr/es/docs/concepts/swarm/): Cuándo lanzar un panel, un jurado o una dispersión de subagentes, los cuatro archivos que los definen, el reparto con semilla, el presupuesto de 26, recuentos honestos y un panel de compradores real.
- [Nexus: autopilot, trabajo en paralelo y ejecuciones duraderas](https://bmad-plus.rochetta.fr/es/docs/concepts/nexus-orchestration/): Autopilot con puntos de control, trabajo paralelo supervisado, exportación de plan desde un enjambre y runtime duradero (create, start, launch, collect, verify, accept), adaptador Codex y límites.
- [Memoria: decisiones, lecciones y cerebro](https://bmad-plus.rochetta.fr/es/docs/concepts/how-memory-works/): Cómo BMAD+ guarda decisiones, lecciones y traspasos entre sesiones: memoria de proyecto, cerebro global o de cartera y su detección, Zecher, comandos mem y memory, y lo que nunca se sobrescribe.
- [Revisión de código y aceptación humana](https://bmad-plus.rochetta.fr/es/docs/concepts/code-review-and-acceptance/): Cómo review scope, anchor y gate hacen verificable una revisión, las reglas integradas y cómo una persona recorre una receta que se lee, clasifica y pasa por la puerta. Por qué una etiqueta la exige.
- [El registro y las habilidades](https://bmad-plus.rochetta.fr/es/docs/concepts/registry-and-skills/): registry.yaml como fuente única de verdad: campos de un pack, uses_skills, external_module, pipelines, intake, las comprobaciones, lo generado y cómo un equipo añade un agente o pack con Maker.
- [Packs](https://bmad-plus.rochetta.fr/es/docs/packs/): Qué aporta cada pack, a quién le sirve y cómo instalarlo.
- [Los diez packs: qué aporta cada uno y cómo elegir](https://bmad-plus.rochetta.fr/es/docs/packs/packs-overview/): Un pack es un grupo instalable de agentes y habilidades. Compara los diez packs de BMAD+ en una tabla, aprende a elegir, instalar, añadir y quitar, y cómo conviven los packs que se solapan.
- [Pack Core: Atlas, Forge, Sentinel y Nexus](https://bmad-plus.rochetta.fr/es/docs/packs/core/): El pack base obligatorio de BMAD+: cuatro agentes de la idea a la entrega revisada, seis habilidades compartidas, instalación, ocho prompts para copiar, salidas y límites.
- [Pack OSINT: Shadow, investigación en fuentes abiertas con gobernanza](https://bmad-plus.rochetta.fr/es/docs/packs/osint/): Shadow investiga en fuentes abiertas por fases, con puerta de base legal obligatoria para personas con nombre. Instalación, claves de API, presupuesto, siete prompts, salidas y límites.
- [Pack Maker: crea y empaqueta tus propios agentes](https://bmad-plus.rochetta.fr/es/docs/packs/maker/): Maker es un metaagente que diseña, valida y empaqueta nuevos agentes de BMAD+. Comando de instalación, las cuatro fases de creación, seis prompts, carpeta de salida y para qué sirve el paquete.
- [Pack Shield: 27 especialistas de cumplimiento y 11 workflows](https://bmad-plus.rochetta.fr/es/docs/packs/shield/): Shield dirige las consultas de cumplimiento a 27 especialistas de marcos y 11 workflows de RGPD y AI Act, y añade casos de aseguramiento, registro de IA y reglas de revisión. No es asesoría legal.
- [Pack SEO / GEO: auditar la visibilidad en buscadores y en respuestas de IA](https://bmad-plus.rochetta.fr/es/docs/packs/seo/): SEO / GEO: tres agentes auditan la visibilidad en buscadores y en respuestas generadas por IA (calidad del contenido, datos estructurados, preparación para IA) con 15 comandos. Instalación y límites.
- [Pack Memory: Zecher y el cerebro persistente](https://bmad-plus.rochetta.fr/es/docs/packs/memory-pack/): Zecher guarda decisiones, lecciones y traspasos de sesión en archivos simples entre sesiones y proyectos. Instalación, detección del cerebro, ocho ejemplos, salidas, comandos de la CLI y límites.
- [Pack Dev Studio: seis perfiles (personas) y 38 workflows](https://bmad-plus.rochetta.fr/es/docs/packs/dev-studio/): Dev Studio cubre el ciclo de vida del software con seis perfiles (personas) y 38 workflows con nombre, del brief a la revisión de código. Instalación, catálogo por fase, ejemplos, CLI studio, límites.
- [Pack Backup: copias ZIP con fecha, restauración y rotación](https://bmad-plus.rochetta.fr/es/docs/packs/backup/): Backup Manager comprime tu proyecto en ZIP con fecha, lista, restaura y rota los archivos con cuatro comandos slash. Instalación, cinco ejemplos, ubicaciones, exclusiones y lo que no cubre.
- [Pack Animated: convierte un MP4 en un sitio animado con el scroll](https://bmad-plus.rochetta.fr/es/docs/packs/animated/): El Animated Website Creator convierte un vídeo en una página guiada por el scroll en cinco pasos: análisis, extracción, seis secciones, construcción, vista previa. Requisitos, seis ejemplos y límites.
- [Pack Design: Atelier pregunta primero, luego construye, audita y rediseña](https://bmad-plus.rochetta.fr/es/docs/packs/design/): Atelier, motor de diseño de BMAD+: intake de 13 preguntas, luego construir, revisar o rediseñar con tres habilidades, evidencias etiquetadas, veredicto de pre-vuelo citado. Instalación, sesión real.
- [Agentes](https://bmad-plus.rochetta.fr/es/docs/agents/): Cada agente al detalle: su papel, cuándo llamarlo y las skills que trae.
- [Directorio de los 48 agentes](https://bmad-plus.rochetta.fr/es/docs/agents/agents-roster/): Los agentes de BMAD+ en un solo lugar: 15 puntos de entrada, 6 perfiles (personas) de Dev Studio y 27 especialistas de Shield, con su pack, rol y modo de llamarlos, enlazados a la página de su pack.
- [Cómo se activan los agentes: nombres, roles, disparadores y comandos de chat](https://bmad-plus.rochetta.fr/es/docs/agents/agents-activation/): Llama a un agente por su nombre, usa los códigos de menú, deja que los roles cambien con tres niveles de disparadores y usa bmad-help, autopilot y parallel. Qué comprobar si un agente calla.
- [Referencia](https://bmad-plus.rochetta.fr/es/docs/reference/): Cada comando, opción, archivo y ajuste, con la sintaxis exacta.
- [La línea de comandos, visión general](https://bmad-plus.rochetta.fr/es/docs/reference/cli-overview/): Cómo ejecutar bmad-plus, las opciones comunes a todos los comandos, los idiomas del instalador, el uso sin interacción con --yes y los códigos de salida que puedes usar en scripts y CI.
- [install](https://bmad-plus.rochetta.fr/es/docs/reference/cli-install/): Instalar los agentes, habilidades, archivos de instrucciones y la configuración de BMAD+ en un proyecto: cada opción, qué se escribe, cómo actúa una reinstalación, salida real y errores posibles.
- [update](https://bmad-plus.rochetta.fr/es/docs/reference/cli-update/): Llevar un proyecto instalado a una versión más reciente de BMAD+ con un plan, copias de seguridad y un recibo restaurable: opciones, qué se conserva, rechazos, recuperación y cada mensaje.
- [uninstall](https://bmad-plus.rochetta.fr/es/docs/reference/cli-uninstall/): Quitar de un proyecto lo que posee BMAD+ y conservar tu memoria, tus ajustes y los archivos editados o desconocidos: opciones, qué se borra, qué queda, salida real y mensajes posibles.
- [doctor](https://bmad-plus.rochetta.fr/es/docs/reference/cli-doctor/): Informe de salud de solo lectura: manifiesto, inventario de propiedad, archivos modificados, archivos de instrucciones, entornos. Opciones, códigos de comprobación, informe JSON, salida real.
- [update-check](https://bmad-plus.rochetta.fr/es/docs/reference/cli-update-check/): Preguntar a npm si existe una versión más reciente de BMAD+ y si tu política permitiría aplicarla, sin cambiar nada: opciones, estados, motivos, campos JSON, caché y modo sin conexión.
- [update-policy](https://bmad-plus.rochetta.fr/es/docs/reference/cli-update-policy/): Mostrar o fijar la política del proyecto que decide si BMAD+ busca actualizaciones y si alguna puede aplicarse sin ti: modos off, notify y auto, canal, rango, preversiones, el archivo y los errores.
- [autoconfig](https://bmad-plus.rochetta.fr/es/docs/reference/cli-autoconfig/): Prepara BMAD+ en un repositorio existente o una carpeta vacía: detecta el stack, puntúa la salud del proyecto, recomienda packs, los instala y siembra la memoria del proyecto.
- [scan](https://bmad-plus.rochetta.fr/es/docs/reference/cli-scan/): Recorre un árbol de carpetas, encuentra tus proyectos, detecta su stack y actividad, y los indexa en el cerebro global para que BMAD+ conozca todo tu portafolio.
- [bmad-plus memory](https://bmad-plus.rochetta.fr/es/docs/reference/cli-memory/): Consultar la salud de la memoria del proyecto y del cerebro global, y exportar el cerebro global a un único archivo Markdown. Opciones, lecturas y escrituras, salida, códigos de salida y errores.
- [bmad-plus mem](https://bmad-plus.rochetta.fr/es/docs/reference/cli-mem/): Recordar decisiones y eventos, anotar el trabajo de un agente, reforzar un patrón con señales de recompensa, vincular una lección a trabajo de Nexus aceptado. Opciones, salida, errores.
- [studio](https://bmad-plus.rochetta.fr/es/docs/reference/cli-studio/): Lista los workflows de Dev Studio y prepara un lote de contexto de solo lectura para uno de ellos, para que tu asistente lo ejecute con las instrucciones exactas incluidas en tu proyecto.
- [bmad-plus intake](https://bmad-plus.rochetta.fr/es/docs/reference/cli-intake/): Valida el cuestionario de un pack, planifica las siguientes preguntas, registra las respuestas con su estado y redacta el brief. Opciones, códigos de salida, salida real y errores.
- [bmad-plus swarm](https://bmad-plus.rochetta.fr/es/docs/reference/cli-swarm/): Repartir, preparar briefs, comprobar, archivar y contar un enjambre de subagentes con presupuesto: panel, jurado o dispersión. Opciones, aprobación con código 2, honestidad, salida real y errores.
- [nexus](https://bmad-plus.rochetta.fr/es/docs/reference/cli-nexus/): Ejecuciones de tareas duraderas: un plan de tareas con alcances de escritura disjuntos, intentos recuperables tras una interrupción, verificación independiente y una aceptación aparte.
- [bmad-plus uat](https://bmad-plus.rochetta.fr/es/docs/reference/cli-uat/): Referencia de bmad-plus uat (alias recette): lint, build, serve, import, read, gate y order para las recetas de aceptación humana, con opciones, códigos de salida y ejemplos.
- [bmad-plus review](https://bmad-plus.rochetta.fr/es/docs/reference/cli-review/): Referencia de bmad-plus review: sellar el alcance, anclar los hallazgos en el código, derivar un veredicto de la cobertura, reanudar, comparar y listar reglas, con opciones y códigos de salida.
- [assurance](https://bmad-plus.rochetta.fr/es/docs/reference/cli-assurance/): Construir un caso de aseguramiento de seguridad: afirmaciones respaldadas solo por comprobaciones realmente ejecutadas, registradas en un diario encadenado y verificadas en un commit.
- [ai-register](https://bmad-plus.rochetta.fr/es/docs/reference/cli-ai-register/): Llevar un registro de las herramientas de IA de tu proyecto, sus datos, base legal y transferencias, y dejar que una comprobación blanda avise de toda integración de IA que el registro omita.
- [Archivo de configuración](https://bmad-plus.rochetta.fr/es/docs/reference/config-yaml/): Cada clave de _bmad/config.yaml: modo de ejecución, los cuatro puntos de control, el bloque uat y el presupuesto del enjambre. Valores por defecto, quién lee cada una y su efecto.
- [Adaptadores](https://bmad-plus.rochetta.fr/es/docs/reference/adapters/): Las siete herramientas de IA que BMAD+ prepara: el archivo que se escribe para cada una, cómo se detecta, la columna común AGENTS.md y cómo install y update protegen tus propias instrucciones.
- [Estructura del proyecto](https://bmad-plus.rochetta.fr/es/docs/reference/project-layout/): Cada carpeta y archivo que BMAD+ crea en un proyecto y en tu máquina, qué comando lo crea y si es tuyo para editar, gestionado por BMAD+ o un estado que conviene no tocar.
- [Guías](https://bmad-plus.rochetta.fr/es/docs/guides/): Recorridos paso a paso para las tareas habituales, de la instalación a las actualizaciones.
- [Tu primera hora con BMAD+](https://bmad-plus.rochetta.fr/es/docs/guides/first-hour/): Un recorrido para empezar, del terminal vacío a un primer resultado revisado: instalar, comprobar, hablar con un agente, revisar, conservar el contexto y mantenerse al día, con el comando real.
- [Instalar, actualizar, desinstalar](https://bmad-plus.rochetta.fr/es/docs/guides/install-lifecycle/): Toda la vida de BMAD+ en un proyecto: instalar, comprobar, actualizar con política y recibos, restaurar, desinstalar conservando tu memoria. Qué escribe y quita cada paso, y cómo actúa sin conexión.
- [Tutorial: de una idea a un enjambre](https://bmad-plus.rochetta.fr/es/docs/guides/idea-to-swarm/): Recorrido completo con salida real: instalar, Atelier pregunta primero, brief, panel simulado con presupuesto, recuento honesto y desinstalación conservando la memoria.
- [Caso práctico: comprobar lo que los agentes dan por terminado](https://bmad-plus.rochetta.fr/es/docs/guides/case-study-rebuild-the-site/): Una revisión calificó de falsas 11 afirmaciones en lo que escribieron 39 agentes en menos de doce horas, y los revisores se equivocaron dos veces. Mira cómo y repite los cinco comandos.
- [Usar BMAD+ en equipo](https://bmad-plus.rochetta.fr/es/docs/guides/for-teams/): Qué versionar y qué dejar en local, qué ajustes acordar, un adaptador por compañero sobre una columna común, una política de actualización segura, puertas de CI e incorporación.
- [Recetario](https://bmad-plus.rochetta.fr/es/docs/guides/recipes-cookbook/): Prompts y comandos listos para copiar para los agentes de Core y cada pack, con lo que hacen de verdad: Atlas, Forge, Sentinel, Nexus, Shadow, Zecher, SEO, Shield, Dev Studio, Atelier, la CLI.
- [Seguridad y datos](https://bmad-plus.rochetta.fr/es/docs/security/): Qué se queda en tu equipo, qué puede salir de él y cómo comprobarlo.
- [Tratamiento de datos y privacidad](https://bmad-plus.rochetta.fr/es/docs/security/data-handling/): Ni telemetría ni autoactualización silenciosa. Los once flujos del paquete npm que pueden enviar datos fuera de tu máquina: qué, a quién, cuándo, con qué consentimiento, y lo que se queda en local.
- [Confianza, propiedad y licencias](https://bmad-plus.rochetta.fr/es/docs/security/trust-and-ownership/): Quién escribió qué, qué licencias, qué archivos posee BMAD+ en tu proyecto y cómo lo demuestra, qué conservan actualización y desinstalación, cómo se regula OSINT y dónde están los avisos.
- [Preguntas y soluciones](https://bmad-plus.rochetta.fr/es/docs/faq/): Respuestas breves a lo que preguntan quienes empiezan, y qué hacer cuando algo falla.
- [Preguntas frecuentes](https://bmad-plus.rochetta.fr/es/docs/faq/faq/): Treinta y cuatro respuestas a lo que preguntan los recién llegados: qué es BMAD+, instalación, actualización, agentes y autopilot, enjambres, revisiones y recetas, datos y legalidad, memoria, equipos.
- [Solución de problemas](https://bmad-plus.rochetta.fr/es/docs/faq/troubleshooting/): Síntoma, causa y solución para los fallos reales de BMAD+: instalaciones y actualizaciones rechazadas, bloqueos obsoletos, errores de doctor, instrucciones obsoletas, enjambres por aprobar.
- [Glosario](https://bmad-plus.rochetta.fr/es/docs/faq/glossary/): Cada término de la documentación de BMAD+ en palabras sencillas, por tema: anfitrión, pack, habilidad, intake, enjambre, semilla, puerta, recibo, receta y estados.
## Empezar, paso a paso
Necesitas Node.js 20 o posterior y tu herramienta habitual de programación con IA. BMAD+ aporta instrucciones, roles y flujos; tu herramienta aporta el modelo y los permisos de ejecución.
### 1. Abrir la carpeta del proyecto
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.
**En la terminal del proyecto**
```sh
node --version
```
La salida debe indicar v20 o posterior. Instala o actualiza Node.js por separado si hace falta.
### 2. Instalar BMAD+ y elegir herramientas
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.
**En la terminal del proyecto**
```sh
npx bmad-plus@0.23.1 install
```
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.
### 3. Iniciar una sesión en la misma carpeta
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.
**En tu asistente de IA**
```text
bmad-help
```
No hay un comando adicional de inicialización de BMAD+. bmad-help es un mensaje para el asistente, no un comando de terminal.
### 4. Asignar una tarea concreta a un rol
Describe tu objetivo, las restricciones y el resultado esperado. Para una idea nueva, empieza con Atlas. Para modificar código existente, empieza con Forge.
**En tu asistente de IA**
```text
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.
```
Revisa el brief antes de pedir a Forge que implemente una historia. Un entregable concreto facilita comprobar el progreso.
### 5. Revisar el resultado y guardar el contexto
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.
**En tu asistente de IA**
```text
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. Si el CLI de BMAD+ está disponible, sella el alcance con bmad-plus review scope, aplica las reglas de su lista de revisión, cita el código de cada hallazgo, da cuenta de cada archivo seleccionado y comunica lo que responde bmad-plus review gate.
```
Lee los cambios y los resultados de las pruebas. El asistente sigue los permisos y las capacidades de su herramienta anfitriona.
## Ejemplos para adaptar
Sustituye los detalles por los de tu proyecto. Estos puntos de partida especifican un resultado que podrás revisar.
### Convertir una idea en una primera versión
Úsalo después de describir los usuarios y el problema.
**En tu asistente de IA**
```text
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.
```
Resultado esperado: un plan priorizado, una primera historia pequeña y puntos de revisión explícitos.
### Corregir un error en un proyecto existente
Incluye el comportamiento observado, los pasos para reproducirlo y los mensajes de error relevantes.
**En tu asistente de IA**
```text
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.
```
Resultado esperado: un fallo reproducido, una corrección concreta y evidencia de cobertura de la regresión.
### Coordinar trabajo independiente
Úsalo cuando tu herramienta admita agentes en paralelo y las tareas no escriban en los mismos archivos.
**En tu asistente de IA**
```text
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.
```
Resultado esperado: tareas delimitadas, dependencias explícitas y una revisión integrada. La herramienta anfitriona proporciona la ejecución en paralelo.
### Hacer que una persona confirme una entrega
Úselo cuando una versión llegue a su entorno de pruebas y alguien deba comprobarla en pantalla.
**En tu asistente de IA**
```text
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. Antes de entregarme la página, constrúyela con uat build, comprueba las garantías que enumera, recorre tú mismo el paso esencial en un navegador real —empezar, marcar, escribir una observación, recargar, todo vuelve— y dime qué comprobaciones se ejecutaron.
```
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.
### Guardar una sesión con Zecher
Úsalo antes de terminar una sesión, con el paquete opcional Memory instalado.
**En tu asistente de IA**
```text
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.
```
Resultado esperado: un contexto actual conciso, un registro de sesión fechado y un prompt de reanudación que identifique la siguiente tarea pendiente.
### Diseñar una pantalla con Atelier
Úsalo con el paquete opcional Design instalado. Atelier hace primero sus preguntas y luego sigue reglas comprobables.
**En tu asistente de IA**
```text
Atelier, haz la lectura de diseño de la lista de facturas de mi aplicación, construye la pantalla y termina con el veredicto de la comprobación previa.
```
Resultado esperado: la lectura de diseño registrada, la pantalla con todos sus estados cubiertos y el veredicto de la comprobación previa citado como última línea.
### Revisar una prueba sin adivinar
Úsalo cuando una persona haya terminado o interrumpido una prueba de aceptación.
**En tu asistente de IA**
```text
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ó.
```
Resultado esperado: un veredicto claro, evidencias de las escrituras confirmadas y una lista breve de las comprobaciones pendientes.
### Retomar sin perder decisiones
Úsalo al comenzar una sesión posterior en el mismo proyecto; no requiere ningún paquete opcional.
**En tu asistente de IA**
```text
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.
```
Resultado esperado: una reanudación breve y fundamentada. Las notas aportan contexto que debe contrastarse con el trabajo actual.
## Comprobar y aplicar actualizaciones
Ejecuta estos comandos desde el proyecto instalado. Las comprobaciones usan una CLI ya disponible. Si npx --no-install no la encuentra, usa el comando con versión explícita que aparece debajo.
### Comprobar la versión publicada
Compara la versión instalada con npm. El resultado incluye installedVersion, latestVersion, status, updateAvailable y canAutoApply.
**En la terminal del proyecto**
```sh
npx --no-install bmad-plus update-check --refresh --json
```
### Si falta la CLI o la instalación es antigua
Este comando explícito descarga la CLI documentada y comprueba tu proyecto. En la versión 0.12.2 o anterior, usa la migración del siguiente párrafo para añadir la detección de actualizaciones.
**En la terminal del proyecto**
```sh
npx bmad-plus@0.23.1 update-check --refresh --json
```
### Revisar y aplicar una actualización
Este comando consulta npm otra vez y solicita confirmación de la versión de destino exacta. Revisa el informe, incluidos los archivos personalizados conservados.
**En la terminal del proyecto**
```sh
npx --no-install bmad-plus update --latest
```
### Migrar desde la versión 0.12.2 o anterior
Usa una vez la CLI con versión explícita. Esta migración confirmada respalda los archivos reemplazados, porque las instalaciones antiguas no tienen hashes completos de propiedad.
**En la terminal del proyecto**
```sh
npx --yes bmad-plus@0.23.1 update --yes
```
- La notificación es el modo predeterminado. Comprobar una versión no activa las actualizaciones automáticas. Un resultado sin conexión, caducado o no disponible significa que se desconoce la última versión.
- Las actualizaciones conservan las personalizaciones identificadas. El informe puede indicar una aplicación parcial si se mantienen archivos locales; el número de versión no demuestra que todos los archivos coincidan.
- Tras una actualización correcta, pide al asistente que vuelva a leer AGENTS.md y las habilidades relevantes, o inicia una nueva sesión.
- Actualizar el paquete BMAD+ y sincronizar las fuentes de BMAD-METHOD son tareas distintas. Estos comandos actualizan BMAD+; no fusionan las fuentes originales en tu proyecto.
### Opcional: autorizar una actualización automática limitada
Actívala solo si quieres que el proyecto aplique versiones válidas dentro del rango semver indicado. La CLI sigue comprobando el entorno, la propiedad de los archivos y la política. Usa notify para volver a las notificaciones.
**En la terminal del proyecto**
```sh
npx --no-install bmad-plus update-policy --mode auto --range "^0.23.1"
```
**En la terminal del proyecto**
```sh
npx --no-install bmad-plus update-policy --mode notify
```
### Restaurar después de una actualización
Los recibos y las copias están en .bmad/updates/. Sustituye RECEIPT_ID por el identificador real del recibo. La restauración verifica las copias y rechaza sobrescribir cambios locales posteriores.
**En la terminal del proyecto**
```sh
npx --no-install bmad-plus update --restore RECEIPT_ID --yes
```
## Novedades
Estas notas describen la versión verificada en npm. La guía, el comando de instalación y el historial corresponden a esa misma publicación.
**v0.23.1** · 2026-10-20
El sitio de documentación se rehace en cuatro idiomas, con siete vídeos. Varios comandos se comportan ahora exactamente como dicen sus páginas: las negativas se leen igual en todas partes, una revisión del árbol de trabajo parte de HEAD y el archivo de configuración es YAML simple. Instalar y actualizar funcionan como antes.
[Historial de versiones](#release-0-23-1)
## Historial de versiones
Selección de versiones recientes con la fecha real de publicación en npm. Los resúmenes describen los cambios entregados en cada versión. La página del paquete incluye el historial completo.
### v0.23.1 — Un sitio más fiel, comandos más constantes
2026-10-20
El sitio de documentación se rehace en cuatro idiomas, con siete vídeos. Varios comandos se comportan ahora exactamente como dicen sus páginas: las negativas se leen igual en todas partes, una revisión del árbol de trabajo parte de HEAD y el archivo de configuración es YAML simple. Instalar y actualizar funcionan como antes.
- El sitio tiene ahora 52 páginas de documentación, cada una en inglés, francés, español y alemán, una landing rehecha y siete vídeos de presentación con subtítulos y transcripciones descritas, incluido un caso práctico de cómo se rehízo el propio sitio con un enjambre de agentes.
- Una actualización --auto que la política no permite se rechaza con el mismo mensaje en todas partes: Update refused: automatic-updates-not-authorized. Los rechazos por inventario de propiedad antiguo y por conflictos locales usan la misma forma Update refused:.
- bmad-plus review scope --workspace parte de HEAD cuando no das --base, así que revisar trabajo sin confirmar ya no falla ni arrastra el último commit.
- _bmad/config.yaml se escribe como YAML simple (auto_role_activation: true, no un !!bool 'true' con etiqueta), sea cual sea la versión compatible de js-yaml que lo escriba.
- Los archivos de instrucciones generados indican omitir la comprobación de versión, sin mencionarla, cuando npx no encuentra una copia local de bmad-plus; los errores de Nexus llevan el prefijo Nexus: una vez en lugar de dos.
- Shield nombra PCI DSS v4.0.1 en todas partes, las habilidades de swarm dicen que hay tres tipos, la variante Bash del paquete Backup muestra el tamaño del archivo como la de PowerShell, y la descripción de npm, las palabras clave y los créditos del README se actualizan.
[Paquete publicado · v0.23.1](https://www.npmjs.com/package/bmad-plus/v/0.23.1)
### v0.23.0 — Preguntar primero, luego el enjambre
2026-10-18
Un paquete declara ahora las preguntas que necesita respondidas antes de actuar, y Nexus puede lanzar un enjambre de subagentes, un panel simulado o un jurado, dentro de un presupuesto que tú fijas. Atelier, el motor de diseño, se incorpora como décimo paquete. Instalar y actualizar funcionan como antes.
- bmad-plus intake hace las preguntas de un paquete de pocas en pocas, marca las imprescindibles, propone valores por defecto, anota lo que no sabes con su riesgo y redacta el brief que se convierte en el contrato de todo lo que el paquete hace después. Nada en él se inventa.
- bmad-plus swarm reparte unidades simuladas a partir de un perfil con una semilla, escribe un brief por subagente, valida cada archivo de respuesta, cuenta solo las respuestas válidas y deja claro que los compradores simulados no son clientes. El bloque swarm de _bmad/config.yaml fija cuántos subagentes se lanzan antes de que el asistente te pregunte; la generación de medios de pago siempre pregunta.
- El registro anota ahora qué habilidades conduce un agente, de qué paquete npm proceden las habilidades de un paquete, qué pasos de pipeline y qué puertas declara y qué cuestionario ejecuta. Las instrucciones generadas lo recogen todo, así que nada se escribe dos veces.
- Paquete Design: Atelier, construido a partir del paquete design-skill, te entrevista con una lectura de diseño y luego construye, audita o rediseña una interfaz con reglas comprobables. El instalador copia sus tres habilidades con sus módulos de referencia, y doctor las comprueba.
- Una puerta de disparadores rechaza las reglas de activación automática que nombran un agente o un pipeline que el registro no conoce, y el instalador no escribe nada cuando los archivos de un paquete no pueden listarse todos primero.
[Paquete publicado · v0.23.0](https://www.npmjs.com/package/bmad-plus/v/0.23.0)
### v0.22.0 — Lo que sale de tu máquina, declarado y comprobado
2026-09-29
BMAD+ declara ahora cada envío de datos y cada proceso que inicia, y su CI rechaza todo lo que no esté declarado. La página de aceptación y el informe SEO ya no cargan nada de otros sitios, las llamadas OSINT van solo por HTTPS, y Shield incorpora un caso de seguridad basado en pruebas ejecutadas y un registro de tratamientos de IA. Nada cambia en la instalación ni en la actualización.
- El registro indica qué envía BMAD+, a quién, cuándo y con qué consentimiento; SECURITY.md lo muestra y las instrucciones instaladas para los agentes lo resumen. Una comprobación de build falla cuando una llamada de red o un proceso iniciado no está declarado. BMAD+ no tiene telemetría, y la comprobación de actualizaciones se puede desactivar.
- La página de aceptación ya no carga Google Fonts ni nada de otro sitio: abrirla no se lo comunica a nadie. El build rechaza una página que lo hiciera, y un navegador real controla cada petición de una ejecución. El informe HTML de SEO también se abre sin conexión.
- La clave de API de Google del pack SEO viaja en una cabecera de la petición, nunca en una URL, y no aparece en los mensajes de error. Las llamadas a proveedores OSINT rechazan todo lo que no sea HTTPS y nunca siguen una redirección a otro host.
- Las capturas de pantalla SEO solo alcanzan la dirección comprobada: Chromium no resuelve nada más, y las redirecciones o recursos que apuntan a otro lugar se bloquean y se enumeran.
- Shield: bmad-plus assurance construye un caso de seguridad cuyas pruebas solo pueden ser comprobaciones realmente ejecutadas, anotadas en un registro a prueba de manipulaciones; bmad-plus ai-register mantiene el registro de herramientas de IA de un proyecto y avisa de las que no figuran; seis reglas de revisión nombran los controles de cumplimiento que toca un cambio.
- El servidor MCP cierra limpiamente los flujos SSE cuando un cliente se va o el servidor se detiene, y acepta fechas de token con desfase horario.
[Paquete publicado · v0.22.0](https://www.npmjs.com/package/bmad-plus/v/0.22.0)
[Todas las versiones publicadas en npm](https://www.npmjs.com/package/bmad-plus?activeTab=versions)
## Si tienes dudas
### El asistente no ve mis agentes. ¿Qué debo comprobar?
Comprueba que esté abierto en el proyecto instalado, que hayas seleccionado su adaptador y que existan AGENTS.md y .agents/skills/. Abre una sesión nueva y pídele que lea las instrucciones. Cada herramienta tiene sus propias reglas de carga.
### ¿Debo escribir autopilot o parallel en la terminal?
No. bmad-help, autopilot y parallel son instrucciones de conversación para tu asistente de IA. Los comandos de terminal usan la CLI de BMAD+, como los ejemplos anteriores.
### La comprobación dice unknown u offline. ¿Estoy al día?
Ese resultado no permite conocer la última versión publicada. Sigue trabajando y repite la comprobación cuando el registro esté disponible. Una comprobación no disponible no autoriza cambiar la política de actualización.
[Código en GitHub](https://github.com/lrochetta/BMAD-PLUS)
[Paquete publicado](https://www.npmjs.com/package/bmad-plus)