Las siete herramientas de IA que BMAD+ prepara: el archivo que se escribe para cada una, cómo se detecta, la columna común AGENTS.md y cómo install y update protegen tus propias instrucciones.
Cada asistente de IA busca sus instrucciones en un archivo distinto. Un adaptador es ese archivo: un documento generado y breve que informa a un asistente de los agentes, habilidades y reglas que BMAD+ instaló. Install escribe un adaptador por herramienta que uses, más una columna común, AGENTS.md, para que todos los asistentes vean el mismo equipo y las mismas reglas. Esta página es para quien elige --tools o se pregunta qué hará BMAD+ con un archivo de instrucciones que ya existe.
Carga CLAUDE.md de la raíz por sí mismo; activa un agente diciendo su nombre.
gemini-cli
Gemini CLI
GEMINI.md
.gemini
Carga GEMINI.md de la raíz por sí mismo.
antigravity
Antigravity
GEMINI.md (compartido con Gemini CLI)
.gemini/antigravity
Lee el mismo archivo; la nota añade una regla de concurrencia: coordinarse con otras herramientas agénticas y no editar nunca los mismos archivos a la vez.
cursor
Cursor
.cursor/rules/bmad-plus.mdc
.cursor
Una regla con alwaysApply: true en su cabecera, así que Cursor siempre la carga; la columna sigue siendo la fuente de verdad.
codex-cli
Codex CLI
.codex/AGENTS.md
.codex
Sigue la convención abierta AGENTS.md; el archivo remite a la columna de la raíz, que conviene leer directamente cuando existen ambos.
opencode
OpenCode
.opencode/AGENTS.md
.opencode
Igual que Codex CLI.
aider
Aider
CONVENTIONS.md
.aider.conf.yml
Aider no carga por sí mismo los archivos de convenciones: añade read: CONVENTIONS.md a .aider.conf.yml o ejecuta /read CONVENTIONS.md en la sesión.
Gemini CLI y Antigravity apuntan al mismo GEMINI.md. Si se eligen ambos, se escribe un solo archivo, titulado para los dos. La detección solo comprueba que el marcador exista en la carpeta del proyecto; no dice nada de si la herramienta está instalada en la máquina.
Se eligen las herramientas cuyo marcador se encuentra. Si no hay ninguno, el asistente pregunta cuáles usas.
nada, con --yes
Solo las herramientas detectadas. Si no se detecta ninguna, no se escribe ningún adaptador y el instalador dice: No AI tool detected; no instruction adapter written. Re-run with --tools <ids> or --tools all to add one.
--tools claude-code,cursor
Exactamente estas. La lista se separa con comas.
--tools all
Las siete.
--tools none (or skip)
No se escribe ningún adaptador y los archivos de instrucciones existentes quedan intactos. Los agentes y habilidades se instalan igualmente.
un id desconocido
El comando se detiene antes de escribir nada: «Unknown tool ID(s): … Available: claude-code, gemini-cli, antigravity, cursor, codex-cli, opencode, aider, all, none.»
Volver a ejecutar install conserva las herramientas que esta instalación ya posee, pases lo que pases, salvo con --tools none. Así, añadir una herramienta nunca quita otra.
Una instalación real que prepara Claude Code
$ npx bmad-plus install --yes --lang fr --packs core,design --tools claude-code --directory .\demo-app• IDE détectés: Claude Codeo ✅ 5 agents, 9 skills, 4 fichiers copiéso ✅ 1 IDE configuré(s)
Salida capturada de una ejecución real. Fuente: Capturado durante la receta de aceptación de la 0.23.0, el 2026-10-18 (paso 1; instalador ejecutado en francés)
AGENTS.md es la columna. Se escribe en cuanto se elige al menos una herramienta y lo lleva todo: el contexto del proyecto, el equipo de agentes (con las habilidades que conduce cada uno), la carpeta de habilidades y el archivo de activación automática, tu nombre y tu idioma, las instrucciones de actualización, los hechos del registro (número de packs y agentes, flujos de datos, notas de convivencia) y los comandos clave del chat. Las reglas de memoria (cuatro salvaguardas y cuatro archivos de .agents/memory) solo se añaden si el pack Memory está instalado. Cada archivo de herramienta empieza con un enlace a la columna y la nota de la tabla, y luego repite las mismas secciones, porque muchas herramientas solo cargan su propio archivo.
Dos líneas de un AGENTS.md generado
$ Select-String -Path .\demo-app\AGENTS.md -Pattern 'Atelier','Cohabitation'demo-app\AGENTS.md:22:- **Atelier** (Design Engine) — Senior product designer and design engineer: surfaces, tokens, accessibility, audits, redesigns (Design) — drives: design, design-review, redesigndemo-app\AGENTS.md:54:- Cohabitation (Design): Overlaps Sentinel's UX-review role and Dev Studio's Rachel (UX Designer); when this pack is installed its rules govern visual design and accessibility, and the others hand those over.# La terminal había partido las líneas largas en la ejecución grabada; aquí se muestran unidas.
Salida capturada de una ejecución real. Fuente: Capturado durante la receta de aceptación de la 0.23.0, el 2026-10-18 (paso 3; Select-String sobre el AGENTS.md de la carpeta demo-app)
Cada archivo generado lleva los marcadores AUTO-GENERATED by tools/build/generate-adapters.js — DO NOT EDIT. y BMAD+ installed project configuration. Esos marcadores son lo que permite a BMAD+ reconocer luego un archivo como suyo. La regla de Cursor empieza con su encabezado YAML (description, alwaysApply: true), así que los marcadores van justo después.
Install registra una huella de cada adaptador que escribe (el hash del contenido, con los finales de línea normalizados). Esa huella, guardada en el manifiesto de instalación, permite a BMAD+ distinguir su archivo intacto de uno que has editado.
Comportamiento según la situación
El archivo en la ruta de destino es…
install
update
inexistente
Se escribe.
Se escribe.
de BMAD+, idéntico a lo que se escribiría
Se deja como está.
Se deja como está.
de BMAD+, intacto desde la instalación
Se actualiza.
Se actualiza y se registra la nueva huella.
de BMAD+, pero lo has editado
Se conserva. Aviso: <file>: existing project instructions preserved.
Se conserva y se lista como conflicto (motivo local-instructions).
escrito por ti, sin marcadores de BMAD+ (ejecución interactiva)
Se conserva, con el mismo aviso.
Se conserva, incluso con --yes.
escrito por ti, sin marcadores de BMAD+, con install --yes
Se copia antes a <file>.bak y luego se reemplaza. Un .bak existente nunca se sobrescribe: la siguiente copia es .bak.1, luego .bak.2.
—
dejado por un instalador antiguo de BMAD+
Se guarda en .bak y se actualiza: <file>: backed up to <file>.bak before refreshing.
Igual: se guarda y luego se migra.
el archivo generado de un repositorio fuente de BMAD+ (marcador del generador, sin marcador de instalación)
Se conserva, con una indicación para compararlo con los valores del paquete.
Se conserva, motivo repository-adopted.
Advertencia·install --yes reemplaza un archivo de instrucciones que escribiste
Una instalación desatendida no puede preguntar, así que hace una copia .bak y escribe la versión de BMAD+. Si tu propio CLAUDE.md importa, ejecuta install una vez en interactivo, o pasa --tools none y fusiona tú mismo el contenido generado. update nunca hace esto: siempre conserva un archivo que no le pertenece.
doctor informa del estado de cada adaptador como Instruction file: <state>. con los estados unchanged (correcto), modified, unowned o adopted (avisos), y missing o unreadable (errores). uninstall solo quita un adaptador si aún lleva el marcador de instalación y su huella coincide con la registrada; un archivo que editaste se queda.
Es texto que el asistente lee. BMAD+ no instala ningún hook ni extensión en ninguna de estas herramientas: el registro describe la integración como gestionada por el anfitrión, sin eventos de ciclo de vida integrados.
Es agnóstico del modelo por contrato: se admiten Claude, GPT, Gemini y modelos locales, porque el contenido son simples instrucciones.
No hace que el asistente ejecute bmad-help, autopilot o parallel: son frases que dices en el chat.
Indica al asistente que compruebe una nueva versión una vez por sesión con npx --no-install bmad-plus update-check --json y que solo aplique una dentro de lo que permita tu política de actualización. Esa forma solo ejecuta una copia local: añade el paquete una vez con npm install --save-dev bmad-plus o usa npx bmad-plus update-check --json.
Añadir Cursor a un proyecto que ya usa Claude Code#
BMAD+ está instalado con claude-code. Un compañero trabaja en Cursor y necesita los mismos agentes.
En tu asistente de IA
Añade Cursor a la instalación de BMAD+ de este proyecto sin tocar la configuración de Claude Code: ejecuta `npx bmad-plus install --yes --tools cursor` y dime qué archivos cambiaron.
Lo que deberías obtener--yes hace falta cuando el asistente ejecuta el comando, porque sin terminal el instalador se niega a arrancar; en tu propia terminal preguntaría antes el idioma, los packs y tu nombre. El instalador conserva claude-code (las herramientas ya poseídas se retienen) y escribe .cursor/rules/bmad-plus.mdc con alwaysApply: true y un enlace a AGENTS.md. CLAUDE.md y AGENTS.md solo se reescriben si su contenido generado difiere; una copia que hayas editado se conserva con el aviso «existing project instructions preserved». El manifiesto lista ahora ambas herramientas.
Añadiste las convenciones del equipo al final del CLAUDE.md generado y sale una nueva versión de BMAD+.
En tu asistente de IA
Actualiza BMAD+ en este proyecto con `npx bmad-plus update --latest --yes` y lista cada archivo que la actualización conservó en lugar de reemplazar.
Lo que deberías obtener El plan muestra «CLAUDE.md: preserved (local-instructions).» y el recibo lo registra como conflicto; la actualización termina con «applied partially.» Tus añadidos quedan intactos. Para adoptar el nuevo texto generado, fusiona a mano o restaura el original y edita de nuevo.