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.
Versión publicada v0.13.0 · Documentación revisada
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.
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.
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.
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.
Retomar sin perder decisiones
Úsalo al comenzar una sesión posterior en el mismo proyecto.
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. 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.
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
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.
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
npx --no-install bmad-plus update-policy --mode auto --range "^0.13.0"
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.
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.13.0 ·
Actualizaciones que respetan tu proyecto
Descubre versiones publicadas, controla la política automática y conserva los archivos de agentes personalizados.
Las comprobaciones ofrecen JSON, actualización de metadatos y modo sin conexión, con notificación por defecto.
Los hashes de archivos, las copias y los recibos protegen las personalizaciones identificadas y permiten restaurar.
El instalador genera la base compartida y siete adaptadores a partir de las mismas definiciones.
La desinstalación conserva la memoria, los ajustes y el contenido modificado que no puede eliminarse con certeza.
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.