elsabro 2.1.0 → 2.3.0

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

package/commands/elsabro/plan.md

@@ -8,17 +8,174 @@ allowed-tools:
   - Glob
   - Grep
   - Task
+  - TaskCreate
+  - TaskUpdate
+  - TaskList
   - WebSearch
+  - AskUserQuestion
   - mcp__plugin_context7_context7__*
 argument-hint: "[número de fase o descripción de feature]"
+sync:
+  reads: [".elsabro/state.json", ".planning/PROJECT.md", ".planning/ROADMAP.md"]
+  writes: [".elsabro/state.json", ".elsabro/context.md", ".planning/*-RESEARCH.md", ".planning/*-PLAN.md"]
+  phases: ["initializing", "exploring", "researching", "planning", "validating", "done"]
+  passes_context_to: ["execute"]
+dispatcher:
+  exploration:
+    agents: [Explore, feature-dev:code-explorer, Plan]
+    model: haiku
+    parallel: true
+    min_agents: 3
+  planning:
+    agents: [elsabro-planner]
+    model: opus
+    parallel: false
+  validation:
+    agents: [elsabro-verifier]
+    model: sonnet
+    parallel: false
 ---
 
 # ELSABRO: Plan
 
+<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 plan command",
+  description: "Leer estado y preparar planificació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 !== "plan") {
+  AskUserQuestion({
+    questions: [{
+      question: `Hay un flujo de "${state.current_flow.command}" en progreso. ¿Continuar ese o empezar plan?`,
+      header: "Flujo",
+      options: [
+        { label: "Continuar anterior", description: "Retomar " + state.current_flow.command },
+        { label: "Empezar plan", description: "Pausar anterior" }
+      ]
+    }]
+  });
+}
+
+// 4. Verificar contexto de start (si viene de ahí)
+if (state.history.length > 0 && state.history[state.history.length - 1].command === "start") {
+  // Heredar contexto de start
+  console.log("Contexto heredado de start:", state.context);
+}
+
+// 5. Actualizar estado
+state.current_flow = { command: "plan", phase: "initializing", started_at: new Date().toISOString() };
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+
+// 6. 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 research
+state.current_flow.phase = "researching";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+
+// Antes de planning
+state.current_flow.phase = "planning";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+
+// Antes de validación
+state.current_flow.phase = "validating";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+### Al Completar
+
+```javascript
+// Registrar en historial
+state.history.push({
+  command: "plan",
+  completed_at: new Date().toISOString(),
+  result: "created",
+  artifact: planFilePath  // ".planning/01-01-PLAN.md"
+});
+
+// Pasar contexto a execute
+state.context.plan_file = planFilePath;
+state.context.tech_stack = verifiedTechStack;
+state.context.ready_for_execution = true;
+
+// Limpiar flujo y sugerir siguiente
+state.current_flow = null;
+state.suggested_next = "execute";
+
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+
+// Actualizar context.md legible
+Write(".elsabro/context.md", generateHumanReadableContext(state));
+```
+</state_sync>
+
 <objective>
 Crear un plan ejecutable para una fase o feature, con investigación previa usando Context7 y WebSearch.
+
+**Dispatcher Integration:** Este comando usa selección automática de modelo:
+- **Exploración (HAIKU x3):** Buscar archivos, analizar patrones, mapear arquitectura
+- **Planificación (OPUS x1):** Crear RESEARCH.md y PLAN.md
+- **Validación (SONNET x1):** Verificar que el plan es ejecutable
 </objective>
 
+<dispatcher_flow>
+## Flujo de Ejecución por Subagentes
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                    FLUJO /elsabro:plan                                   │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  FASE 1: EXPLORACIÓN (HAIKU x3 paralelo)                               │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐                     │
+│  │   Explore   │  │ code-explor │  │    Plan     │                     │
+│  │  (haiku)    │  │   (haiku)   │  │  (haiku)    │                     │
+│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘                     │
+│         │                │                │                             │
+│         └────────────────┼────────────────┘                             │
+│                          ▼                                              │
+│  FASE 2: PLANIFICACIÓN (OPUS x1)                                       │
+│  ┌─────────────────────────────────────────────────────────┐           │
+│  │                  elsabro-planner (opus)                 │           │
+│  │  - Crea RESEARCH.md con Context7                        │           │
+│  │  - Crea PLAN.md con tareas atómicas                     │           │
+│  └────────────────────────┬────────────────────────────────┘           │
+│                           │                                             │
+│                           ▼                                             │
+│  FASE 3: VALIDACIÓN (SONNET x1)                                        │
+│  ┌─────────────────────────────────────────────────────────┐           │
+│  │                  elsabro-verifier (sonnet)              │           │
+│  │  - Verifica <verify> ejecutables                        │           │
+│  │  - Valida must_haves observables                        │           │
+│  └─────────────────────────────────────────────────────────┘           │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+</dispatcher_flow>
+
 <process>
 ## Paso 1: Entender Qué Planificar
 
@@ -43,52 +200,123 @@ Leer:
 - `.planning/ROADMAP.md` (si planificando fase)
 - `.planning/config.json` (para preferencias)
 
