ELSABRO v7.1.0

Tu asistente AI para crear apps increibles — Orquestacion de agentes con flow engine, checkpointing y ejecucion paralela.

ELSABRO es un sistema de desarrollo AI-powered para Claude Code que te guia paso a paso en la creacion de aplicaciones. Incluye un flow engine con 44 nodos, 12 agentes especializados, un CLI para control de flujo, y un sistema de checkpoints para recuperacion automatica.

Que Hay de Nuevo en v7.1.0

- Flow Engine Runtime — Motor de ejecucion basado en grafos con 9 tipos de nodos, resolución de templates, y checkpointing automatico
- CLI de 6 comandos — validate, dry-run, init, step, complete, status
- PartyEngine — Discusiones multi-agente con seleccion automatica de participantes
- CallbackProtocol — Composicion automatica de Agent Teams (minimo 5 miembros)
- 279 tests — Zero dependencias externas, Node 18+
- Design-UI Routing — Integracion con Stitch AI para generar pantallas desde texto

Para Quien es ELSABRO?

- Emprendedores con ideas pero sin conocimientos tecnicos
- Disenadores que quieren prototipar sus disenos
- Desarrolladores que quieren acelerar su workflow
- Cualquiera que tenga una idea y quiera convertirla en realidad

Instalacion

$3

``bash
npx elsabro --global
`

$3

`bash
pnpm dlx elsabro --global
`

$3

`bash
bunx elsabro --global
`

Despues de instalar, abre Claude Code y escribe:
`
/elsabro:start
`

Quick Start

`
1. /elsabro:start — Wizard interactivo para empezar
2. /elsabro:new-milestone — Crear milestone con objetivos
3. /elsabro:plan 1 — Planificar la primera fase
4. /elsabro:execute 1 — Ejecutar con TDD y verificacion
5. /elsabro:verify-work — Verificar con 3 agentes paralelos
`

Comandos

$3


| Comando | Descripcion |
|---------|-------------|
| /elsabro:start | Wizard para empezar (recomendado) |
| /elsabro:new | Crear un proyecto nuevo |
| /elsabro:help | Ver todos los comandos |

$3

| Comando | Descripcion |
|---------|-------------|
| /elsabro:plan | Planificar una fase o feature |
| /elsabro:execute | Ejecutar un plan con TDD |
| /elsabro:verify-work | Verificacion completa con agentes paralelos |
| /elsabro:quick | Ejecucion rapida para tareas simples |

$3

| Comando | Descripcion |
|---------|-------------|
| /elsabro:new-milestone | Crear nuevo milestone |
| /elsabro:complete-milestone | Cerrar milestone completado |
| /elsabro:audit-milestone | Auditar estado de milestone |
| /elsabro:progress | Ver progreso actual |

$3

| Comando | Descripcion |
|---------|-------------|
| /elsabro:add-phase | Agregar fase al final |
| /elsabro:insert-phase | Insertar fase en posicion |
| /elsabro:remove-phase | Eliminar fase |
| /elsabro:discuss-phase | Discutir scope de fase |
| /elsabro:research-phase | Investigar tecnologias para fase |

$3

| Comando | Descripcion |
|---------|-------------|
| /elsabro:debug | Debugging sistematico |
| /elsabro:party | Discusion multi-agente colaborativa |
| /elsabro:design-ui | Disenar interfaces con Stitch AI |
| /elsabro:map-codebase | Generar mapa del codebase |

$3

| Comando | Descripcion |
|---------|-------------|
| /elsabro:resume-work | Retomar trabajo guardado |
| /elsabro:pause-work | Pausar y guardar contexto |
| /elsabro:settings | Ver/modificar configuracion |
| /elsabro:set-profile | Cambiar perfil |
| /elsabro:exit | Desactivar persistent mode |

Flow Engine

ELSABRO incluye un motor de ejecucion de flujos basado en grafos. El engine es una libreria con callbacks — los comandos son duenos de la logica de negocio, el engine es dueno del recorrido del grafo.

$3

`
JSON Flow Definition (44 nodos)
|
v
graph.js — Construye Map + valida referencias
|
v
runner.js — While-loop: nodo → executor → checkpoint → siguiente
|
v
executors.js — 9 tipos de nodos (entry, exit, condition, router,
sequence, agent, parallel, interrupt, team)
|
v
callbacks — onAgent, onBash, onParallel, onInterrupt...
(inyectados en runtime, el engine no sabe de Claude Code)
`

- 279 tests, 75 suites, 0 dependencias externas
- Checkpoint despues de cada nodo — recuperacion automatica desde cualquier punto
- Template resolver — 7 tipos de expresiones {{...}} sin eval()

Para mas detalles ver ARCHITECTURE.md.

$3

Control manual del flujo con 6 comandos:

`bash


Validar flow y ver composicion de teams

