Qué es BMAD+, qué hace cada pack y cada agente, todos los comandos y archivos, y guías paso a paso. Empieza por la guía rápida de abajo o elige un tema.
Versión publicada v0.23.1 · Documentación revisada
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
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.
01
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
node --version
La salida debe indicar v20 o posterior. Instala o actualiza Node.js por separado si hace falta.
02
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
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.
03
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
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.
04
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
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.
05
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
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
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
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.
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
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.
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
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.
Ejemplos avanzados: coordinación, aceptación y memoria
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
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
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
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.
Revisar una prueba sin adivinar
Úsalo cuando una persona haya terminado o interrumpido una prueba de aceptación.
En tu asistente de IA
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.
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.
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.
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
npx --no-install bmad-plus update --latest
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.
Avanzado: migración, comportamiento de las actualizaciones y política automática
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
npx --yes bmad-plus@0.23.1 update --yes
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
npx --no-install bmad-plus update-policy --mode auto --range "^0.23.1"
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.
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 ·
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.
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
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.
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.
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.
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.