elsabro 7.0.1 → 7.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +155 -887
- package/commands/elsabro/execute.md +121 -10
- package/commands/elsabro/party.md +87 -2
- package/commands/elsabro/start.md +9 -3
- package/flow-engine/src/party.js +29 -3
- package/flow-engine/tests/cli.test.js +2 -2
- package/flow-engine/tests/graph.test.js +1 -1
- package/flow-engine/tests/integration.test.js +7 -7
- package/flow-engine/tests/party.test.js +57 -0
- package/flow-engine/tests/runner.test.js +457 -0
- package/flow-engine/tests/skill-install.test.js +374 -0
- package/flows/development-flow.json +42 -5
- package/flows/quick-flow.json +0 -1
- package/hooks/skill-discovery.sh +6 -4
- package/hooks/skill-install.sh +224 -0
- package/package.json +1 -1
- package/references/command-flow.md +25 -20
package/README.md
CHANGED
|
@@ -1,273 +1,26 @@
|
|
|
1
|
-
# ELSABRO
|
|
2
|
-
|
|
3
|
-
**Tu asistente AI para crear apps increibles**
|
|
4
|
-
|
|
5
|
-
ELSABRO es un sistema de desarrollo AI-powered para Claude Code que te guia paso a paso en la creacion de aplicaciones,
|
|
6
|
-
|
|
7
|
-
##
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
- **
|
|
11
|
-
-
|
|
12
|
-
- **
|
|
13
|
-
- **
|
|
14
|
-
- **
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
- **
|
|
19
|
-
- **
|
|
20
|
-
- **Auto-documentation**: Designs saved to `.planning/ui-designs/` with screen specs
|
|
21
|
-
- **Persistent mode routing**: Say "design", "mockup", "wireframe" and ELSABRO routes to design-ui
|
|
22
|
-
|
|
23
|
-
## Novedades v4.1.0 (Persistent Mode + Code Review Enforcement)
|
|
24
|
-
|
|
25
|
-
### Persistent Mode
|
|
26
|
-
- **ELSABRO stays ON**: Once activated, all subsequent messages are automatically routed through ELSABRO workflows
|
|
27
|
-
- **Intent classification**: Your messages are classified and routed to the right command (debug, plan, quick, etc.)
|
|
28
|
-
- **`/elsabro:exit`**: Deactivate persistent mode when you want to return to normal Claude Code
|
|
29
|
-
- **Zero overhead when inactive**: <5ms fast path when persistent mode is off
|
|
30
|
-
- **Slash command bypass**: `/commit`, `/help`, etc. still work normally
|
|
31
|
-
|
|
32
|
-
### Mandatory Code Review
|
|
33
|
-
- **Rule 7 enforcement**: Code review is now mandatory after every code modification
|
|
34
|
-
- **Integrated into commands**: `quick` and `debug` commands include automatic code review steps
|
|
35
|
-
- **No escape hatches**: Cannot complete a code-writing command without running `pr-review-toolkit:code-reviewer`
|
|
36
|
-
|
|
37
|
-
## Novedades v4.0.0 (Agent Teams + Blocking Review)
|
|
38
|
-
|
|
39
|
-
### Agent Teams
|
|
40
|
-
- **Coordinacion peer-to-peer** entre agentes usando Claude Code Agent Teams nativo
|
|
41
|
-
- **Auto-routing** entre subagents y Agent Teams segun complejidad y perfil
|
|
42
|
-
- **7 agentes migrados** a Team mode (orchestrator, executor, planner, analyst, qa, verifier, debugger)
|
|
43
|
-
- **5 agentes mantienen** modo subagent (quick-dev, yolo-dev, scrum-master, tech-writer, ux-designer)
|
|
44
|
-
- **Nuevo nodo `team`** en el flow engine para spawn y coordinacion de equipos
|
|
45
|
-
- **Nuevo perfil `teams`** en hooks y flow engine
|
|
46
|
-
|
|
47
|
-
### Blocking Code Review (Sin Escape)
|
|
48
|
-
- **CERO opciones de skip** - no "aceptar con errores", no "continuar sin fix"
|
|
49
|
-
- **5 iteraciones max** de fix antes de bloqueo (antes eran 2)
|
|
50
|
-
- **3 reviewers paralelos** (code quality, silent failures, staff review)
|
|
51
|
-
- **Quality gate completo** - tests + TypeScript + lint (antes faltaba lint)
|
|
52
|
-
- **Exit codes reales** - `captureExitCode: true` en vez de `|| true`
|
|
53
|
-
- **Nuevo nodo `interrupt_blocked`** para bloqueo duro en review failures
|
|
54
|
-
|
|
55
|
-
### Nuevos Nodos de Flujo
|
|
56
|
-
- `interrupt_blocked` - Bloqueo sin escape en review failures
|
|
57
|
-
- `wait_manual_review_fix` - Espera fix manual del usuario
|
|
58
|
-
- `interrupt_teams_failed` - Fallback de Agent Teams a subagents
|
|
59
|
-
|
|
60
|
-
## Novedades v3.8 (Skill Marketplace Integration)
|
|
61
|
-
|
|
62
|
-
### Integración Automática de Skills (skills.sh)
|
|
63
|
-
- **SkillDiscoveryEngine** - Descubrimiento automático de skills necesarias por keywords y categorías
|
|
64
|
-
- **SkillInstallManager** - Instalación y actualización automática de skills con versionado semver
|
|
65
|
-
- **SkillCacheManager** - Cache inteligente de búsquedas (1h) y versiones (6h)
|
|
66
|
-
- **AutoSkillResolver** - Resolución de dependencias con ordenamiento topológico
|
|
67
|
-
- **FlowIntegration** - Hooks pre-comando para skill discovery automático
|
|
68
|
-
|
|
69
|
-
### CLI Commands
|
|
70
|
-
- `npx skills find <query>` - Buscar skills disponibles
|
|
71
|
-
- `npx skills add <skill>` - Instalar skill
|
|
72
|
-
- `npx skills check <skill>` - Verificar actualizaciones
|
|
73
|
-
- `npx skills update [skill]` - Actualizar skills
|
|
74
|
-
|
|
75
|
-
### ELSABRO Commands
|
|
76
|
-
- `/elsabro:skills search <query>` - Buscar skills en marketplace
|
|
77
|
-
- `/elsabro:skills install <skill>` - Instalar skill específica
|
|
78
|
-
- `/elsabro:skills update [skill]` - Actualizar skill(s)
|
|
79
|
-
- `/elsabro:skills list` - Listar skills instaladas
|
|
80
|
-
- `/elsabro:skills config` - Configurar auto-discovery
|
|
81
|
-
|
|
82
|
-
### Características
|
|
83
|
-
- **25+ keyword mappings** para descubrimiento automático (auth→clerk, payments→stripe, etc.)
|
|
84
|
-
- **16 categorías** de skills organizadas
|
|
85
|
-
- **Scoring inteligente** con nameScore, descScore, categoryScore, downloadScore
|
|
86
|
-
- **Cache multi-nivel** para búsquedas y versiones
|
|
87
|
-
- **Fallback graceful** cuando no hay conexión al registry
|
|
88
|
-
- **Mode toggleable** (auto/manual/hybrid) para control del usuario
|
|
89
|
-
|
|
90
|
-
## 🚀 Novedades v3.7 (Mobile & IDE Release)
|
|
91
|
-
|
|
92
|
-
### Mobile App Companion (Expo SDK 52+)
|
|
93
|
-
- **MobileAppArchitecture** - React Native con expo-router y Zustand
|
|
94
|
-
- **SessionSync** - Sincronización WebSocket en tiempo real
|
|
95
|
-
- **PushNotificationManager** - Notificaciones de tareas, builds, approvals
|
|
96
|
-
- **VoiceInputHandler** - Comandos de voz desde el móvil
|
|
97
|
-
- **OfflineMode** - Cache local con sync automático
|
|
98
|
-
- **BiometricAuth** - Face ID, Touch ID, fallback a PIN
|
|
99
|
-
- **Widget Support** - iOS WidgetKit y Android App Widgets
|
|
100
|
-
|
|
101
|
-
### Voice Commands & Dictation
|
|
102
|
-
- **VoiceCommandEngine** - Pipeline audio → ASR → NLU → action
|
|
103
|
-
- **DictationTranscriber** - Transcripción con puntuación automática
|
|
104
|
-
- **IntentClassifier** - Clasificación de comandos ELSABRO
|
|
105
|
-
- **WakeWordDetector** - "Hey ELSABRO" on-device
|
|
106
|
-
- **MultiLanguageSupport** - Español, inglés, portugués
|
|
107
|
-
- **AudioFeedback** - Respuestas TTS configurables
|
|
108
|
-
|
|
109
|
-
### AI Code Suggestions
|
|
110
|
-
- **CodeSuggestionEngine** - Sugerencias contextuales inteligentes
|
|
111
|
-
- **CompletionProvider** - Autocompletado inline tipo Copilot
|
|
112
|
-
- **RefactoringAdvisor** - Extract function, rename, move suggestions
|
|
113
|
-
- **PatternDetector** - Anti-patterns y SOLID violations
|
|
114
|
-
- **SecurityScanner** - OWASP Top 10, secrets en código
|
|
115
|
-
- **TestSuggester** - Tests unitarios sugeridos automáticamente
|
|
116
|
-
|
|
117
|
-
### IDE Integrations
|
|
118
|
-
- **VSCodeExtension** - Extension completa con sidebar y CodeLens
|
|
119
|
-
- **JetBrainsPlugin** - IntelliJ, WebStorm, PyCharm
|
|
120
|
-
- **LSPServer** - Language Server Protocol para cualquier editor
|
|
121
|
-
- **InlineAnnotations** - Decorations y hover con info de agentes
|
|
122
|
-
- **StatusBarIntegration** - Estado de sesión y progreso
|
|
123
|
-
|
|
124
|
-
## 🚀 Novedades v3.6 (Enterprise Scale Release)
|
|
125
|
-
|
|
126
|
-
### Agent Marketplace (Inspirado en NPM/Homebrew)
|
|
127
|
-
- **MarketplaceRegistry** - Descubrimiento y listado de agentes comunitarios
|
|
128
|
-
- **AgentPackager** - Empaquetado con firma criptográfica y versionado semántico
|
|
129
|
-
- **PublishingPipeline** - Review automatizado y publicación segura
|
|
130
|
-
- **ReviewSystem** - Ratings, reviews y reportes de la comunidad
|
|
131
|
-
- **InstallationManager** - Sandboxing con permisos granulares
|
|
132
|
-
|
|
133
|
-
### Multi-LLM Providers (Inspirado en LiteLLM)
|
|
134
|
-
- **ProviderRegistry** - Gestión unificada de múltiples proveedores
|
|
135
|
-
- **ModelRouter** - Routing inteligente basado en costo/latencia/capacidad
|
|
136
|
-
- Soporte para: Claude, OpenAI, Gemini, Azure OpenAI, Ollama (local)
|
|
137
|
-
- **CostOptimizer** - Minimización de costos manteniendo calidad
|
|
138
|
-
- **ProviderHealthChecker** - Circuit breaker y failover automático
|
|
139
|
-
|
|
140
|
-
### Kubernetes Deployment (Inspirado en Helm/ArgoCD)
|
|
141
|
-
- **K8sDeployer** - Deployment automatizado con zero-downtime
|
|
142
|
-
- **HelmChartGenerator** - Charts con values por environment
|
|
143
|
-
- **ResourceScaler** - HPA/VPA con custom metrics (queue_length, active_agents)
|
|
144
|
-
- **HealthMonitor** - Probes, métricas Prometheus y alertas
|
|
145
|
-
- Infraestructura: Redis, PostgreSQL, RabbitMQ incluidos
|
|
146
|
-
|
|
147
|
-
### Enterprise SSO (Inspirado en Auth0)
|
|
148
|
-
- **SSOManager** - Autenticación unificada enterprise
|
|
149
|
-
- **SAML 2.0** - Integración con IdPs corporativos
|
|
150
|
-
- **OIDC/OAuth 2.0** - OpenID Connect con PKCE
|
|
151
|
-
- **SCIM 2.0** - Provisioning y deprovisioning automático
|
|
152
|
-
- Integraciones: Okta, Azure AD, Google Workspace, Keycloak
|
|
153
|
-
|
|
154
|
-
## 🚀 Novedades v3.5 (Collaboration & UX Release)
|
|
155
|
-
|
|
156
|
-
### Flow Visualization (Inspirado en n8n/Langflow)
|
|
157
|
-
- **FlowVisualizer** - Renderizado de flows como grafos interactivos
|
|
158
|
-
- **GraphRenderer** - Múltiples modos: ASCII (terminal), SVG, HTML
|
|
159
|
-
- **Layout algorithms** - Dagre, ELK, force-directed, tree, radial
|
|
160
|
-
- **NodeEditor** - Configuración visual de nodos con templates
|
|
161
|
-
- **ConnectionManager** - Validación automática y detección de ciclos
|
|
162
|
-
|
|
163
|
-
### Multi-Project Memory (Inspirado en Notion AI)
|
|
164
|
-
- **SharedMemoryHub** - Conocimiento compartido entre proyectos
|
|
165
|
-
- **ProjectLinker** - Relaciones y herencia entre proyectos
|
|
166
|
-
- **KnowledgeSync** - Sincronización con manejo de conflictos
|
|
167
|
-
- **CrossProjectSearch** - Búsqueda semántica cross-project
|
|
168
|
-
- **KnowledgeExtractor** - Auto-extracción de patterns y mistakes
|
|
169
|
-
|
|
170
|
-
### Collaborative Sessions (Inspirado en Google Docs/Figma)
|
|
171
|
-
- **SessionManager** - Sesiones multi-usuario en tiempo real
|
|
172
|
-
- **RealtimeSync** - WebSocket con reconexión automática
|
|
173
|
-
- **ConflictResolver** - OT (Operational Transformation) para edición concurrente
|
|
174
|
-
- **PresenceTracker** - Cursores, avatares y actividad en tiempo real
|
|
175
|
-
- Roles: host, editor, viewer con permisos granulares
|
|
176
|
-
|
|
177
|
-
### Performance Profiler (Inspirado en Chrome DevTools)
|
|
178
|
-
- **Profiler** - Sampling y tracing de agentes/flows/tools
|
|
179
|
-
- **BottleneckDetector** - Identificación automática de cuellos de botella
|
|
180
|
-
- **MemoryAnalyzer** - Detección de memory leaks
|
|
181
|
-
- **LatencyTracker** - Percentiles P50/P95/P99 con SLO monitoring
|
|
182
|
-
- **Dashboard ASCII** - Visualización en terminal con recomendaciones
|
|
183
|
-
|
|
184
|
-
## 🚀 Novedades v3.4 (Enterprise Release)
|
|
185
|
-
|
|
186
|
-
### Testing Framework (Inspirado en Jest + Pytest)
|
|
187
|
-
- **AgentTestRunner** - Suites de tests con setup/teardown y retries
|
|
188
|
-
- **MockProvider** - Mocking de LLM y herramientas
|
|
189
|
-
- **SimulationEngine** - Testing de escenarios multi-agente
|
|
190
|
-
- **AssertionEngine** - 12+ tipos de assertions (behavioral, property, semantic)
|
|
191
|
-
- **Coverage tracking** - Métricas de cobertura por agente, flow y tool
|
|
192
|
-
|
|
193
|
-
### Security System (Enterprise-grade)
|
|
194
|
-
- **RBAC** - Control de acceso basado en roles con herencia
|
|
195
|
-
- **SecretsVault** - Cifrado AES-256-GCM con rotación automática
|
|
196
|
-
- **AuditLogger** - Logging de seguridad con alertas automáticas
|
|
197
|
-
- **PolicyEngine** - Policies con conditions (time, IP, rate_limit)
|
|
198
|
-
- Built-in roles: admin, agent:explore, agent:implement, agent:review
|
|
199
|
-
|
|
200
|
-
### Configuration Management (Inspirado en Firebase Remote Config)
|
|
201
|
-
- **ConfigManager** - Multi-source loading (file, env, remote)
|
|
202
|
-
- **FeatureFlags** - Targeting, percentage rollout, schedules
|
|
203
|
-
- **EnvResolver** - Variables con herencia y secretos
|
|
204
|
-
- **ConfigValidator** - JSON Schema validation con coerción de tipos
|
|
205
|
-
- **RemoteConfigSync** - Actualización sin re-deploy con fallback
|
|
206
|
-
|
|
207
|
-
### Plugin System (Inspirado en VSCode Extensions)
|
|
208
|
-
- **PluginLoader** - Discovery, validación y carga dinámica
|
|
209
|
-
- **PluginRegistry** - Contribuciones (agents, tools, commands, hooks)
|
|
210
|
-
- **PluginManager** - Lifecycle completo con hot-reload
|
|
211
|
-
- **HookSystem** - Middleware chain para extensibilidad
|
|
212
|
-
- **Sandboxing** - Aislamiento y permisos granulares
|
|
213
|
-
|
|
214
|
-
## 🚀 Novedades v3.0-v3.3
|
|
215
|
-
|
|
216
|
-
### Persistent Checkpointing (Inspirado en LangGraph)
|
|
217
|
-
- **Estado serializable** entre sesiones - nunca pierdas progreso
|
|
218
|
-
- **Snapshots automáticos** por fase y wave
|
|
219
|
-
- **Rollback** a cualquier punto anterior
|
|
220
|
-
- **Time-travel debugging** para analizar decisiones pasadas
|
|
221
|
-
- **Resume from interrupt** después de pausas
|
|
222
|
-
|
|
223
|
-
### Multi-Level Memory (Inspirado en CrewAI)
|
|
224
|
-
- **Short-term memory** - Contexto de sesión actual
|
|
225
|
-
- **Long-term memory** - Patrones y errores persistentes
|
|
226
|
-
- **Entity memory** - Conocimiento del codebase (archivos, funciones, relaciones)
|
|
227
|
-
- **Contextual memory** - RAG semántico para búsqueda inteligente
|
|
228
|
-
- **Auto-learning** - Detecta correcciones y aprende automáticamente
|
|
229
|
-
|
|
230
|
-
### Flow-Based Orchestration (Inspirado en LangGraph)
|
|
231
|
-
- **Workflows declarativos** - Define flujos como grafos JSON
|
|
232
|
-
- **Conditional routing** - Enrutamiento basado en condiciones
|
|
233
|
-
- **Parallel branches** - Ejecución paralela nativa
|
|
234
|
-
- **Subflows reutilizables** - Composición de workflows
|
|
235
|
-
- **10 tipos de nodos** - entry, agent, router, condition, parallel, sequence, subflow, interrupt, loop, exit
|
|
236
|
-
|
|
237
|
-
### Error Contracts v2 (10 contratos)
|
|
238
|
-
- **Circuit Breaker** - Previene cascadas de fallos
|
|
239
|
-
- **Bulkhead** - Aísla recursos por partición
|
|
240
|
-
- **Fallback** - Degradación graceful con alternativas
|
|
241
|
-
- Plus los 7 contratos originales (Registry, Lifecycle, Timeout, Retry, Aggregator, Severity, Session)
|
|
242
|
-
|
|
243
|
-
### Sistema de Interrupts
|
|
244
|
-
- **Approval gates** - Aprobación antes de acciones críticas
|
|
245
|
-
- **Decision points** - Usuario elige entre opciones
|
|
246
|
-
- **Error recovery** - Intervención cuando auto-fix falla
|
|
247
|
-
- **Progress checkpoints** - Pausas programáticas
|
|
248
|
-
- **Confirmation dialogs** - Confirmar acciones destructivas
|
|
249
|
-
|
|
250
|
-
### Novedades v2.3 (Incluidas)
|
|
251
|
-
- **7 contratos de error** para ejecución paralela confiable
|
|
252
|
-
- **Sistema de memoria persistente** - Aprende de tus correcciones
|
|
253
|
-
- **Hooks automáticos** - Tests y lint al guardar
|
|
254
|
-
- **Git worktrees** - Aislamiento real para agentes paralelos
|
|
255
|
-
|
|
256
|
-
### Base Sólida (v2.0)
|
|
257
|
-
- **12 Agentes Especializados** basados en BMAD-METHOD
|
|
258
|
-
- **31+ Comandos** para todo el ciclo de desarrollo
|
|
259
|
-
- **3 Perfiles** (default, yolo, careful) para diferentes estilos
|
|
260
|
-
- **Context7** integrado para documentación actualizada
|
|
261
|
-
- **21st.dev** integrado para componentes UI
|
|
262
|
-
|
|
263
|
-
## ¿Para Quién es ELSABRO?
|
|
264
|
-
|
|
265
|
-
- **Emprendedores** con ideas pero sin conocimientos técnicos
|
|
266
|
-
- **Diseñadores** que quieren prototipar sus diseños
|
|
1
|
+
# ELSABRO v7.1.0
|
|
2
|
+
|
|
3
|
+
**Tu asistente AI para crear apps increibles** — Orquestacion de agentes con flow engine, checkpointing y ejecucion paralela.
|
|
4
|
+
|
|
5
|
+
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.
|
|
6
|
+
|
|
7
|
+
## Que Hay de Nuevo en v7.1.0
|
|
8
|
+
|
|
9
|
+
- **Flow Engine Runtime** — Motor de ejecucion basado en grafos con 9 tipos de nodos, resolución de templates, y checkpointing automatico
|
|
10
|
+
- **CLI de 6 comandos** — validate, dry-run, init, step, complete, status
|
|
11
|
+
- **PartyEngine** — Discusiones multi-agente con seleccion automatica de participantes
|
|
12
|
+
- **CallbackProtocol** — Composicion automatica de Agent Teams (minimo 5 miembros)
|
|
13
|
+
- **279 tests** — Zero dependencias externas, Node 18+
|
|
14
|
+
- **Design-UI Routing** — Integracion con Stitch AI para generar pantallas desde texto
|
|
15
|
+
|
|
16
|
+
## Para Quien es ELSABRO?
|
|
17
|
+
|
|
18
|
+
- **Emprendedores** con ideas pero sin conocimientos tecnicos
|
|
19
|
+
- **Disenadores** que quieren prototipar sus disenos
|
|
267
20
|
- **Desarrolladores** que quieren acelerar su workflow
|
|
268
21
|
- **Cualquiera** que tenga una idea y quiera convertirla en realidad
|
|
269
22
|
|
|
270
|
-
##
|
|
23
|
+
## Instalacion
|
|
271
24
|
|
|
272
25
|
### Con NPX (Recomendado)
|
|
273
26
|
```bash
|
|
@@ -284,657 +37,204 @@ pnpm dlx elsabro --global
|
|
|
284
37
|
bunx elsabro --global
|
|
285
38
|
```
|
|
286
39
|
|
|
287
|
-
|
|
40
|
+
Despues de instalar, abre Claude Code y escribe:
|
|
288
41
|
```
|
|
289
42
|
/elsabro:start
|
|
290
43
|
```
|
|
291
44
|
|
|
45
|
+
## Quick Start
|
|
46
|
+
|
|
47
|
+
```
|
|
48
|
+
1. /elsabro:start — Wizard interactivo para empezar
|
|
49
|
+
2. /elsabro:new-milestone — Crear milestone con objetivos
|
|
50
|
+
3. /elsabro:plan 1 — Planificar la primera fase
|
|
51
|
+
4. /elsabro:execute 1 — Ejecutar con TDD y verificacion
|
|
52
|
+
5. /elsabro:verify-work — Verificar con 3 agentes paralelos
|
|
53
|
+
```
|
|
54
|
+
|
|
292
55
|
## Comandos
|
|
293
56
|
|
|
294
57
|
### Getting Started
|
|
295
|
-
| Comando |
|
|
58
|
+
| Comando | Descripcion |
|
|
296
59
|
|---------|-------------|
|
|
297
60
|
| `/elsabro:start` | Wizard para empezar (recomendado) |
|
|
298
61
|
| `/elsabro:new` | Crear un proyecto nuevo |
|
|
299
62
|
| `/elsabro:help` | Ver todos los comandos |
|
|
300
63
|
|
|
301
64
|
### Core Workflow
|
|
302
|
-
| Comando |
|
|
65
|
+
| Comando | Descripcion |
|
|
303
66
|
|---------|-------------|
|
|
304
67
|
| `/elsabro:plan` | Planificar una fase o feature |
|
|
305
|
-
| `/elsabro:execute` | Ejecutar un plan |
|
|
306
|
-
| `/elsabro:verify` |
|
|
307
|
-
| `/elsabro:
|
|
308
|
-
| `/elsabro:quick` | Ejecución rápida (YOLO mode) |
|
|
68
|
+
| `/elsabro:execute` | Ejecutar un plan con TDD |
|
|
69
|
+
| `/elsabro:verify-work` | Verificacion completa con agentes paralelos |
|
|
70
|
+
| `/elsabro:quick` | Ejecucion rapida para tareas simples |
|
|
309
71
|
|
|
310
72
|
### Milestone Management
|
|
311
|
-
| Comando |
|
|
73
|
+
| Comando | Descripcion |
|
|
312
74
|
|---------|-------------|
|
|
313
75
|
| `/elsabro:new-milestone` | Crear nuevo milestone |
|
|
314
76
|
| `/elsabro:complete-milestone` | Cerrar milestone completado |
|
|
315
77
|
| `/elsabro:audit-milestone` | Auditar estado de milestone |
|
|
316
|
-
| `/elsabro:
|
|
78
|
+
| `/elsabro:progress` | Ver progreso actual |
|
|
317
79
|
|
|
318
80
|
### Phase Management
|
|
319
|
-
| Comando |
|
|
81
|
+
| Comando | Descripcion |
|
|
320
82
|
|---------|-------------|
|
|
321
83
|
| `/elsabro:add-phase` | Agregar fase al final |
|
|
322
|
-
| `/elsabro:insert-phase` | Insertar fase en
|
|
84
|
+
| `/elsabro:insert-phase` | Insertar fase en posicion |
|
|
323
85
|
| `/elsabro:remove-phase` | Eliminar fase |
|
|
324
86
|
| `/elsabro:discuss-phase` | Discutir scope de fase |
|
|
325
|
-
| `/elsabro:research-phase` | Investigar
|
|
326
|
-
| `/elsabro:list-phase-assumptions` | Listar asunciones de fase |
|
|
327
|
-
|
|
328
|
-
### Session Management
|
|
329
|
-
| Comando | Descripción |
|
|
330
|
-
|---------|-------------|
|
|
331
|
-
| `/elsabro:resume-work` | Retomar trabajo guardado |
|
|
332
|
-
| `/elsabro:pause-work` | Pausar y guardar contexto |
|
|
333
|
-
| `/elsabro:progress` | Ver progreso actual |
|
|
334
|
-
| `/elsabro:exit` | Desactivar persistent mode |
|
|
87
|
+
| `/elsabro:research-phase` | Investigar tecnologias para fase |
|
|
335
88
|
|
|
336
|
-
###
|
|
337
|
-
| Comando |
|
|
89
|
+
### Productividad
|
|
90
|
+
| Comando | Descripcion |
|
|
338
91
|
|---------|-------------|
|
|
339
|
-
| `/elsabro:
|
|
340
|
-
| `/elsabro:
|
|
341
|
-
|
|
342
|
-
### Debugging & Analysis
|
|
343
|
-
| Comando | Descripción |
|
|
344
|
-
|---------|-------------|
|
|
345
|
-
| `/elsabro:debug` | Investigar y arreglar problemas |
|
|
92
|
+
| `/elsabro:debug` | Debugging sistematico |
|
|
93
|
+
| `/elsabro:party` | Discusion multi-agente colaborativa |
|
|
94
|
+
| `/elsabro:design-ui` | Disenar interfaces con Stitch AI |
|
|
346
95
|
| `/elsabro:map-codebase` | Generar mapa del codebase |
|
|
347
96
|
|
|
348
|
-
###
|
|
349
|
-
| Comando |
|
|
350
|
-
|---------|-------------|
|
|
351
|
-
| `/elsabro:tutor` | Aprende con método socrático |
|
|
352
|
-
| `/elsabro:audit-debt` | Escanea deuda técnica |
|
|
353
|
-
| `/elsabro:review` | Code review profesional |
|
|
354
|
-
| `/elsabro:memory` | Gestiona memoria persistente |
|
|
355
|
-
|
|
356
|
-
### Flow & Checkpointing (Nuevo en v3.0)
|
|
357
|
-
| Comando | Descripción |
|
|
358
|
-
|---------|-------------|
|
|
359
|
-
| `/elsabro:flow list` | Listar flows disponibles |
|
|
360
|
-
| `/elsabro:flow run <name>` | Ejecutar un flow |
|
|
361
|
-
| `/elsabro:flow status` | Ver estado del flow actual |
|
|
362
|
-
| `/elsabro:checkpoint save` | Guardar checkpoint manual |
|
|
363
|
-
| `/elsabro:checkpoint list` | Listar checkpoints |
|
|
364
|
-
| `/elsabro:checkpoint restore <id>` | Restaurar checkpoint |
|
|
365
|
-
| `/elsabro:interrupt list` | Ver interrupts pendientes |
|
|
366
|
-
| `/elsabro:interrupt respond` | Responder a interrupt |
|
|
367
|
-
|
|
368
|
-
### Settings
|
|
369
|
-
| Comando | Descripción |
|
|
97
|
+
### Session & Settings
|
|
98
|
+
| Comando | Descripcion |
|
|
370
99
|
|---------|-------------|
|
|
371
|
-
| `/elsabro:
|
|
100
|
+
| `/elsabro:resume-work` | Retomar trabajo guardado |
|
|
101
|
+
| `/elsabro:pause-work` | Pausar y guardar contexto |
|
|
102
|
+
| `/elsabro:settings` | Ver/modificar configuracion |
|
|
372
103
|
| `/elsabro:set-profile` | Cambiar perfil |
|
|
373
|
-
| `/elsabro:
|
|
374
|
-
|
|
375
|
-
## Agentes Especializados
|
|
376
|
-
|
|
377
|
-
| Agente | Nombre | Especialidad |
|
|
378
|
-
|--------|--------|--------------|
|
|
379
|
-
| `elsabro-analyst` | Mary | Análisis y research |
|
|
380
|
-
| `elsabro-planner` | Winston | Planificación técnica |
|
|
381
|
-
| `elsabro-executor` | Amelia | Implementación de código |
|
|
382
|
-
| `elsabro-debugger` | Sherlock | Debugging sistemático |
|
|
383
|
-
| `elsabro-verifier` | Quincy | Verificación de calidad |
|
|
384
|
-
| `elsabro-orchestrator` | Quantum | Coordinación de agentes paralelos |
|
|
385
|
-
| `elsabro-scrum-master` | Bob | Gestión de sprints |
|
|
386
|
-
| `elsabro-qa` | Murat | Testing y calidad |
|
|
387
|
-
| `elsabro-ux-designer` | Sally | Diseño de experiencia |
|
|
388
|
-
| `elsabro-tech-writer` | Paige | Documentación técnica |
|
|
389
|
-
| `elsabro-quick-dev` | Barry | Desarrollo rápido |
|
|
390
|
-
| `elsabro-yolo-dev` | Flash | Desarrollo ultra-rápido |
|
|
391
|
-
|
|
392
|
-
## Error Contracts v2 (v3.0)
|
|
393
|
-
|
|
394
|
-
ELSABRO v3.0 incluye 10 contratos de error para garantizar resiliencia enterprise:
|
|
395
|
-
|
|
396
|
-
### Contratos Base (v2.3)
|
|
397
|
-
| Contrato | Función |
|
|
398
|
-
|----------|---------|
|
|
399
|
-
| `ContractRegistryValidator` | Valida que agentes existen antes de ejecutar |
|
|
400
|
-
| `ContractTaskLifecycle` | Estados explícitos: INIT → ACTIVE → COMPLETE |
|
|
401
|
-
| `ContractTimeoutHandler` | Timeouts automáticos con escalación |
|
|
402
|
-
| `ContractRetryPolicy` | Retry con backoff exponencial (1s, 2s, 4s) |
|
|
403
|
-
| `ContractErrorAggregator` | Políticas: fail_fast, quorum, continue_all |
|
|
404
|
-
| `ContractSeverityClassifier` | Clasifica: CRITICAL, HIGH, MEDIUM, LOW |
|
|
405
|
-
| `ContractSessionValidator` | Valida integridad de sesiones |
|
|
406
|
-
|
|
407
|
-
### Nuevos Contratos de Resiliencia (v3.0)
|
|
408
|
-
| Contrato | Función |
|
|
409
|
-
|----------|---------|
|
|
410
|
-
| `ContractCircuitBreaker` | Previene cascadas de fallos (CLOSED → OPEN → HALF_OPEN) |
|
|
411
|
-
| `ContractBulkhead` | Aísla recursos por partición (max concurrency) |
|
|
412
|
-
| `ContractFallback` | Degradación graceful con alternativas |
|
|
413
|
-
|
|
414
|
-
### Políticas de Agregación
|
|
415
|
-
|
|
416
|
-
```
|
|
417
|
-
fail_fast → Para al primer error
|
|
418
|
-
quorum → Continúa si >50% tiene éxito
|
|
419
|
-
continue_all → Continúa siempre (con mínimo 1 éxito)
|
|
420
|
-
```
|
|
421
|
-
|
|
422
|
-
### Estrategias de Fallback
|
|
423
|
-
|
|
424
|
-
```
|
|
425
|
-
alternative_agent → Usa agente alternativo
|
|
426
|
-
simplified → Operación simplificada
|
|
427
|
-
cached → Resultado cacheado
|
|
428
|
-
default → Valor por defecto
|
|
429
|
-
manual → Intervención del usuario
|
|
430
|
-
skip → Skip graceful
|
|
431
|
-
```
|
|
432
|
-
|
|
433
|
-
## Sistema de Memoria Multi-Nivel (v3.0)
|
|
434
|
-
|
|
435
|
-
ELSABRO tiene 4 niveles de memoria que trabajan juntos:
|
|
436
|
-
|
|
437
|
-
### Arquitectura de Memoria
|
|
438
|
-
|
|
439
|
-
```
|
|
440
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
441
|
-
│ SHORT-TERM │ LONG-TERM │ ENTITY │ RAG │
|
|
442
|
-
│ (Sesión) │ (Persistente) │ (Codebase) │ │
|
|
443
|
-
├─────────────────────────────────────────────────────────────┤
|
|
444
|
-
│ • Conversación │ • patterns.md │ • Archivos │ Search │
|
|
445
|
-
│ • Decisiones │ • mistakes.md │ • Funciones │ semán- │
|
|
446
|
-
│ • Archivos │ • preferences │ • Relaciones │ tico │
|
|
447
|
-
│ • Contexto │ • learnings │ • Historial │ │
|
|
448
|
-
└─────────────────────────────────────────────────────────────┘
|
|
449
|
-
```
|
|
450
|
-
|
|
451
|
-
### Estructura de Archivos
|
|
452
|
-
|
|
453
|
-
```
|
|
454
|
-
.planning/
|
|
455
|
-
├── memory/
|
|
456
|
-
│ ├── short-term/ # Estado de sesión
|
|
457
|
-
│ ├── long-term/ # Aprendizajes persistentes
|
|
458
|
-
│ ├── entity/ # Info del codebase
|
|
459
|
-
│ └── contextual/ # Índice para RAG
|
|
460
|
-
├── CLAUDE.md # Memoria del proyecto
|
|
461
|
-
├── mistakes.md # Errores a evitar
|
|
462
|
-
├── patterns.md # Patrones preferidos
|
|
463
|
-
└── checkpoints/ # Checkpoints para recovery
|
|
464
|
-
```
|
|
465
|
-
|
|
466
|
-
### Triggers Automáticos
|
|
467
|
-
|
|
468
|
-
ELSABRO detecta cuando le corriges:
|
|
469
|
-
- "No, hazlo así..."
|
|
470
|
-
- "Siempre usa X en vez de Y"
|
|
471
|
-
- "En este proyecto preferimos..."
|
|
472
|
-
|
|
473
|
-
Y guarda el aprendizaje automáticamente.
|
|
474
|
-
|
|
475
|
-
## Hooks Automáticos (v2.3)
|
|
476
|
-
|
|
477
|
-
| Hook | Trigger | Función |
|
|
478
|
-
|------|---------|---------|
|
|
479
|
-
| `post-edit-test` | Al editar código | Ejecuta tests automáticamente |
|
|
480
|
-
| `lint-check` | Al guardar | Ejecuta linter |
|
|
481
|
-
| `confirm-destructive` | Comandos peligrosos | Pide confirmación |
|
|
482
|
-
|
|
483
|
-
### Perfiles de Hooks
|
|
484
|
-
|
|
485
|
-
```bash
|
|
486
|
-
# En settings
|
|
487
|
-
/elsabro:settings hooks.profile development # Tests + lint
|
|
488
|
-
/elsabro:settings hooks.profile fast # Sin hooks
|
|
489
|
-
/elsabro:settings hooks.profile careful # Todo + confirmaciones
|
|
490
|
-
/elsabro:settings hooks.profile ci # Solo tests
|
|
491
|
-
```
|
|
104
|
+
| `/elsabro:exit` | Desactivar persistent mode |
|
|
492
105
|
|
|
493
|
-
##
|
|
106
|
+
## Flow Engine
|
|
494
107
|
|
|
495
|
-
|
|
108
|
+
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.
|
|
496
109
|
|
|
497
|
-
|
|
498
|
-
# Crear worktree para agente
|
|
499
|
-
./scripts/setup-parallel-worktrees.sh create feature-auth
|
|
110
|
+
### Arquitectura
|
|
500
111
|
|
|
501
|
-
# Mergear cambios
|
|
502
|
-
./scripts/setup-parallel-worktrees.sh merge feature-auth
|
|
503
|
-
|
|
504
|
-
# Limpiar
|
|
505
|
-
./scripts/setup-parallel-worktrees.sh cleanup
|
|
506
112
|
```
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
{ "agent": "Plan" },
|
|
523
|
-
{ "agent": "feature-dev:code-explorer" }
|
|
524
|
-
]},
|
|
525
|
-
{ "id": "implement", "type": "parallel", "branches": [
|
|
526
|
-
{ "agent": "elsabro-executor" },
|
|
527
|
-
{ "agent": "elsabro-qa" }
|
|
528
|
-
]},
|
|
529
|
-
{ "id": "review", "type": "parallel", "branches": [
|
|
530
|
-
{ "agent": "pr-review-toolkit:code-reviewer" },
|
|
531
|
-
{ "agent": "pr-review-toolkit:silent-failure-hunter" }
|
|
532
|
-
]}
|
|
533
|
-
]
|
|
534
|
-
}
|
|
113
|
+
JSON Flow Definition (44 nodos)
|
|
114
|
+
|
|
|
115
|
+
v
|
|
116
|
+
graph.js — Construye Map + valida referencias
|
|
117
|
+
|
|
|
118
|
+
v
|
|
119
|
+
runner.js — While-loop: nodo → executor → checkpoint → siguiente
|
|
120
|
+
|
|
|
121
|
+
v
|
|
122
|
+
executors.js — 9 tipos de nodos (entry, exit, condition, router,
|
|
123
|
+
sequence, agent, parallel, interrupt, team)
|
|
124
|
+
|
|
|
125
|
+
v
|
|
126
|
+
callbacks — onAgent, onBash, onParallel, onInterrupt...
|
|
127
|
+
(inyectados en runtime, el engine no sabe de Claude Code)
|
|
535
128
|
```
|
|
536
129
|
|
|
537
|
-
|
|
130
|
+
- **279 tests**, 75 suites, 0 dependencias externas
|
|
131
|
+
- **Checkpoint despues de cada nodo** — recuperacion automatica desde cualquier punto
|
|
132
|
+
- **Template resolver** — 7 tipos de expresiones `{{...}}` sin `eval()`
|
|
538
133
|
|
|
539
|
-
|
|
540
|
-
|------|-------------|
|
|
541
|
-
| `entry` | Punto de entrada |
|
|
542
|
-
| `agent` | Ejecuta un agente |
|
|
543
|
-
| `parallel` | Ejecuta ramas en paralelo |
|
|
544
|
-
| `sequence` | Ejecuta pasos secuencialmente |
|
|
545
|
-
| `router` | Enruta según condiciones |
|
|
546
|
-
| `condition` | Bifurcación binaria |
|
|
547
|
-
| `subflow` | Ejecuta otro flow |
|
|
548
|
-
| `interrupt` | Pausa para input del usuario |
|
|
549
|
-
| `loop` | Repite hasta condición |
|
|
550
|
-
| `exit` | Punto de salida |
|
|
134
|
+
Para mas detalles ver [ARCHITECTURE.md](ARCHITECTURE.md).
|
|
551
135
|
|
|
552
|
-
###
|
|
136
|
+
### CLI
|
|
553
137
|
|
|
554
|
-
|
|
555
|
-
- `quick_flow` - Workflow simplificado para tareas rápidas
|
|
556
|
-
- `review_flow` - Code review multi-agente
|
|
557
|
-
- `debug_flow` - Debugging sistemático
|
|
558
|
-
|
|
559
|
-
## Checkpointing (v3.0)
|
|
560
|
-
|
|
561
|
-
Nunca pierdas progreso con checkpoints automáticos:
|
|
138
|
+
Control manual del flujo con 6 comandos:
|
|
562
139
|
|
|
563
140
|
```bash
|
|
564
|
-
#
|
|
565
|
-
/
|
|
566
|
-
|
|
567
|
-
# Ver checkpoints disponibles
|
|
568
|
-
/elsabro:checkpoint list
|
|
569
|
-
|
|
570
|
-
# Restaurar a punto anterior
|
|
571
|
-
/elsabro:checkpoint restore chk_20240120_abc123
|
|
572
|
-
|
|
573
|
-
# Time-travel: ver estado en un punto
|
|
574
|
-
/elsabro:checkpoint diff chk_1 chk_2
|
|
575
|
-
```
|
|
576
|
-
|
|
577
|
-
### Triggers Automáticos de Checkpoint
|
|
578
|
-
|
|
579
|
-
- `PHASE_START` - Al iniciar fase
|
|
580
|
-
- `PHASE_COMPLETE` - Al completar fase
|
|
581
|
-
- `WAVE_COMPLETE` - Al completar wave paralela
|
|
582
|
-
- `INTERRUPT` - Al pausar para input
|
|
583
|
-
- `INTERVAL` - Cada N minutos (configurable)
|
|
141
|
+
# Validar flow y ver composicion de teams
|
|
142
|
+
node flow-engine/src/cli.js validate --flow flows/development-flow.json
|
|
584
143
|
|
|
585
|
-
|
|
144
|
+
# Dry-run completo con mock callbacks
|
|
145
|
+
node flow-engine/src/cli.js dry-run --flow flows/development-flow.json --task "feature" --profile default
|
|
586
146
|
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
/
|
|
591
|
-
/
|
|
592
|
-
/elsabro:telemetry traces # Ver traces recientes
|
|
147
|
+
# Ejecucion paso a paso
|
|
148
|
+
node flow-engine/src/cli.js init --flow flows/development-flow.json --task "build auth" --profile default
|
|
149
|
+
node flow-engine/src/cli.js step --flow flows/development-flow.json
|
|
150
|
+
node flow-engine/src/cli.js complete --flow flows/development-flow.json --result '{"output": "done"}'
|
|
151
|
+
node flow-engine/src/cli.js status --flow flows/development-flow.json
|
|
593
152
|
```
|
|
594
153
|
|
|
595
|
-
|
|
596
|
-
- Distributed tracing (spans por agente)
|
|
597
|
-
- Métricas (counters, gauges, histograms)
|
|
598
|
-
- Logging estructurado con trace context
|
|
599
|
-
- Dashboard ASCII sin dependencias externas
|
|
600
|
-
|
|
601
|
-
## Progress Streaming (v3.1)
|
|
602
|
-
|
|
603
|
-
Ver progreso en tiempo real con 3 modos:
|
|
604
|
-
|
|
605
|
-
| Modo | Descripción |
|
|
606
|
-
|------|-------------|
|
|
607
|
-
| `values` | Estado completo después de cada operación |
|
|
608
|
-
| `updates` | Solo deltas/cambios (más eficiente) |
|
|
609
|
-
| `messages` | Texto legible para humanos |
|
|
610
|
-
|
|
611
|
-
```bash
|
|
612
|
-
/elsabro:stream mode messages # Cambiar a modo messages (default)
|
|
613
|
-
/elsabro:stream mode updates # Cambiar a modo updates
|
|
614
|
-
```
|
|
615
|
-
|
|
616
|
-
## Output Schemas (v3.1)
|
|
617
|
-
|
|
618
|
-
Validación automática de outputs de agentes:
|
|
619
|
-
|
|
620
|
-
| Schema | Agentes | Campos Requeridos |
|
|
621
|
-
|--------|---------|-------------------|
|
|
622
|
-
| `analysis` | analyst, Explore, Plan | summary, files, recommendations |
|
|
623
|
-
| `implementation` | executor, quick-dev | success |
|
|
624
|
-
| `review` | code-reviewer | approved, issues, summary |
|
|
625
|
-
| `verification` | verifier, qa | passed, tests, typescript, lint |
|
|
626
|
-
| `plan` | planner | phases |
|
|
154
|
+
### Flow Definitions
|
|
627
155
|
|
|
628
|
-
|
|
156
|
+
ELSABRO incluye 2 flow definitions:
|
|
157
|
+
- `flows/development-flow.json` — Flujo completo de desarrollo (44 nodos, ~1080 lineas)
|
|
158
|
+
- `flows/quick-flow.json` — Flujo rapido para tareas simples (8 nodos)
|
|
629
159
|
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
### Comandos
|
|
633
|
-
|
|
634
|
-
```bash
|
|
635
|
-
/elsabro:timeline # Ver timeline completo
|
|
636
|
-
/elsabro:timeline back 5 # Retroceder 5 pasos
|
|
637
|
-
/elsabro:timeline goto cp3 # Ir a checkpoint específico
|
|
638
|
-
|
|
639
|
-
/elsabro:replay # Reproducir ejecución paso a paso
|
|
640
|
-
/elsabro:replay speed 2.0 # Reproducir a 2x
|
|
641
|
-
|
|
642
|
-
/elsabro:whatif # Análisis de escenarios alternativos
|
|
643
|
-
/elsabro:whatif branch fix # Crear branch alternativo
|
|
644
|
-
```
|
|
645
|
-
|
|
646
|
-
### Visualización de Timeline
|
|
647
|
-
|
|
648
|
-
```
|
|
649
|
-
─────────────────────────────────────────────────────────────────
|
|
650
|
-
│ TIMELINE: flow_abc123 │
|
|
651
|
-
─────────────────────────────────────────────────────────────────
|
|
652
|
-
│ [1] ● INIT 00:00:00 Flow initialized │
|
|
653
|
-
│ [2] ● EXPLORE 00:00:15 4 haiku agents dispatched │
|
|
654
|
-
│ [3] ► CURRENT 00:01:30 Implementation in progress │
|
|
655
|
-
─────────────────────────────────────────────────────────────────
|
|
656
|
-
```
|
|
657
|
-
|
|
658
|
-
## Agent Protocol API (v3.2)
|
|
659
|
-
|
|
660
|
-
API REST estándar para interoperabilidad con otros frameworks de agentes:
|
|
661
|
-
|
|
662
|
-
### Endpoints
|
|
663
|
-
|
|
664
|
-
| Endpoint | Método | Descripción |
|
|
665
|
-
|----------|--------|-------------|
|
|
666
|
-
| `/api/v1/agent` | GET | Info del agente |
|
|
667
|
-
| `/api/v1/tasks` | GET/POST | CRUD de tareas |
|
|
668
|
-
| `/api/v1/tasks/:id/steps` | GET/POST | Pasos de tarea |
|
|
669
|
-
| `/api/v1/tasks/:id/artifacts` | GET/POST | Archivos generados |
|
|
670
|
-
|
|
671
|
-
### Compatibilidad
|
|
672
|
-
|
|
673
|
-
- Auto-GPT
|
|
674
|
-
- BabyAGI
|
|
675
|
-
- AgentGPT
|
|
676
|
-
- SuperAGI
|
|
677
|
-
- Cualquier cliente que implemente Agent Protocol
|
|
678
|
-
|
|
679
|
-
## Sandbox Execution (v3.2)
|
|
680
|
-
|
|
681
|
-
Ejecución segura de código en entornos aislados:
|
|
682
|
-
|
|
683
|
-
### Providers
|
|
684
|
-
|
|
685
|
-
| Provider | Seguridad | Velocidad | Lenguajes |
|
|
686
|
-
|----------|-----------|-----------|-----------|
|
|
687
|
-
| Docker | Alta | Media | Todos |
|
|
688
|
-
| E2B | Alta | Alta | Python, JS, TS |
|
|
689
|
-
| Firecracker | Muy Alta | Muy Alta | Todos |
|
|
690
|
-
| Process | Baja | Muy Alta | Todos |
|
|
691
|
-
|
|
692
|
-
### Límites de Recursos
|
|
693
|
-
|
|
694
|
-
- CPU: cores, percent
|
|
695
|
-
- Memory: limit, reservation
|
|
696
|
-
- Disk: limit, read-only
|
|
697
|
-
- Network: disabled by default
|
|
698
|
-
- PIDs: limit
|
|
699
|
-
|
|
700
|
-
## Event-Driven Architecture (v3.2)
|
|
701
|
-
|
|
702
|
-
Sistema de eventos para comunicación desacoplada:
|
|
703
|
-
|
|
704
|
-
### EventBus
|
|
705
|
-
|
|
706
|
-
```typescript
|
|
707
|
-
// Publicar evento
|
|
708
|
-
await eventBus.publish('agent.completed', { agentId, result });
|
|
709
|
-
|
|
710
|
-
// Suscribirse a eventos
|
|
711
|
-
eventBus.subscribe('agent.*', async (event) => {
|
|
712
|
-
console.log(event.type, event.payload);
|
|
713
|
-
});
|
|
714
|
-
```
|
|
715
|
-
|
|
716
|
-
### Features
|
|
717
|
-
|
|
718
|
-
- **Pub/Sub**: Comunicación asíncrona desacoplada
|
|
719
|
-
- **Event Sourcing**: Historial inmutable de eventos
|
|
720
|
-
- **Webhooks**: Integraciones externas configurables
|
|
721
|
-
- **Dead Letter Queue**: Manejo de eventos fallidos
|
|
722
|
-
- **Replay**: Reproducción de eventos históricos
|
|
723
|
-
|
|
724
|
-
## Cost Tracking & Optimization (v3.3)
|
|
725
|
-
|
|
726
|
-
Monitoreo de costos y optimización automática de modelos:
|
|
727
|
-
|
|
728
|
-
### Dashboard de Costos
|
|
729
|
-
|
|
730
|
-
```
|
|
731
|
-
╔═══════════════════════════════════════════════════════════╗
|
|
732
|
-
║ SESSION: $7.82 │ DAILY: 42% │ MONTHLY: 15% ║
|
|
733
|
-
╠═══════════════════════════════════════════════════════════╣
|
|
734
|
-
║ Haiku ████░░░░░░ $0.45 (6%) ║
|
|
735
|
-
║ Sonnet ██████░░░░ $2.87 (37%) ║
|
|
736
|
-
║ Opus ████████░░ $4.50 (57%) ║
|
|
737
|
-
╚═══════════════════════════════════════════════════════════╝
|
|
738
|
-
```
|
|
739
|
-
|
|
740
|
-
### Features
|
|
741
|
-
|
|
742
|
-
- **TokenTracker**: Metering por request con breakdown detallado
|
|
743
|
-
- **BudgetManager**: Presupuestos por sesión/día/mes con alertas
|
|
744
|
-
- **ModelOptimizer**: Selección automática de modelo según tarea
|
|
745
|
-
- **Savings Report**: Recomendaciones de ahorro
|
|
746
|
-
|
|
747
|
-
## Tool Registry (v3.3)
|
|
748
|
-
|
|
749
|
-
Registro dinámico de herramientas con discovery inteligente:
|
|
750
|
-
|
|
751
|
-
```typescript
|
|
752
|
-
// Descubrir herramientas por capacidad
|
|
753
|
-
const tools = discovery.suggest("need to read and edit files");
|
|
754
|
-
// Returns: [Read, Edit, Write, Glob]
|
|
755
|
-
|
|
756
|
-
// Buscar por categoría
|
|
757
|
-
const fileTools = registry.list({ category: 'file-ops' });
|
|
758
|
-
```
|
|
759
|
-
|
|
760
|
-
## Agent Collaboration Patterns (v3.3)
|
|
761
|
-
|
|
762
|
-
Patrones avanzados para orquestación multi-agente:
|
|
763
|
-
|
|
764
|
-
| Patrón | Descripción | Uso Ideal |
|
|
765
|
-
|--------|-------------|-----------|
|
|
766
|
-
| **Supervisor** | 1 coordinador + N workers | Subtareas independientes |
|
|
767
|
-
| **Hierarchical** | Árbol multinivel | Proyectos grandes |
|
|
768
|
-
| **Consensus** | Votación entre agentes | Decisiones críticas |
|
|
769
|
-
| **Debate** | Pro vs Con + Juez | Trade-off analysis |
|
|
770
|
-
| **Round-Robin** | Turnos secuenciales | Pipelines |
|
|
771
|
-
| **Swarm** | Auto-organizado | Problemas creativos |
|
|
772
|
-
|
|
773
|
-
## Prompt Management (v3.3)
|
|
160
|
+
## Agentes Especializados
|
|
774
161
|
|
|
775
|
-
|
|
162
|
+
12 agentes con personalidades distintas, basados en BMAD-METHOD:
|
|
776
163
|
|
|
777
|
-
|
|
164
|
+
| Agente | Nombre | Especialidad |
|
|
165
|
+
|--------|--------|--------------|
|
|
166
|
+
| `elsabro-analyst` | Mary | Analisis y clarificacion de requisitos |
|
|
167
|
+
| `elsabro-planner` | Winston | Planificacion tecnica y arquitectura |
|
|
168
|
+
| `elsabro-executor` | Amelia | Implementacion de codigo con TDD |
|
|
169
|
+
| `elsabro-debugger` | Sherlock | Debugging sistematico con metodo cientifico |
|
|
170
|
+
| `elsabro-verifier` | Quincy | Verificacion de spec compliance y calidad |
|
|
171
|
+
| `elsabro-orchestrator` | Quantum | Coordinacion de agentes paralelos |
|
|
172
|
+
| `elsabro-scrum-master` | Bob | Validacion de milestones y sprints |
|
|
173
|
+
| `elsabro-qa` | Murat | Testing, coverage y calidad |
|
|
174
|
+
| `elsabro-ux-designer` | Sally | Diseno de experiencia con Stitch AI |
|
|
175
|
+
| `elsabro-tech-writer` | Paige | Documentacion tecnica y retrospectivas |
|
|
176
|
+
| `elsabro-quick-dev` | Barry | Desarrollo rapido con minima ceremonia |
|
|
177
|
+
| `elsabro-yolo-dev` | Flash | Desarrollo ultra-rapido, maximo riesgo |
|
|
778
178
|
|
|
779
|
-
|
|
780
|
-
You are {{role}}. Your task is to {{task}}.
|
|
179
|
+
## PartyEngine
|
|
781
180
|
|
|
782
|
-
|
|
783
|
-
Context: {{context}}
|
|
784
|
-
{{/if}}
|
|
181
|
+
Sistema de discusion multi-agente. Selecciona 2-3 agentes relevantes para un tema y ejecuta rondas de debate con sintesis automatica.
|
|
785
182
|
|
|
786
|
-
{{#each requirements}}
|
|
787
|
-
- {{this}}
|
|
788
|
-
{{/each}}
|
|
789
183
|
```
|
|
790
|
-
|
|
791
|
-
### A/B Testing
|
|
792
|
-
|
|
793
|
-
```bash
|
|
794
|
-
/elsabro:prompt experiment create # Crear experimento
|
|
795
|
-
/elsabro:prompt experiment status # Ver resultados
|
|
796
|
-
# Winner: variant_a (12.5% improvement, 95% confidence)
|
|
184
|
+
/elsabro:party "Debatir la arquitectura de autenticacion"
|
|
797
185
|
```
|
|
798
186
|
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
Pausas programáticas para intervención humana:
|
|
802
|
-
|
|
803
|
-
### Tipos de Interrupt
|
|
804
|
-
|
|
805
|
-
| Tipo | Uso |
|
|
806
|
-
|------|-----|
|
|
807
|
-
| `approval` | Aprobación antes de continuar |
|
|
808
|
-
| `decision` | Usuario elige entre opciones |
|
|
809
|
-
| `error_recovery` | Cuando auto-fix falla |
|
|
810
|
-
| `input` | Necesita información del usuario |
|
|
811
|
-
| `confirmation` | Confirmar acción destructiva |
|
|
812
|
-
| `checkpoint` | Pausa en operación larga |
|
|
813
|
-
|
|
814
|
-
### Ejemplo de Interrupt
|
|
815
|
-
|
|
816
|
-
```
|
|
817
|
-
╔════════════════════════════════════════════════════════════╗
|
|
818
|
-
║ 🚀 Production Deployment Approval ║
|
|
819
|
-
╠════════════════════════════════════════════════════════════╣
|
|
820
|
-
║ Ready to deploy v3.0.0 to production ║
|
|
821
|
-
║ • Changes: 15 files ║
|
|
822
|
-
║ • Tests: All passed ║
|
|
823
|
-
║ • Coverage: 87% ║
|
|
824
|
-
╠════════════════════════════════════════════════════════════╣
|
|
825
|
-
║ [approve] Deploy Now ║
|
|
826
|
-
║ [staging] Deploy to Staging First ║
|
|
827
|
-
║ [cancel] Cancel ║
|
|
828
|
-
╚════════════════════════════════════════════════════════════╝
|
|
829
|
-
```
|
|
187
|
+
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).
|
|
830
188
|
|
|
831
189
|
## Perfiles
|
|
832
190
|
|
|
833
|
-
|
|
834
|
-
|
|
191
|
+
| Perfil | Comportamiento |
|
|
192
|
+
|--------|---------------|
|
|
193
|
+
| `default` | Balance entre velocidad y seguridad |
|
|
194
|
+
| `yolo` | Maximo velocidad, minima ceremonia |
|
|
195
|
+
| `careful` | Maximo seguridad, verificacion exhaustiva |
|
|
835
196
|
|
|
836
|
-
|
|
837
|
-
Máxima velocidad, mínima fricción. Para prototipos y fixes urgentes.
|
|
197
|
+
Cambiar perfil:
|
|
838
198
|
```
|
|
839
199
|
/elsabro:set-profile yolo
|
|
840
200
|
```
|
|
841
201
|
|
|
842
|
-
|
|
843
|
-
Máxima calidad, validación exhaustiva. Para producción crítica.
|
|
844
|
-
```
|
|
845
|
-
/elsabro:set-profile careful
|
|
846
|
-
```
|
|
847
|
-
|
|
848
|
-
## Cómo Funciona
|
|
202
|
+
## Como Funciona
|
|
849
203
|
|
|
850
|
-
### 1. Describe tu idea
|
|
851
204
|
```
|
|
852
|
-
|
|
853
|
-
|
|
205
|
+
1. Describes tu idea → ELSABRO analiza y pregunta
|
|
206
|
+
2. Planifica las fases → Crea planes atomicos con TDD
|
|
207
|
+
3. Ejecuta con agentes → Parallel execution + checkpointing
|
|
208
|
+
4. Verifica automaticamente → 3 reviewers + quality gates
|
|
854
209
|
```
|
|
855
210
|
|
|
856
|
-
|
|
857
|
-
- Busca las mejores tecnologías actuales
|
|
858
|
-
- Crea un plan paso a paso
|
|
859
|
-
- Te pregunta si algo no está claro
|
|
860
|
-
|
|
861
|
-
### 3. ELSABRO construye
|
|
862
|
-
- Usa agentes en paralelo para máxima eficiencia
|
|
863
|
-
- Escribe código verificado con TDD
|
|
864
|
-
- Crea commits organizados
|
|
865
|
-
|
|
866
|
-
### 4. Tú verificas
|
|
867
|
-
- Te guía para probar que funciona
|
|
868
|
-
- Explica qué hace cada parte
|
|
869
|
-
- Arregla problemas que encuentres
|
|
870
|
-
|
|
871
|
-
## Características
|
|
872
|
-
|
|
873
|
-
### 🔍 Investigación Automática
|
|
874
|
-
ELSABRO busca documentación actualizada antes de escribir código, usando Context7 y WebSearch.
|
|
875
|
-
|
|
876
|
-
### 👥 Agentes en Paralelo
|
|
877
|
-
Múltiples agentes trabajan simultáneamente (protocolo CUBAIT):
|
|
878
|
-
- 4 agentes para exploración (haiku)
|
|
879
|
-
- 2 agentes para implementación (opus)
|
|
880
|
-
- 3 agentes para code review (opus)
|
|
881
|
-
- Coordinados por Flow Engine
|
|
882
|
-
- **v3.0:** 10 error contracts garantizan resiliencia enterprise
|
|
883
|
-
|
|
884
|
-
### 🎓 Adaptado a Tu Nivel
|
|
885
|
-
- Respuestas concisas por defecto
|
|
886
|
-
- Explicaciones detalladas cuando las pides
|
|
887
|
-
- Sin jerga técnica innecesaria
|
|
888
|
-
|
|
889
|
-
### 📱 Skills para Diferentes Apps
|
|
890
|
-
- **Web**: Next.js con las mejores prácticas
|
|
891
|
-
- **Mobile**: Expo/React Native
|
|
892
|
-
- **API**: Backend servers
|
|
893
|
-
- **Integraciones**: Sentry, Auth, Pagos, etc.
|
|
894
|
-
|
|
895
|
-
### ⚡ Optimizado
|
|
896
|
-
- Usa el contexto de Claude eficientemente
|
|
897
|
-
- Commits atómicos y verificación automática
|
|
898
|
-
- TDD siempre
|
|
899
|
-
|
|
900
|
-
### 🧠 Memoria Multi-Nivel (v3.0)
|
|
901
|
-
- 4 niveles de memoria (short-term, long-term, entity, contextual)
|
|
902
|
-
- Aprende automáticamente de correcciones
|
|
903
|
-
- RAG semántico sobre el codebase
|
|
904
|
-
- Checkpointing persistente con time-travel
|
|
905
|
-
- Evita errores repetidos
|
|
906
|
-
|
|
907
|
-
## Ejemplo de Uso
|
|
908
|
-
|
|
909
|
-
```
|
|
910
|
-
Usuario: /elsabro:start
|
|
911
|
-
|
|
912
|
-
ELSABRO: ¡Hola! ¿Qué te gustaría hacer hoy?
|
|
913
|
-
1) Tengo una idea y quiero crear algo nuevo
|
|
914
|
-
2) Ya tengo código y quiero agregar algo
|
|
915
|
-
3) Algo no funciona y necesito arreglarlo
|
|
916
|
-
|
|
917
|
-
Usuario: 1
|
|
211
|
+
Persistent mode mantiene ELSABRO activo entre mensajes — escribe naturalmente y ELSABRO rutea al comando correcto.
|
|
918
212
|
|
|
919
|
-
|
|
920
|
-
1) Una página web
|
|
921
|
-
2) Una app para celular
|
|
922
|
-
3) Otra cosa
|
|
213
|
+
## Estructura del Proyecto
|
|
923
214
|
|
|
924
|
-
|
|
215
|
+
```
|
|
216
|
+
.planning/
|
|
217
|
+
PROJECT.md — Descripcion del proyecto
|
|
218
|
+
*-PLAN.md — Planes por fase
|
|
219
|
+
milestones/ — Milestones con MILESTONE.md + RETROSPECTIVE.md
|
|
220
|
+
SESSION.md — Estado de sesion para pause/resume
|
|
925
221
|
|
|
926
|
-
|
|
927
|
-
|
|
222
|
+
.elsabro/
|
|
223
|
+
state.json — Estado persistente del flujo
|
|
224
|
+
checkpoints/ — Checkpoints del flow engine
|
|
928
225
|
|
|
929
|
-
|
|
930
|
-
|
|
931
|
-
|
|
932
|
-
|
|
226
|
+
flow-engine/
|
|
227
|
+
src/ — 9 modulos del engine (index, graph, template,
|
|
228
|
+
executors, runner, checkpoint, callbacks, cli, party)
|
|
229
|
+
tests/ — 9 archivos de tests (279 tests, 75 suites)
|
|
230
|
+
src/agent-cards.json — 9 personalidades de agentes
|
|
933
231
|
|
|
934
|
-
|
|
232
|
+
flows/
|
|
233
|
+
development-flow.json — Flujo completo (44 nodos)
|
|
234
|
+
quick-flow.json — Flujo rapido (8 nodos)
|
|
935
235
|
```
|
|
936
236
|
|
|
937
|
-
##
|
|
237
|
+
## Actualizacion
|
|
938
238
|
|
|
939
239
|
```bash
|
|
940
240
|
npx elsabro --update
|
|
@@ -945,56 +245,24 @@ O desde Claude Code:
|
|
|
945
245
|
/elsabro:update
|
|
946
246
|
```
|
|
947
247
|
|
|
948
|
-
##
|
|
248
|
+
## Version History
|
|
949
249
|
|
|
950
|
-
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
954
|
-
|
|
955
|
-
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
- `ROADMAP.md` - Fases del desarrollo
|
|
959
|
-
- `RESEARCH.md` - Investigación de tecnologías
|
|
960
|
-
- `*-PLAN.md` - Planes para cada fase
|
|
961
|
-
- `milestones/` - Milestones con retrospectivas
|
|
962
|
-
- `SESSION.md` - Estado de sesión para pause/resume
|
|
963
|
-
- `TODOS.md` - Lista de todos del proyecto
|
|
964
|
-
- `CLAUDE.md` - Memoria del proyecto (v2.3)
|
|
965
|
-
- `mistakes.md` - Errores aprendidos (v2.3)
|
|
966
|
-
- `patterns.md` - Patrones preferidos (v2.3)
|
|
967
|
-
- `notes/` - Notas por tarea (v2.3)
|
|
250
|
+
| Version | Milestone | Cambio Principal |
|
|
251
|
+
|---------|-----------|-----------------|
|
|
252
|
+
| 7.1.0 | M5 + M6 | AT compliance, design-ui routing, 279 failure mode tests |
|
|
253
|
+
| 7.0.0 | M4 | Feature completeness — 42/42 nodos, CLI, 257 tests |
|
|
254
|
+
| 6.0.0 | M3 | Flow engine runtime — 6 source files, 109 tests |
|
|
255
|
+
| 5.3.0 | M1 | Flow JSON sync — 42 nodos auditados |
|
|
256
|
+
| 5.2.0 | M2 | Skills injection pipeline + Agent Teams bridge |
|
|
257
|
+
| 5.0.0 | — | BMAD integration, party mode |
|
|
968
258
|
|
|
969
259
|
## Licencia
|
|
970
260
|
|
|
971
261
|
MIT
|
|
972
262
|
|
|
973
|
-
##
|
|
974
|
-
|
|
975
|
-
ELSABRO
|
|
976
|
-
- [
|
|
977
|
-
- [
|
|
978
|
-
- [
|
|
979
|
-
- [Claude Productivity Plugin](https://github.com/claude-productivity-plugin) - Sistema de memoria y hooks
|
|
980
|
-
|
|
981
|
-
Inspiración para v3.0:
|
|
982
|
-
- [LangGraph](https://github.com/langchain-ai/langgraph) - Graph-based orchestration, checkpointing
|
|
983
|
-
- [CrewAI](https://github.com/crewAIInc/crewAI) - Multi-level memory, role-based agents
|
|
984
|
-
- [Microsoft AutoGen](https://github.com/microsoft/autogen) - Event-driven architecture
|
|
985
|
-
- [Agent Protocol](https://agentprotocol.ai/) - Interoperability standards
|
|
986
|
-
|
|
987
|
-
Mejoras en v3.0:
|
|
988
|
-
- Persistent checkpointing con time-travel debugging
|
|
989
|
-
- Multi-level memory (4 niveles)
|
|
990
|
-
- Flow-based orchestration con grafos declarativos
|
|
991
|
-
- 10 error contracts (+ Circuit Breaker, Bulkhead, Fallback)
|
|
992
|
-
- Sistema de interrupts para intervención humana
|
|
993
|
-
- 35+ comandos totales
|
|
994
|
-
|
|
995
|
-
Mejoras en v2.3:
|
|
996
|
-
- 7 error contracts para paralelismo confiable
|
|
997
|
-
- Sistema de memoria persistente
|
|
998
|
-
- 4 nuevos skills (tutor, audit-debt, review, memory)
|
|
999
|
-
- Hooks automáticos (tests, lint, confirm-destructive)
|
|
1000
|
-
- Git worktrees para aislamiento de agentes
|
|
263
|
+
## Creditos
|
|
264
|
+
|
|
265
|
+
ELSABRO esta basado en:
|
|
266
|
+
- [BMAD-METHOD](https://github.com/bmadmethod) — Agentes especializados
|
|
267
|
+
- [Superpowers](https://github.com/anthropics/superpowers) — Skills y TDD
|
|
268
|
+
- [LangGraph](https://github.com/langchain-ai/langgraph) — Inspiracion para graph-based orchestration
|