Instalacion y Estructura del Proyecto

Crear el proyecto

Empezamos creando el directorio del proyecto Kanban e inicializando Git:

mkdir kanban-bmad
cd kanban-bmad
git init

BMAD vive junto a tu codigo. Los artefactos que genera son archivos markdown y JSON que se versionan en el mismo repositorio.

Instalar BMAD

La instalacion es un solo comando:

npx bmad-method@alpha install

Esto descarga y ejecuta el instalador interactivo que genera la estructura _bmad/ en tu proyecto, junto con _bmad-output/ para artefactos generados. No instala dependencias globales ni modifica tu package.json.

Nota: Se usa la version @alpha porque BMAD esta en desarrollo activo. La API puede cambiar entre versiones.

Estructura generada

Despues de la instalacion, tu proyecto tendra esta estructura:

kanban-bmad/
├── _bmad/
│   ├── agents/
│   │   ├── analyst.md
│   │   ├── product-manager.md
│   │   ├── architect.md
│   │   ├── scrum-master.md
│   │   ├── developer.md
│   │   └── qa.md
│   ├── templates/
│   │   └── (plantillas para artefactos)
│   ├── checklists/
│   │   └── (checklists de validacion)
│   ├── personas/
│   │   └── (perfiles de usuario)
│   ├── config.yaml
│   └── workflow-status.md
├── _bmad-output/
│   ├── docs/
│   │   └── (aqui se generan los artefactos)
│   └── tasks/
│       └── (aqui van las stories)
├── .claude/               # Configuracion IDE (si usas Claude Code)
└── .gitignore

Veamos cada parte en detalle.

Directorio agents/

Cada archivo .md en este directorio define un agente IA. No es codigo ejecutable: es un prompt estructurado que le dice a la IA como comportarse cuando asume ese rol.

analyst.md

Define al “Vision Crystallizer”. Contiene:

• Identidad: quien es y cual es su objetivo
• Tecnicas: brainstorming inverso, estado futuro ideal, analisis de riesgos
• Outputs esperados: product-brief.md
• Restricciones: no toma decisiones tecnicas, solo de producto

product-manager.md

Define al “Requirements Architect”. Contiene:

• Identidad: experto en requisitos y user stories
• Inputs: product-brief.md del Analyst
• Outputs: PRD.md con epicas, stories y criterios de aceptacion
• Formato: estructura especifica del PRD que debe seguir

architect.md

Define al “Technical Visionary”. Contiene:

• Identidad: arquitecto de software senior
• Inputs: PRD.md del PM
• Outputs: ARCHITECTURE.md, db-schema.md, api-spec.json
• Restricciones: decisiones deben alinearse con los requisitos del PRD

scrum-master.md

Define al “Story Crafter”. Contiene:

• Identidad: experto en fragmentar trabajo
• Tecnica clave: Context Sharding (fragmentar PRDs grandes en stories atomicas)
• Inputs: ARCHITECTURE.md + PRD.md
• Outputs: story-001.md, story-002.md, etc.

developer.md

Define al “IDE Agent”. Contiene:

• Identidad: desarrollador que sigue specs al pie de la letra
• Inputs: story individual + ARCHITECTURE.md
• Restricciones: no inventa features, no cambia la arquitectura
• Workflow: implementar, testear, documentar

qa.md

Define al “Quality Guardian”. Contiene:

• Identidad: ingeniero de calidad
• Inputs: codigo implementado + story original + ARCHITECTURE.md
• Checklists: seguridad, edge cases, cobertura, performance
• Outputs: reporte de issues y sugerencias

El archivo config.yaml

Este es el archivo de configuracion central de BMAD:

project:
  name: "Kanban BMAD"
  type: "fullstack"
  description: "Tablero Kanban construido con BMAD Method"

agents:
  default: "analyst"
  available:
    - analyst
    - product-manager
    - architect
    - scrum-master
    - developer
    - qa

quality:
  pre_commit: true
  checklist_required: true

paths:
  docs: "_bmad-output/docs"
  tasks: "_bmad-output/tasks"
  templates: "_bmad/templates"
  agents: "_bmad/agents"

Campos importantes

