PTENES
RUTA 4

🏗️ BMAD Method — Framework de agentes

Instala y configura BMAD Method en Codex: agentes @pm y @architect para crear software con una metodología profesional de producto.

6 módulos ~45 minutos Node.js · npm · Intermedio

Mapa de la ruta

Contenido detallado

🟢 Qué es

BMAD Method es un framework de npm que instala agentes especializados en Codex CLI. En lugar de escribir prompts desde cero, llamas a @pm, @architect y otros agentes preconfigurados para cada etapa del desarrollo de software.

💡 Por qué aprender

Con BMAD, Codex deja de ser un asistente de código y pasa a ser un equipo: gerente de producto, arquitecto, desarrollador, QA. Cada agente sabe exactamente qué preguntar y qué entregar, sin que tengas que crear el prompt desde cero cada vez.

🔑 Agentes disponibles

AgenteFunciónEntrega
@pmProduct ManagerPRD, historias de usuario, roadmap
@architectArquitecto de softwareDiagrama, stack, diseño de API
@devDesarrolladorCódigo, pruebas, refactorización
@qaAseguramiento de calidadCasos de prueba, bugs, cobertura

🟢 Qué es

Instalar BMAD Method en tu proyecto lleva menos de 5 minutos. Son 4 comandos: inicializar package.json, instalar el paquete, ejecutar la configuración completa e integrarlo con Codex.

💡 Requisitos previos

Node.js

versión 18 o superior

npm

viene con Node.js

Codex CLI

instalado y con sesión iniciada

🔑 Comandos de instalación

Guía paso a paso completa
# 1. Entre no seu projeto
cd meu-projeto

# 2. Inicialize o package.json (se não existir)
npm init -y

# 3. Instale o BMAD como dependência de dev
npm install bmad-method --save-dev

# 4. Rode o setup completo
npx bmad-method install --full

Qué hace --full: crea los directorios .agents/, docs/, copia plantillas de PRD, instala definiciones de agentes y configura el SKILL.md base.

🟢 Qué es

Para usar BMAD con Codex CLI (terminal), intégralo mediante la flag -i codex. Esto permite que la configuración reconozca y cargue los agentes BMAD en el contexto de Codex.

🔑 Integración y verificación

Comando de integración
npx bmad-method install --full -i codex
Verificar el estado de la integración
npx bmad-method status

Devuelve: versión instalada, agentes activos, si la integración con Codex funciona.

Primera tarea de prueba
codex "As dev, implement user login module"

💡 Qué sucede internamente

Codex lee el SKILL.md creado por BMAD y carga el contexto de los agentes. «As dev» activa el rol de desarrollador: el agente responde con el estilo y los entregables adecuados para ese rol.

🟢 Qué es

Además de Codex CLI, puedes usar BMAD en el Codex Web (interfaz del navegador de ChatGPT con Codex habilitado). La integración usa la bandera -i codex-web y genera archivos optimizados para subirlos a ChatGPT.

🔑 Comparación entre CLI y Web

FuncionalidadCLI (-i codex)Web (-i codex-web)
Ejecución de código✅ directamente en la terminalsandbox de ChatGPT
Carga de archivoslee del filesystem✅ arrastrar y soltar
RequirementAPI key OpenAIChatGPT Plus
Ideal paraproyecto completoprototipado rápido
Comando para integración Web
npx bmad-method install --full -i codex-web

Esto crea un archivo bmad-context.md optimizado para pegarlo en Custom Instructions o System Prompt de ChatGPT.

🟢 Qué es

Los agentes BMAD se activan con el prefijo @nome. Cada uno asume un rol profesional completo: @pm crea documentos de producto, @architect define la estructura técnica, @dev implementa.

🔑 Prompts esenciales por agente

@pm — Product Manager
@pm Create PRD for a task management app with user auth

Entrega: documento PRD con objetivo, personas, historias de usuario y criterios de aceptación.

@architect — Arquitecto
@architect Design API structure for the task management PRD

Entrega: stack tecnológico, diagrama de componentes, endpoints REST y esquema de datos.

Activación por rol (lenguaje natural)
As dev, implement user login module
As qa, write tests for the login module

🟢 Qué es

Un proyecto BMAD completo pasa por estas etapas: PRD → Arquitectura → Implementación → Pruebas → Verificación. Cada etapa está a cargo de un agente especializado, con transferencia automática de contexto.

🔑 Flujo de extremo a extremo

1
@pm crea PRD

Define el objetivo, las personas, las funciones y los criterios de aceptación

2
@architect diseña la estructura

Stack, API, base de datos, infraestructura

3
Como dev, implementa cada módulo

Codex lee el PRD + la arquitectura y genera el código

4
Como qa, escribe las pruebas

Casos de prueba basados en los criterios de aceptación del PRD

5
Verificar y actualizar BMAD

npx bmad-method update para nuevas versiones de los agentes

Comando de actualización
npx bmad-method update

Mantiene los agentes actualizados sin perder tus personalizaciones locales.

← T3 Agent Builder Siguiente: T5 Equipo →