Cada carpeta y archivo que BMAD+ crea en un proyecto y en tu máquina, qué comando lo crea y si es tuyo para editar, gestionado por BMAD+ o un estado que conviene no tocar.
BMAD+ escribe en unos pocos lugares bien nombrados y en ningún otro. Saber cuál es cuál responde a las tres preguntas prácticas: qué puedo editar, qué debo versionar y qué se quita si desinstalo. Esta página los mapea todos.
La propiedad se registra, no se adivina. Al instalar, BMAD+ guarda una huella de contenido de cada archivo que copia bajo .agents/ y de _bmad/module.yaml y _bmad/module-help.csv: esa lista es el inventario de archivos del manifiesto. Un archivo cuya huella sigue coincidiendo es de BMAD+: update lo actualiza y uninstall lo quita. Un archivo que cambiaste, o que BMAD+ nunca entregó, es tuyo: update lo conserva e informa de un conflicto, y uninstall lo mantiene. Tus ajustes, tu memoria y los entregables de _bmad-output/ nunca están en el inventario.
Generados desde el registro. Si editas uno, BMAD+ conserva tu versión y deja de actualizarlo. Ver la página de adaptadores.
.agents/skills/
install, update
No: es de BMAD+
Una carpeta por agente (agent-*), por pack (pack-<name>) y por habilidad (bmad-plus-*, dev-studio, design, ...). Los archivos editados se conservan como conflictos.
.agents/data/role-triggers.yaml
install, update
No: es de BMAD+
Las reglas de activación automática de roles de agentes.
.agents/memory/
install con el pack Memory; los agentes escriben en ella
Sí
decisions.md, lessons.md, patterns.md, context.md, una carpeta sessions/ y un puntero .brain-link al cerebro en uso. Los archivos existentes nunca se sobrescriben y uninstall conserva la carpeta.
_bmad/config.yaml
install
Sí
Tus ajustes; ver la página de configuración. Lo conserva uninstall.
_bmad/module.yaml, _bmad/module-help.csv
install, update
No: es de BMAD+
Descripción del módulo e índice de ayuda, seguidos en el inventario.
_bmad/.bmad-plus-install.json
install, update
Nunca a mano
El manifiesto: versión, packs, herramientas, idioma, modo de ejecución, huellas de los adaptadores e inventario de archivos. Si no se puede leer, install lo copia a .bmad-plus-install.json.corrupt.bak antes de repararlo.
_bmad/update-policy.json
update-policy (cuando guardas una política)
Mediante el comando
Si falta, rige la política por defecto: notify. Un archivo inválido hace que los comandos de actualización se nieguen a ejecutarse.
Briefs y revisiones de diseño, informes de Dev Studio (<workflow-id>.md), dosieres OSINT y agentes empaquetados. Un brief escrito por intake render lleva una línea de propiedad y lo reescribe el comando: edita las respuestas, no el brief.
.bmad/update-check.json
update-check
Nunca a mano
Una caché de 24 horas de la última respuesta del registro, con una espera antes de reintentar tras un fallo. Se puede borrar sin riesgo: se reconstruye.
.bmad/update.lock
install, update (mientras se ejecutan)
Solo si está obsoleto
Evita dos instalaciones o actualizaciones a la vez. doctor avisa cuando está obsoleto (propietario desaparecido, o más de 60 minutos) y el mensaje nombra el archivo que borrar.
.bmad/updates/<receipt-id>/
update
Nunca a mano
receipt.json y backups/ de una actualización. Es lo que lee update --restore <receipt-id>: consérvalos mientras puedas querer volver atrás.
.bmad/venv/<pack>/
install --provision-python
Nunca a mano
El entorno Python aislado de un pack que lo necesita (SEO).
.bmad/memory/
comandos mem
Nunca a mano
journal.ndjson, pattern-scores.json y los registros de promociones y resultados: el diario de memoria.
Una carpeta por ejecución de enjambre (definición, fichas, briefs, respuestas, recuento). El comando solo escribe bajo este árbol. Añade respuestas con swarm save.
.bmad-plus/nexus/runs/
comandos nexus
Nunca a mano
El estado de referencia de las ejecuciones de tareas duraderas. Un .bmad-plus/orchestrator-state.yaml puede estar al lado, solo como resumen de navegación.
backups/
Backup Manager (pack Backup)
Sí
Archivos ZIP con marca de tiempo del proyecto. El pack Backup excluye esta carpeta de sus propios archivos.
~/.bmad-plus/brain/
install con el pack Memory (si no se halla otro cerebro), scan
Sí
Fuera del proyecto, en tu carpeta personal: el cerebro global compartido por todos tus proyectos. uninstall nunca lo toca.
install no edita .gitignore: lo que no ignores aparecerá en git status. La decisión es tuya; la tabla de arriba da los hechos para decidir. En la ejecución de aceptación registrada, el proyecto de demostración ya ignoraba las rutas instaladas, y git status --short siguió vacío tras la instalación.
Conviene compartir con el equipo: _bmad/config.yaml (comportamiento común), .agents/memory/ (decisiones y lecciones comunes), los entregables de _bmad-output/ y _bmad/update-policy.json si la política es una regla del equipo.
Reproducibles desde el paquete, así que un equipo puede preferir ignorarlos: .agents/skills/, .agents/data/, los archivos de adaptadores generados. Quien clone el proyecto ejecuta entonces install una vez.
Estado local sin sentido en otra máquina: .bmad/ y .bmad-plus/.
Nota· Esto es una sugerencia
Esta división sigue cómo se produce y se usa cada ubicación; BMAD+ no impone ninguna política de control de versiones.
Archivos idénticos byte a byte a lo que BMAD+ entrega bajo .agents/skills/ y .agents/data/, incluidas las habilidades copiadas del paquete Design
.agents/memory/, _bmad/config.yaml, _bmad-output/, cualquier archivo editado, cualquier archivo que BMAD+ no entregó
Los archivos del módulo, el manifiesto de instalación y los adaptadores que aún llevan el marcador de instalación y una huella coincidente (AGENTS.md, CLAUDE.md, ...)
.bmad/, .bmad-plus/ (estado de ejecuciones y recibos) y ~/.bmad-plus/brain
Las carpetas que quedan vacías se eliminan; nada se borra de forma recursiva
Todo lo que esté bajo un enlace simbólico o una unión: uninstall se niega a tocar rutas enlazadas
Uninstall en la práctica
$ npx bmad-plus uninstall --yes --directory .\demo-appT BMAD+ Uninstaller• BMAD+ v0.23.0 (installé le 2026-10-18)• Packs sélectionnés: core, design— La mémoire, les réglages et les fichiers inconnus ou modifiés ont été conservés.# La línea con el número de elementos quitados se omite a propósito: la primera ejecución registrada, que reveló un fallo que dejaba las habilidades Design en su sitio, mostraba una cifra que ya no vale tras la corrección.
Salida capturada de una ejecución real. Fuente: Capturado durante dos recetas de aceptación de la 0.23.0, el 2026-10-18 (líneas de cabecera y luego lo esperado del paso 7); el instalador se ejecutó en francés
Limpiar el estado local sin perder nada importante#
La carpeta del proyecto está recargada tras meses de actualizaciones y ejecuciones de enjambre, y quieres saber qué se puede borrar sin riesgo.
En tu asistente de IA
Lista lo que hay bajo .bmad y .bmad-plus en este proyecto, di qué es cada elemento e indica cuáles puedo borrar sin perder la memoria del proyecto, los ajustes ni la posibilidad de restaurar una actualización.
Lo que deberías obtener Una respuesta fiel separa tres grupos. update-check.json es una caché y se reconstruye en la próxima comprobación. updates/<receipt-id>/ guarda las copias que update --restore necesita, así que borra solo recibos a los que nunca volverás. update.lock solo se borra si doctor lo declara obsoleto. .bmad/memory/ contiene el diario de eventos y los resultados que leen mem recall y mem observe, y swarm/runs/ y nexus/runs/ son la evidencia de ejecuciones pasadas: bórralos solo si ya no necesitas ese historial ni esa evidencia. La memoria del proyecto en Markdown vive en .agents/memory/ y los ajustes en _bmad/config.yaml, que nada de esto toca.