BMAD-METHOD: el método ágil que organiza equipos de agentes de IA para construir software

BMAD-METHOD (Breakthrough Method of Agile AI-Driven Development, «Método de ruptura para el desarrollo ágil guiado por IA») es un conjunto de instrucciones, flujos de trabajo y agentes especializados que convierte una idea o una petición de cambio en software terminado sin que el desarrollador pierda el control. No es un modelo, un servidor ni un IDE: es una capa de metodología, en forma de skills en Markdown y guiones en Python, que se instala dentro de una herramienta de programación con IA (Claude Code, Codex, Cursor, Cline, Roo, Aider y otras) y que obliga a hacer explícitas las decisiones de producto, arquitectura y pruebas antes de que el agente escriba código. A 11 de septiembre de 2026 acumula más de 52.800 estrellas en GitHub, lo que lo sitúa entre los frameworks de «desarrollo dirigido por IA» más extendidos.

Origen

El repositorio fue creado el 13 de abril de 2025 (14:54 UTC según la API de GitHub) por Brian Madison, que responde al nombre «BMad» y a la marca BMad Code, con el identificador de GitHub bmadcode. La autoría se verifica en el registro de commits: el commit inicial («Initial Commit of the BMAaDd Workflow», 13 de abril de 2025) y los siguientes llevan la firma Brian Madison <brianmadison@Brians-MacBook-Pro.local> y Brian <bmadcode@gmail.com>. Su perfil público (github.com/bmadcode/bmadcode, «Hey — I’m BMad 👋 Creator of the BMad Method») y el pie del blog oficial (blog.bmadcode.com, «FOUNDER & EDITOR IN CHIEF — Brian Madison») confirman el papel. Su biografía autodeclarada menciona más de 25 años de carrera (Northrop Grumman, Siemens) y un puesto de transformación AI-native en Extend (dato autoinformado, sin verificar de forma independiente).

Hay un matiz de autoría que conviene señalar: el mayor número de contribuciones en el historial corresponde a alexeyv (644 commits) frente a bmadcode (187). No obstante, todos los commits iniciales y el anuncio del proyecto llevan la firma de Brian Madison, por lo que el fundador es Madison y Verkhovsky es un mantenedor central, no el creador.

El proyecto no cambió de nombre: siempre se llamó BMAD-METHOD. Lo que sí ocurrió fue un traslado de cuenta: empezó en la cuenta personal bmadcode/BMAD-METHOD (capturas de Wayback Machine de 2025-04-22 a 2025-06-26) y se movió a la organización bmad-code-org en agosto de 2025 (la org se creó el 01-08-2025; la primera captura de la URL de la org data de 2025-08-09).

El tono narrativo de lanzamiento fue explícitamente antivibe-coding. El video de presentación en YouTube (@BMadCode, 18 de abril de 2025) se tituló «Better than Vibe Coding: Hands‑On AI Agents Build Your Project Blueprint», y un README de abril de 2025 (snapshot de Wayback, 22-04-2025) vendía el método como «flujo de implementación predecible con menos rework costoso o quema de créditos del agente que produce el vibe coding». La propuesta de valor, en pocas palabras: los asistentes de código suelen convertir suposiciones implícitas en código; BMAD hace que las decisiones importantes queden escritas como documentos (brief, PRD, arquitectura, especificación) y se conviertan en contexto duradero para el trabajo siguiente.

Filosofía y principios

El README actual resume la filosofía en torno a la idea de desarrollo dirigido por IA (AiDD) que cubre todo el esfuerzo y no solo el código: qué construir, cómo encaja y cómo cambia a medida que se aprende. Los principios verificables en la documentación son:

