elsabro 2.2.0 → 3.7.0

package/skills/tutor.md

@@ -0,0 +1,219 @@
+---
+name: tutor
+description: Modo tutor socratico - aprendizaje guiado con tecnicas de Feynman y analisis de errores
+trigger: /elsabro:tutor
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Task
+argument-hint: "[tema] - tema a aprender (ej: useEffect, async/await, React hooks)"
+---
+
+# ELSABRO: Socratic Tutor
+
+<objective>
+Activar modo de aprendizaje socratico. En lugar de dar respuestas directamente,
+guiar al usuario a descubrir las respuestas por si mismo mediante preguntas
+estrategicas y tecnicas de refuerzo.
+</objective>
+
+<task_integration>
+## Integracion con Tasks API
+
+Al iniciar sesion de tutoria, crear tarea para tracking:
+
+```
+TaskCreate:
+  description: "Sesion de tutoria: [tema]"
+  status: in_progress
+```
+
+Actualizar progreso con checkpoints de confianza del usuario.
+Al finalizar sesion, marcar como completada con resumen de aprendizaje.
+</task_integration>
+
+<core_rules>
+## Reglas Fundamentales (OBLIGATORIAS)
+
+1. **NUNCA dar la respuesta inmediatamente** - Hacer que el usuario trabaje por ella
+2. **Explicar paso a paso SOLO cuando lo pida** - No sobre-explicar
+3. **Hacer preguntas estilo Socratico** - Para que piense y descubra
+4. **Quiz frecuente** - Mezclar multiple choice, respuesta corta, y "explicame esto"
+5. **Cuando se equivoque** - Mostrar el gap suavemente y pedir que intente de nuevo
+6. **Rating de confianza** - Pedir que califique su confianza (1-10) despues de cada tema
+</core_rules>
+
+<techniques>
+## Tecnicas Avanzadas
+
+### Feynman Checks
+Pedir que explique conceptos como si fuera principiante:
+
+```
+"Antes de continuar, explicame [concepto] como si yo nunca hubiera programado"
+```
+
+Esto revela si realmente entiende vs. pattern matching superficial.
+
+### Make Connections
+Vincular conceptos nuevos con conocimiento previo:
+
+```
+"Como se relaciona esto con [X que vimos antes]?"
+"En que se parece/diferencia de [concepto similar]?"
+```
+
+### Predict Before Reveal
+Antes de mostrar como funciona algo:
+
+```
+"Que crees que va a pasar cuando ejecutemos esto?"
+"Por que crees que funciona de esa manera?"
+```
+
+### Error Analysis
+Cuando cometa un error, no solo corregir:
+
+```
+"Interesante respuesta. Por que pensaste eso?"
+"Que te llevo a esa conclusion?"
+"Puedes identificar donde se desvio tu razonamiento?"
+```
+
+### Summarization Checkpoints
+Periodicamente pedir resumenes:
+
+```
+"Pausa. Resume lo que hemos aprendido hasta ahora en tus propias palabras."
+"Si tuvieras que explicar esto en un tweet, que dirias?"
+```
+
+### Spaced Callbacks
+Volver a conceptos anteriores inesperadamente:
+
+```
+"Por cierto, recuerdas lo que vimos sobre [tema anterior]? Como aplicaria aqui?"
+```
+</techniques>
+
+<session_flow>
+## Flujo de Sesion
+
+### Inicio
+```
+Usuario: /elsabro:tutor useEffect
+
+Claude: [Crea tarea de tutoria en Tasks]
+
+"Vamos a explorar useEffect. Antes de profundizar, respondeme:
+
+1. Que CREES que hace useEffect? No busques, dime lo que piensas.
+2. En que situaciones lo has usado o visto usado?
+
+Cuando tengas respuestas, continuamos."
+```
+
+### Durante
+```
+- Preguntas guiadas (no respuestas)
+- Checkpoints de confianza cada 2-3 conceptos
+- Feynman checks cuando el usuario "cree entender"
+- Error analysis sin juicio cuando falla
+```
+
+### Cierre
+```
+Claude: "Antes de terminar:
+
+1. Resume en 2-3 oraciones que aprendiste hoy sobre [tema]
+2. Como calificarias tu confianza ahora (1-10)?
+3. Que pregunta te queda pendiente?
+
+[Actualiza tarea con resumen de sesion]"
+```
+</session_flow>
+
+<example_flow>
+## Ejemplo de Flujo Completo
+
+```
+Usuario: /elsabro:tutor useEffect
+
+Claude: "Vamos a explorar useEffect. Antes de profundizar, respondeme:
+        Que CREES que hace useEffect? No busques, dime lo que piensas."
+
+Usuario: "Creo que ejecuta codigo cuando el componente se monta"
+
+Claude: "Casi. Solo cuando se monta? Que pasa si cambio una variable de estado?"
+
+Usuario: "Hmm... se vuelve a ejecutar?"
+
+Claude: "Correcto. Ahora, CUANDO se vuelve a ejecutar exactamente?
+        Pista: tiene que ver con el segundo argumento."
+
+[continua guiando con preguntas...]
+
+Claude: "Checkpoint de confianza: Como calificarias tu entendimiento
+        sobre cuando se ejecuta useEffect? (1-10)"
+
+Usuario: "Un 6"
+
+Claude: "Ok, sigamos practicando hasta que llegues a 8+.
+        Ahora, explicame el array de dependencias como si yo fuera
+        alguien que nunca ha usado React..."
+```
+</example_flow>
+
+<confidence_tracking>
+## Tracking de Confianza
+
+Mantener registro durante la sesion:
+
+| Concepto | Confianza Inicial | Confianza Final |
+|----------|-------------------|-----------------|
+| useEffect basico | 4 | 7 |
+| Dependencies array | 2 | 8 |
+| Cleanup function | 1 | 6 |
+
+**Meta**: Todos los conceptos en 7+ antes de cerrar sesion.
+</confidence_tracking>
+
+<exit_modes>
+## Salir del Modo Tutor
+
+El usuario puede salir diciendo:
+- "Salir de modo tutor"
+- "Ya entendi, continua normal"
+- `/elsabro:tutor off`
+- "Modo normal"
+
+Al salir, guardar resumen en la tarea y marcar como completada.
+</exit_modes>
+
+<adaptation>
+## Adaptacion Dinamica
+
+- Si responde correctamente 3 veces seguidas: aumentar dificultad
+- Si falla 2 veces seguidas: dar pistas mas directas
+- Si confianza < 5: volver a lo basico
+- Si confianza > 8: introducir edge cases y complejidad
+- Si usuario frustrado: ofrecer explicacion directa como opcion
+</adaptation>
+
+<integration_memory>
+## Integracion con Memoria ELSABRO
+
+Al detectar gaps de conocimiento recurrentes:
+
+```
+"He notado que [concepto X] te cuesta. Quieres que agregue
+ejercicios de repaso a tu proxima sesion?"
+```
+
+Guardar en `.planning/notes/learning.md`:
+- Temas dominados
+- Temas que necesitan refuerzo
+- Progreso historico
+</integration_memory>

