# Tu primera hora con BMAD+ > 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. Canonical: https://bmad-plus.rochetta.fr/es/docs/guides/first-hour/ Language: es BMAD+ version: 0.23.1 Documentation reviewed: 2026-10-19 Author: Laurent Rochetta License: MIT Documentación de BMAD+ › [Guías](https://bmad-plus.rochetta.fr/es/docs/guides/) › Tu primera hora con BMAD+ 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. Video: [BMAD+ en breve](https://bmad-plus.rochetta.fr/media/overview-en.mp4) — Qué instala BMAD+, cómo un paquete pregunta antes de actuar, cómo se cuenta un enjambre con honestidad y los diez paquetes. [Subtítulos (WebVTT)](https://bmad-plus.rochetta.fr/media/overview-es.vtt) 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. Transcripción con descripción visual: - **0:00** En pantalla: Una bruma azul oscura llena la pantalla. El título «BMAD+ 0.23.0» está en el centro y una luz cálida crece despacio detrás de él. Narración: BMAD+ instala roles, flujos de trabajo y contexto compartido en la herramienta de programación con IA que ya usas. - **0:09** En pantalla: Un único punto de luz ámbar en una nube verde oscura, del que salen rayos tenues. El rótulo inferior, en inglés, dice «Ask first». Narración: Empieza preguntando: un paquete declara las preguntas que necesita ver respondidas antes de actuar. - **0:19** En pantalla: Una ventana de terminal titulada «~/app». Se escribe un comando: bmad-plus intake record, con el archivo intake.yaml del pack Design y un archivo de respuestas, tres respuestas (surface_kind=dashboard; audience=«Accountants in a practice, on a desktop, at month end»; job=UNKNOWN) y un valor por defecto para design_system. La salida muestra «Recorded surface_kind, audience, job, design_system», después «design-read (design): ready — 2 answered, 1 defaulted, 1 unknown, 9 not asked yet.» y la lista de las siguientes preguntas, cada una con su tipo (choice, number o text): brand_assets, aesthetic_family, variance, motion, density y stack. La imagen se acerca a la última línea, donde «Unknown: job» aparece enmarcado: «risk: There is no goal to review against, so hierarchy and the primary action cannot be judged, only decorated.» Todo el texto del terminal está en inglés. Narración: Respondes unas pocas cada vez, y lo que no sabes queda registrado como desconocido, con su riesgo. - **0:27** En pantalla: Partículas ámbar salen disparadas de un centro luminoso y forman un anillo que se ensancha sobre un fondo violeta oscuro. El rótulo, en inglés, dice «A swarm, within a budget». Narración: Después, Nexus puede lanzar un enjambre de subagentes, dentro de un presupuesto que tú fijas. - **0:33** En pantalla: Dos paneles de terminal, uno al lado del otro. A la izquierda se escribe bmad-plus swarm tally buyer-panel-20261018-zho8. El comando muestra la ruta de un archivo tally.md, «8 of 40 units counted; 32 skipped.» y una línea que empieza por «Disclosure:», el aviso de transparencia: «Simulated units are not people. Read rates as an upper bound and confirm with real ones.» El panel de la derecha abre tally.md. Su título, enmarcado en naranja, dice «Simulated buyers see the pitch (run buyer-panel-20261018-zho8)», seguido de «8 of 40 units gave a valid answer; 32 skipped» y de una tabla «Rate: buys» (la fila «all» indica 4 yes de 8, 50.0%). El panel se desplaza por breves respuestas citadas, agrupadas por segmento y por comportamiento, y se detiene en «Numbers: price_floor»: una tabla con las columnas group, count, median, mean, min y max, cuya primera fila, «all», indica 8, 3.65, 3.7, 3 y 4.5. Narración: 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. - **0:48** En pantalla: Un nudo de finas líneas ámbar enredadas se endereza, línea a línea, hasta formar una cuadrícula cuadrada con un punto brillante en el centro. El rótulo, en inglés, dice «Independent checks before acceptance». Narración: En el trabajo planificado, Nexus exige comprobaciones independientes antes de aceptar un resultado. - **0:54** En pantalla: Altos bloques oscuros, como de cristal, se alinean en fila, iluminados de lado por un resplandor cálido. El rótulo, en inglés, dice «10 packs · 7 adapters». Narración: Los cuatro roles de Core, nueve paquetes opcionales y adaptadores para siete herramientas de programación con IA. - **1:04** En pantalla: Un terminal. Se escribe el comando npx bmad-plus install --lang en --packs core,design --tools claude-code. Aparecen las líneas del instalador: «BMAD+ Installer v0.23.0», «Installing to: /home/dev/app», «Selected packs: Core, Design», «Detected IDEs: Claude Code», una pregunta por el nombre (Developer), el idioma de comunicación (English), una pregunta por la URL de un entorno de pruebas y el modo de ejecución, con Manual, Autopilot e Hybrid como opciones y «Manual — You call agents yourself» elegido. La imagen se acerca a dos marcas verdes: «5 agents, 9 skills, 4 files copied», con «files copied» enmarcado en naranja, y «1 IDE(s) configured». Todo el texto del terminal está en inglés. Narración: Se instala con un solo comando npx desde la carpeta de tu proyecto. - **1:12** En pantalla: Un cielo azul casi negro y apagado, con una tenue franja de luz en el horizonte. La dirección «bmad-plus.rochetta.fr» aparece en naranja y se desvanece. > **Consejo · Dos tipos de instrucción** 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. ## Parte 1. Instalar 1. **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í. ```sh node --version ``` 2. **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/`. ```sh npx bmad-plus@0.23.1 install ``` 3. **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`. ```sh npx bmad-plus@0.23.1 install --yes --packs core --tools claude-code ``` 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** ```text $ npx bmad-plus install --yes --lang en --packs core --tools claude-code $ git status --short ?? .agents/ ?? AGENTS.md ?? CLAUDE.md ?? _bmad/ $ ls .agents/skills agent-architect-dev agent-orchestrator agent-quality agent-strategist bmad-plus-autopilot bmad-plus-intake bmad-plus-parallel bmad-plus-swarm bmad-plus-sync bmad-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+. ``` 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 ## Parte 2. Comprobar y despertar a tu asistente 1. **Añade el paquete al proyecto (una sola vez)** 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 `, 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. ```sh npm install --save-dev bmad-plus ``` 2. **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. ```sh npx --no-install bmad-plus doctor ``` 3. **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+. 4. **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/`. ```sh bmad-help ``` ## Parte 3. Una primera tarea 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. ### Partir de una idea Úsalo cuando todavía no hay código, o cuando quieres escribir el problema antes de cambiar nada. **En tu asistente de IA** ```text 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. ### Hacer un pequeño cambio en código existente Ú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** ```text 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. ## Parte 4. Hacerlo revisar 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. ### Pedir a Sentinel una revisión honesta Úsalo justo después de un cambio, antes de hacer commit. **En tu asistente de IA** ```text 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. ## Parte 5. Conservar lo aprendido 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** ```sh npx bmad-plus install --packs core,memory ``` ### Terminar la sesión con un traspaso Ú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** ```text 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-.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. ## Parte 6. Mantenerse al día, con seguridad 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** ```text $ npx --no-install bmad-plus update-check --offline Installed: 0.23.0; running: 0.23.0; channel latest: unknown unknown: offline $ npx --no-install bmad-plus update-policy Update 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 --yes` la deshace. La guía de equipo y la página del ciclo de vida de la instalación dan los detalles. ## Y después **Elige la página siguiente según lo que quieras hacer** | Quieres | Lee | | --- | --- | | Entender qué hace y qué no hace BMAD+ | Cómo funciona BMAD+ | | Automatizar un proyecto entero, o ejecutar tareas en paralelo | Nexus, autopilot y trabajo en paralelo | | Dejar que un pack te haga primero las preguntas adecuadas | Intake: preguntar primero, actuar después | | Probar un argumentario o una página ante muchos lectores simulados | Enjambres de subagentes | | Seguir un ejemplo completo de la idea al recuento | Tutorial: de una idea a un enjambre | | Copiar prompts para cada pack | Recetario | | Saber qué sale de tu máquina | Tratamiento de datos | | Compartir una misma configuración en un equipo | Usar BMAD+ en equipo | | Resolver un problema | Solución de problemas y FAQ | **Véase también** - [Cómo funciona BMAD+](https://bmad-plus.rochetta.fr/es/docs/concepts/how-bmad-plus-works/) - [Tutorial: de una idea a un enjambre](https://bmad-plus.rochetta.fr/es/docs/guides/idea-to-swarm/) - [Recetario](https://bmad-plus.rochetta.fr/es/docs/guides/recipes-cookbook/) - [Usar BMAD+ en equipo](https://bmad-plus.rochetta.fr/es/docs/guides/for-teams/) - [Preguntas frecuentes](https://bmad-plus.rochetta.fr/es/docs/faq/faq/) - [Solución de problemas](https://bmad-plus.rochetta.fr/es/docs/faq/troubleshooting/) [Documentación de BMAD+](https://bmad-plus.rochetta.fr/es/docs/) · [Guías](https://bmad-plus.rochetta.fr/es/docs/guides/) [Código en GitHub](https://github.com/lrochetta/BMAD-PLUS)