-## Paso 4: Research-Before-Plan
-
-**OBLIGATORIO:** Investigar antes de planificar.
-
-Spawn agentes en paralelo:
-
+## Paso 4: Exploración Pre-Planificación (HAIKU x3 paralelo)
+
+**OBLIGATORIO:** Explorar el codebase antes de planificar.
+
+```javascript
+// Crear tasks de exploración
+TaskCreate({
+  subject: "Explore: Related files",
+  activeForm: "Buscando archivos relacionados...",
+  metadata: { type: "exploration", model: "haiku" }
+})
+
+TaskCreate({
+  subject: "Explore: Existing patterns",
+  activeForm: "Analizando patrones...",
+  metadata: { type: "exploration", model: "haiku" }
+})
+
+TaskCreate({
+  subject: "Explore: Architecture map",
+  activeForm: "Mapeando arquitectura...",
+  metadata: { type: "exploration", model: "haiku" }
+})
+
+// Lanzar 3 agentes HAIKU EN PARALELO (UN SOLO MENSAJE)
+Task({
+  subagent_type: "Explore",
+  model: "haiku",  // ← HAIKU para exploración
+  description: "Buscar archivos relacionados",
+  prompt: "Busca archivos relacionados con la fase/feature. Lista los 10 más relevantes."
+}) |
+Task({
+  subagent_type: "feature-dev:code-explorer",
+  model: "haiku",  // ← HAIKU para exploración
+  description: "Analizar patrones existentes",
+  prompt: "Analiza patrones de arquitectura, convenciones y dependencias del área."
+}) |
+Task({
+  subagent_type: "Plan",
+  model: "haiku",  // ← HAIKU para exploración
+  description: "Mapear arquitectura",
+  prompt: "Mapea componentes, flujo de datos y puntos de integración."
+})
 ```
-Task(elsabro-planner, model: sonnet):
-  Fase/Feature: [descripción]
-
-  Contexto del proyecto:
-  [Resumen de PROJECT.md]
-
-  Tu trabajo:
-  1. Identificar tecnologías necesarias
-  2. Buscar en Context7 las APIs actuales
-  3. Buscar en WebSearch mejores prácticas [año]
-  4. Crear RESEARCH.md con hallazgos
-  5. Crear PLAN.md con tareas específicas
-
-  Recuerda:
-  - Context7 PRIMERO para cualquier librería
-  - Máximo 2-3 tareas por plan
-  - Cada tarea debe ser verificable
+
+## Paso 5: Research-Before-Plan (OPUS x1)
+
+**OBLIGATORIO:** Investigar con OPUS antes de planificar.
+
+```javascript
+TaskCreate({
+  subject: "Create RESEARCH.md and PLAN.md",
+  activeForm: "Investigando y planificando...",
+  metadata: { type: "planning", model: "opus" }
+})
+
+// Lanzar agente OPUS para planificación
+Task({
+  subagent_type: "elsabro-planner",
+  model: "opus",  // ← OPUS para planificación profunda
+  description: "Crear plan ejecutable",
+  prompt: `
+    Fase/Feature: [descripción]
+
+    Contexto del proyecto:
+    [Resumen de PROJECT.md]
+
+    Hallazgos de exploración:
+    [Resultados de HAIKU agents]
+
+    Tu trabajo:
+    1. Identificar tecnologías necesarias
+    2. Buscar en Context7 las APIs actuales
+    3. Buscar en WebSearch mejores prácticas 2026
+    4. Crear RESEARCH.md con hallazgos
+    5. Crear PLAN.md con tareas específicas
+
+    Recuerda:
+    - Context7 PRIMERO para cualquier librería
+    - Máximo 2-3 tareas por plan
+    - Cada tarea debe ser verificable
+  `
+})
 ```
 
-## Paso 5: Crear Archivos
+## Paso 6: Crear Archivos
 
 El planner crea:
 - `.planning/{phase}-RESEARCH.md`
 - `.planning/{phase}-{N}-PLAN.md`
 
-## Paso 6: Verificar Plan (Opcional)
-
-Si `plan_check: true` en config.json:
-
-```
-Task(elsabro-verifier, model: haiku):
-  Verifica que los planes cumplen:
-  - Cada tarea tiene <verify> ejecutable
-  - Los must_haves son observables
-  - No hay dependencias circulares
-  - El scope es razonable (~50% context)
+## Paso 7: Verificar Plan (SONNET x1)
+
+**SIEMPRE** verificar que el plan es ejecutable:
+
+```javascript
+TaskCreate({
+  subject: "Validate plan",
+  activeForm: "Validando plan...",
+  metadata: { type: "validation", model: "sonnet" }
+})
+
+Task({
+  subagent_type: "elsabro-verifier",
+  model: "sonnet",  // ← SONNET para validación estructurada
+  description: "Validar plan",
+  prompt: `
+    Verifica que los planes cumplen:
+    - Cada tarea tiene <verify> ejecutable
+    - Los must_haves son observables
+    - No hay dependencias circulares
+    - El scope es razonable (~50% context)
+  `
+})
 ```
 
-## Paso 7: Presentar al Usuario
+## Paso 8: Presentar al Usuario
 
 ```
 Plan creado para: [fase/feature]