elsabro 2.3.0 → 3.7.0

package/flows/development-flow.json

@@ -0,0 +1,452 @@
+{
+  "id": "development_flow",
+  "name": "Standard Development Flow",
+  "version": "3.0.0",
+  "description": "Workflow completo para desarrollar features con quality gates",
+
+  "config": {
+    "timeout": 3600000,
+    "maxRetries": 3,
+    "checkpointEnabled": true,
+    "interruptEnabled": true,
+    "errorPolicy": "quorum"
+  },
+
+  "inputs": {
+    "task": { "type": "string", "required": true, "description": "Descripción de la tarea" },
+    "complexity": { "type": "enum", "values": ["low", "medium", "high"], "default": "medium" },
+    "profile": { "type": "enum", "values": ["default", "yolo", "careful"], "default": "default" }
+  },
+
+  "outputs": {
+    "filesCreated": { "type": "array" },
+    "filesModified": { "type": "array" },
+    "testsCreated": { "type": "array" },
+    "testsPassed": { "type": "boolean" },
+    "reviewApproved": { "type": "boolean" },
+    "success": { "type": "boolean" }
+  },
+
+  "nodes": [
+    {
+      "id": "start",
+      "type": "entry",
+      "next": "load_context"
+    },
+
+    {
+      "id": "load_context",
+      "type": "sequence",
+      "description": "Cargar contexto del proyecto",
+      "steps": [
+        {
+          "action": "read_files",
+          "files": ["CLAUDE.md", ".planning/patterns.md", ".planning/mistakes.md"],
+          "optional": true
+        },
+        {
+          "action": "load_memory",
+          "types": ["longTerm", "entity"]
+        }
+      ],
+      "next": "profile_router"
+    },
+
+    {
+      "id": "profile_router",
+      "type": "router",
+      "description": "Enrutar según perfil seleccionado",
+      "condition": "{{inputs.profile}}",
+      "routes": {
+        "yolo": "yolo_execute",
+        "careful": "careful_analyze",
+        "default": "standard_analyze"
+      },
+      "default": "standard_analyze"
+    },
+
+    {
+      "id": "yolo_execute",
+      "type": "agent",
+      "description": "Ejecución rápida sin ceremony",
+      "agent": "elsabro-yolo-dev",
+      "config": { "model": "opus", "timeout": 600000 },
+      "inputs": {
+        "task": "{{inputs.task}}",
+        "context": "{{state.loadedContext}}"
+      },
+      "next": "quick_verify"
+    },
+
+    {
+      "id": "quick_verify",
+      "type": "agent",
+      "agent": "elsabro-verifier",
+      "config": { "model": "haiku", "timeout": 120000 },
+      "next": "verify_check"
+    },
+
+    {
+      "id": "careful_analyze",
+      "type": "sequence",
+      "description": "Análisis exhaustivo para modo careful",
+      "steps": [
+        { "agent": "elsabro-analyst", "as": "requirements", "model": "opus" },
+        { "agent": "elsabro-analyst", "as": "risks", "model": "opus" },
+        { "agent": "elsabro-planner", "as": "detailed_plan", "model": "opus" }
+      ],
+      "next": "interrupt_plan_approval"
+    },
+
+    {
+      "id": "interrupt_plan_approval",
+      "type": "interrupt",
+      "reason": "Plan requires approval in careful mode",
+      "display": {
+        "title": "📋 Plan de Implementación",
+        "content": "{{nodes.careful_analyze.outputs.detailed_plan}}",
+        "risks": "{{nodes.careful_analyze.outputs.risks}}",
+        "options": [
+          { "id": "approve", "label": "✓ Aprobar y continuar" },
+          { "id": "modify", "label": "✎ Modificar plan" },
+          { "id": "reject", "label": "✗ Cancelar" }
+        ]
+      },
+      "routes": {
+        "approve": "parallel_implementation",
+        "modify": "careful_analyze",
+        "reject": "end_cancelled"
+      }
+    },
+
+    {
+      "id": "standard_analyze",
+      "type": "parallel",
+      "description": "Análisis paralelo estándar (4 agentes)",
+      "branches": [
+        {
+          "id": "explore",
+          "agent": "Explore",
+          "config": { "model": "haiku" },
+          "inputs": { "task": "Explorar estructura del codebase relevante para: {{inputs.task}}" }
+        },
+        {
+          "id": "code_explore",
+          "agent": "feature-dev:code-explorer",
+          "config": { "model": "haiku" },
+          "inputs": { "task": "Analizar código existente relacionado con: {{inputs.task}}" }
+        },
+        {
+          "id": "plan",
+          "agent": "Plan",
+          "config": { "model": "haiku" },
+          "inputs": { "task": "Diseñar plan de implementación para: {{inputs.task}}" }
+        },
+        {
+          "id": "tech_debt",
+          "agent": "general-purpose",
+          "config": { "model": "haiku" },
+          "inputs": { "task": "Escanear tech debt y patrones existentes relevantes para: {{inputs.task}}" }
+        }
+      ],
+      "joinType": "all",
+      "timeout": 300000,
+      "next": "merge_analysis"
+    },
+
+    {
+      "id": "merge_analysis",
+      "type": "agent",
+      "description": "Consolidar análisis de los 4 agentes",
+      "agent": "elsabro-analyst",
+      "config": { "model": "opus" },
+      "inputs": {
+        "exploration": "{{nodes.standard_analyze.outputs.branches.explore}}",
+        "codeAnalysis": "{{nodes.standard_analyze.outputs.branches.code_explore}}",
+        "plan": "{{nodes.standard_analyze.outputs.branches.plan}}",
+        "techDebt": "{{nodes.standard_analyze.outputs.branches.tech_debt}}",
+        "task": "Consolidar estos análisis en un plan unificado"
+      },
+      "next": "parallel_implementation"
+    },
+
+    {
+      "id": "parallel_implementation",
+      "type": "parallel",
+      "description": "Implementación paralela (2 agentes opus)",
+      "branches": [
+        {
+          "id": "implementation",
+          "agent": "elsabro-executor",
+          "config": { "model": "opus", "timeout": 900000 },
+          "inputs": {
+            "task": "{{inputs.task}}",
+            "plan": "{{nodes.merge_analysis.outputs.plan || nodes.careful_analyze.outputs.detailed_plan}}",
+            "patterns": "{{state.patterns}}",
+            "mistakes": "{{state.mistakes}}"
+          }
+        },
+        {
+          "id": "testing",
+          "agent": "elsabro-qa",
+          "config": { "model": "opus", "timeout": 600000 },
+          "inputs": {
+            "task": "Crear tests para: {{inputs.task}}",
+            "plan": "{{nodes.merge_analysis.outputs.plan || nodes.careful_analyze.outputs.detailed_plan}}"
+          }
+        }
+      ],
+      "joinType": "all",
+      "timeout": 1200000,
+      "next": "quality_gate"
+    },
+
+    {
+      "id": "quality_gate",
+      "type": "sequence",
+      "description": "Quality gate: tests, types, lint",
+      "steps": [
+        {
+          "action": "bash",
+          "command": "npm test 2>&1 || true",
+          "as": "tests",
+          "timeout": 120000
+        },
+        {
+          "action": "bash",
+          "command": "npx tsc --noEmit 2>&1 || true",
+          "as": "typescript",
+          "timeout": 60000
+        },
+        {
+          "action": "bash",
+          "command": "npm run lint 2>&1 || true",
+          "as": "lint",
+          "timeout": 60000
+        }
+      ],
+      "next": "quality_check"
+    },
+
+    {
+      "id": "quality_check",
+      "type": "condition",
+      "description": "Verificar si pasó quality gate",
+      "condition": "{{nodes.quality_gate.outputs.tests.exitCode === 0 && nodes.quality_gate.outputs.typescript.exitCode === 0}}",
+      "true": "parallel_review",
+      "false": "fix_issues"
+    },
+
+    {
+      "id": "fix_issues",
+      "type": "parallel",
+      "description": "Corregir problemas detectados (3 agentes)",
+      "branches": [
+        {
+          "id": "debugger",
+          "agent": "elsabro-debugger",
+          "config": { "model": "opus" },
+          "inputs": { "errors": "{{nodes.quality_gate.outputs}}" }
+        },
+        {
+          "id": "error_detective",
+          "agent": "error-detective",
+          "config": { "model": "opus" },
+          "inputs": { "errors": "{{nodes.quality_gate.outputs}}" }
+        },
+        {
+          "id": "refactor",
+          "agent": "refactoring-specialist",
+          "config": { "model": "opus" },
+          "inputs": { "issues": "{{nodes.quality_gate.outputs.lint}}" }
+        }
+      ],
+      "joinType": "all",
+      "next": "quality_gate",
+      "maxIterations": 3,
+      "onMaxIterations": "interrupt_manual_fix"
+    },
+
+    {
+      "id": "interrupt_manual_fix",
+      "type": "interrupt",
+      "reason": "Auto-fix failed after 3 attempts",
+      "display": {
+        "title": "⚠️ Corrección Manual Requerida",
+        "errors": "{{nodes.quality_gate.outputs}}",
+        "attempts": "3",
+        "options": [
+          { "id": "retry", "label": "Reintentar auto-fix" },
+          { "id": "skip", "label": "Continuar sin fix" },
+          { "id": "manual", "label": "Corregiré manualmente" }
+        ]
+      },
+      "routes": {
+        "retry": "fix_issues",
+        "skip": "parallel_review",
+        "manual": "wait_manual_fix"
+      }
+    },
+
+    {
+      "id": "wait_manual_fix",
+      "type": "interrupt",
+      "reason": "Waiting for manual fix",
+      "display": {
+        "title": "Esperando corrección manual",
+        "content": "Avísame cuando hayas corregido los errores",
+        "options": [
+          { "id": "done", "label": "Ya corregí los errores" }
+        ]
+      },
+      "routes": {
+        "done": "quality_gate"
+      }
+    },
+
+    {
+      "id": "parallel_review",
+      "type": "parallel",
+      "description": "Code review paralelo (3 agentes opus)",
+      "branches": [
+        {
+          "id": "code_reviewer",
+          "agent": "pr-review-toolkit:code-reviewer",
+          "config": { "model": "opus" },
+          "inputs": {
+            "changes": "{{collectOutputs('filesModified')}}",
+            "focus": "code quality, patterns, maintainability"
+          }
+        },
+        {
+          "id": "silent_failure_hunter",
+          "agent": "pr-review-toolkit:silent-failure-hunter",
+          "config": { "model": "opus" },
+          "inputs": {
+            "changes": "{{collectOutputs('filesModified')}}",
+            "focus": "error handling, edge cases, silent failures"
+          }
+        },
+        {
+          "id": "staff_review",
+          "agent": "code-reviewer",
+          "config": { "model": "opus" },
+          "inputs": {
+            "changes": "{{collectOutputs('filesModified')}}",
+            "focus": "Staff Engineer review: architecture, scalability, security"
+          }
+        }
+      ],
+      "joinType": "all",
+      "timeout": 600000,
+      "next": "review_check"
+    },
+
+    {
+      "id": "review_check",
+      "type": "condition",
+      "description": "Verificar si hay issues críticos en review",
+      "condition": "{{!hasCriticalIssues(nodes.parallel_review.outputs)}}",
+      "true": "verify_final",
+      "false": "fix_review_issues"
+    },
+
+    {
+      "id": "fix_review_issues",
+      "type": "agent",
+      "description": "Corregir issues del code review",
+      "agent": "elsabro-executor",
+      "config": { "model": "opus" },
+      "inputs": {
+        "task": "Corregir issues del code review",
+        "issues": "{{nodes.parallel_review.outputs}}"
+      },
+      "next": "parallel_review",
+      "maxIterations": 2,
+      "onMaxIterations": "verify_final"
+    },
+
+    {
+      "id": "verify_final",
+      "type": "agent",
+      "description": "Verificación final",
+      "agent": "elsabro-verifier",
+      "config": { "model": "opus" },
+      "next": "verify_check"
+    },
+
+    {
+      "id": "verify_check",
+      "type": "condition",
+      "condition": "{{nodes.verify_final.outputs.passed || nodes.quick_verify.outputs.passed}}",
+      "true": "post_mortem",
+      "false": "interrupt_verification_failed"
+    },
+
+    {
+      "id": "interrupt_verification_failed",
+      "type": "interrupt",
+      "reason": "Final verification failed",
+      "display": {
+        "title": "❌ Verificación Final Fallida",
+        "errors": "{{nodes.verify_final.outputs.errors}}",
+        "options": [
+          { "id": "retry", "label": "Reintentar desde implementación" },
+          { "id": "accept", "label": "Aceptar con errores" },
+          { "id": "cancel", "label": "Cancelar" }
+        ]
+      },
+      "routes": {
+        "retry": "parallel_implementation",
+        "accept": "post_mortem",
+        "cancel": "end_cancelled"
+      }
+    },
+
+    {
+      "id": "post_mortem",
+      "type": "sequence",
+      "description": "Post-mortem: guardar aprendizajes",
+      "steps": [
+        {
+          "action": "learn_patterns",
+          "from": "{{collectDecisions()}}"
+        },
+        {
+          "action": "learn_mistakes",
+          "from": "{{collectErrors()}}"
+        },
+        {
+          "action": "update_entity_memory",
+          "files": "{{collectOutputs('filesModified')}}"
+        }
+      ],
+      "next": "end_success"
+    },
+
+    {
+      "id": "end_success",
+      "type": "exit",
+      "status": "success",
+      "outputs": {
+        "filesCreated": "{{collectOutputs('filesCreated')}}",
+        "filesModified": "{{collectOutputs('filesModified')}}",
+        "testsCreated": "{{collectOutputs('testsCreated')}}",
+        "testsPassed": true,
+        "reviewApproved": true,
+        "success": true,
+        "summary": "{{generateSummary()}}"
+      }
+    },
+
+    {
+      "id": "end_cancelled",
+      "type": "exit",
+      "status": "cancelled",
+      "outputs": {
+        "success": false,
+        "reason": "Cancelled by user"
+      }
+    }
+  ]
+}

