Toda la vida de BMAD+ en un proyecto: instalar, comprobar, actualizar con política y recibos, restaurar, desinstalar conservando tu memoria. Qué escribe y quita cada paso, y cómo actúa sin conexión.
BMAD+ vive dentro de tu proyecto, junto a tu código. Eso plantea tres preguntas razonables: cómo instalarlo sin que lo invada, cómo mantenerlo al día sin perder mis ediciones y cómo quitarlo sin perder mi trabajo. Esta página sigue una instalación desde el primer comando hasta el último y dice, en cada paso, qué se lee, qué se escribe y qué se quita. El principio es el mismo en todas partes: BMAD+ lleva la lista de los archivos que posee, con la huella de cada uno, y solo actúa sobre los que aún coinciden.
Instalar, actualizar, desinstalar y conservar la memoriaUn comando de instalación, una comprobación con doctor, actualizaciones que conservan tus cambios y una desinstalación que deja la memoria y la configuración en su sitio.Transcripción
Un solo comando desde la carpeta de tu proyecto, y eliges tus adaptadores y tus paquetes. El instalador escribe las instrucciones de los agentes, la columna compartida del proyecto y los adaptadores que seleccionaste. Después, doctor comprueba la instalación e indica cuántas verificaciones se superaron. Las actualizaciones conservan tus archivos personalizados: BMAD+ registra qué archivos gestiona. Una comprobación de versión solo mira. Las actualizaciones automáticas requieren una política explícita del proyecto. La desinstalación solo elimina los archivos que siguen coincidiendo con lo que se instaló. Tu memoria, tus modificaciones y tu configuración se quedan donde están. Nunca borra una carpeta de forma recursiva, así que los archivos ocultos y el contenido anidado sobreviven.
Planificar, copiar, escribir, verificar, dejar un recibo. Se deshace con --restore.
En la terminal del proyecto
npx --no-install bmad-plus update --latest --yes
06
Desinstalar
Quita solo lo que posee BMAD+; la memoria, los ajustes y tus ediciones se quedan.
En la terminal del proyecto
npx --no-install bmad-plus uninstall --yes
Advertencia· Los pasos 2 a 6 necesitan una copia local
El instalador no coloca bmad-plus en el node_modules de tu proyecto, así que npx --no-install bmad-plus ... falla justo después del paso 1 (npx canceled due to missing packages and no YES option). Añade el paquete una vez con npm install --save-dev bmad-plus, o ejecuta esos pasos como npx bmad-plus ..., que lo descarga cuando hace falta. Los archivos CLAUDE.md y AGENTS.md generados piden al asistente que ejecute npx --no-install bmad-plus update-check; sin copia local el comando no está disponible, y el asistente omite la comprobación de actualizaciones y continúa con tu tarea. Consulta la visión general de la CLI.
Todo descansa en un archivo escrito por install: _bmad/.bmad-plus-install.json, el manifiesto. Anota la versión, los packs, las herramientas, tu nombre e idioma, el modo de ejecución, un mapa adapterHashes (una huella por archivo de instrucciones) y un fileInventory: para cada archivo de agente, habilidad y datos que BMAD+ colocó, su huella SHA-256. Los finales de línea se normalizan antes de calcular la huella de los archivos de instrucciones, así que una copia de trabajo en Windows no parece una edición.
Estados del inventario de propiedad que muestra doctor
Estado
Significado
Consecuencia
complete
Cada archivo entregado está registrado.
Las actualizaciones pueden ser automáticas si la política lo permite.
incomplete
Algún archivo ya estaba allí, con contenido distinto, al instalar.
Esos archivos se tratan como tuyos.
legacy
Instalado antes de que existieran las huellas de propiedad.
Las actualizaciones copian antes los archivos originales de los packs; --auto rechaza.
invalid
El inventario está mal formado.
doctor informa de un error; repara el manifiesto o reinstala.
Una vez instalado el paquete en local (añádelo una vez con npm install --save-dev bmad-plus y usa después npx --no-install bmad-plus ...), install, doctor, update-policy, uninstall y un update simple funcionan sin red alguna.
update-check y update --latest son los únicos comandos que consultan npm. Sin conexión, update-check informa del estado unknown (motivo registry-unavailable, u offline con --offline), sale con 0, y un asistente simplemente sigue con tu tarea.
Una respuesta de caché obsoleta se presenta como tal, con stale: true; nunca se presenta como actual.
Solo el primerísimo npx bmad-plus install necesita red, para obtener el paquete, salvo que lo instalaras desde un archivo.
Una actualización fallida se deshace sola e imprime el comando exacto update --restore <id>. Los recibos quedan en .bmad/updates/.
doctor informa de un bloqueo de proyecto (.bmad/update.lock) de más de 60 minutos, o cuyo proceso ya no existe, como obsoleto, con el archivo que borrar. La siguiente instalación o actualización retoma un bloqueo cuyo proceso está demostrablemente muerto en esta máquina.
Un manifiesto dañado se copia a _bmad/.bmad-plus-install.json.corrupt.bak antes de que install lo sustituya.
Una instalación anterior a las huellas de propiedad (0.12.2 o anterior) se migra una vez ejecutando explícitamente un paquete más nuevo: npx --yes bmad-plus@0.13.0 update --yes. Antes se copian los originales.
Un retroceso de versión siempre se rechaza. Para volver atrás usa update --restore con el recibo de la actualización que quieres deshacer.
Actualizar un proyecto donde editaste archivos de instrucciones#
Añadiste tus propias reglas a CLAUDE.md y retocaste un archivo de agente, y quieres la última versión de BMAD+ sin perder ninguno de los dos.
En tu asistente de IA
Comprueba si existe una versión más reciente de BMAD+ para este proyecto. Si es así, actualízala y lista exactamente qué archivos se conservaron porque los edité, y por qué.
Lo que deberías obtener El asistente ejecuta update-check y luego update --latest --yes con tu aprobación. El comando imprime un plan como Planned changes: N files (R no longer shipped, removed with backup); preserved conflicts: 2. y una línea por conflicto: CLAUDE.md: preserved (local-instructions). y <agent file>: preserved (modified-managed-file). Esos dos archivos no se tocan; todo lo demás se actualiza tras una copia de seguridad, y se indica la ruta del recibo bajo .bmad/updates/ para poder deshacerlo con update --restore.