Proceso a medida (right-sized process): para un cambio claro se va directo a implementación; para iniciativas grandes se añade planificación más profunda. «Pequeños cambios van directos a build; el trabajo complejo recibe la profundidad que necesita».
Nuevos o códigos existentes: empezar desde cero o establecer contexto verificado sobre un código heredado y trabajar a partir de lo que realmente hay.
Contexto duradero (durable context): las decisiones de producto y técnica se llevan hacia adelante en documentos, en vez de reexplicarlas en cada chat.
Perspectivas especializadas: traer expertos de producto, arquitectura, UX, desarrollo y pruebas cuando ayudan.
Colaboración guiada: flujos estructurados y discusiones multiagente sin ceder el criterio.
Un único camino de entrega: de la reflexión temprana hasta la implementación revisada, la corrección y el aprendizaje.

CONTRIBUTING.md añade un principio de gobernanza: amplificación humana, no sustitución («Human Amplification, Not Replacement»). Cada contribución debe responder a «¿Esto hace que humanos e IA trabajen mejor juntos?»; se rechazan las soluciones puramente automatizadas que dejan al humano al margen y la complejidad que fragmenta la base común.

Cómo funciona

El método funciona como un equipo de agentes especializados que ejecutan un flujo ágil que produce artefactos. La versión 6 (lanzada como estable el 17 de febrero de 2026) reorganizó el recorrido en un bucle de entrega: Clarify → Plan → Build → Learn, donde se puede empezar en cualquier punto. Los skills de planificación se agrupan en tres fases, y cada uno escribe un documento que se pasa al siguiente:

Fase	Skill	Qué produce
Análisis	`bmad-brainstorming`	`brainstorm.html` + opcional `brainstorm-intent.md`
Análisis	`bmad-forge-idea`	`forge-report.html`; `forged-idea.md` si la idea se endurece
Análisis	`bmad-deep-recon`	`research.md` con citas + briefing HTML
Análisis	`bmad-product-brief`	`brief.md` + `addendum.md`
Análisis	`bmad-prfaq`	`prfaq-<project>.md` (testeado desde la nota de prensa)
Planificación	`bmad-prd`	`prd.md`, `addendum.md`, `.memlog.md`
Planificación	`bmad-ux`	`DESIGN.md`, `EXPERIENCE.md`, `.memlog.md`
Planificación	`bmad-spec`	`SPEC.md` + compañeros bajo `specs/spec-<slug>/`; opcional `stories.yaml`
Solución	`bmad-architecture`	`ARCHITECTURE-SPINE.md`
Solución	`bmad-create-epics-and-stories`	archivos de epics con historias
Solución	`bmad-sprint-planning`	veredicto PASS/CONCERNS/FAIL + `sprint-status.yaml`

El punto de entrada operativo es bmad-spec, que condensa cualquier intención en un contrato corto y, bajo petición, lo divide en historias (stories.yaml). Después bmad-build implementa una historia por sesión. El tamaño del trabajo decide cuántas sesiones hay: un resultado coherente que necesita varias sesiones es un epic; varios epics, o unas 20 o más sesiones, es un project. bmad-build-auto ejecuta una sesión sin esperar input humano, pero solo después de que las decisiones importantes de implementación estén estables; no elige la siguiente historia ni posee el backlog.

La nota de versión v6.12.0 (04 de septiembre de 2026) muestra el diseño en movimiento: «Build decide cuánto ritual necesita un cambio después de investigar, no antes. Los cambios simples reciben una especificación de dos secciones y terminan en una sesión». También introdujo triaje de revisiones con veredicto y evidencia para cada hallazgo, y adopta el AGENTS.md escrito a mano en vez de reescribirlo. Hay breaking changes documentados (p. ej. persistent_facts llega vacío; {diff_output} pasó a {diff_file}).

El ecosistema

Repositorios oficiales de la organización `bmad-code-org`

El README lista los módulos oficiales y la organización mantiene 18 repos. Los principales, con sus estrellas consultadas el 11 de septiembre de 2026:

bmad-code-org/BMAD-METHOD — el núcleo: planificar y entregar software, de prototipos a bases de código consolidadas; 52.875 estrellas.
bmad-code-org/bmad-module-game-dev-studio — idear, diseñar y construir juegos en cualquier framework (Unity, Unreal, Godot, Phaser); 231 estrellas.
bmad-code-org/bmad-builder — constructor y validador de skills, flujos y agentes; 197 estrellas.
bmad-code-org/bmad-module-creative-intelligence-suite — partners de pensamiento creativo para innovación, design thinking y storytelling; 182 estrellas.
bmad-code-org/bmad-loop — construye, verifica y hace retrospectiva de un epic completo sin supervisión; 125 estrellas.
bmad-code-org/bmad-method-test-architecture-enterprise — aditivo de pruebas empresarial; 97 estrellas.
bmad-code-org/bmad-method-wds-expansion — diseño de UX (Whiteport Design System); 90 estrellas.
bmad-code-org/bmad-automator (40), bmad-method-ui (26, extensión de VS Code), bmad-module-template (17, plantilla para crear módulos instalables), bmad-utility-skills (7) y bmad-eval-quality (3, arnés de calidad).
bmad-code-org/bmad-plugins y bmad-plugins-marketplace — distribución del plugin para todas las plataformas de agentes.

Puertos, tutoriales y extensiones de la comunidad

LarsCowe/bmalph — «Unificado AI Development Framework» que combina las fases de BMAD con la ejecución autónoma de Ralph; 406 estrellas. Es el puente más visible entre BMAD (planificación) y Ralph (ejecución en bucle).
aj-geddes/claude-code-bmad-skills — skills de BMAD para Claude Code con autodetección e integración de memoria; 485 estrellas.
ErwanLorteau/BMAD_Openclaw — puente del método hacia OpenClaw; 309 estrellas.
ljxpython/bmad-method-tutorial — tutorial y práctica personal en chino («bmad-method使用教程及个人实践»); 150 estrellas.
echoVic/boss-skill — «Boss Skill», pipeline de desarrollo BMAD totalmente automatizado con orquestación multiagente, en chino; 555 estrellas.
rihebty/flow-kit — fusión de bmad, spec-kit, OpenSpec, GSD, claude-task-master y superpowers; 399 estrellas.
stephenleo/bmad-autonomous-development (107), bookmark/BMAD-METHOD-EXP (90), armelhbobdad/bmad-module-skill-forge (95), robertguss/bmad_automated (88) y salacoste/antigravity-bmad-config (65, configuración para Antigravity).

El propio repositorio incluye traducciones del README: README_CN.md (chino), README_KR.md (coreano) y README_VN.md (vietnamita), además de documentación en docs/zh-cn, docs/ko-kr, docs/fr, docs/cs y docs/vi-vn.

Registros de paquetes (npm)

El ecosistema npm es amplio y en su mayoría de terceros (consulta del 11-09-2026): bmad-agent-init (integración con Windsurf), bmad-mcp-server (servidor MCP para el método), bmad-statusline (para ccstatusline), bmad-invisible (capa orquestadora), bmad-md (módulo de dispositivos médicos/SaMD), bmad-odoo y convoke-agents (equipos de agentes compatibles), wdi-method (método que envuelve BMad), bmad-method-quarkus y bmad-module-ultracode-goal.

Estado oficial / semioficial

BMAD-METHOD no es un producto de un gran vendor, pero tiene un estatus semioficial claro dentro de la comunidad de «desarrollo dirigido por IA» / «spec-driven development»:

