Cómo se activan los agentes: nombres, roles, disparadores y comandos de chat
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.
Instalar BMAD+ escribe los agentes en tu proyecto; activar uno es simplemente hablar con tu herramienta de programación con IA. No hay ningún proceso que iniciar. Dices el nombre de un agente, tu herramienta carga sus instrucciones y el agente te saluda y trabaja. Esta página explica las formas de llamar a un agente, cómo cambia de rol por sí mismo (y cómo evitarlo), qué hacen las palabras de chat bmad-help, autopilot y parallel, y qué comprobar cuando nada responde.
Por su nombre, seguido de la tarea: Atlas, analiza el mercado de las aplicaciones de notas con IA. El nombre puede abrir cualquier frase; un nombre de perfil (persona) también vale (Miriam, Oholiab, Atelier).
Por código de menú, tras llamar al agente: cada agente muestra un menú con códigos de dos letras (PR para un PRD con Atlas, CA para una arquitectura con Forge, RG para la puerta de aceptación con Sentinel, AP para el autopilot con Nexus). Vale un código, un número de línea o una descripción cercana, y el agente invoca la capacidad por su nombre registrado en lugar de inventar una.
Por palabra de comando en los packs que definen alguna: /seo … (SEO / GEO) y /design … (Design) se escriben en el chat y los enruta la habilidad del pack; tu herramienta no los registra como comandos slash, así que una petición normal también funciona. /backup, /backup-list, /backup-restore y /backup-clean son las cuatro entradas del menú de Backup Manager. El pack Animated no tiene ninguna: describe la tarea, por ejemplo animated website from hero.mp4.
Por identificador de workflow de Dev Studio: nombra el perfil (persona) y el workflow (Yosef, validate-prd sobre docs/prd.md). Cada workflow responde también a bmad-<id> y bmad-plus-<id>.
En la primera llamada, un agente lee _bmad/config.yaml para tu nombre, tu idioma de comunicación, el modo de ejecución y los dos interruptores de abajo, carga un project-context.md y los disparadores de rol si los encuentra, te saluda en tu idioma y muestra su menú. Atlas, Shadow y Maker se detienen entonces y esperan tu elección; con ellos, repite la tarea o elige un código de menú si solo vuelve el menú. Forge, Sentinel, Nexus y Atelier continúan cuando tu petición ya es clara, como en los ejemplos de abajo, porque un saludo no es una segunda confirmación; solo esperan una elección si los llamaste sin tarea.
Forge, investiga por qué guardar una factura editada crea un duplicado. Reproduce el problema, rastrea la causa y propón la corrección mínima.
Lo que deberías obtener Forge responde en tu idioma de comunicación y trabaja como Developer o Architect según la formulación. Informa del fallo reproducido, la causa y una corrección acotada, y distingue las comprobaciones fallidas, omitidas y no ejecutadas.
Los códigos son propios de cada agente: las mismas dos letras pueden significar cosas distintas según el agente (CA crea una arquitectura en Forge y un agente en Maker; QA genera pruebas en Sentinel y crea un agente rápido en Maker).
En tu asistente de IA
Sentinel, RG
Lo que deberías obtener Sentinel ejecuta la capacidad que hay tras RG: calcular la puerta de aceptación de la receta humana y emitir su verificador para Nexus. Responde passed, failed, awaiting o stale, con los motivos, y nunca da por pasado un paso no realizado.
La mayoría de los agentes tienen varios roles. Atlas es Analyst y Product Manager; Forge, Architect, Developer y Tech Writer; Sentinel, QA Engineer, UX Reviewer y un rol Recette (aceptación humana); Nexus, Scrum Master, Quick Flow, Autopilot Controller y Parallel Supervisor. Cuando auto_role_activation es true (por defecto), el agente cambia de rol por sí mismo si la conversación encaja con otro, y antes lo dice: «I’m switching to [Role] mode — [reason]. Say skip to stay in current mode.» Responde skip y se queda. También puedes pedir un rol explícitamente.
La palabra architecture lleva a Forge a su rol Architect
2, contextos
Situaciones detectadas durante el trabajo
Un cambio que toca más de cinco archivos (multi_file_change_gt_5) pide el rol Architect; una versión candidata en un entorno de pruebas pide el rol Recette de Sentinel
3, razonamiento
Descubrimientos hechos al ejecutar
Al programar surge un problema de arquitectura (implementation_exposes_architectural_issue) y vuelve el rol Architect
Palabras clave típicas por agente, de role-triggers.yaml
Agente
Rol por defecto
Roles y palabras clave típicas
Atlas
pm
analyst: analyze, research, market, benchmark, SWOT, stakeholder; pm: PRD, product brief, roadmap, MVP, user story
qa: test, review, bug, edge case, coverage; ux-review: UX, responsive, accessibility, usability; uat: recette, UAT, acceptance test, what should I check
Nexus
scrum-master
scrum-master: sprint, story, backlog, epic; quick-flow: quick, hotfix, simple, patch; autopilot: autopilot, full pipeline, from scratch; parallel-supervisor: parallel, concurrent, batch
SEO Scout, Chief, Judge
seo-chief
seo-chief: SEO, SERP, meta tags; seo-scout: crawl, sitemap, robots.txt, core web vitals; seo-judge: E-E-A-T, PageSpeed, CrUX, quality gate
Atelier
design-engine
Atelier, /design, design tokens, maquette, wireframe, landing page, make it look good, accessibility, redesign
Las palabras clave incluyen palabras en francés e inglés (por ejemplo «recherche», «marché», «rapide», «refonte»), de modo que una petición en cualquiera de los dos idiomas activa los mismos roles. Las listas completas están en .agents/data/role-triggers.yaml, que puedes leer. Ten en cuenta que ese archivo da Product Manager como rol por defecto de Atlas, mientras que las instrucciones del propio Atlas presentan Analyst como el rol por defecto para investigación y descubrimiento.
Empieza en el rol por defecto de Atlas (Product Manager en role-triggers.yaml) y usa luego una palabra de investigación. El cambio se anuncia antes de producirse.
En tu asistente de IA
Atlas, compara nuestros precios con los de los tres principales competidores y haz un DAFO de cada uno.
Lo que deberías obtener Atlas te saluda y muestra primero su menú, porque espera en la activación; vuelve a enviar la petición si solo vuelve el menú. Las palabras benchmark y SWOT coinciden con los patrones del Analyst, así que Atlas anuncia el paso al modo Analyst con su motivo y ofrece quedarse en el modo actual si respondes skip. Si respondes skip, continúa como Product Manager y el análisis se enfoca en consecuencia.
Útil cuando quieres un rol que la formulación no activaría o cuando el cambio automático está desactivado.
En tu asistente de IA
Sentinel, pasa a tu rol UX Reviewer y revisa el flujo de pago en cuanto a acceso por teclado y estados de error.
Lo que deberías obtener Sentinel trabaja como UX Reviewer durante toda la respuesta. Si el pack Design está instalado, el juicio sobre diseño visual y accesibilidad corresponde a Atelier y Sentinel le traspasa esos puntos.
Para detener el cambio automático, ponlo en false en _bmad/config.yaml
auto_role_activation: false
Las palabras de chat: bmad-help, autopilot, parallel#
Tres frases son instrucciones para tu asistente, no comandos de terminal. Escribirlas en un shell no hace nada.
Palabras de chat
Di
Efecto
bmad-help
Muestra los agentes y workflows instalados y recomienda un siguiente paso. Con Dev Studio es también un workflow de Miriam.
autopilot
Lanza Nexus en modo pipeline completo: Discovery, Build y Ship con puntos de control, tras el intake de cada pack implicado.
parallel
Pide a Nexus que detecte tareas independientes y las supervise en paralelo; el paralelismo real depende de tu herramienta anfitriona.
Qué paradas te esperan lo fija checkpoints en _bmad/config.yaml. El valor execution_mode fija el rol inicial de Nexus: manual lo arranca como Scrum Master, autopilot como Autopilot Controller; hybrid no tiene un rol inicial propio.
En tu asistente de IA
autopilot. El proyecto: un portal de clientes donde descargan sus facturas y abren tickets de soporte. Detente en el PRD y en la arquitectura.
Lo que deberías obtener Nexus pasa a ser el Autopilot Controller y ejecuta el pipeline: Discovery con Atlas (y la especificación UX de Sentinel), un punto de control en el PRD, Build con Forge, un punto de control en la arquitectura, y luego stories, pruebas y Ship. Con execution_mode: autopilot anuncia que el autopilot está activo. Con los checkpoints por defecto se aplican dos paradas más: cada story terminada solo se comunica (story es notify_only en modo autopilot) y la entrega final espera tu aprobación (delivery).
Las stories independientes que no comparten archivos pueden ejecutarse en paralelo; las dependientes, las ediciones del mismo archivo, la arquitectura antes del código y la revisión antes de fusionar siguen siendo secuenciales.
En tu asistente de IA
Nexus, divide el trabajo aprobado en tareas independientes. Da a cada rol un alcance, archivos a su cargo y una definición de terminado. Usa agentes en paralelo solo si este anfitrión lo permite; si no, ejecuta las tareas sucesivamente. Integra los resultados y pide a Sentinel que revise el flujo completo.
Lo que deberías obtener Asignaciones acotadas, dependencias explícitas y una revisión integrada. La ejecución paralela viene de la herramienta anfitriona; si no puede crear agentes independientes, Nexus lo dice y trabaja las tareas una a una. Para un registro duradero de intentos y comprobaciones independientes, Nexus puede usar bmad-plus nexus.
Manual: tú llamas a los agentes. Autopilot: Nexus gestiona el pipeline. Hybrid: lo ofrece el instalador como autopilot con puntos de control frecuentes; las instrucciones de Nexus no le definen ningún comportamiento más allá de los valores de checkpoints. Se fija al instalar con --mode; solo autopilot pone story en notify_only, los demás modos piden aprobación también ahí.
auto_role_activation
true, false
Indica si los agentes cambian de rol por sí mismos.
parallel_execution
true, false
Indica si Nexus puede ejecutar tareas independientes en paralelo.
checkpoints
discovery, architecture, story, delivery: require_approval, notify_only, auto
Indica si cada etapa se detiene para tu aprobación, solo informa, o continúa dejando registro.
Core y Dev Studio se solapan (Atlas y Miriam, Forge y Bezalel, Sentinel y Oholiab, Nexus y Oholiab para los sprints). Ambos pueden convivir; responde el que nombras.
Design se solapa con la revisión UX de Sentinel y con Rachel. Sus palabras disparadoras son deliberadamente estrechas (Atelier, /design, design tokens, maquette, wireframe, landing page, make it look good, accesibilidad, rediseño): las palabras sueltas design, UI e interface siguen siendo de Forge en rol Architect y de la revisión UX de Sentinel. Con Design instalado, sus reglas gobiernan el diseño visual y la accesibilidad.
Los agentes SEO (Scout, Chief, Judge) tienen sus propias palabras disparadoras y también enrutan las palabras de comando /seo.
La herramienta debe ejecutarse en la carpeta donde se instaló BMAD+, para cargar AGENTS.md y su archivo de adaptador (por ejemplo CLAUDE.md o GEMINI.md).
02
Comprobar que los archivos existen
Hacen falta AGENTS.md en la raíz del proyecto y la carpeta .agents/skills/. Si no se eligió un adaptador al instalar, vuelve a ejecutar la instalación con --tools.
En la terminal del proyecto
npx bmad-plus install --tools claude-code --yes
03
Reiniciar la sesión
Muchas herramientas leen las instrucciones del proyecto solo al iniciar la sesión. Abre una sesión nueva y di de nuevo el nombre del agente.
04
Ejecutar el diagnóstico
Comprueba la instalación y nombra los archivos que faltan o están modificados.
En la terminal del proyecto
npx bmad-plus doctor
Nota· Lo que la activación no hace
Un agente es un conjunto de instrucciones que tu herramienta sigue. Nada corre en segundo plano, no hay planificador, y los agentes paralelos, la navegación y la ejecución de comandos existen solo si tu herramienta anfitriona los ofrece. Los permisos y el modelo vienen de esa herramienta.