elsabro 2.3.0 → 3.8.0

package/README.md

@@ -1,15 +1,209 @@
-# ELSABRO v2.0
+# ELSABRO v3.8
 
-**Tu asistente AI para crear apps increíbles** - Sin necesidad de saber programar.
+**Tu asistente AI para crear apps increíbles** - Orquestación de agentes de nivel enterprise.
 
 ELSABRO es un sistema de desarrollo AI-powered para Claude Code que te guía paso a paso en la creación de aplicaciones, desde la idea inicial hasta el producto funcionando.
 
-## Novedades v2.0
-
+## 🚀 Novedades v3.8 (Skill Marketplace Integration)
+
+### Integración Automática de Skills (skills.sh)
+- **SkillDiscoveryEngine** - Descubrimiento automático de skills necesarias por keywords y categorías
+- **SkillInstallManager** - Instalación y actualización automática de skills con versionado semver
+- **SkillCacheManager** - Cache inteligente de búsquedas (1h) y versiones (6h)
+- **AutoSkillResolver** - Resolución de dependencias con ordenamiento topológico
+- **FlowIntegration** - Hooks pre-comando para skill discovery automático
+
+### CLI Commands
+- `npx skills find <query>` - Buscar skills disponibles
+- `npx skills add <skill>` - Instalar skill
+- `npx skills check <skill>` - Verificar actualizaciones
+- `npx skills update [skill]` - Actualizar skills
+
+### ELSABRO Commands
+- `/elsabro:skills search <query>` - Buscar skills en marketplace
+- `/elsabro:skills install <skill>` - Instalar skill específica
+- `/elsabro:skills update [skill]` - Actualizar skill(s)
+- `/elsabro:skills list` - Listar skills instaladas
+- `/elsabro:skills config` - Configurar auto-discovery
+
+### Características
+- **25+ keyword mappings** para descubrimiento automático (auth→clerk, payments→stripe, etc.)
+- **16 categorías** de skills organizadas
+- **Scoring inteligente** con nameScore, descScore, categoryScore, downloadScore
+- **Cache multi-nivel** para búsquedas y versiones
+- **Fallback graceful** cuando no hay conexión al registry
+- **Mode toggleable** (auto/manual/hybrid) para control del usuario
+
+## 🚀 Novedades v3.7 (Mobile & IDE Release)
+
+### Mobile App Companion (Expo SDK 52+)
+- **MobileAppArchitecture** - React Native con expo-router y Zustand
+- **SessionSync** - Sincronización WebSocket en tiempo real
+- **PushNotificationManager** - Notificaciones de tareas, builds, approvals
+- **VoiceInputHandler** - Comandos de voz desde el móvil
+- **OfflineMode** - Cache local con sync automático
+- **BiometricAuth** - Face ID, Touch ID, fallback a PIN
+- **Widget Support** - iOS WidgetKit y Android App Widgets
+
+### Voice Commands & Dictation
+- **VoiceCommandEngine** - Pipeline audio → ASR → NLU → action
+- **DictationTranscriber** - Transcripción con puntuación automática
+- **IntentClassifier** - Clasificación de comandos ELSABRO
+- **WakeWordDetector** - "Hey ELSABRO" on-device
+- **MultiLanguageSupport** - Español, inglés, portugués
+- **AudioFeedback** - Respuestas TTS configurables
+
+### AI Code Suggestions
+- **CodeSuggestionEngine** - Sugerencias contextuales inteligentes
+- **CompletionProvider** - Autocompletado inline tipo Copilot
+- **RefactoringAdvisor** - Extract function, rename, move suggestions
+- **PatternDetector** - Anti-patterns y SOLID violations
+- **SecurityScanner** - OWASP Top 10, secrets en código
+- **TestSuggester** - Tests unitarios sugeridos automáticamente
+
+### IDE Integrations
+- **VSCodeExtension** - Extension completa con sidebar y CodeLens
+- **JetBrainsPlugin** - IntelliJ, WebStorm, PyCharm
+- **LSPServer** - Language Server Protocol para cualquier editor
+- **InlineAnnotations** - Decorations y hover con info de agentes
+- **StatusBarIntegration** - Estado de sesión y progreso
+
+## 🚀 Novedades v3.6 (Enterprise Scale Release)
+
+### Agent Marketplace (Inspirado en NPM/Homebrew)
+- **MarketplaceRegistry** - Descubrimiento y listado de agentes comunitarios
+- **AgentPackager** - Empaquetado con firma criptográfica y versionado semántico
+- **PublishingPipeline** - Review automatizado y publicación segura
+- **ReviewSystem** - Ratings, reviews y reportes de la comunidad
+- **InstallationManager** - Sandboxing con permisos granulares
+
+### Multi-LLM Providers (Inspirado en LiteLLM)
+- **ProviderRegistry** - Gestión unificada de múltiples proveedores
+- **ModelRouter** - Routing inteligente basado en costo/latencia/capacidad
+- Soporte para: Claude, OpenAI, Gemini, Azure OpenAI, Ollama (local)
+- **CostOptimizer** - Minimización de costos manteniendo calidad
+- **ProviderHealthChecker** - Circuit breaker y failover automático
+
+### Kubernetes Deployment (Inspirado en Helm/ArgoCD)
+- **K8sDeployer** - Deployment automatizado con zero-downtime
+- **HelmChartGenerator** - Charts con values por environment
+- **ResourceScaler** - HPA/VPA con custom metrics (queue_length, active_agents)
+- **HealthMonitor** - Probes, métricas Prometheus y alertas
+- Infraestructura: Redis, PostgreSQL, RabbitMQ incluidos
+
+### Enterprise SSO (Inspirado en Auth0)
+- **SSOManager** - Autenticación unificada enterprise
+- **SAML 2.0** - Integración con IdPs corporativos
+- **OIDC/OAuth 2.0** - OpenID Connect con PKCE
+- **SCIM 2.0** - Provisioning y deprovisioning automático
+- Integraciones: Okta, Azure AD, Google Workspace, Keycloak
+
+## 🚀 Novedades v3.5 (Collaboration & UX Release)
+
+### Flow Visualization (Inspirado en n8n/Langflow)
+- **FlowVisualizer** - Renderizado de flows como grafos interactivos
+- **GraphRenderer** - Múltiples modos: ASCII (terminal), SVG, HTML
+- **Layout algorithms** - Dagre, ELK, force-directed, tree, radial
+- **NodeEditor** - Configuración visual de nodos con templates
+- **ConnectionManager** - Validación automática y detección de ciclos
+
+### Multi-Project Memory (Inspirado en Notion AI)
+- **SharedMemoryHub** - Conocimiento compartido entre proyectos
+- **ProjectLinker** - Relaciones y herencia entre proyectos
+- **KnowledgeSync** - Sincronización con manejo de conflictos
+- **CrossProjectSearch** - Búsqueda semántica cross-project
+- **KnowledgeExtractor** - Auto-extracción de patterns y mistakes
+
+### Collaborative Sessions (Inspirado en Google Docs/Figma)
+- **SessionManager** - Sesiones multi-usuario en tiempo real
+- **RealtimeSync** - WebSocket con reconexión automática
+- **ConflictResolver** - OT (Operational Transformation) para edición concurrente
+- **PresenceTracker** - Cursores, avatares y actividad en tiempo real
+- Roles: host, editor, viewer con permisos granulares
+
+### Performance Profiler (Inspirado en Chrome DevTools)
+- **Profiler** - Sampling y tracing de agentes/flows/tools
+- **BottleneckDetector** - Identificación automática de cuellos de botella
+- **MemoryAnalyzer** - Detección de memory leaks
+- **LatencyTracker** - Percentiles P50/P95/P99 con SLO monitoring
+- **Dashboard ASCII** - Visualización en terminal con recomendaciones
+
+## 🚀 Novedades v3.4 (Enterprise Release)
+
+### Testing Framework (Inspirado en Jest + Pytest)
+- **AgentTestRunner** - Suites de tests con setup/teardown y retries
+- **MockProvider** - Mocking de LLM y herramientas
+- **SimulationEngine** - Testing de escenarios multi-agente
+- **AssertionEngine** - 12+ tipos de assertions (behavioral, property, semantic)
+- **Coverage tracking** - Métricas de cobertura por agente, flow y tool
+
+### Security System (Enterprise-grade)
+- **RBAC** - Control de acceso basado en roles con herencia
+- **SecretsVault** - Cifrado AES-256-GCM con rotación automática
+- **AuditLogger** - Logging de seguridad con alertas automáticas
+- **PolicyEngine** - Policies con conditions (time, IP, rate_limit)
+- Built-in roles: admin, agent:explore, agent:implement, agent:review
+
+### Configuration Management (Inspirado en Firebase Remote Config)
+- **ConfigManager** - Multi-source loading (file, env, remote)
+- **FeatureFlags** - Targeting, percentage rollout, schedules
+- **EnvResolver** - Variables con herencia y secretos
+- **ConfigValidator** - JSON Schema validation con coerción de tipos
+- **RemoteConfigSync** - Actualización sin re-deploy con fallback
+
+### Plugin System (Inspirado en VSCode Extensions)
+- **PluginLoader** - Discovery, validación y carga dinámica
+- **PluginRegistry** - Contribuciones (agents, tools, commands, hooks)
+- **PluginManager** - Lifecycle completo con hot-reload
+- **HookSystem** - Middleware chain para extensibilidad
+- **Sandboxing** - Aislamiento y permisos granulares
+
+## 🚀 Novedades v3.0-v3.3
+
+### Persistent Checkpointing (Inspirado en LangGraph)
+- **Estado serializable** entre sesiones - nunca pierdas progreso
+- **Snapshots automáticos** por fase y wave
+- **Rollback** a cualquier punto anterior
+- **Time-travel debugging** para analizar decisiones pasadas
+- **Resume from interrupt** después de pausas
+
+### Multi-Level Memory (Inspirado en CrewAI)
+- **Short-term memory** - Contexto de sesión actual
+- **Long-term memory** - Patrones y errores persistentes
+- **Entity memory** - Conocimiento del codebase (archivos, funciones, relaciones)
+- **Contextual memory** - RAG semántico para búsqueda inteligente
+- **Auto-learning** - Detecta correcciones y aprende automáticamente
+
+### Flow-Based Orchestration (Inspirado en LangGraph)
+- **Workflows declarativos** - Define flujos como grafos JSON
+- **Conditional routing** - Enrutamiento basado en condiciones
+- **Parallel branches** - Ejecución paralela nativa
+- **Subflows reutilizables** - Composición de workflows
+- **10 tipos de nodos** - entry, agent, router, condition, parallel, sequence, subflow, interrupt, loop, exit
+
+### Error Contracts v2 (10 contratos)
+- **Circuit Breaker** - Previene cascadas de fallos
+- **Bulkhead** - Aísla recursos por partición
+- **Fallback** - Degradación graceful con alternativas
+- Plus los 7 contratos originales (Registry, Lifecycle, Timeout, Retry, Aggregator, Severity, Session)
+
+### Sistema de Interrupts
+- **Approval gates** - Aprobación antes de acciones críticas
+- **Decision points** - Usuario elige entre opciones
+- **Error recovery** - Intervención cuando auto-fix falla
+- **Progress checkpoints** - Pausas programáticas
+- **Confirmation dialogs** - Confirmar acciones destructivas
+
+### Novedades v2.3 (Incluidas)
+- **7 contratos de error** para ejecución paralela confiable
+- **Sistema de memoria persistente** - Aprende de tus correcciones
+- **Hooks automáticos** - Tests y lint al guardar
+- **Git worktrees** - Aislamiento real para agentes paralelos
+
+### Base Sólida (v2.0)
 - **12 Agentes Especializados** basados en BMAD-METHOD