Distribución oficial propia: el método se entrega a través del marketplace oficial bmad-code-org/bmad-plugins (instalable en Claude Code con /plugin marketplace add bmad-code-org/bmad-plugins y en Codex con codex plugin marketplace add bmad-code-org/bmad-plugins) y vía Skills CLI (npx skills add bmad-code-org/BMAD-METHOD).
Estándar de facto del patrón de agentes por rol: el método fue citado en el hilo de Hacker News «The Claude Code Framework Wars» (id 45155302, 125 puntos, 13 comentarios, Substack, 07-09-2025), que cartografía el ecosistema de frameworks de Claude Code y lista a BMAD-code entre los ejemplos de enfoque basado en roles. No hay una designación formal de «estándar» por parte de ningún vendor, pero la presencia en ese tipo de listados y la abundancia de módulos comunitarios lo convierten en una referencia de facto para el patrón de «SDLC de agentes con artefactos».
Acreditación comercial: el proyecto se presenta a sí mismo como «el estándar para entrega empresarial de IA», con formación/certificación y consultoría opcionales en bmadcode.com. El núcleo es 100 % gratuito y MIT («No paywalls. No premium tiers. Ever»).
Marca: «BMad» y «BMAD-METHOD» son marcas registradas de BMad Code, LLC (ver TRADEMARK.md); los módulos comunitarios deben usar convenciones de nomenclatura tipo «My Module (BMad Community Module)».

Guía rápida de uso

Instalación y primer arranque

Requisitos: una herramienta de programación con IA que soporte skills, Node.js + npm y Git, y uv (de Astral) para la configuración y los guiones de Python.

Ruta por Skills CLI — dentro de tu proyecto:

npx skills add bmad-code-org/BMAD-METHOD

Selecciona las skills y la herramienta de código que quieres; incluye bmad para configuración y ayuda.

Ruta por plugin de Claude Code (dentro de Claude Code):

/plugin marketplace add bmad-code-org/bmad-plugins

Ruta por plugin de Codex (desde la terminal):

codex plugin marketplace add bmad-code-org/bmad-plugins

En cualquiera de los dos marketplaces instala bmad-method (flujos de entrega) y bmad-toolbox (skills independientes, incluida la hub bmad). Abre tu herramienta en el proyecto y pide a la skill bmad que ejecute bmad setup; luego invoca bmad-build con lo que quieres cambiar. Pregúntale a bmad siempre que quieras orientación sobre qué sigue o qué es opcional.

Actualizaciones: bmad update comprueba versiones; instala actualizaciones con npx skills update o tu marketplace; después, pide bmad doctor para reparar el runtime existente del proyecto.

Flujos de trabajo habituales

Para planificar un cambio claro: ejecuta bmad-spec con la intención; produce SPEC.md (y compañeros bajo specs/spec-<slug>/) y, si es de tamaño epic, stories.yaml. Después ejecuta bmad-build con la intención; la implementación queda bajo la carpeta del spec.
Para un producto nuevo de varios epics: usa bmad-prd (para el documento compartido de producto) y bmad-architecture (para ARCHITECTURE-SPINE.md), luego bmad-spec por cada epic, bmad-create-epics-and-stories para dividirlo y bmad-retrospective para cerrar cada epic.
Para trabajar sobre un código heredado: empieza por docs/existing-codebases/start-in-an-existing-codebase/, que establece contexto verificado sobre lo que ya existe antes de construir.
Para un epic sin supervisión: una vez estables las decisiones, bmad-build-auto (o el módulo bmad-loop) ejecuta, verifica y hace retrospectiva del epic completo.

Configuración esencial

AGENTS.md — el contrato del agente en el proyecto; desde v6.12 bmad-project-context adopta un AGENTS.md escrito a mano en vez de reescribirlo.
SPEC.md (+ carpetas specs/spec-<slug>/) — el contrato de una intención concreta; es la entrada principal de bmad-build.
stories.yaml — el orden de historias dentro de un epic; bmad-retrospective lo lee como inventario del epic.
prd.md / ARCHITECTURE-SPINE.md — documentos compartidos cuando varios epics o varios ingenieros deben seguir decisiones comunes.
sprint-status.yaml — estado de las historias que genera bmad-sprint-planning (PASS/CONCERNS/FAIL).

Trampas frecuentes y soluciones