package/templates/CLAUDE.md.template

@@ -0,0 +1,48 @@
+# [NOMBRE_PROYECTO] - Memoria de Claude
+
+## Stack Tecnologico
+<!-- Descomenta y personaliza segun tu proyecto -->
+<!-- - Frontend: React/Next.js/Vue -->
+<!-- - Backend: Node/Python/Go -->
+<!-- - Database: PostgreSQL/MongoDB -->
+<!-- - Deploy: Vercel/AWS/Docker -->
+
+## Reglas de Codigo (OBLIGATORIAS)
+
+### Estilo
+- Preferir TypeScript sobre JavaScript
+- Componentes funcionales con hooks
+- Imports especificos, no `import *`
+- Async/await sobre .then()
+
+### Patrones
+- Composicion sobre herencia
+- Funciones puras cuando sea posible
+- Early returns para reducir anidamiento
+- Error handling explicito
+
+### Naming
+- camelCase para variables y funciones
+- PascalCase para componentes y clases
+- SCREAMING_SNAKE para constantes
+- Nombres descriptivos, no abreviados
+
+## NO HACER (Errores Aprendidos)
+
+**Ver archivo completo:** `.planning/mistakes.md`
+
+<!-- Errores criticos se documentan aqui como resumen -->
+
+## Contexto del Proyecto
+
+### Arquitectura
+<!-- Describir arquitectura de alto nivel -->
+
+### Decisiones Importantes
+<!-- Documentar decisiones arquitectonicas y por que -->
+
+## Referencias
+
+- Errores detallados: `.planning/mistakes.md`
+- Patrones preferidos: `.planning/patterns.md`
+- Notas por feature: `.planning/notes/`

package/templates/agent-marketplace-config.json