package/flows/quick-flow.json

@@ -0,0 +1,118 @@
+{
+  "id": "quick_flow",
+  "name": "Quick Development Flow",
+  "version": "3.0.0",
+  "description": "Workflow simplificado para tareas rápidas con mínima ceremonia",
+
+  "config": {
+    "timeout": 900000,
+    "maxRetries": 2,
+    "checkpointEnabled": true,
+    "interruptEnabled": false,
+    "errorPolicy": "continue_all"
+  },
+
+  "inputs": {
+    "task": { "type": "string", "required": true }
+  },
+
+  "outputs": {
+    "filesModified": { "type": "array" },
+    "success": { "type": "boolean" }
+  },
+
+  "nodes": [
+    {
+      "id": "start",
+      "type": "entry",
+      "next": "quick_analyze"
+    },
+
+    {
+      "id": "quick_analyze",
+      "type": "agent",
+      "agent": "elsabro-quick-dev",
+      "config": { "model": "opus", "timeout": 300000 },
+      "inputs": {
+        "task": "{{inputs.task}}",
+        "mode": "analyze_and_plan"
+      },
+      "next": "quick_implement"
+    },
+
+    {
+      "id": "quick_implement",
+      "type": "agent",
+      "agent": "elsabro-quick-dev",
+      "config": { "model": "opus", "timeout": 600000 },
+      "inputs": {
+        "task": "{{inputs.task}}",
+        "plan": "{{nodes.quick_analyze.outputs.plan}}",
+        "mode": "implement"
+      },
+      "next": "quick_verify"
+    },
+
+    {
+      "id": "quick_verify",
+      "type": "sequence",
+      "steps": [
+        {
+          "action": "bash",
+          "command": "npm test -- --passWithNoTests 2>&1 || true",
+          "as": "tests",
+          "timeout": 60000
+        },
+        {
+          "action": "bash",
+          "command": "npx tsc --noEmit 2>&1 || true",
+          "as": "typescript",
+          "timeout": 30000
+        }
+      ],
+      "next": "verify_result"
+    },
+
+    {
+      "id": "verify_result",
+      "type": "condition",
+      "condition": "{{nodes.quick_verify.outputs.typescript.exitCode === 0}}",
+      "true": "end_success",
+      "false": "quick_fix"
+    },
+
+    {
+      "id": "quick_fix",
+      "type": "agent",
+      "agent": "elsabro-debugger",
+      "config": { "model": "haiku", "timeout": 180000 },
+      "inputs": {
+        "errors": "{{nodes.quick_verify.outputs}}"
+      },
+      "next": "quick_verify",
+      "maxIterations": 2,
+      "onMaxIterations": "end_with_warnings"
+    },
+
+    {
+      "id": "end_success",
+      "type": "exit",
+      "status": "success",
+      "outputs": {
+        "filesModified": "{{collectOutputs('filesModified')}}",
+        "success": true
+      }
+    },
+
+    {
+      "id": "end_with_warnings",
+      "type": "exit",
+      "status": "partial",
+      "outputs": {
+        "filesModified": "{{collectOutputs('filesModified')}}",
+        "success": true,
+        "warnings": "{{nodes.quick_verify.outputs}}"
+      }
+    }
+  ]
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elsabro",
-  "version": "2.3.0",
-  "description": "Sistema de desarrollo AI-powered para Claude Code - El mejor asistente para crear apps sin experiencia previa",
+  "version": "3.7.0",
+  "description": "Sistema de desarrollo AI-powered para Claude Code - Orquestación avanzada con checkpointing, memoria multi-nivel y flows declarativos",
   "bin": {
     "elsabro": "bin/install.js"
   },
@@ -12,6 +12,7 @@
     "skills",
     "templates",
     "workflows",
+    "flows",
     "references",
     "hooks",
     "scripts"