Cómo funciona BMAD+

Esta página explica la mecánica de una sola vez, para quien quiera saber qué ocurre tras npx bmad-plus install antes de confiarle un proyecto. BMAD+ no es un programa que ejecute tus agentes. Es un conjunto de archivos (instrucciones, roles, workflows) más una pequeña herramienta de línea de comandos que lleva registros. Tu herramienta de programación con IA, llamada anfitrión en estas páginas, lee los archivos y hace el trabajo con su propio modelo y sus propios permisos.

La ejecución la gestiona el anfitrión#

El registro lo establece como contrato: execution: host-managed, lifecycle_events: not-integrated. En la práctica son cuatro cosas. El anfitrión aporta el modelo, así que BMAD+ no guarda ninguna clave de API ni llama a ningún modelo. El anfitrión aporta los permisos: tu herramienta, no BMAD+, permite o rechaza una edición de archivo o un comando de shell. El anfitrión aporta los subagentes paralelos, si los hay. Y nada se ejecuta en segundo plano: no hay demonio, ni planificador, ni telemetría.

El vocabulario#

Lo que escribe el instalador#

La instalación copia archivos en tu proyecto y registra lo que copió. No toca tu código fuente y no inicia nada. La única escritura fuera del proyecto es el cerebro global del pack Memory, en tu carpeta personal (fila ~/.bmad-plus/brain/). La tabla lista las ubicaciones; las últimas filas solo aparecen cuando usas la función correspondiente.

$ npx bmad-plus install --yes --lang en --packs core,design,memory --tools claude-code
●  Selected packs: ⚙️ Core, 🧠 Memory, 🎨 Design
●  Detected IDEs: Claude Code
●  🧠 Global brain created: /home/dev/.bmad-plus/brain
◇  ✅ 6 agents, 9 skills, 5 files copied
◇  ✅ 1 IDE(s) configured
└  BMAD+ is ready! Talk to Atlas to get started 🚀
$ npx bmad-plus doctor
│  98/98 checks passed
│  0 error(s), 0 warning(s)
│  Installed: v0.23.0 | Executing CLI: v0.23.0
│  Ownership inventory: complete
│  Integrations use host-managed execution; host capabilities were not probed.
# Extracto: se omitió el recuadro de guía del instalador y las líneas vacías, y la carpeta personal está abreviada. Las cifras dependen de los packs que elijas. La línea del cerebro solo aparece si el pack Memory no encuentra ningún cerebro existente.

Qué se ejecuta dónde#

De una frase a archivos#

1. 01

   Escribes a tu anfitrión

   Te diriges a un agente por su nombre en el chat de tu herramienta de IA, en tu idioma.

   En la terminal del proyecto

   Atlas, help me define a small invoicing app for freelancers.

2. 02

   El anfitrión carga las instrucciones

   El anfitrión lee su archivo de adaptador, que remite a AGENTS.md. La columna nombra a Atlas y la carpeta de su SKILL.md. Leer ese archivo es lo que convierte a un asistente general en el perfil (persona).

3. 03

   Se leen los ajustes y Atlas espera

   El agente lee _bmad/config.yaml (tu idioma, el modo de ejecución, el comportamiento de los puntos de control), te saluda y muestra su menú de capacidades (por ejemplo CB para un product brief, MR para un estudio de mercado). Atlas espera tu elección: un número, un código o una frase que coincida con alguno.

4. 04

   Se elige un rol

   Atlas tiene dos roles, Analista (investigación, descubrimiento) y Product Manager (planificación, product briefs, PRD). Una palabra clave como «market» o «PRD», o una situación como un proyecto nuevo, cambia el rol, y el agente lo avisa. El modo de ejecución y los puntos de control deciden después si se detiene a preguntar o sigue.

5. 05

   Se escribe un entregable

   Una vez que eliges, por ejemplo CB para crear un product brief, el anfitrión escribe el resultado en el proyecto con sus propios permisos, normalmente en la carpeta de salida (_bmad-output/ por defecto). Lo revisas como cualquier otro archivo.

6. 06

   La CLI lleva los registros cuando hace falta

   Para intake, enjambres, revisiones o recetas de aceptación, el agente llama a bmad-plus para validar, contar o sellar evidencias. La CLI responde con archivos y códigos de salida, nunca con opiniones.

Cómo cambian los roles#

Las reglas están en .agents/data/role-triggers.yaml. Cada agente puede cambiar de rol en tres niveles y anuncia el cambio para que puedas rechazarlo.

El aviso es del estilo «I’m switching to QA mode - financial calculations detected. Say ’skip’ to stay in current mode.» Poner auto_role_activation: false en _bmad/config.yaml desactiva el cambio automático; aun así puedes pedir un rol por su nombre.

Ajustes y modos de ejecución#

El instalador escribe _bmad/config.yaml una vez y conserva tus cambios en instalaciones posteriores. execution_mode es manual por defecto: llamas tú a cada agente. autopilot deja que Nexus ejecute el pipeline completo; hybrid es autopilot con puntos de control frecuentes. Cada punto de control (discovery, architecture, story, delivery) es require_approval, notify_only o auto.

execution_mode: 'manual'
auto_role_activation: true
parallel_execution: true
checkpoints:
  discovery: 'require_approval'
  architecture: 'require_approval'
  story: 'require_approval'
  delivery: 'require_approval'
uat:
  mode: 'advisory'
swarm:
  budget: 26
  wave: 10
  media_credits: 'ask'

Archivos generados y tus cambios#

La columna y los adaptadores se generan a partir de registry.yaml en el repositorio fuente de BMAD+, de modo que las cifras y las listas no pueden desviarse de las declaraciones. En tu proyecto puedes añadir tus propias reglas a un adaptador. El instalador registra un hash SHA-256 por cada archivo que escribe; un adaptador o una habilidad cuyo hash ya no coincide se trata como tuyo y las actualizaciones y la desinstalación lo conservan.

Lo que BMAD+ no hace a propósito#

• Sin runtime de modelo: no llama a ninguna API de LLM, no guarda ninguna clave para usar una y no ejecuta ningún bucle de agente propio.
• Sin procesos en segundo plano: ni demonio, ni planificador, ni exportador de telemetría, ni autoactualización silenciosa.
• Sin motor de revisión que adivine: los hallazgos que el código no permite anclar se notifican como tales, nunca los reubica un modelo.
• Sin corrección automática a partir de una revisión: una revisión no concede permiso de escritura y la aceptación humana sigue siendo la puerta de entrega.
• Sin extensión de IDE y sin publicar en GitHub, GitLab u otras forjas.