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 CHANGED
@@ -1,273 +1,26 @@
1
- # ELSABRO v4.2.0
2
-
3
- **Tu asistente AI para crear apps increibles** - Orquestacion de agentes de nivel enterprise.
4
-
5
- ELSABRO es un sistema de desarrollo AI-powered para Claude Code que te guia paso a paso en la creacion de aplicaciones, desde la idea inicial hasta el producto funcionando.
6
-
7
- ## Novedades v4.2.0 (Next Step Suggestions + Stitch UI Design)
8
-
9
- ### Next Step Suggestions
10
- - **Guided workflow**: Every command now suggests what to do next with "Siguiente Paso" blocks
11
- - **`suggested_next` in state.json**: Programmatic field for smart routing in persistent mode
12
- - **Context-aware**: Suggestions adapt based on pending tasks, TODOs, verification results
13
- - **28 commands enhanced**: All state-writing commands guide you to the next logical step
14
- - **New reference**: `references/next-step-engine.md` Complete decision matrix and override rules
15
-
16
- ### Stitch AI UI Design
17
- - **`/elsabro:design-ui`**: New command to generate professional UI screens from text descriptions
18
- - **Stitch MCP integration**: Create projects, generate screens, review and refine designs
19
- - **Sally enhanced**: UX Designer agent now uses both Stitch (full screens) and 21st.dev (components)
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
- ## Instalación
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
- Después de instalar, abre Claude Code y escribe:
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 | Descripción |
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 | Descripción |
65
+ | Comando | Descripcion |
303
66
  |---------|-------------|
304
67
  | `/elsabro:plan` | Planificar una fase o feature |
305
- | `/elsabro:execute` | Ejecutar un plan |
306
- | `/elsabro:verify` | Verificar que todo funciona |
307
- | `/elsabro:verify-work` | Verificación completa con agentes paralelos |
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 | Descripción |
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:plan-milestone-gaps` | Planificar gaps en milestone |
78
+ | `/elsabro:progress` | Ver progreso actual |
317
79
 
318
80
  ### Phase Management
319
- | Comando | Descripción |
81
+ | Comando | Descripcion |
320
82
  |---------|-------------|
321
83
  | `/elsabro:add-phase` | Agregar fase al final |
322
- | `/elsabro:insert-phase` | Insertar fase en posición |
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 tecnologías para fase |
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
- ### Todo Management
337
- | Comando | Descripción |
89
+ ### Productividad
90
+ | Comando | Descripcion |
338
91
  |---------|-------------|
339
- | `/elsabro:add-todo` | Agregar item al todo list |
340
- | `/elsabro:check-todos` | Ver y gestionar todos |
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
- ### Productividad (v2.3)
349
- | Comando | Descripción |
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:settings` | Ver/modificar configuración |
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:update` | Actualizar 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
- ## Git Worktrees (v2.3)
106
+ ## Flow Engine
494
107
 
495
- Para paralelismo real, ELSABRO puede usar git worktrees:
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
- ```bash
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
- Esto permite que múltiples agentes trabajen en el mismo repo sin conflictos.
509
-
510
- ## Flow Orchestration (v3.0)
511
-
512
- Define workflows complejos como grafos declarativos:
513
-
514
- ### Ejemplo de Flow
515
-
516
- ```json
517
- {
518
- "id": "development_flow",
519
- "nodes": [
520
- { "id": "analyze", "type": "parallel", "branches": [
521
- { "agent": "Explore" },
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
- ### Tipos de Nodos
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
- | Tipo | Descripción |
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
- ### Flows Predefinidos
136
+ ### CLI
553
137
 
554
- - `development_flow` - Workflow completo con quality gates
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
- # Guardar checkpoint manual
565
- /elsabro:checkpoint save "antes de refactor"
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
- ## Observability (v3.1)
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
- Sistema de telemetría completo para monitoreo y debugging:
588
-
589
- ```bash
590
- /elsabro:telemetry dashboard # Dashboard en tiempo real
591
- /elsabro:telemetry summary # Resumen de métricas
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
- **Características:**
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
- ## Time-Travel Debugging (v3.2)
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
- Navegación temporal para debugging avanzado y análisis what-if:
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
- Sistema de gestión de prompts con A/B testing:
162
+ 12 agentes con personalidades distintas, basados en BMAD-METHOD:
776
163
 
777
- ### Template Engine
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
- {{#if context}}
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
- ## Sistema de Interrupts (v3.0)
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
- ### Default (Balanced)
834
- Equilibrio entre velocidad y calidad. Ideal para desarrollo día a día.
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
- ### YOLO ⚡ (Speed)
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
- ### Careful 🛡️ (Quality)
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
- /elsabro:start
853
- "Quiero crear una app para gestionar mis tareas"
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
- ### 2. ELSABRO investiga y planifica
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
- ELSABRO: ¿Qué tipo de app quieres crear?
920
- 1) Una página web
921
- 2) Una app para celular
922
- 3) Otra cosa
213
+ ## Estructura del Proyecto
923
214
 
924
- Usuario: 1 - Quiero crear un blog personal
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
- ELSABRO: ¡Genial! Déjame investigar las mejores opciones...
927
- [Usa agentes en paralelo con Context7]
222
+ .elsabro/
223
+ state.json — Estado persistente del flujo
224
+ checkpoints/ — Checkpoints del flow engine
928
225
 
929
- Voy a crear tu blog con:
930
- - Next.js 15 (el framework más moderno para web)
931
- - Tailwind CSS (estilos bonitos sin complicaciones)
932
- - MDX (para escribir tus posts fácilmente)
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
- ¿Empezamos?
232
+ flows/
233
+ development-flow.json — Flujo completo (44 nodos)
234
+ quick-flow.json — Flujo rapido (8 nodos)
935
235
  ```
936
236
 
937
- ## Actualización
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
- ## Desinstalación
248
+ ## Version History
949
249
 
950
- ```bash
951
- npx elsabro --uninstall
952
- ```
953
-
954
- ## Estructura del Proyecto
955
-
956
- Cuando trabajas con ELSABRO, se crea una carpeta `.planning/` con:
957
- - `PROJECT.md` - Descripción de tu proyecto
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
- ## Créditos
974
-
975
- ELSABRO está basado en:
976
- - [Get Shit Done](https://github.com/glittercowboy/get-shit-done) - Workflow original
977
- - [BMAD-METHOD](https://github.com/bmadmethod) - Agentes especializados
978
- - [Superpowers](https://github.com/anthropics/superpowers) - Skills y TDD
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