# Documentación de BMAD+ — Inicio, ejemplos y versiones
> Instala BMAD+, inicia tu primer flujo de agentes, prueba prompts prácticos y mantén tu proyecto actualizado. Guía paso a paso e historial de versiones publicadas.
Canonical: https://bmad-plus.rochetta.fr/es/docs/
Language: es
BMAD+ version: 0.13.0
Documentation reviewed: 2026-09-09
Author: Laurent Rochetta
License: MIT
De la instalación al primer flujo de trabajo.
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.
- [Empezar, paso a paso](#start)
- [Ejemplos para adaptar](#examples)
- [Comprobar y aplicar actualizaciones](#updates)
- [Novedades](#news)
- [Historial de versiones](#changelog)
- [Si tienes dudas](#help)
## Empezar, paso a paso
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.
### 1. 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**
```sh
node --version
```
La salida debe indicar v20 o posterior. Instala o actualiza Node.js por separado si hace falta.
### 2. 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.
**En la terminal del proyecto**
```sh
npx bmad-plus@0.13.0 install
```
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.
### 3. 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**
```text
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.
### 4. 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**
```text
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.
### 5. 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**
```text
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**
```text
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**
```text
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**
```text
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**
```text
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.
**En la terminal del proyecto**
```sh
npx --no-install bmad-plus update-check --refresh --json
```
### Si falta la CLI o la instalación es antigua
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.
**En la terminal del proyecto**
```sh
npx bmad-plus@0.13.0 update-check --refresh --json
```
### Revisar y aplicar una actualización
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**
```sh
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.
**En la terminal del proyecto**
```sh
npx --yes bmad-plus@0.13.0 update --yes
```
- 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**
```sh
npx --no-install bmad-plus update-policy --mode auto --range "^0.13.0"
```
**En la terminal del proyecto**
```sh
npx --no-install bmad-plus update-policy --mode notify
```
### Restaurar después de una actualización
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.
**En la terminal del proyecto**
```sh
npx --no-install bmad-plus update --restore RECEIPT_ID --yes
```
## Novedades
La última versión publicada tiene en cuenta los cambios locales al actualizar. La guía y el comando de instalación describen la misma versión.
### v0.13.0 — Actualizaciones que respetan tu proyecto
2026-09-08
Descubre versiones publicadas, controla la política automática y conserva los archivos de agentes personalizados.
## Historial de versiones
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
2026-09-08
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.
[Paquete publicado · v0.13.0](https://www.npmjs.com/package/bmad-plus/v/0.13.0)
### v0.12.2 — Herramientas SEO incluidas en el pack
2026-07-17
El pack SEO incluye los scripts Python y los requisitos de su flujo documentado.
- El kit SEO se distribuye en el paquete npm y se copia en los proyectos instalados.
- SEO Scout, SEO Chief y SEO Judge se pueden seleccionar mediante sus activadores.
- Las redirecciones del crawler se comprueban en cada salto y se ampliaron las pruebas de CLI y seguridad Python.
[Paquete publicado · v0.12.2](https://www.npmjs.com/package/bmad-plus/v/0.12.2)
### v0.12.1 — Memoria de proyecto más coherente
2026-07-12
La memoria reconoce mejor un cerebro compartido existente y registra el enlace elegido.
- La búsqueda de memoria respeta las ubicaciones configuradas y cercanas del portafolio antes de las globales.
- Se corrigieron la inicialización y la indexación para evitar entradas duplicadas ajenas al proyecto.
- Se reforzaron las comprobaciones de adaptadores y del archivo de bloqueo de la instalación.
[Paquete publicado · v0.12.1](https://www.npmjs.com/package/bmad-plus/v/0.12.1)
[Todas las versiones publicadas en npm](https://www.npmjs.com/package/bmad-plus?activeTab=versions)
## Si tienes dudas
### 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.