-- **27 Comandos** para todo el ciclo de desarrollo
+- **31+ Comandos** para todo el ciclo de desarrollo
 - **3 Perfiles** (default, yolo, careful) para diferentes estilos
-- **Agentes Paralelos** para máxima eficiencia
 - **Context7** integrado para documentación actualizada
 - **21st.dev** integrado para componentes UI
 
@@ -97,6 +291,26 @@ Después de instalar, abre Claude Code y escribe:
 | `/elsabro:debug` | Investigar y arreglar problemas |
 | `/elsabro:map-codebase` | Generar mapa del codebase |
 
+### Productividad (v2.3)
+| Comando | Descripción |
+|---------|-------------|
+| `/elsabro:tutor` | Aprende con método socrático |
+| `/elsabro:audit-debt` | Escanea deuda técnica |
+| `/elsabro:review` | Code review profesional |
+| `/elsabro:memory` | Gestiona memoria persistente |
+
+### Flow & Checkpointing (Nuevo en v3.0)
+| Comando | Descripción |
+|---------|-------------|
+| `/elsabro:flow list` | Listar flows disponibles |
+| `/elsabro:flow run <name>` | Ejecutar un flow |
+| `/elsabro:flow status` | Ver estado del flow actual |
+| `/elsabro:checkpoint save` | Guardar checkpoint manual |
+| `/elsabro:checkpoint list` | Listar checkpoints |
+| `/elsabro:checkpoint restore <id>` | Restaurar checkpoint |
+| `/elsabro:interrupt list` | Ver interrupts pendientes |
+| `/elsabro:interrupt respond` | Responder a interrupt |
+
 ### Settings
 | Comando | Descripción |
 |---------|-------------|