Quema excesiva de tokens: el flujo completo recarga documentación cada sesión. Un usuario de r/ClaudeAI (1rure2k, «Burning too many tokens with BMAD full flow») lo reportó; la solución compartida (usuario jayjaytinker) fue tratar los documentos como archivos de referencia que Claude lee bajo demanda, no como contexto que se carga en cada sesión.
AGENTS.md se infla: un usuario de r/ClaudeAI (1n79qvq) advirtió que «BMAD adds to the AGENTS.md file quite a lot». Conviene revisar y recortar el archivo, especialmente en proyectos pequeños.
Sobreceremonia / overkill para tareas pequeñas: varias fuentes (HN, Reddit) señalan que el método es pesado para cambios pequeños. La respuesta documentada del propio proyecto es usar bmad-spec que «se adapta al tamaño del trabajo» y, para un cambio evidente de bajo riesgo, no instalar BMad en absoluto.
Breaking changes entre versiones (ej. v6.12.0): persistent_facts llega vacío (re-añade project-context.md a tu override si dependías del auto-carga) y {diff_output} pasó a {diff_file} en overrides de revisión.
Errores de validación de referencias de archivo: para skills en YAML/Markdown, el validador es uv run tools/validate_file_refs.py --strict.

Integraciones y migración

Herramientas de código con IA: el README documenta instalación para Claude Code, Codex, y vía Skills CLI para herramientas que soportan skills (Cursor, Cline, Roo, Aider, etc.); también Polytoken, Grok y ZCode se añadieron al instalador en v6.12.
MCP: el paquete npm bmad-mcp-server expone el método como servidor del Model Context Protocol.
Puente hacia ejecución autónoma (Ralph): LarsCowe/bmalph y hieutrtr/RalphMAD combinan la planificación de BMAD con el bucle de ejecución de snarktank/ralph (21.756 estrellas). El flujo típico: BMAD genera spec/epics/historias → Ralph las ejecuta una a una hasta completar el PRD.
Status line / CI: bmad-statusline integra el estado del flujo con ccstatusline; el módulo bmad-method-ui ofrece una extensión de VS Code.
Migración desde otros frameworks: no existe una ruta oficial de migración documentada; en la práctica la comunidad usa BMAD en lugar de SuperClaude, Claude Flow o spec-kit (véase la comparación). La migración «hacia» BMAD consiste en instalar las skills y generar los artefactos (brief/PRD/spec) sobre el código existente, empezando por la guía de «existing codebases».

Métricas actuales

Medición: 11 de septiembre de 2026, API de GitHub.

Métrica	Valor
Estrellas	52.875
Bifurcaciones	5.982
Suscriptores (watchers reales)	417
Lenguaje principal	Python
Licencia	MIT (badge del README; la API devuelve `NOASSERTION` en `license.spdx_id`)
Creación	13 de abril de 2025
Último push	10 de septiembre de 2026
Última publicación estable	`v6.12.0`, 04 de septiembre de 2026
Último commit en `main`	06 de septiembre de 2026 (`abe4eb1b`)

Caveats: la API de GitHub hace que watchers_count replique el número de estrellas; por eso se informa subscribers_count (417) como el conteo real de suscriptores. El campo open_issues_count (33) incluye incidencias y solicitudes de cambios abiertas, no solo incidencias. El conteo total de commits no se pudo obtener (la API de búsqueda de commits devolvió total_count: null); se informa la fecha del último commit en main como proxy de actividad.

Principales contribuyentes (por commits, según la API): alexeyv (644), bmadcode (187), semantic-release-bot (91), muratkeremozcan (61), dracic (23), lrliang (15), pbean (13), ksylvan (13), forcetrainer (13), jheyworth (8). El mayor contribuyente por volumen (alexeyv) es un mantenedor central, no el fundador.

Recepción de la comunidad

