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.
Esta página te lleva de la nada a un primer resultado que has revisado tú mismo, en un orden que funciona. Necesitas una carpeta de proyecto, Node.js 20 o superior y una herramienta de programación con IA que ya uses (Claude Code, Gemini CLI, Cursor, Codex CLI y otras). BMAD+ aporta las instrucciones, los roles y los workflows; tu herramienta aporta el modelo y los permisos para editar archivos y ejecutar comandos. Nada de esto requiere una cuenta de BMAD+, una clave de API propia ni un servicio en segundo plano.
BMAD+ en breveQué instala BMAD+, cómo un paquete pregunta antes de actuar, cómo se cuenta un enjambre con honestidad y los diez paquetes.Transcripción
BMAD+ instala roles, flujos de trabajo y contexto compartido en la herramienta de programación con IA que ya usas. Empieza preguntando: un paquete declara las preguntas que necesita ver respondidas antes de actuar. Respondes unas pocas cada vez, y lo que no sabes queda registrado como desconocido, con su riesgo. Después, Nexus puede lanzar un enjambre de subagentes, dentro de un presupuesto que tú fijas. Cada uno lee un brief y escribe una respuesta, y solo se cuentan las respuestas válidas. El recuento que ves es de demostración, y lo dice sin rodeos: las unidades simuladas no son personas. En el trabajo planificado, Nexus exige comprobaciones independientes antes de aceptar un resultado. Los cuatro roles de Core, nueve paquetes opcionales y adaptadores para siete herramientas de programación con IA. Se instala con un solo comando npx desde la carpeta de tu proyecto.
Los comandos que empiezan por npx bmad-plus van en un terminal. Frases como bmad-help, autopilot, parallel o «Atlas, ...» van en el chat de tu herramienta de IA. Escribir autopilot en un terminal no sirve de nada.
Abre un terminal en tu proyecto y comprueba Node.js
Usa el repositorio en el que quieres trabajar. El comando debe imprimir v20 o superior; instala o actualiza Node.js por separado si no es así.
En la terminal del proyecto
node --version
02
Ejecuta el instalador
El asistente interactivo pregunta tu idioma, los packs, las herramientas (si no se detecta ninguna), tu nombre, tu idioma de comunicación, la URL de un entorno de pruebas para las recetas de aceptación (opcional) y el modo de ejecución. Core siempre se instala. Las herramientas se detectan a partir de carpetas como .claude/ o .cursor/.
En la terminal del proyecto
npx bmad-plus@0.23.1 install
03
O instala sin preguntas
Para un script o una primera prueba, pasa cada ajuste por la línea de comandos. --yes se salta el asistente (inglés por defecto salvo que pases --lang); --tools acepta ids como claude-code, gemini-cli, antigravity, cursor, codex-cli, opencode, aider, o all o none.
El instalador termina con una breve guía de con quién hablar y una línea como «BMAD+ is ready! Talk to Atlas to get started». Con un id de pack o herramienta desconocido se detiene e imprime los ids válidos; sin terminal y sin --yes se niega a ejecutarse.
Lo que deja la instalación en un proyecto Git
$ npx bmad-plus install --yes --lang en --packs core --tools claude-code$ git status --short?? .agents/?? AGENTS.md?? CLAUDE.md?? _bmad/$ ls .agents/skillsagent-architect-devagent-orchestratoragent-qualityagent-strategistbmad-plus-autopilotbmad-plus-intakebmad-plus-parallelbmad-plus-swarmbmad-plus-syncbmad-plus-uat# Cuatro rutas nuevas, nada en tu árbol de código. Decide con tu equipo si las incluyes en el repositorio o las ignoras; en ambos casos, `_bmad/.bmad-plus-install.json` registra qué archivos son de BMAD+.
npx bmad-plus install --yes --lang en --packs core --tools claude-code
git status --short
ls .agents/skills
Salida capturada de una ejecución real. Fuente: Reproducido en un servidor de pruebas el 2026-10-18 con el código fuente 0.23.0 (tools/cli/bmad-plus-cli.js) en un proyecto Git desechable
El instalador no pone bmad-plus en el node_modules de tu proyecto, y los comandos npx --no-install que se usan a partir de aquí solo ejecutan una copia local: sin ella se detienen con npx canceled due to missing packages and no YES option. Esto añade una dependencia de desarrollo a package.json. Sáltate el paso si prefieres escribir npx bmad-plus <command>, que descarga el paquete cuando hace falta. Sin copia local, la comprobación de actualizaciones que los CLAUDE.md y AGENTS.md generados piden ejecutar a tu asistente simplemente se omite.
En la terminal del proyecto
npm install --save-dev bmad-plus
02
Ejecuta el diagnóstico
doctor es de solo lectura: nunca cambia el proyecto y nunca contacta con npm. Termina con una línea como «98/98 checks passed» y «0 error(s)» y sale con 1 si hay algún error.
En la terminal del proyecto
npx --no-install bmad-plus doctor
03
Abre tu herramienta de IA en la misma carpeta
Inicia una sesión nueva (o reinicia la herramienta) para que cargue su archivo de adaptador y AGENTS.md. No hay ningún comando de inicialización adicional de BMAD+.
04
Pregúntale qué sabe
En el chat, no en el terminal. Si lista a Atlas, Forge, Sentinel y Nexus, tu herramienta ha leído las instrucciones. Si no, comprueba que la herramienta está abierta en el proyecto instalado, que elegiste su adaptador y que existen AGENTS.md y .agents/skills/.
Elige lo más pequeño y real que necesites. Los cuatro agentes de Core cubren casi cualquier comienzo: Atlas para ideas y requisitos, Forge para arquitectura y código, Sentinel para revisión y pruebas, Nexus para planes y coordinación. Una buena petición da el objetivo, las restricciones y el resultado que quieres revisar.
Úsalo cuando todavía no hay código, o cuando quieres escribir el problema antes de cambiar nada.
En tu asistente de IA
Atlas, quiero una pequeña herramienta que permita a nuestro equipo de soporte clasificar las incidencias entrantes. Pregúntame por los usuarios y su flujo diario, y luego redacta un product brief con el primer flujo útil y criterios de aceptación que yo pueda comprobar. Una página como máximo.
Lo que deberías obtener Atlas puede mostrar primero su menú y esperar: responde con tu petición, o con el código de menú CB (crear un product brief). Después pregunta y escribe el brief bajo _bmad-output/; el nombre del archivo lo elige la habilidad, así que lee la ruta que indique. Lee el brief como el borrador de un colega: los criterios de aceptación deben poder comprobarse y cuanto no dijiste debe marcarse como suposición.
Úsalo para un cambio acotado. «Quick dev» es el camino de Forge con el mínimo de ceremonia; mantiene las comprobaciones proporcionadas y se salta el pipeline completo.
En tu asistente de IA
Forge, quick dev: añade un estado de carga a la lista de facturas. Enséñame qué archivos vas a tocar antes de editar, cambia solo esos, ejecuta las pruebas existentes que los cubren y dime exactamente qué ejecutaste y qué pasó.
Lo que deberías obtener Una lista corta de archivos, un diff pequeño y un informe de las comprobaciones que de verdad se ejecutaron. Si las pruebas no pudieron ejecutarse en el entorno del asistente, el informe lo dice en vez de anunciar un éxito.
Pide a Sentinel, otro rol, que compruebe lo que produjo Forge frente a los criterios de aceptación. Si la línea de comandos de BMAD+ está disponible, la revisión puede sellarse para que su veredicto se derive de la cobertura y no del tono: lista los archivos que debe leer, cita el código de cada hallazgo y termina con incomplete, findings o clean. La página de revisión de código explica esas tres palabras.
Úsalo justo después de un cambio, antes de hacer commit.
En tu asistente de IA
Sentinel, revisa este cambio frente a los criterios de aceptación del brief. Comprueba el camino de éxito y los principales caminos de fallo. Si la CLI de BMAD+ está disponible, sella primero el ámbito con bmad-plus review scope first-change --workspace, cita el código de cada hallazgo, contabiliza cada archivo seleccionado e informa de lo que responde bmad-plus review gate. Di lo que no pudiste comprobar.
Lo que deberías obtener Una revisión en _bmad-output/review/first-change/ que termina con un veredicto. incomplete significa que algún archivo no se contabilizó; findings lista lo que hay que corregir, cada punto con el código citado; clean significa ningún hallazgo abierto en un ámbito cubierto por completo, lo que no prueba que el código sea correcto.
Una sesión nueva empieza de cero. Sin el pack Memory, pide al asistente una breve nota de traspaso que guardes en el proyecto: lo hecho y verificado, lo pendiente, las decisiones y el siguiente paso. Con el pack Memory, Zecher se encarga y guarda decisiones, lecciones y traspasos en .agents/memory/. Puedes añadir el pack más tarde: volver a ejecutar el instalador con --packs core,memory solo añade lo que falta y conserva tu configuración.
En el terminal de tu proyecto, para añadir el pack Memory más tarde
Úsalo al final de una sesión de trabajo, con el pack Memory instalado. Sin el pack, quita el nombre «Zecher», dirígete a tu asistente y guarda la nota tú mismo.
En tu asistente de IA
Zecher, redacta un traspaso para la próxima sesión. Separa lo implementado, lo probado, lo que solo está planeado, las decisiones tomadas y por qué, las preguntas abiertas y el primer paso exacto a dar a continuación. Fechas en AAAA-MM-DD. No incluyas secretos.
Lo que deberías obtener Una nota fechada (con el pack Memory, .agents/memory/sessions/YYYY-MM-DD-<topic>.md y un context.md actualizado) que una sesión en frío puede leer en menos de un minuto y creer, porque separa lo hecho de lo planeado.
Por defecto BMAD+ solo avisa. update-check informa de las versiones instalada y publicada sin cambiar nada, y sin conexión dice desconocido en vez de adivinar. update-policy muestra o fija si las actualizaciones están en off, notify (por defecto) o auto (que exige un rango de versiones explícito). update sin opciones dice «Nothing to update» cuando la versión instalada es igual al paquete que lo ejecuta; update --latest consulta npm.
Leer el estado de las actualizaciones, sin conexión
$ npx --no-install bmad-plus update-check --offlineInstalled: 0.23.0; running: 0.23.0; channel latest: unknownunknown: offline$ npx --no-install bmad-plus update-policyUpdate policy: notify; channel=latest; range=none; prereleases=false$ npx --no-install bmad-plus update● Installed: v0.23.0 -> Executing package: v0.23.0◆ The installed version matches this executing package. Use --latest to check the registry.└ Nothing to update.
Salida capturada de una ejecución real. Fuente: Reproducido en un servidor de pruebas el 2026-10-18 con el código fuente 0.23.0 (tools/cli/bmad-plus-cli.js) en un proyecto Git desechable
Cuando una actualización se aplica, los archivos que editaste se conservan y se notifican, se escriben un recibo y copias de seguridad en .bmad/updates/, y update --restore <receipt-id> --yes la deshace. La guía de equipo y la página del ciclo de vida de la instalación dan los detalles.