Usar BMAD+ en equipo

BMAD+ vive en el proyecto, así que un equipo lo comparte como cualquier otra parte del repositorio: decidiendo qué se versiona, qué se configura igual para todos y quién lo cambia. Esta página lista esas decisiones y los hechos que hacen segura cada una: hashes de propiedad, ediciones preservadas, una política de actualización por proyecto, adaptadores generados desde una sola columna. Es para responsables técnicos y para quien tenga que incorporar a compañeros que usan herramientas de IA distintas. Cuando una elección es cuestión de gusto y no un hecho, el texto lo dice.

Qué versionar y qué dejar en local#

Convenciones que conviene acordar#

Una columna, un adaptador por compañero#

Todos los adaptadores se generan a partir del mismo registro que AGENTS.md, así que un compañero con Cursor y otro con Claude Code obtienen la misma lista y las mismas reglas; solo cambia el formato de archivo. --tools acepta varios ids a la vez (--tools claude-code,cursor), all o none. El instalador detecta las herramientas por sus carpetas (.claude/, .gemini/, .cursor/, .codex/, .opencode/, .aider.conf.yml) cuando no pasas --tools; --yes sin herramienta detectada no escribe ningún adaptador. Un adaptador de BMAD+ que editaste se conserva. Un archivo de instrucciones que escribiste tú se conserva en una instalación interactiva y con update; install --yes lo copia primero a <file>.bak y luego lo sustituye. Los archivos antiguos del instalador se guardan como <file>.bak.

Un compañero que añade una herramienta más tarde vuelve a ejecutar el instalador con esa herramienta: la ejecución conserva lo ya instalado y añade el adaptador que falta. --tools none instala agentes, habilidades y memoria sin tocar la configuración de ninguna herramienta, que es la opción adecuada para un proyecto cuyo CLAUDE.md o AGENTS.md se mantiene a mano.

Una política de actualización segura#

El valor por defecto es avisar: las instrucciones generadas piden al asistente que ejecute update-check una vez por sesión y lo notifique. No se aplica nada. Para un equipo, el patrón práctico es una persona (o un job de CI) que decide cuándo avanzar, aplica update, revisa el informe y hace commit; los demás reciben el resultado con su siguiente pull. Si el equipo quiere que las actualizaciones fluyan sin una persona, auto exige un rango semver explícito y varias salvaguardas: el resultado del registro debe ser reciente, los archivos gestionados sin cambios, el inventario de hashes de la instalación completo, la versión destino exactamente la registrada en el comando y el requisito de Node cumplido. Una consulta sin conexión, obsoleta o fallida nunca permite una actualización automática.

$ npx bmad-plus update-policy
Update policy: notify; channel=latest; range=none; prereleases=false
$ npx bmad-plus update-policy --json
{"policy":{"mode":"notify","channel":"latest","allowedRange":null,"allowPrerelease":false,"registry":"https://registry.npmjs.org/"},"changed":false}
$ npx bmad-plus update-policy --mode auto --range "^0.23.0"
Update policy saved: auto; channel=latest; range=^0.23.0; prereleases=false
$ npx bmad-plus update-policy --mode notify
Update policy saved: notify; channel=latest; range=^0.23.0; prereleases=false
$ npx bmad-plus update-check --offline --json
{"schemaVersion":1,"installedVersion":"0.23.0","runningVersion":"0.23.0","latestVersion":null,"targetVersion":null,"channel":"latest","status":"unknown","checkedAt":null,"source":"none","stale":false,"updateAvailable":null,"releaseEligible":false,"versionEligible":false,"canAutoApply":false,"engineCompatible":null,"engines":{},"reason":"offline"}

