Prepara BMAD+ en un repositorio existente o una carpeta vacía: detecta el stack, puntúa la salud del proyecto, recomienda packs, los instala y siembra la memoria del proyecto.
autoconfig es el arranque en un solo comando para un proyecto que aún no has configurado. En lugar de elegir los packs tú mismo, dejas que BMAD+ mire la carpeta, recomiende un conjunto de packs, ejecute install con ellos y escriba un primer contexto del proyecto en la memoria. Úsalo cuando llegues a un repositorio desconocido o todavía no sepas qué packs necesitas. Si ya sabes lo que quieres, install te da el control completo.
Un pack es un conjunto instalable de agentes y habilidades (consulta la sección de packs). Un proyecto se considera existente cuando su carpeta contiene al menos una entrada visible, es decir, cuyo nombre no empieza por un punto. Si no, se considera nuevo.
Idioma que se pasa al instalador que ejecuta. Los mensajes propios de autoconfig siguen en inglés.
-y, --yes
ninguno
desactivado
Solo proyecto existente: omite la confirmación «Install N recommended packs?». No omite las preguntas del proyecto nuevo.
Advertencia· --yes no hace autónomo un proyecto nuevo
En una carpeta vacía el asistente siempre hace dos preguntas (tipo de proyecto, descripción en una frase), diga lo que diga --yes. Ejecútalo en una terminal donde puedas responder.
Lee la carpeta, muestra un análisis breve (stack, estructura, una barra de salud, si ya hay BMAD+ o un archivo de instrucciones), lista los packs recomendados con un motivo cada uno, pide confirmación (salvo --yes), instala e imprime hasta cinco pasos siguientes redactados como peticiones a un agente.
Qué packs se recomiendan
Pack
Se recomienda cuando
core, memory
Siempre.
dev-studio
No hay carpeta docs, doc ni documentation, o el proyecto tiene más de cinco carpetas visibles en la raíz (sin contar node_modules).
shield
Existe una carpeta .github, .gitlab-ci o .circleci, o un archivo Dockerfile, docker-compose.yml o docker-compose.yaml.
seo
El framework detectado en package.json es Next.js, Nuxt, Angular, React, Vue.js o Svelte.
La barra de salud es una lista de comprobación ponderada. Su puntuación es la proporción redondeada sobre un peso total de 10; solo informa los consejos finales y nunca cambia los packs recomendados.
Lista de comprobación de salud
Comprobación
Peso
Cuenta cuando
Código fuente
2
existe una carpeta src, lib o app
Pruebas
2
existe una carpeta tests, test, __tests__ o spec
Documentación
1
existe una carpeta docs, doc o documentation
CI/CD
1
existe una carpeta .github, .gitlab-ci o .circleci
Git
1
existe una carpeta .git o un archivo .gitignore
README
1
existe README.md o readme.md
Licencia
1
existe LICENSE o LICENSE.md
Docker
1
existe Dockerfile o un archivo docker-compose
La detección del stack lee primero package.json (framework, TypeScript y gestor de paquetes según pnpm-lock.yaml, yarn.lock o bun.lockb, o npm si no hay ninguno). Sin package.json busca Cargo.toml (Rust), pyproject.toml o requirements.txt (Python), go.mod (Go), composer.json (PHP), Gemfile (Ruby), pom.xml o build.gradle (Java).
Lee: las entradas de primer nivel de la carpeta, package.json, tsconfig.json, los archivos de bloqueo y los demás manifiestos citados arriba. No hace ninguna petición de red ni lanza otro proceso.
Escribe: todo lo que install escribe para los packs elegidos (llama al instalador con --yes), y después .agents/memory/context.md.
Archivos de instrucciones: si ya existe CLAUDE.md, GEMINI.md o AGENTS.md en la raíz, pasa --tools none y no toca ningún adaptador. Si no, pasa las herramientas cuya carpeta marcadora encuentra (por ejemplo .claude), o none si no hay ninguna.
En un proyecto nuevo no pasa ninguna opción --tools: el instalador detecta por su cuenta y, con --yes, no escribe ningún adaptador si no encuentra herramienta.
Advertencia· context.md se reescribe
autoconfig sustituye .agents/memory/context.md por un archivo generado (stack, estructura, salud, carpetas clave, packs instalados, o el brief del proyecto si es nuevo). Todo lo que tú o un agente hubierais escrito ahí se sobrescribe. Ejecútalo una vez, al principio, no en un proyecto cuyo contexto vienes cuidando.
Terminó, o rechazaste o cancelaste una pregunta (en ese caso no se instaló nada).
1
Falló el instalador al que llama. autoconfig no fija ningún código por sí mismo; el instalador pone 1 cuando rechaza (por ejemplo un conflicto de versión) o lanza un error (la CLI imprime entonces BMAD+: <message>).
Proyecto Next.js existente con carpeta de CI y sin docs (simulado)Simulado
$ npx bmad-plus autoconfig --yesBMAD+ AutoconfigExisting project detected: invoice-appAnalysis completeProject Analysis Stack: Next.js + TypeScript + Node.js (npm) Structure: src/ tests/ CI/CD no docs Health: ████████░░ 80%Recommended Packs ✓ core Essential multi-role agents (Atlas, Forge, Sentinel, Nexus) ✓ memory Persistent brain for context continuity across sessions ✓ dev-studio No docs/ found — Huldah (Tech Writer) will help document ✓ shield CI/CD and/or Docker detected — GRC compliance agents recommended ✓ seo Next.js web app detected — SEO audit agents recommended# Después el instalador se ejecuta igual que en la página install, sin preguntas.Recommended Next Steps ! "Forge, document the project architecture and API" · "Forge, continue developing the current module" · "Zecher, consolidate session memory"Autoconfig complete! 🚀
npx bmad-plus autoconfig --yes
Transcripción ilustrativa, no capturada de una ejecución real. Fuente: Compuesto a partir de las plantillas de mensajes de tools/cli/commands/autoconfig.js; colores, emojis y caracteres de recuadro omitidos
La cifra de salud es la lista de comprobación de arriba: este proyecto ficticio tiene código, pruebas, CI, git, README y licencia (8 de 10), pero ni docs ni Docker. Los siguientes pasos salen de reglas fijas: la falta de pruebas da un paso de Sentinel de prioridad alta, la falta de docs y de CI da pasos de Forge, una puntuación inferior al 60 % añade una revisión de Sentinel, el código fuente añade «seguir desarrollando», y un paso de Zecher va el último. Se imprimen cinco pasos como máximo, así que un proyecto que activa las otras cinco reglas no ve el paso de Zecher. El 80 % supone git, un README y una licencia, que la línea Structure no lista: con git pero sin README ni licencia, la misma línea muestra 60 %.
El instalador lanzó un error; la CLI imprime después el mismo error como BMAD+: <message> y el código de salida es 1.
Lee el mensaje, o ejecuta install directamente para ver el mismo fallo en contexto.
BMAD+ v<old> is installed; this package is v<new>. Run bmad-plus update first ...
El proyecto contiene otra versión de BMAD+. El instalador rechaza y pone el código de salida en 1, pero autoconfig imprime igualmente sus propias líneas finales.
Ejecuta update y luego autoconfig otra vez. No tomes «Installation complete» por éxito cuando el código de salida es 1.
Autoconfig cancelled.
Respondiste que no a la confirmación, o cancelaste una pregunta del asistente.
No se instaló nada. Vuelve a ejecutarlo cuando estés listo.
autoconfig: Failed to list directory <message>
No se pudo leer la carpeta. El resultado es una lista vacía, así que se trata como un proyecto nuevo.
Comprueba la ruta dada a --directory y sus permisos antes de responder al asistente.
Has clonado un proyecto que no conoces y quieres que BMAD+ elija los packs.
En tu asistente de IA
Ejecuta `npx bmad-plus autoconfig --yes` en este repositorio. Luego dime qué packs recomendó y por qué, y qué petición a un agente sugiere primero.
Lo que deberías obtener El asistente ejecuta el comando, que imprime el análisis, un motivo por pack recomendado (core y memory siempre, los demás según las reglas de arriba) y los instala. Te informa de la lista de packs con cada motivo impreso y de la primera línea de «Recommended Next Steps» (la primera regla aplicable, por ejemplo un paso de Sentinel cuando no hay pruebas). .agents/memory/context.md contiene ahora el resumen generado del stack y la salud.
Solo tienes una idea y una carpeta vacía, y puedes responder a dos preguntas en la terminal.
En tu asistente de IA
En esta carpeta vacía ejecuta `npx bmad-plus autoconfig`. Cuando pregunte, elige «Web Application» y describe el proyecto así: una página de reservas para una pequeña consulta de fisioterapia.
Lo que deberías obtener Imprime «Empty directory — starting new project wizard», instala core, memory, dev-studio y seo (el conjunto Web Application), escribe .agents/memory/context.md con el tipo, tu descripción y el estado «New — not started», e imprime cuatro primeros pasos: pedir a Atlas que construya el proyecto descrito, pedirle el PRD, pedir la arquitectura a Forge, o decir «autopilot».