node flow-engine/src/cli.js validate --flow flows/development-flow.json

Dry-run completo con mock callbacks

node flow-engine/src/cli.js dry-run --flow flows/development-flow.json --task "feature" --profile default

Ejecucion paso a paso

node flow-engine/src/cli.js init --flow flows/development-flow.json --task "build auth" --profile default
node flow-engine/src/cli.js step --flow flows/development-flow.json
node flow-engine/src/cli.js complete --flow flows/development-flow.json --result '{"output": "done"}'
node flow-engine/src/cli.js status --flow flows/development-flow.json
`

$3

ELSABRO incluye 2 flow definitions:
- flows/development-flow.json — Flujo completo de desarrollo (44 nodos, ~1080 lineas)
- flows/quick-flow.json — Flujo rapido para tareas simples (8 nodos)

Agentes Especializados

12 agentes con personalidades distintas, basados en BMAD-METHOD:

| Agente | Nombre | Especialidad |
|--------|--------|--------------|
| elsabro-analyst | Mary | Analisis y clarificacion de requisitos |
| elsabro-planner | Winston | Planificacion tecnica y arquitectura |
| elsabro-executor | Amelia | Implementacion de codigo con TDD |
| elsabro-debugger | Sherlock | Debugging sistematico con metodo cientifico |
| elsabro-verifier | Quincy | Verificacion de spec compliance y calidad |
| elsabro-orchestrator | Quantum | Coordinacion de agentes paralelos |
| elsabro-scrum-master | Bob | Validacion de milestones y sprints |
| elsabro-qa | Murat | Testing, coverage y calidad |
| elsabro-ux-designer | Sally | Diseno de experiencia con Stitch AI |
| elsabro-tech-writer | Paige | Documentacion tecnica y retrospectivas |
| elsabro-quick-dev | Barry | Desarrollo rapido con minima ceremonia |
| elsabro-yolo-dev | Flash | Desarrollo ultra-rapido, maximo riesgo |

PartyEngine

Sistema de discusion multi-agente. Selecciona 2-3 agentes relevantes para un tema y ejecuta rondas de debate con sintesis automatica.

`
/elsabro:party "Debatir la arquitectura de autenticacion"
`

El engine usa un mapa de relevancia (18 categorias de keywords) para elegir los agentes mas apropiados. Cada agente tiene una personalidad definida en agent-cards.json (estilo, foco, tendencia).

Perfiles

| Perfil | Comportamiento |
|--------|---------------|
| default | Balance entre velocidad y seguridad |
| yolo | Maximo velocidad, minima ceremonia |
| careful | Maximo seguridad, verificacion exhaustiva |

Cambiar perfil:
`
/elsabro:set-profile yolo
`

Como Funciona

`
1. Describes tu idea → ELSABRO analiza y pregunta
2. Planifica las fases → Crea planes atomicos con TDD
3. Ejecuta con agentes → Parallel execution + checkpointing
4. Verifica automaticamente → 3 reviewers + quality gates
`

Persistent mode mantiene ELSABRO activo entre mensajes — escribe naturalmente y ELSABRO rutea al comando correcto.

Estructura del Proyecto

`
.planning/
PROJECT.md — Descripcion del proyecto
*-PLAN.md — Planes por fase
milestones/ — Milestones con MILESTONE.md + RETROSPECTIVE.md
SESSION.md — Estado de sesion para pause/resume

.elsabro/
state.json — Estado persistente del flujo
checkpoints/ — Checkpoints del flow engine

flow-engine/
src/ — 9 modulos del engine (index, graph, template,
executors, runner, checkpoint, callbacks, cli, party)
tests/ — 9 archivos de tests (279 tests, 75 suites)
src/agent-cards.json — 9 personalidades de agentes

flows/
development-flow.json — Flujo completo (44 nodos)
quick-flow.json — Flujo rapido (8 nodos)
`

Actualizacion

`bash
npx elsabro --update
`

O desde Claude Code:
`
/elsabro:update
``

Version History

| Version | Milestone | Cambio Principal |
|---------|-----------|-----------------|
| 7.1.0 | M5 + M6 | AT compliance, design-ui routing, 279 failure mode tests |
| 7.0.0 | M4 | Feature completeness — 42/42 nodos, CLI, 257 tests |
| 6.0.0 | M3 | Flow engine runtime — 6 source files, 109 tests |
| 5.3.0 | M1 | Flow JSON sync — 42 nodos auditados |
| 5.2.0 | M2 | Skills injection pipeline + Agent Teams bridge |
| 5.0.0 | — | BMAD integration, party mode |

Licencia

MIT

Creditos

ELSABRO esta basado en:
- BMAD-METHOD — Agentes especializados
- Superpowers — Skills y TDD
- LangGraph — Inspiracion para graph-based orchestration