@@ -121,6 +335,445 @@ Después de instalar, abre Claude Code y escribe:
 | `elsabro-quick-dev` | Barry | Desarrollo rápido |
 | `elsabro-yolo-dev` | Flash | Desarrollo ultra-rápido |
 
+## Error Contracts v2 (v3.0)
+
+ELSABRO v3.0 incluye 10 contratos de error para garantizar resiliencia enterprise:
+
+### Contratos Base (v2.3)
+| Contrato | Función |
+|----------|---------|
+| `ContractRegistryValidator` | Valida que agentes existen antes de ejecutar |
+| `ContractTaskLifecycle` | Estados explícitos: INIT → ACTIVE → COMPLETE |
+| `ContractTimeoutHandler` | Timeouts automáticos con escalación |
+| `ContractRetryPolicy` | Retry con backoff exponencial (1s, 2s, 4s) |
+| `ContractErrorAggregator` | Políticas: fail_fast, quorum, continue_all |
+| `ContractSeverityClassifier` | Clasifica: CRITICAL, HIGH, MEDIUM, LOW |
+| `ContractSessionValidator` | Valida integridad de sesiones |
+
+### Nuevos Contratos de Resiliencia (v3.0)
+| Contrato | Función |
+|----------|---------|
+| `ContractCircuitBreaker` | Previene cascadas de fallos (CLOSED → OPEN → HALF_OPEN) |
+| `ContractBulkhead` | Aísla recursos por partición (max concurrency) |
+| `ContractFallback` | Degradación graceful con alternativas |
+
+### Políticas de Agregación
+
+```
+fail_fast    → Para al primer error
+quorum       → Continúa si >50% tiene éxito
+continue_all → Continúa siempre (con mínimo 1 éxito)
+```
+
+### Estrategias de Fallback
+
+```
+alternative_agent → Usa agente alternativo
+simplified        → Operación simplificada
+cached            → Resultado cacheado
+default           → Valor por defecto
+manual            → Intervención del usuario
+skip              → Skip graceful
+```
+
+## Sistema de Memoria Multi-Nivel (v3.0)
+
+ELSABRO tiene 4 niveles de memoria que trabajan juntos:
+
+### Arquitectura de Memoria
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  SHORT-TERM     │  LONG-TERM      │  ENTITY       │  RAG   │
+│  (Sesión)       │  (Persistente)  │  (Codebase)   │        │
+├─────────────────────────────────────────────────────────────┤
+│  • Conversación │  • patterns.md  │  • Archivos   │ Search │
+│  • Decisiones   │  • mistakes.md  │  • Funciones  │ semán- │
+│  • Archivos     │  • preferences  │  • Relaciones │ tico   │
+│  • Contexto     │  • learnings    │  • Historial  │        │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Estructura de Archivos
+
+```
+.planning/
+├── memory/
+│   ├── short-term/      # Estado de sesión
+│   ├── long-term/       # Aprendizajes persistentes
+│   ├── entity/          # Info del codebase
+│   └── contextual/      # Índice para RAG
+├── CLAUDE.md            # Memoria del proyecto
+├── mistakes.md          # Errores a evitar
+├── patterns.md          # Patrones preferidos
+└── checkpoints/         # Checkpoints para recovery
+```
+
+### Triggers Automáticos
+
+ELSABRO detecta cuando le corriges:
+- "No, hazlo así..."
+- "Siempre usa X en vez de Y"
+- "En este proyecto preferimos..."
+
+Y guarda el aprendizaje automáticamente.
+
+## Hooks Automáticos (v2.3)
+
+| Hook | Trigger | Función |
+|------|---------|---------|
+| `post-edit-test` | Al editar código | Ejecuta tests automáticamente |
+| `lint-check` | Al guardar | Ejecuta linter |
+| `confirm-destructive` | Comandos peligrosos | Pide confirmación |
+
+### Perfiles de Hooks
+
+```bash
+# En settings
+/elsabro:settings hooks.profile development  # Tests + lint
+/elsabro:settings hooks.profile fast         # Sin hooks
+/elsabro:settings hooks.profile careful      # Todo + confirmaciones
+/elsabro:settings hooks.profile ci           # Solo tests
+```
+
+## Git Worktrees (v2.3)
+
+Para paralelismo real, ELSABRO puede usar git worktrees:
+
+```bash
+# Crear worktree para agente
+./scripts/setup-parallel-worktrees.sh create feature-auth
+
+# Mergear cambios
+./scripts/setup-parallel-worktrees.sh merge feature-auth
+
+# Limpiar
+./scripts/setup-parallel-worktrees.sh cleanup
+```
+
+Esto permite que múltiples agentes trabajen en el mismo repo sin conflictos.
+
+## Flow Orchestration (v3.0)
+
+Define workflows complejos como grafos declarativos:
+
+### Ejemplo de Flow
+
+```json
+{
+  "id": "development_flow",
+  "nodes": [
+    { "id": "analyze", "type": "parallel", "branches": [
+      { "agent": "Explore" },
+      { "agent": "Plan" },
+      { "agent": "feature-dev:code-explorer" }
+    ]},
+    { "id": "implement", "type": "parallel", "branches": [
+      { "agent": "elsabro-executor" },
+      { "agent": "elsabro-qa" }
+    ]},
+    { "id": "review", "type": "parallel", "branches": [
+      { "agent": "pr-review-toolkit:code-reviewer" },
+      { "agent": "pr-review-toolkit:silent-failure-hunter" }
+    ]}
+  ]
+}
+```
+
+### Tipos de Nodos
+
+| Tipo | Descripción |
+|------|-------------|
+| `entry` | Punto de entrada |
+| `agent` | Ejecuta un agente |
+| `parallel` | Ejecuta ramas en paralelo |
+| `sequence` | Ejecuta pasos secuencialmente |
+| `router` | Enruta según condiciones |
+| `condition` | Bifurcación binaria |
+| `subflow` | Ejecuta otro flow |
+| `interrupt` | Pausa para input del usuario |
+| `loop` | Repite hasta condición |
+| `exit` | Punto de salida |
+
+### Flows Predefinidos
+
+- `development_flow` - Workflow completo con quality gates
+- `quick_flow` - Workflow simplificado para tareas rápidas
+- `review_flow` - Code review multi-agente
+- `debug_flow` - Debugging sistemático
+
+## Checkpointing (v3.0)
+
+Nunca pierdas progreso con checkpoints automáticos:
+
+```bash
+# Guardar checkpoint manual
+/elsabro:checkpoint save "antes de refactor"
+
+# Ver checkpoints disponibles
+/elsabro:checkpoint list
+
+# Restaurar a punto anterior
+/elsabro:checkpoint restore chk_20240120_abc123
+
+# Time-travel: ver estado en un punto
+/elsabro:checkpoint diff chk_1 chk_2
+```
+
+### Triggers Automáticos de Checkpoint
+
+- `PHASE_START` - Al iniciar fase
+- `PHASE_COMPLETE` - Al completar fase
+- `WAVE_COMPLETE` - Al completar wave paralela
+- `INTERRUPT` - Al pausar para input
+- `INTERVAL` - Cada N minutos (configurable)
+
+## Observability (v3.1)
+
+Sistema de telemetría completo para monitoreo y debugging:
+
+```bash
+/elsabro:telemetry dashboard    # Dashboard en tiempo real
+/elsabro:telemetry summary      # Resumen de métricas
+/elsabro:telemetry traces       # Ver traces recientes
+```
+
+**Características:**
+- Distributed tracing (spans por agente)
+- Métricas (counters, gauges, histograms)
+- Logging estructurado con trace context
+- Dashboard ASCII sin dependencias externas
+
+## Progress Streaming (v3.1)
+
+Ver progreso en tiempo real con 3 modos:
+
+| Modo | Descripción |
+|------|-------------|
+| `values` | Estado completo después de cada operación |
+| `updates` | Solo deltas/cambios (más eficiente) |
+| `messages` | Texto legible para humanos |
+
+```bash
+/elsabro:stream mode messages   # Cambiar a modo messages (default)
+/elsabro:stream mode updates    # Cambiar a modo updates
+```
+
+## Output Schemas (v3.1)
+
+Validación automática de outputs de agentes:
+
+| Schema | Agentes | Campos Requeridos |
+|--------|---------|-------------------|
+| `analysis` | analyst, Explore, Plan | summary, files, recommendations |
+| `implementation` | executor, quick-dev | success |
+| `review` | code-reviewer | approved, issues, summary |
+| `verification` | verifier, qa | passed, tests, typescript, lint |
+| `plan` | planner | phases |
+
+## Time-Travel Debugging (v3.2)
+
+Navegación temporal para debugging avanzado y análisis what-if:
+
+### Comandos
+
+```bash
+/elsabro:timeline           # Ver timeline completo
+/elsabro:timeline back 5    # Retroceder 5 pasos
+/elsabro:timeline goto cp3  # Ir a checkpoint específico
+
+/elsabro:replay             # Reproducir ejecución paso a paso
+/elsabro:replay speed 2.0   # Reproducir a 2x
+
+/elsabro:whatif             # Análisis de escenarios alternativos
+/elsabro:whatif branch fix  # Crear branch alternativo
+```
+
+### Visualización de Timeline
+
+```
+─────────────────────────────────────────────────────────────────
+│ TIMELINE: flow_abc123                                          │
+─────────────────────────────────────────────────────────────────
+│ [1] ● INIT     00:00:00  Flow initialized                      │
+│ [2] ● EXPLORE  00:00:15  4 haiku agents dispatched             │
+│ [3] ► CURRENT  00:01:30  Implementation in progress            │
+─────────────────────────────────────────────────────────────────
+```
+
+## Agent Protocol API (v3.2)
+
+API REST estándar para interoperabilidad con otros frameworks de agentes:
+
+### Endpoints
+
+| Endpoint | Método | Descripción |
+|----------|--------|-------------|
+| `/api/v1/agent` | GET | Info del agente |
+| `/api/v1/tasks` | GET/POST | CRUD de tareas |
+| `/api/v1/tasks/:id/steps` | GET/POST | Pasos de tarea |
+| `/api/v1/tasks/:id/artifacts` | GET/POST | Archivos generados |
+
+### Compatibilidad
+
+- Auto-GPT
+- BabyAGI
+- AgentGPT
+- SuperAGI
+- Cualquier cliente que implemente Agent Protocol
+
+## Sandbox Execution (v3.2)
+
+Ejecución segura de código en entornos aislados:
+
+### Providers
+
+| Provider | Seguridad | Velocidad | Lenguajes |
+|----------|-----------|-----------|-----------|
+| Docker | Alta | Media | Todos |
+| E2B | Alta | Alta | Python, JS, TS |
+| Firecracker | Muy Alta | Muy Alta | Todos |
+| Process | Baja | Muy Alta | Todos |
+
+### Límites de Recursos
+
+- CPU: cores, percent
+- Memory: limit, reservation
+- Disk: limit, read-only
+- Network: disabled by default
+- PIDs: limit
+
+## Event-Driven Architecture (v3.2)
+
+Sistema de eventos para comunicación desacoplada:
+
+### EventBus
+
+```typescript
+// Publicar evento
+await eventBus.publish('agent.completed', { agentId, result });
+
+// Suscribirse a eventos
+eventBus.subscribe('agent.*', async (event) => {
+  console.log(event.type, event.payload);
+});
+```
+
+### Features
+
+- **Pub/Sub**: Comunicación asíncrona desacoplada
+- **Event Sourcing**: Historial inmutable de eventos
+- **Webhooks**: Integraciones externas configurables
+- **Dead Letter Queue**: Manejo de eventos fallidos
+- **Replay**: Reproducción de eventos históricos
+
+## Cost Tracking & Optimization (v3.3)
+
+Monitoreo de costos y optimización automática de modelos:
+
+### Dashboard de Costos
+
+```
+╔═══════════════════════════════════════════════════════════╗
+║  SESSION: $7.82  │  DAILY: 42%  │  MONTHLY: 15%           ║
+╠═══════════════════════════════════════════════════════════╣
+║  Haiku  ████░░░░░░  $0.45 (6%)                            ║
+║  Sonnet ██████░░░░  $2.87 (37%)                           ║
+║  Opus   ████████░░  $4.50 (57%)                           ║
+╚═══════════════════════════════════════════════════════════╝
+```
+
+### Features
+
+- **TokenTracker**: Metering por request con breakdown detallado
+- **BudgetManager**: Presupuestos por sesión/día/mes con alertas
+- **ModelOptimizer**: Selección automática de modelo según tarea
+- **Savings Report**: Recomendaciones de ahorro
+
+## Tool Registry (v3.3)
+
+Registro dinámico de herramientas con discovery inteligente:
+
+```typescript
+// Descubrir herramientas por capacidad
+const tools = discovery.suggest("need to read and edit files");
+// Returns: [Read, Edit, Write, Glob]
+
+// Buscar por categoría
+const fileTools = registry.list({ category: 'file-ops' });
+```
+
+## Agent Collaboration Patterns (v3.3)
+
+Patrones avanzados para orquestación multi-agente:
+
+| Patrón | Descripción | Uso Ideal |
+|--------|-------------|-----------|
+| **Supervisor** | 1 coordinador + N workers | Subtareas independientes |
+| **Hierarchical** | Árbol multinivel | Proyectos grandes |
+| **Consensus** | Votación entre agentes | Decisiones críticas |
+| **Debate** | Pro vs Con + Juez | Trade-off analysis |
+| **Round-Robin** | Turnos secuenciales | Pipelines |
+| **Swarm** | Auto-organizado | Problemas creativos |
+
+## Prompt Management (v3.3)
+
+Sistema de gestión de prompts con A/B testing:
+
+### Template Engine
+
+```
+You are {{role}}. Your task is to {{task}}.
+
+{{#if context}}
+Context: {{context}}
+{{/if}}
+
+{{#each requirements}}
+- {{this}}
+{{/each}}
+```
+
+### A/B Testing
+
+```bash
+/elsabro:prompt experiment create    # Crear experimento
+/elsabro:prompt experiment status    # Ver resultados
+# Winner: variant_a (12.5% improvement, 95% confidence)
+```
+
+## Sistema de Interrupts (v3.0)
+
+Pausas programáticas para intervención humana:
+
+### Tipos de Interrupt
+
+| Tipo | Uso |
+|------|-----|
+| `approval` | Aprobación antes de continuar |
+| `decision` | Usuario elige entre opciones |
+| `error_recovery` | Cuando auto-fix falla |
+| `input` | Necesita información del usuario |
+| `confirmation` | Confirmar acción destructiva |
+| `checkpoint` | Pausa en operación larga |
+
+### Ejemplo de Interrupt
+
+```
+╔════════════════════════════════════════════════════════════╗
+║  🚀 Production Deployment Approval                         ║
+╠════════════════════════════════════════════════════════════╣
+║  Ready to deploy v3.0.0 to production                      ║
+║  • Changes: 15 files                                       ║
+║  • Tests: All passed                                       ║
+║  • Coverage: 87%                                           ║
+╠════════════════════════════════════════════════════════════╣
+║  [approve] Deploy Now                                      ║
+║  [staging] Deploy to Staging First                         ║
+║  [cancel] Cancel                                           ║
+╚════════════════════════════════════════════════════════════╝
+```
+
 ## Perfiles
 
 ### Default (Balanced)