@@ -0,0 +1,220 @@
+{
+  "marketplace": {
+    "enabled": true,
+    "version": "3.6.0",
+
+    "registry": {
+      "url": "https://marketplace.elsabro.dev/api/v1",
+      "mirrorUrls": [
+        "https://marketplace-eu.elsabro.dev/api/v1",
+        "https://marketplace-asia.elsabro.dev/api/v1"
+      ],
+      "timeout": 30000,
+      "retryAttempts": 3,
+      "cacheEnabled": true,
+      "cacheTTL": 3600000
+    },
+
+    "categories": [
+      {
+        "id": "exploration",
+        "name": "Exploration",
+        "description": "Agents for codebase analysis and discovery",
+        "icon": "search"
+      },
+      {
+        "id": "implementation",
+        "name": "Implementation",
+        "description": "Agents for code generation and development",
+        "icon": "code"
+      },
+      {
+        "id": "review",
+        "name": "Review",
+        "description": "Agents for code review and quality analysis",
+        "icon": "eye"
+      },
+      {
+        "id": "testing",
+        "name": "Testing",
+        "description": "Agents for test generation and execution",
+        "icon": "check-circle"
+      },
+      {
+        "id": "specialized",
+        "name": "Specialized",
+        "description": "Domain-specific and custom agents",
+        "icon": "star"
+      }
+    ],
+
+    "search": {
+      "enabled": true,
+      "maxResults": 50,
+      "defaultSort": "relevance",
+      "sortOptions": ["relevance", "downloads", "rating", "updated", "name"],
+      "filters": {
+        "tags": true,
+        "rating": true,
+        "downloads": true,
+        "compatibility": true,
+        "verified": true,
+        "category": true
+      },
+      "fuzzyMatching": true,
+      "minSearchLength": 2
+    },
+
+    "packaging": {
+      "manifestFile": "agent.manifest.json",
+      "requiredFields": ["name", "version", "displayName", "description", "author", "main"],
+      "maxPackageSize": 52428800,
+      "allowedFileTypes": [".js", ".ts", ".json", ".md", ".txt", ".yaml", ".yml"],
+      "excludePatterns": ["node_modules/**", ".git/**", "*.log", ".env*"],
+      "compressionLevel": 9,
+      "checksumAlgorithm": "sha256"
+    },
+
+    "signing": {
+      "enabled": true,
+      "required": false,
+      "algorithm": "ed25519",
+      "trustedPublishers": [],
+      "keyServer": "https://keys.elsabro.dev",
+      "verifyOnInstall": true,
+      "allowUnsigned": true,
+      "warnUnsigned": true
+    },
+
+    "publishing": {
+      "requireAccount": true,
+      "requireVerifiedEmail": true,
+      "autoReview": true,
+      "manualReviewThreshold": 0.7,
+      "stages": ["submit", "validate", "review", "approve", "publish"],
+      "webhooks": {
+        "onSubmit": null,
+        "onApprove": null,
+        "onPublish": null,
+        "onReject": null
+      },
+      "retentionPolicy": {
+        "keepVersions": 10,
+        "keepDays": 365
+      }
+    },
+
+    "testing": {
+      "requiredBeforePublish": true,
+      "minCoverage": 60,
+      "runSandboxed": true,
+      "timeout": 300000,
+      "testTypes": ["unit", "integration", "compatibility"],
+      "compatibilityMatrix": {
+        "elsabroVersions": ["3.4.x", "3.5.x", "3.6.x"],
+        "nodeVersions": ["18.x", "20.x", "22.x"]
+      }
+    },
+
+    "reviews": {
+      "enabled": true,
+      "requireInstall": true,
+      "minRating": 1,
+      "maxRating": 5,
+      "allowAnonymous": false,
+      "moderationEnabled": true,
+      "editWindow": 604800000,
+      "responseEnabled": true
+    },
+
+    "metrics": {
+      "trackDownloads": true,
+      "trackActiveUsers": true,
+      "trackSuccessRate": true,
+      "trackErrors": true,
+      "retentionDays": 90,
+      "aggregationInterval": 86400000
+    },
+
+    "installation": {
+      "defaultPath": ".elsabro/marketplace-agents",
+      "globalPath": "~/.elsabro/global-agents",
+      "verifyChecksum": true,
+      "verifySignature": true,
+      "backupBeforeUpdate": true,
+      "rollbackOnFailure": true,
+      "maxConcurrentInstalls": 3,
+      "lockFile": ".elsabro/agent-lock.json"
+    },
+
+    "dependencies": {
+      "autoResolve": true,
+      "strategy": "highest-compatible",
+      "allowPeerDependencies": true,
+      "checkConflicts": true,
+      "hoistDependencies": true,
+      "lockfileVersion": 1
+    },
+
+    "sandbox": {
+      "enabled": true,
+      "isolationLevel": "strict",
+      "permissions": {
+        "filesystem": "restricted",
+        "network": "restricted",
+        "shell": "denied",
+        "env": "restricted"
+      },
+      "resourceLimits": {
+        "memory": 268435456,
+        "cpu": 0.75,
+        "timeout": 60000
+      },
+      "allowedHosts": [],
+      "blockedHosts": []
+    },
+
+    "updates": {
+      "checkOnStartup": true,
+      "checkInterval": 86400000,
+      "autoUpdate": false,
+      "autoUpdateMinor": false,
+      "autoUpdatePatch": true,
+      "notifyAvailable": true,
+      "prereleaseChannel": false
+    },
+
+    "reporting": {
+      "enabled": true,
+      "types": ["bug", "security", "inappropriate", "license"],
+      "requireDescription": true,
+      "minDescriptionLength": 50,
+      "notifyPublisher": true
+    },
+
+    "cache": {
+      "enabled": true,
+      "path": ".elsabro/marketplace-cache",
+      "maxSize": 524288000,
+      "cleanupInterval": 604800000,
+      "cachePackages": true,
+      "cacheMetadata": true
+    },
+
+    "offline": {
+      "enabled": true,
+      "useCachedMetadata": true,
+      "useCachedPackages": true,
+      "syncOnConnect": true
+    },
+
+    "ui": {
+      "showRatings": true,
+      "showDownloads": true,
+      "showLastUpdated": true,
+      "showVerifiedBadge": true,
+      "previewEnabled": true,
+      "defaultView": "grid"
+    }
+  }
+}