La discusión real de BMAD-METHOD no está en hilos dedicados de Hacker News (los ~8 envíos directos son de bajo alcance, entre 1 y 4 puntos y 0 comentarios; el más antiguo es «BMad-Method: Universal AI Agent Framework», id 44879862, 04-08-2025, 4 puntos). La conversación ocurre como comentarios dentro de hilos populares de programación con IA y está dominada en Reddit por r/ClaudeAI. La opinión está dividida: hay fans claros y objeciones repetidas.

Elogios (usuarios nombrados):

matt3D (HN 45155302, «The Claude Code Framework Wars», 125 pts): «Pretty surprised BMAD-method wasn’t mentioned. For my money it’s by far the best Claude Code compliment.» Repitió el respaldo luego («my go to is the BMAD method»).
easygenes (HN 44081081, «Peer Programming with LLMs», 213 pts/15 cmts): «The best structure I’ve found… is called BMAD, and treats the LLM as though it were a whole development team in an orchestrated way that you have full control over.»
redact207 (HN 48002442, «Agentic Coding Is a Trap», 463 pts/67 cmts): «bmad-code-org/BMAD-METHOD is really good and I’ve onboarded a few SaaS projects into it now. Tech speccing and multiple cycles of elicitation are what deal with all the edge cases.»
ValentineC (HN 47282777, «Tell HN: I’m 60 years old…», 1086 pts/206 cmts): «I’ve been using BMAD for planning and speccing out something fairly elaborate, and it’s been a blast.»
sminchev (varios hilos): «I like it, I use it, I see high potential… it gives good results.» — y matizando el coste: «It is expensive, I know… it takes a lot of tokens and the $20 is just not enough, but [it’s] worth it.»
En Reddit r/ClaudeAI, el hilo 1m9lqfv («SuperClaude vs BMAD vs Claude Flow…», 50 upvotes, 23 cmts) es mayoritariamente favorable: Sir-Noodle (12) «I prefer BMAD. It is more extensive in terms of planning but delivers best results imo.»; Are_we_winning_son (5) «BMAD without question.»; RecentQuarter (1) «Been using BMAD for over a month now. So far it’s great… also learning to become a better product manager along the way.»

Críticas y objeciones (usuarios nombrados):

MattGrommes (HN 47243272, «Agentic Engineering Patterns», 543 pts/53 cmts): «There’s already BMAD… Basically, it’s Waterfall for Agents. Lots of Capitalized Words to signify something. Also they constantly call it the BMAD Method, even though the M already stands for method.»
taffyda vid (HN 47994012, «Specsmaxxing», 287 pts/54 cmts): «I just spent a week training up in spec driven development through bmad, which was awful… unnecessary ceremony around the specs, generating fields of spec documents which presumably fill up the context window quickly.»
paulnovacovici (HN 46743908, «Claude Code’s new hidden feature: Swarms», 521 pts/43 cmts): pregunta si el método llega al 90 % de código «production-ready» pero falla en el último 10 % cuando la deuda técnica crece.
desireco42 (HN 47417804, «Get Shit Done», 473 pts/65 cmts): «this was completely not very much useful… all smoke and mirrors. I would maybe use BMad, which suffers from same issues, like Speckit… I don’t know if they have some sponsorship with bunch of youtubers who are raving how awesome this is… without any supporting evidence.»
vielite1310 (HN 47197595, «Verified Spec-Driven Development», 211 pts/35 cmts): pregunta si RPI, BMAD u otros enfoques spec-driven funcionan realmente en proyectos medianos/grandes «without wasting millions of tokens».
El hilo más crítico localizado es r/ChatGPTCoding 1o6j1yr («Spec-driven development for AI is a form of technical masturbation and frameworks like Spec-kit, bmad, Openspec are BS», 39 upvotes, 55 cmts): el OP im3000 alega «Context drift and pollution… you try to hand them a 4-page long spec and expect good results? Please!… Also mad token burn.» La réplica pro-BMAD más votada (Chetan496, 27) responde: «each task is supposed to be completed in a new session. That way there is no context pollution.»
En r/ClaudeAI, n0beans777 (1mmn41s): «it was bloating my projects out of proportion. Overly documenting everything, running around in circles.»; nizos-dev: «Agents are happy to over-engineer… I don’t use personas and I don’t see the point.»; stingraycharles (1m9lqfv): «These pre-built workflows are very meh… generic and generally total overkill.»