• project.type: indica el tipo de proyecto (fullstack, frontend, backend, library). Afecta que templates y checklists se activan.
• agents.default: el agente que se carga cuando inicias una sesion sin especificar rol.
• agents.available: lista de agentes habilitados. Puedes desactivar los que no necesites.
• quality.pre_commit: si es true, BMAD sugiere validar contra checklists antes de cada commit.
• paths: rutas relativas donde se guardan los artefactos.

El archivo workflow-status.md

Este archivo trackea el progreso del proyecto a traves de las fases de BMAD:

# Workflow Status

## Current Phase: BRAINSTORMING

## Artifacts
- [ ] product-brief.md
- [ ] PRD.md
- [ ] ARCHITECTURE.md
- [ ] db-schema.md
- [ ] api-spec.json
- [ ] Stories creadas

## Phase History
| Phase | Status | Date | Agent |
|-------|--------|------|-------|
| Brainstorming | IN_PROGRESS | - | Analyst |
| Requirements | PENDING | - | PM |
| Architecture | PENDING | - | Architect |
| Stories | PENDING | - | Scrum Master |
| Implementation | PENDING | - | Developer |
| QA | PENDING | - | QA |

El workflow-status.md se actualiza automaticamente cuando los agentes completan sus tareas. Es tu “dashboard” para saber en que punto del proceso estas.

Workflows disponibles

BMAD ofrece varios flujos de trabajo predefinidos:

Referencia de comandos v6

Comando	Agente	Funcion
*workflow-init	Analyst	Inicializa proyecto y recomienda track
*workflow-status	Cualquiera	Muestra progreso y siguiente paso
*prd	PM	Crea el Product Requirements Document
*create-epics-and-stories	PM	Desglosa PRD en epics y stories
*create-architecture	Architect	Genera documento de arquitectura
*implementation-readiness	Architect	Valida coherencia de planificacion
*sprint-planning	Scrum Master	Inicializa tracking del sprint
*create-story	Scrum Master	Genera archivo de story individual
*dev-story	Developer	Implementa una story
*code-review	Developer	Validacion de calidad de codigo

Tracks disponibles

Al ejecutar *workflow-init, BMAD analiza tu proyecto y recomienda un track:

• Quick Flow (~5 min): Para bug fixes y features pequenas. Combina Analyst + PM y simplifica la arquitectura.
• BMad Method (~15 min): El flujo completo de 6 fases. Es el que seguiremos en este tutorial.
• Enterprise (~30 min): Para proyectos con compliance. Agrega gates de aprobacion y auditoria entre fases.

Inicializar el proyecto Kanban

Con BMAD instalado, ejecutamos el workflow de inicializacion. En tu IDE agentico, carga el agente por defecto y usa el comando:

*workflow-init

Esto hace lo siguiente:

1. Verifica que la estructura _bmad/ existe
2. Lee el config.yaml para entender el proyecto
3. Crea el workflow-status.md con estado inicial
4. Prepara los directorios docs/ y tasks/
5. Confirma que estas listo para empezar con el Analyst

Despues de ejecutar *workflow-init, deberias ver un mensaje confirmando que el proyecto esta inicializado y que la primera fase (Brainstorming) esta lista.

Verificar la instalacion

Para confirmar que todo esta en orden, verifica:

# Estructura de directorios
ls -la _bmad/

# Agentes disponibles
ls _bmad/agents/

# Configuracion
cat _bmad/config.yaml

# Estado del workflow
cat _bmad/workflow-status.md

Si ves los 6 archivos de agentes y el config.yaml, estas listo para empezar.

Primer commit

Es buena practica hacer un commit con la estructura inicial de BMAD:

git add _bmad/
git commit -m "feat: inicializar proyecto con BMAD Method"

Esto establece la linea base. Cada fase posterior generara artefactos que tambien se commitearan, creando un historial completo de como evoluciono el proyecto desde la idea hasta el codigo.

Como cargar un agente en tu IDE

El mecanismo exacto depende de tu IDE agentico:

• Claude Code: referencia el archivo del agente en tu prompt o usa el sistema de CLAUDE.md
• Cursor: usa las Rules o el contexto del proyecto para cargar el archivo .md del agente
• Windsurf: similar a Cursor, carga el agente via reglas de proyecto

La idea es que cuando dices “quiero trabajar con el Analyst”, tu IDE lee _bmad/agents/analyst.md y la IA asume ese rol con todas sus instrucciones, restricciones y formato de output.

---

← Capitulo 1: Introduccion | Siguiente → Capitulo 3: El Analyst