elsabro 2.1.0 → 2.2.0

package/commands/elsabro/discuss-phase.md

@@ -1,10 +1,27 @@
 ---
 name: discuss-phase
-description: Discusión colaborativa sobre una fase - clarificar scope, identificar riesgos, refinar approach
+description: Discusion colaborativa sobre una fase - clarificar scope, identificar riesgos, refinar approach
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json"]
 ---
 
 # /elsabro:discuss-phase
 
+<state_sync>
+## SINCRONIZACION DE ESTADO
+
+**IMPORTAR**: Ver `/references/state-sync.md` para protocolo completo.
+
+### Al Iniciar
+- Leer `.elsabro/state.json`
+- Verificar contexto actual del milestone/phase
+
+### Al Completar
+- Registrar cambio en `history`
+- Actualizar `context` si corresponde
+</state_sync>
+
 <command-name>discuss-phase</command-name>
 
 ## Propósito

package/commands/elsabro/execute.md

@@ -13,22 +13,225 @@ allowed-tools:
   - TaskUpdate
   - TaskList
   - TaskGet
+  - AskUserQuestion
   - mcp__plugin_context7_context7__*
 argument-hint: "[número de fase]"
+sync:
+  reads: [".elsabro/state.json", ".planning/*-PLAN.md"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
+  phases: ["initializing", "exploring", "executing_wave_N", "verifying", "done"]
+  passes_context_to: ["verify-work"]
+dispatcher:
+  exploration:
+    agents: [Explore, feature-dev:code-explorer, Plan]
+    model: haiku
+    parallel: true
+    min_agents: 3
+  implementation:
+    agents: [elsabro-executor, feature-dev:code-architect]
+    model: opus
+    parallel: true
+    min_agents: 2
+  verification:
+    agents: [pr-review-toolkit:code-reviewer, pr-review-toolkit:silent-failure-hunter, pr-review-toolkit:pr-test-analyzer]
+    model: opus
+    parallel: true
+    min_agents: 3
 ---
 
 # ELSABRO: Execute
 
+<state_sync>
+## SINCRONIZACIÓN DE ESTADO (OBLIGATORIO)
+
+**IMPORTAR**: Este comando DEBE seguir `/references/state-sync.md` y `/references/enforcement-rules.md`.
+
+### Al Iniciar (ANTES de cualquier operación)
+
+```javascript
+// 1. Crear task de inicialización
+TaskCreate({
+  subject: "Initialize execute command",
+  description: "Leer estado y preparar ejecución",
+  activeForm: "Inicializando..."
+})
+TaskUpdate(id, status: "in_progress")
+
+// 2. Leer estado existente
+const state = Read(".elsabro/state.json") || createInitialState();
+
+// 3. Verificar flujo en progreso
+if (state.current_flow && state.current_flow.command !== "execute") {
+  AskUserQuestion({
+    questions: [{
+      question: `Hay un flujo de "${state.current_flow.command}" en progreso. ¿Continuar ese o empezar execute?`,
+      header: "Flujo",
+      options: [
+        { label: "Continuar anterior", description: "Retomar " + state.current_flow.command },
+        { label: "Empezar execute", description: "Pausar anterior" }
+      ]
+    }]
+  });
+}
+
+// 4. Actualizar estado
+state.current_flow = { command: "execute", phase: "initializing", started_at: new Date().toISOString() };
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+
+// 5. Completar task de inicialización
+TaskUpdate(id, status: "completed")
+```
+
+### Al Cambiar de Fase
+
+```javascript
+// Antes de exploración
+state.current_flow.phase = "exploring";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+
+// Antes de cada wave
+state.current_flow.phase = "executing_wave_" + waveNumber;
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+
+// Antes de verificación
+state.current_flow.phase = "verifying";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+### Al Completar
+
+```javascript
+// Registrar en historial
+state.history.push({
+  command: "execute",
+  completed_at: new Date().toISOString(),
+  result: "completed_phase_" + phaseNumber,
+  artifact: null
+});
+
+// Pasar contexto a verify-work
+state.context.changed_files = [...changedFiles];
+state.context.commits = [...commitIds];
+state.context.tests_added = [...testFiles];
+state.context.phase_completed = phaseNumber;
+
+// Limpiar flujo y sugerir siguiente
+state.current_flow = null;
+state.suggested_next = "verify-work";
+
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+
+// Actualizar context.md legible
+Write(".elsabro/context.md", generateHumanReadableContext(state));
+```
+</state_sync>
+
 <objective>
 Ejecutar planes de una fase con:
 - **Sistema de Tasks para tracking real** de waves y dependencias
+- **Dispatcher inteligente con selección automática de modelo** (ver @references/task-dispatcher.md)
+- **Ejecución por subagentes en paralelo** según tipo de tarea
 - Investigación de patrones con Context7
 - TDD cuando sea apropiado
 - Commits atómicos por tarea
 - Verificación automática con agregador
 </objective>
 
+<dispatcher_integration>
+## Selección Automática de Modelo
+
+**REGLA CRÍTICA:** Cada tarea se ejecuta con el modelo óptimo para su tipo.
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    MODELO SEGÚN FASE                                     │
+├─────────────────────────────────────────────────────────────────────────┤
+│  FASE              │  SUBAGENTES                        │  MODELO       │
+├────────────────────┼────────────────────────────────────┼───────────────┤
+│  Exploración       │  Explore                           │  HAIKU        │
+│  (pre-ejecución)   │  feature-dev:code-explorer         │  HAIKU        │
+│                    │  Plan                              │  HAIKU        │
+│                    │  (3 en paralelo obligatorio)       │               │
+├────────────────────┼────────────────────────────────────┼───────────────┤
+│  Implementación    │  elsabro-executor                  │  OPUS         │
+│  (waves)           │  feature-dev:code-architect        │  OPUS         │
+│                    │  (2+ en paralelo por wave)         │               │
+├────────────────────┼────────────────────────────────────┼───────────────┤
+│  Verificación      │  pr-review-toolkit:code-reviewer   │  OPUS         │
+│  (post-ejecución)  │  pr-review-toolkit:silent-...      │  OPUS         │
+│                    │  pr-review-toolkit:pr-test-...     │  OPUS         │
+│                    │  (3 en paralelo obligatorio)       │               │
+└────────────────────┴────────────────────────────────────┴───────────────┘
+```
+
+### Por qué esta distribución
+
+- **HAIKU para exploración:** Solo lee y mapea, no necesita razonamiento profundo
+- **OPUS para implementación:** Escribe código, necesita máxima calidad
+- **OPUS para verificación:** Análisis profundo de bugs y edge cases
+</dispatcher_integration>
+
 <process>
+## Paso 0: Exploración Pre-Ejecución (HAIKU x3 paralelo)
+
+**OBLIGATORIO:** Antes de ejecutar, explorar el codebase para entender contexto.
+
+```javascript
+// Crear tasks de exploración
+TaskCreate({
+  subject: "Explore: Find related files",
+  description: "Buscar archivos relacionados con la fase",
+  activeForm: "Buscando archivos...",
+  metadata: { type: "exploration", model: "haiku" }
+})  // → explore-files-id
+
+TaskCreate({
+  subject: "Explore: Analyze patterns",
+  description: "Analizar patrones existentes en el codebase",
+  activeForm: "Analizando patrones...",
+  metadata: { type: "exploration", model: "haiku" }
+})  // → explore-patterns-id
+
+TaskCreate({
+  subject: "Explore: Map architecture",
+  description: "Mapear arquitectura del área afectada",
+  activeForm: "Mapeando arquitectura...",
+  metadata: { type: "exploration", model: "haiku" }
+})  // → explore-arch-id
+
+// Marcar todas como in_progress
+TaskUpdate({ taskId: "explore-files-id", status: "in_progress" })
+TaskUpdate({ taskId: "explore-patterns-id", status: "in_progress" })
+TaskUpdate({ taskId: "explore-arch-id", status: "in_progress" })
+
+// Lanzar 3 agentes HAIKU EN PARALELO (UN SOLO MENSAJE)
+Task({
+  subagent_type: "Explore",
+  model: "haiku",
+  description: "Buscar archivos relacionados",
+  prompt: "Busca archivos relacionados con la fase [N]. Lista los 10 más relevantes."
+}) |
+Task({
+  subagent_type: "feature-dev:code-explorer",
+  model: "haiku",
+  description: "Analizar patrones",
+  prompt: "Analiza patrones de arquitectura en el área de la fase [N]."
+}) |
+Task({
+  subagent_type: "Plan",
+  model: "haiku",
+  description: "Mapear arquitectura",
+  prompt: "Mapea componentes y flujo de datos del área afectada."
+})
+
+// Marcar completed
+TaskUpdate({ taskId: "explore-files-id", status: "completed" })
+TaskUpdate({ taskId: "explore-patterns-id", status: "completed" })
+TaskUpdate({ taskId: "explore-arch-id", status: "completed" })
+```
+
+**Resultado:** Contexto del codebase capturado antes de modificar nada.
+
 ## Paso 1: Descubrir Planes
 
 ```bash
@@ -93,26 +296,64 @@ Para cada wave:
 TaskUpdate({ taskId: "wave-W-id", status: "in_progress" })
 ```
 
-### Si hay múltiples planes en la wave → Paralelo
+### Si hay múltiples planes en la wave → Paralelo (OPUS)
 ```javascript
 // Marcar todos los planes como in_progress
 TaskUpdate({ taskId: "plan-A-id", status: "in_progress" })
 TaskUpdate({ taskId: "plan-B-id", status: "in_progress" })
 TaskUpdate({ taskId: "plan-C-id", status: "in_progress" })
 
-// Lanzar agentes en paralelo (UN SOLO MENSAJE)
-Task(elsabro-executor) para Plan A |
-Task(elsabro-executor) para Plan B |
-Task(elsabro-executor) para Plan C
+// Lanzar agentes OPUS en paralelo (UN SOLO MENSAJE)
+// MODELO: OPUS porque escriben código
+Task({
+  subagent_type: "elsabro-executor",
+  model: "opus",  // ← OPUS para implementación
+  description: "Ejecutar Plan A",
+  prompt: "Implementa el Plan A siguiendo TDD..."
+}) |
+Task({
+  subagent_type: "elsabro-executor",
+  model: "opus",  // ← OPUS para implementación
+  description: "Ejecutar Plan B",
+  prompt: "Implementa el Plan B siguiendo TDD..."
+}) |
+Task({
+  subagent_type: "elsabro-executor",
+  model: "opus",  // ← OPUS para implementación
+  description: "Ejecutar Plan C",
+  prompt: "Implementa el Plan C siguiendo TDD..."
+})
 
 // Al completar cada plan
 TaskUpdate({ taskId: "plan-A-id", status: "completed" })
 ```
 
-### Si solo hay un plan → Secuencial
+### Validación arquitectónica en paralelo (OPUS x2)
+```javascript
+// Además de implementar, validar arquitectura en paralelo
+Task({
+  subagent_type: "elsabro-executor",
+  model: "opus",
+  description: "Implementar cambios",
+  prompt: "..."
+}) |
+Task({
+  subagent_type: "feature-dev:code-architect",
+  model: "opus",  // ← OPUS para decisiones arquitectónicas
+  description: "Validar arquitectura",
+  prompt: "Verifica que la implementación sigue los patrones del codebase..."
+})
+```
+
+### Si solo hay un plan → Secuencial (OPUS)
 ```javascript
 TaskUpdate({ taskId: "plan-X-id", status: "in_progress" })
-Task(elsabro-executor) para Plan único
+Task({
+  subagent_type: "elsabro-executor",
+  model: "opus",  // ← OPUS porque escribe código
+  description: "Ejecutar plan único",
+  prompt: "..."
+})
 TaskUpdate({ taskId: "plan-X-id", status: "completed" })
 ```
 
@@ -151,18 +392,53 @@ TaskUpdate({
 })
 ```
 
-### 4.2 Ejecutar verificación en paralelo
+### 4.2 Ejecutar verificación en paralelo (OPUS x3)
+
+**OBLIGATORIO:** Usar 3 agentes OPUS para verificación profunda.
+
 ```javascript
+// Crear task adicional de seguridad
+TaskCreate({
+  subject: "Verify Security & Edge Cases",
+  activeForm: "Verificando seguridad...",
+  metadata: { type: "verifier", area: "security", model: "opus" }
+})  // → verify-security-id
+
+// Actualizar agregador para esperar los 3
+TaskUpdate({
+  taskId: "verify-aggregate-id",
+  addBlockedBy: ["verify-functional-id", "verify-quality-id", "verify-security-id"]
+})
+
+// Marcar todos como in_progress
 TaskUpdate({ taskId: "verify-functional-id", status: "in_progress" })
 TaskUpdate({ taskId: "verify-quality-id", status: "in_progress" })
-
-// Lanzar agentes verificadores en paralelo
-Task(elsabro-verifier): Verifica funcionalidad |
-Task(elsabro-verifier): Verifica calidad
+TaskUpdate({ taskId: "verify-security-id", status: "in_progress" })
+
+// Lanzar 3 agentes OPUS EN PARALELO (UN SOLO MENSAJE)
+Task({
+  subagent_type: "pr-review-toolkit:code-reviewer",
+  model: "opus",  // ← OPUS para análisis profundo
+  description: "Code review completo",
+  prompt: "Revisa los cambios buscando bugs, code smells, mejores prácticas..."
+}) |
+Task({
+  subagent_type: "pr-review-toolkit:silent-failure-hunter",
+  model: "opus",  // ← OPUS para edge cases
+  description: "Buscar errores ocultos",
+  prompt: "Busca errores silenciosos, try/catch que ocultan errores, fallbacks problemáticos..."
+}) |
+Task({
+  subagent_type: "pr-review-toolkit:pr-test-analyzer",
+  model: "opus",  // ← OPUS para análisis de tests
+  description: "Analizar cobertura de tests",
+  prompt: "Verifica que los tests cubren los cambios, busca casos críticos sin test..."
+})
 
 // Marcar completed al terminar
 TaskUpdate({ taskId: "verify-functional-id", status: "completed" })
 TaskUpdate({ taskId: "verify-quality-id", status: "completed" })
+TaskUpdate({ taskId: "verify-security-id", status: "completed" })
 
 // Agregador se desbloquea y genera reporte final
 TaskUpdate({ taskId: "verify-aggregate-id", status: "in_progress" })

package/commands/elsabro/insert-phase.md

@@ -1,10 +1,27 @@
 ---
 name: insert-phase
-description: Insertar una nueva fase en una posición específica del milestone
+description: Insertar una nueva fase en una posicion especifica del milestone
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json"]
 ---
 
 # /elsabro:insert-phase
 
+<state_sync>
+## SINCRONIZACION DE ESTADO
+
+**IMPORTAR**: Ver `/references/state-sync.md` para protocolo completo.
+
+### Al Iniciar
+- Leer `.elsabro/state.json`
+- Verificar contexto actual del milestone/phase
+
+### Al Completar
+- Registrar cambio en `history`
+- Actualizar `context` si corresponde
+</state_sync>
+
 <command-name>insert-phase</command-name>
 
 ## Propósito

package/commands/elsabro/list-phase-assumptions.md

@@ -1,10 +1,27 @@
 ---
 name: list-phase-assumptions
 description: Listar y validar los supuestos hechos para una fase del proyecto
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json"]
 ---
 
 # /elsabro:list-phase-assumptions
 
+<state_sync>
+## SINCRONIZACION DE ESTADO
+
+**IMPORTAR**: Ver `/references/state-sync.md` para protocolo completo.
+
+### Al Iniciar
+- Leer `.elsabro/state.json`
+- Verificar contexto actual del milestone/phase
+
+### Al Completar
+- Registrar cambio en `history`
+- Actualizar `context` si corresponde
+</state_sync>
+
 <command-name>list-phase-assumptions</command-name>
 
 ## Propósito

package/commands/elsabro/new-milestone.md

@@ -1,10 +1,29 @@
 ---
 name: new-milestone
 description: Crear un nuevo milestone con objetivos, timeline y métricas de éxito
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # /elsabro:new-milestone
 
+<state_sync>
+## SINCRONIZACION DE ESTADO
+
+**IMPORTAR**: Ver `/references/state-sync.md` para protocolo completo.
+
+### Al Iniciar
+- Leer `.elsabro/state.json`
+- Verificar si hay flujo en progreso
+- Actualizar `current_flow.command` con este comando
+
+### Al Completar
+- Registrar en `history`
+- Actualizar `context` con informacion del milestone
+- Limpiar `current_flow`
+</state_sync>
+
 <command-name>new-milestone</command-name>
 
 ## Propósito

package/commands/elsabro/new.md

@@ -12,10 +12,29 @@ allowed-tools:
   - WebSearch
   - mcp__plugin_context7_context7__*
 argument-hint: "[tipo de proyecto: web, mobile, api]"
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # ELSABRO: Nuevo Proyecto
 
+<state_sync>
+## SINCRONIZACION DE ESTADO
+
+**IMPORTAR**: Ver `/references/state-sync.md` para protocolo completo.
+
+### Al Iniciar
+- Leer `.elsabro/state.json`
+- Verificar si hay flujo en progreso
+- Actualizar `current_flow.command` con este comando
+
+### Al Completar
+- Registrar en `history`
+- Actualizar `context` con informacion relevante
+- Limpiar `current_flow`
+</state_sync>
+
 <objective>
 Crear un proyecto nuevo con investigación previa, configuración correcta, y estructura lista para desarrollo.
 

package/commands/elsabro/pause-work.md

@@ -10,10 +10,29 @@ allowed-tools:
   - TaskCreate
   - TaskList
   - TaskGet
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # /elsabro:pause-work
 
+<state_sync>
+## SINCRONIZACION DE ESTADO
+
+**IMPORTAR**: Ver `/references/state-sync.md` para protocolo completo.
+
+### Al Iniciar
+- Leer `.elsabro/state.json`
+- Verificar si hay flujo en progreso
+- Actualizar `current_flow.command` con este comando
+
+### Al Completar
+- Registrar en `history`
+- Actualizar `context` con informacion relevante
+- Limpiar `current_flow`
+</state_sync>
+
 <command-name>pause-work</command-name>
 
 ## Propósito

package/commands/elsabro/plan-milestone-gaps.md

@@ -1,10 +1,29 @@
 ---
 name: plan-milestone-gaps
-description: Identificar y planificar cómo cerrar gaps en un milestone para alcanzar los objetivos
+description: Identificar y planificar como cerrar gaps en un milestone para alcanzar los objetivos
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # /elsabro:plan-milestone-gaps
 
+<state_sync>
+## SINCRONIZACION DE ESTADO
+
+**IMPORTAR**: Ver `/references/state-sync.md` para protocolo completo.
+
+### Al Iniciar
+- Leer `.elsabro/state.json`
+- Verificar si hay flujo en progreso
+- Actualizar `current_flow.command` con este comando
+
+### Al Completar
+- Registrar en `history`
+- Actualizar `context` con informacion del milestone
+- Limpiar `current_flow`
+</state_sync>
+
 <command-name>plan-milestone-gaps</command-name>
 
 ## Propósito