← Volver al listado de tecnologías ← Índice de BMAD Method

Instalacion y Estructura del Proyecto

Por: Artiko
bmadinstalacionconfiguracionestructura

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:

product-manager.md

Define al “Requirements Architect”. Contiene:

architect.md

Define al “Technical Visionary”. Contiene:

scrum-master.md

Define al “Story Crafter”. Contiene:

developer.md

Define al “IDE Agent”. Contiene:

qa.md

Define al “Quality Guardian”. Contiene:

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

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

ComandoAgenteFuncion
*workflow-initAnalystInicializa proyecto y recomienda track
*workflow-statusCualquieraMuestra progreso y siguiente paso
*prdPMCrea el Product Requirements Document
*create-epics-and-storiesPMDesglosa PRD en epics y stories
*create-architectureArchitectGenera documento de arquitectura
*implementation-readinessArchitectValida coherencia de planificacion
*sprint-planningScrum MasterInicializa tracking del sprint
*create-storyScrum MasterGenera archivo de story individual
*dev-storyDeveloperImplementa una story
*code-reviewDeveloperValidacion de calidad de codigo

Tracks disponibles

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

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:

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

← Volver al listado de tecnologías ← Índice de BMAD Method