Síntesis honesta: el consenso no es uniforme. Quienes lo defienden lo valoran para aclarar ideas vagas y planificar a escala (producto nuevo, equipos con PRD compartido, código heredado); quienes lo critican señalan coste alto de tokens, sobreceremonia para cambios pequeños y riesgo de sobreingeniería. El contraargumento recurrente es que el problema no es el método sino el uso: «estás usando las specs de forma equivocada — divide en tareas por sesión».

Comparación con proyectos similares

Proyecto	Coincidencia verificable	Diferencia verificable
`snarktank/ralph` (21.756 ★)	Automatiza el ciclo de desarrollo hasta completar un PRD.	Ralph es un bucle de ejecución autónoma que repite hasta cerrar el PRD; BMAD es un método de planificación y entrega con artefactos. No son rivales directos: proyectos como `bmalph` y `RalphMAD` los combinan (BMAD planea, Ralph ejecuta).
spec-driven development (spec-kit / OpenSpec / VSDD)	Todos generan especificaciones y tickets que el agente cumple.	BMAD añade agentes por rol (PM, arquitecto, UX, dev, QA) y un flujo ágil completo con Kanban; los demás se centran en el ciclo spec → código. Usuarios de Reddit agrupan a BMAD con spec-kit y OpenSpec en la misma categoría («BS» para unos, «brillante» para otros).
SuperClaude / Claude Flow / Awesome Claude	Plugins/skills que amplían Claude Code con roles y flujos.	SuperClaude y Claude Flow son shards/skills para una sola herramienta; BMAD pretende ser agnóstico de IDE (Claude Code, Codex, Cursor, Cline, Roo, Aider, etc.) y entrega documentos portables.
TaskMaster	Orquestación de tareas para agentes de código.	TaskMaster se centra en gestionar/backlog de tareas; BMAD cubre el SDLC completo desde la idea hasta la retrospectiva. En Reddit ambos se mencionan juntos en debates de «lock-in».

Cómo contribuir

CONTRIBUTING.md documenta un proceso concreto y estricto:

Habla en Discord antes de programar si el cambio añade funcionalidad, reestructura código o toca más de un par de archivos. «Un PR grande de la nada tiene muchas probabilidades de cerrarse, sin importar el esfuerzo invertido.»
Incidencias y peticiones siempre por GitHub Issues (plantillas de bug report y feature request).
Ramas: se desarrolla contra dev (rama de desarrollo) y main es solo para releases. Existe la rama V6.12 para mantenimiento de npm. Los PRs abiertos contra main se re-apuntan a dev.
Tamaño del PR: ideal 200–400 líneas, máximo 800 (sin generados), una característica/arreglo por PR.
Código generado por IA: se espera que la mayor parte de las contribuciones usen IA, pero se exige curaduría humana intensa; se rechazan PRs que «se leen como output crudo de LLM» (refactors masivos no pedidos, «mejoras» intempestivas).
Plantilla de PR: secciones What / Why / How / Testing, menos de 200 palabras. Commits convencionales (feat:, fix:, docs:, refactor:, test:, chore:), menos de 72 caracteres.
Validación de referencias de archivo: uv run tools/validate_file_refs.py --strict (para *.yaml/*.md/*.xml).

El proyecto también mantiene tools/validate_skills.py, tools/quality.py y un arnés bmad-eval-quality para calidad/evaluación.

Casos de uso y a quién puede ayudar este repositorio

Equipos o tech leads que quieren desarrollo spec-driven a escala: el flujo bmad-prd → bmad-architecture → bmad-spec → historias → bmad-build por sesión da un producto nuevo multi-epic con decisiones compartidas documentadas y seguimiento por epic. Apto para organizaciones donde varios ingenieros construyen en paralelo y necesitan un PRD como documento que todos aprueben.
Desarrolladores individuales (indie/solo) en proyectos grandes: para un proyecto que no cabe en «one-shot», el método organiza el trabajo. Un usuario de r/LocalLLaMA construyó una web app completa con Qwen 3.6-35B local usando BMAD; otro describió cómo redujo el onboarding a ~15 minutos en su empresa. No está pensado para correcciones rápidas de bugs en sistemas legacy (mismo usuario lo reconoce).
Personas que heredan un código ajeno / consolidado: la ruta «existing codebases» (bmad-deep-recon, bmad-project-context) establece contexto verificado sobre lo que ya existe antes de modificar, en vez de adivinar.
Equipos de producto que necesitan clarificar ideas vagas: bmad-brainstorming, bmad-forge-idea y bmad-prfaq testean una idea hasta que se endurece o muere barato, antes de escribir código.
Quienes trabajan con modelos locales o abiertos: bmalph/RalphMAD y el flujo de ejecución permiten usar modelos abiertos (glm, kimi, deepseek) para entregar apps complejas.
Estudios de juegos y equipos creativos: los módulos oficiales bmad-module-game-dev-studio (Unity, Unreal, Godot, Phaser) y bmad-module-creative-intelligence-suite extienden el método a esos dominios.
Quienes quieren automatizar un epic sin supervisión: bmad-build-auto o el módulo bmad-loop construyen, verifican y hacen retrospectiva del epic completo una vez estables las decisiones.

Recursos

Repositorio: https://github.com/bmad-code-org/BMAD-METHOD
Documentación: https://docs.bmad-method.org/ (guía «Build your first change»: https://docs.bmad-method.org/start/build-your-first-change/)
Skills / plugins oficiales: https://github.com/bmad-code-org/BMAD-METHOD/tree/main/skills · marketplace de plugins: https://github.com/bmad-code-org/bmad-plugins
Módulos oficiales: Game Dev Studio, Creative Intelligence Suite, Test Architect, bmad-builder, bmad-loop (org bmad-code-org)
Blog / changelog oficial: https://blog.bmadcode.com/ (cambios por versión en https://github.com/bmad-code-org/BMAD-METHOD/releases)
Web bundles (Gemini Gems / ChatGPT GPTs): https://bmadcode.com/web-bundles/
Comunidad / Discord: https://discord.gg/gk8jAdXWmj
YouTube (tutoriales y master classes): https://youtube.com/@BMadCode
GitHub Discussions: https://github.com/bmad-code-org/BMAD-METHOD/discussions
Registros de paquetes (npm, principalmente terceros): https://www.npmjs.com/package/bmad-mcp-server · https://www.npmjs.com/package/bmad-statusline · https://www.npmjs.com/package/bmad-invisible
Listas curadas (awesome-*): shanraisshan/claude-code-best-practice (65.835 ★), awesome-opencode/awesome-opencode (10.183 ★), eltociear/awesome-AI-driven-development (539 ★), quemsah/awesome-claude-plugins (1.283 ★)
Hilos de Hacker News: 45155302 (Framework Wars) · 48002442 (Agentic Coding Is a Trap) · 47243272 (Agentic Engineering Patterns) · 44879862 (envío directo)
Proyectos asociados: LarsCowe/bmalph · ErwanLorteau/BMAD_Openclaw · aj-geddes/claude-code-bmad-skills · snarktank/ralph

Nota: este artículo combina el README, CONTRIBUTING.md, la documentación de docs.bmad-method.org, las notas de versión y la API de GitHub de BMAD-METHOD, la API de búsqueda de Hacker News y archivos espejo de Reddit consultados el 11 de septiembre de 2026. Las cifras (estrellas, forks, contribuciones) cambian con el tiempo; los conteos de upvotes de Reddit son instantáneas de archivo.