• off detiene toda consulta. notify (por defecto) informa. auto exige --range; añade --allow-prerelease o --stable-only para gestionar las preversiones. El registro está fijado a https://registry.npmjs.org/.
• Una actualización conserva los archivos cambiados desde su hash registrado y los notifica; un conflicto bloquea la vía automática. Los archivos que una versión nueva ya no incluye se quitan tras una copia de seguridad restaurable. Cada actualización aplicada escribe .bmad/updates/<receipt-id>/ con receipt.json y backups/; update --restore <receipt-id> --yes vuelve a ella y se niega a sobrescribir ediciones locales posteriores.
• Una instalación anterior a 0.13 (sin hashes de archivos) no se puede actualizar automáticamente; una migración explícita, npx --yes bmad-plus@0.23.1 update --yes, guarda copia de lo que reemplaza.
• install nunca cambia la versión instalada: se rechaza una bajada de versión y una subida pasa por update. Si dos compañeros instalaron versiones distintas, quien tiene la más antigua ejecuta update.
• Un bloqueo .bmad/update.lock protege el proyecto durante una actualización (se considera obsoleto tras 60 minutos o si su propietario ha muerto); doctor informa de un bloqueo que no es suyo.

CI y puertas#

BMAD+ no instala ningún hook de Git ni de ciclo de vida en tu proyecto, porque una instrucción se puede saltar. Lo que un equipo quiere imponer lo impone con su propia CI, mediante códigos de salida pensados para ello.

Incorporar a un compañero#

1. 01

   Traer el repositorio y comprobar la instalación

   Si los archivos generados están en el repositorio, doctor ya funciona. Si no, ejecuta el instalador con la lista de packs del equipo y luego doctor.

   En la terminal del proyecto

   npx bmad-plus@0.23.1 install --packs core,memory --tools claude-code
   npx bmad-plus@0.23.1 doctor

2. 02

   Añadir tu propia herramienta

   Instala con el id de tu herramienta; los archivos existentes se conservan y se añade tu adaptador.

   En la terminal del proyecto

   npx bmad-plus@0.23.1 install --packs core,memory --tools cursor

3. 03

   Leer la columna y preguntar al asistente

   Abre AGENTS.md para ver la lista de agentes y las reglas del equipo y escribe bmad-help en el chat. Lee los ajustes de _bmad/config.yaml para saber qué puntos de control se detendrán a preguntarte.

4. 04

   Enlazar la memoria a tu máquina

   Con el pack Memory, la instalación detecta un cerebro en tu máquina (BMAD_PLUS_BRAIN, una carpeta _brain/ en un directorio superior, ~/.bmad-plus/brain/, y por último un ~/.claude/memory/ que no esté vacío) y lo registra en .agents/memory/.brain-link. Ese archivo es solo tuyo; los archivos de memoria del proyecto que lo rodean son los del equipo.

Notas de gobernanza para equipos#

• Aprobaciones: si el equipo quiere que una persona apruebe la arquitectura y la entrega, mantén require_approval en esos puntos de control. Un autopilot con auto en todos es una elección deliberada, no un valor por defecto.
• Presupuesto: un enjambre mayor que swarm.budget se rechaza hasta que una persona diga sí; la generación de medios de pago se pregunta cada vez. Nadie debería pasar --approved en nombre de otro.
• OSINT: investigar a una persona con nombre exige un propósito y una base legal registrados, en cada ejecución. En un equipo eso supone alguien que asuma esa decisión. Consulta la página de confianza.
• Shield: los informes los genera una IA y llevan la marca «not legal advice»; una decisión de cumplimiento sigue en manos de una persona cualificada.
• Secretos: las claves de API van en el entorno de cada persona o de la CI, nunca en el repositorio. El suelo de ocultación de la revisión y el de las notas de aceptación enmascaran formas habituales de credenciales; no sustituyen el no incluir secretos en el repositorio.
• Propiedad: cada archivo escrito por BMAD+ lleva hash. Un archivo que editó un compañero lo conservan la actualización y la desinstalación y doctor lo señala como modificado (una advertencia): la personalización local es visible, no se sobrescribe en silencio.

Lee _bmad/config.yaml, _bmad/update-policy.json si existe, _bmad/review-rules.yaml si existe y el manifiesto _bmad/.bmad-plus-install.json. Resume en una tabla: versión instalada, packs, herramientas, modo de ejecución, comportamiento de cada punto de control, modo uat, presupuesto de enjambre, modo y rango de la política de actualización. Luego lista lo que un compañero nuevo tendría que hacer para tener la misma configuración y señala cualquier ajuste que parezca incoherente con los demás. No cambies nada.