package/templates/agent-protocol-config.json

@@ -0,0 +1,136 @@
+{
+  "agentProtocol": {
+    "enabled": true,
+    "version": "1.0.0",
+
+    "server": {
+      "port": 8080,
+      "host": "localhost",
+      "basePath": "/api/v1",
+      "shutdownTimeout": 5000
+    },
+
+    "agent": {
+      "name": "ELSABRO",
+      "version": "3.2.0",
+      "description": "AI-powered development orchestration framework",
+      "capabilities": [
+        "checkpointing",
+        "multi-level-memory",
+        "flow-orchestration",
+        "error-contracts",
+        "interrupts",
+        "observability",
+        "streaming",
+        "output-schemas",
+        "time-travel",
+        "agent-protocol"
+      ]
+    },
+
+    "artifacts": {
+      "directory": ".elsabro/artifacts",
+      "maxSizeBytes": 104857600,
+      "allowedTypes": [
+        "application/json",
+        "text/plain",
+        "text/markdown",
+        "text/typescript",
+        "text/javascript",
+        "application/pdf",
+        "image/png",
+        "image/jpeg",
+        "application/zip"
+      ],
+      "retention": {
+        "enabled": true,
+        "maxAgeDays": 30,
+        "maxTotalSizeBytes": 1073741824
+      }
+    },
+
+    "cors": {
+      "enabled": true,
+      "origins": ["*"],
+      "methods": ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
+      "allowedHeaders": ["Content-Type", "Authorization"],
+      "credentials": false
+    },
+
+    "auth": {
+      "enabled": false,
+      "type": "bearer",
+      "token": null,
+      "apiKeyHeader": "X-API-Key"
+    },
+
+    "websocket": {
+      "enabled": true,
+      "path": "/ws",
+      "pingInterval": 30000,
+      "maxConnections": 100
+    },
+
+    "rateLimit": {
+      "enabled": true,
+      "windowMs": 60000,
+      "maxRequests": 100,
+      "skipFailedRequests": false,
+      "keyGenerator": "ip"
+    },
+
+    "logging": {
+      "enabled": true,
+      "level": "info",
+      "includeBody": false,
+      "excludePaths": ["/health", "/metrics"]
+    },
+
+    "health": {
+      "enabled": true,
+      "path": "/health",
+      "checks": ["memory", "disk", "agents"]
+    },
+
+    "metrics": {
+      "enabled": true,
+      "path": "/metrics",
+      "format": "prometheus"
+    },
+
+    "tasks": {
+      "maxConcurrent": 10,
+      "defaultTimeout": 300000,
+      "cleanupAfterMs": 86400000
+    },
+
+    "steps": {
+      "maxPerTask": 1000,
+      "defaultTimeout": 60000,
+      "autoSaveCheckpoint": true
+    },
+
+    "integration": {
+      "flowEngine": {
+        "enabled": true,
+        "defaultFlow": "development-flow"
+      },
+      "checkpointManager": {
+        "enabled": true,
+        "autoCheckpoint": true
+      },
+      "memoryManager": {
+        "enabled": true,
+        "persistContext": true
+      },
+      "streamManager": {
+        "enabled": true,
+        "broadcastProgress": true
+      },
+      "telemetryManager": {
+        "enabled": true,
+        "traceRequests": true
+      }
+    }
+  }
+}