@@ -168,9 +821,11 @@ ELSABRO busca documentación actualizada antes de escribir código, usando Conte
 
 ### 👥 Agentes en Paralelo
 Múltiples agentes trabajan simultáneamente (protocolo CUBAIT):
-- Mínimo 3 agentes para exploración
-- Mínimo 3 agentes para verificación
-- Coordinados por el Orchestrator
+- 4 agentes para exploración (haiku)
+- 2 agentes para implementación (opus)
+- 3 agentes para code review (opus)
+- Coordinados por Flow Engine
+- **v3.0:** 10 error contracts garantizan resiliencia enterprise
 
 ### 🎓 Adaptado a Tu Nivel
 - Respuestas concisas por defecto
@@ -188,6 +843,13 @@ Múltiples agentes trabajan simultáneamente (protocolo CUBAIT):
 - Commits atómicos y verificación automática
 - TDD siempre
 
+### 🧠 Memoria Multi-Nivel (v3.0)
+- 4 niveles de memoria (short-term, long-term, entity, contextual)
+- Aprende automáticamente de correcciones
+- RAG semántico sobre el codebase
+- Checkpointing persistente con time-travel
+- Evita errores repetidos
+
 ## Ejemplo de Uso
 
 ```
@@ -245,6 +907,10 @@ Cuando trabajas con ELSABRO, se crea una carpeta `.planning/` con:
 - `milestones/` - Milestones con retrospectivas
 - `SESSION.md` - Estado de sesión para pause/resume
 - `TODOS.md` - Lista de todos del proyecto
+- `CLAUDE.md` - Memoria del proyecto (v2.3)
+- `mistakes.md` - Errores aprendidos (v2.3)
+- `patterns.md` - Patrones preferidos (v2.3)
+- `notes/` - Notas por tarea (v2.3)
 
 ## Licencia
 
@@ -252,17 +918,29 @@ MIT
 
 ## Créditos
 
-ELSABRO v2.0 está basado en:
+ELSABRO está basado en:
 - [Get Shit Done](https://github.com/glittercowboy/get-shit-done) - Workflow original
 - [BMAD-METHOD](https://github.com/bmadmethod) - Agentes especializados
 - [Superpowers](https://github.com/anthropics/superpowers) - Skills y TDD
-
-Mejoras significativas:
-- 12 agentes especializados (vs 5 originales)
-- 27 comandos (vs 9 originales)
-- Ejecución de agentes en paralelo (protocolo CUBAIT)
-- Context7 para documentación actualizada
-- 21st.dev para componentes UI
-- Perfiles configurables (yolo/default/careful)
-- Session management (pause/resume)
-- Milestone y phase management completo
+- [Claude Productivity Plugin](https://github.com/claude-productivity-plugin) - Sistema de memoria y hooks
+
+Inspiración para v3.0:
+- [LangGraph](https://github.com/langchain-ai/langgraph) - Graph-based orchestration, checkpointing
+- [CrewAI](https://github.com/crewAIInc/crewAI) - Multi-level memory, role-based agents
+- [Microsoft AutoGen](https://github.com/microsoft/autogen) - Event-driven architecture
+- [Agent Protocol](https://agentprotocol.ai/) - Interoperability standards
+
+Mejoras en v3.0:
+- Persistent checkpointing con time-travel debugging
+- Multi-level memory (4 niveles)
+- Flow-based orchestration con grafos declarativos
+- 10 error contracts (+ Circuit Breaker, Bulkhead, Fallback)
+- Sistema de interrupts para intervención humana
+- 35+ comandos totales
+
+Mejoras en v2.3:
+- 7 error contracts para paralelismo confiable
+- Sistema de memoria persistente
+- 4 nuevos skills (tutor, audit-debt, review, memory)
+- Hooks automáticos (tests, lint, confirm-destructive)
+- Git worktrees para aislamiento de agentes