elsabro 4.0.0 → 4.2.0

package/commands/elsabro/new.md

@@ -28,11 +28,14 @@ sync:
 - Leer `.elsabro/state.json`
 - Verificar si hay flujo en progreso
 - Actualizar `current_flow.command` con este comando
+- Activar persistent mode: `state.elsabro_mode = true`
 
 ### Al Completar
 - Registrar en `history`
 - Actualizar `context` con informacion relevante
 - Limpiar `current_flow`
+- Establecer `state.suggested_next = "plan"` en state.json
+- Establecer `state.context.suggested_args = "1"` para la primera fase
 </state_sync>
 
 <objective>
@@ -115,6 +118,12 @@ Ejecutar los pasos del skill seleccionado para:
 2. Configurar dependencias
 3. Verificar que funciona
 
+```javascript
+// MARCAR: código fue generado (para code_review_gate)
+state.current_flow.code_written = true;
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
 ## Paso 7: Crear .planning/
 
 Una vez el proyecto base funciona:
@@ -177,6 +186,36 @@ Para probarlo:
 ```
 </process>
 
+<code_review_gate>
+## Code Review Gate (OBLIGATORIO - NO NEGOCIABLE)
+
+**ANTES de mostrar resultado al usuario o continuar a siguiente paso, VERIFICAR:**
+
+```
+¿Se generó código de scaffold/proyecto?
+│
+├─ SÍ → ¿Se ejecutó code review?
+│    │
+│    ├─ NO → EJECUTAR AHORA:
+│    │   Task(pr-review-toolkit:code-reviewer)
+│    │   Si issues > 0: fix y re-review
+│    │   Solo cuando issues == 0: continuar
+│    │
+│    └─ SÍ, issues == 0 → Continuar
+│         state.current_flow.code_review_passed = true ← MARCAR
+│
+└─ NO → Continuar (no aplica)
+```
+
+```javascript
+// MARCAR: code review pasó (para GATE CHECK en siguiente_paso)
+state.current_flow.code_review_passed = true;
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+**VIOLACIÓN CRÍTICA**: Entregar proyecto sin code review = ABORTAR OPERACIÓN
+</code_review_gate>
+
 <skills_routing>
 ## Routing a Skills
 
@@ -247,3 +286,28 @@ Antes de terminar, confirmar:
 3. **Usuario confirma:**
    "¿Puedes ver [lo esperado]?"
 </verification>
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al completar la creación del proyecto, establecer en state.json:
+```javascript
+// GATE CHECK: No escribir suggested_next sin code review
+if (state.current_flow?.code_written && !state.current_flow?.code_review_passed) {
+  // VIOLACIÓN CRÍTICA — ABORTAR. Volver a code_review_gate.
+  throw new Error("CODE_REVIEW_GATE: Cannot proceed without code review");
+}
+state.context = state.context || {};
+state.suggested_next = "plan";
+state.context.suggested_args = "1"; // primera fase
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ /elsabro:plan 1 — planificar la primera fase del proyecto
+→ /elsabro:map-codebase — explorar la estructura creada
+```
+</siguiente_paso>

package/commands/elsabro/pause-work.md

@@ -26,11 +26,14 @@ sync:
 - 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`
+- Activar persistent mode: `state.elsabro_mode = true`
+
+### Al Completar (ORDEN IMPORTA)
+1. **PRIMERO** guardar `state.context.paused_command = state.current_flow?.command` (ANTES de limpiar current_flow)
+2. Registrar en `history`
+3. Actualizar `context` con informacion relevante
+4. Limpiar `current_flow` (DESPUÉS de guardar paused_command)
+5. Establecer `state.suggested_next = "resume-work"`
 </state_sync>
 
 <command-name>pause-work</command-name>
@@ -334,3 +337,23 @@ Al reanudar, verificar tiempo desde pausa:
 └──────────────────────────────────────────────────┘
 ```
 </session_state_management>
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al completar la pausa, establecer en state.json:
+```javascript
+// Guardar qué comando estaba activo para que resume-work lo sepa
+state.context = state.context || {};
+state.context.paused_command = state.current_flow?.command || null;
+state.suggested_next = "resume-work";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ /elsabro:resume-work — cuando estés listo para continuar
+```
+</siguiente_paso>

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

@@ -17,11 +17,13 @@ sync:
 - Leer `.elsabro/state.json`
 - Verificar si hay flujo en progreso
 - Actualizar `current_flow.command` con este comando
+- Activar persistent mode: `state.elsabro_mode = true`
 
 ### Al Completar
 - Registrar en `history`
 - Actualizar `context` con informacion del milestone
 - Limpiar `current_flow`
+- Establecer `state.suggested_next = "execute"`
 </state_sync>
 
 <command-name>plan-milestone-gaps</command-name>
@@ -146,3 +148,21 @@ Genera `.planning/milestones/M001-xxx/GAP-PLAN.md` con:
 - Alimenta sprint planning
 - Conecta con `/elsabro:plan` para detalles
 - Usa `/elsabro:quick` para gaps pequeños
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al completar la planificación de gaps, establecer en state.json:
+```javascript
+state.suggested_next = "execute";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ /elsabro:execute — ejecutar el plan para corregir los gaps
+→ /elsabro:quick — resolver gaps pequeños rápidamente
+```
+</siguiente_paso>

package/commands/elsabro/plan.md

@@ -79,6 +79,7 @@ if (state.history.length > 0 && state.history[state.history.length - 1].command
 
 // 5. Actualizar estado
 state.current_flow = { command: "plan", phase: "initializing", started_at: new Date().toISOString() };
+state.elsabro_mode = true;
 Write(".elsabro/state.json", JSON.stringify(state, null, 2));
 
 // 6. Completar task de inicialización
@@ -117,6 +118,7 @@ state.history.push({
 });
 
 // Pasar contexto a execute
+state.context = state.context || {};
 state.context.plan_file = planFilePath;
 state.context.tech_stack = verifiedTechStack;
 state.context.ready_for_execution = true;
@@ -498,3 +500,21 @@ Al completar planificación:
 }
 ```
 </parallel_coordination>
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al completar, establecer en state.json:
+```javascript
+state.suggested_next = "execute";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ /elsabro:execute — ejecutar el plan creado
+→ /elsabro:discuss-phase — discutir el alcance antes de ejecutar
+```
+</siguiente_paso>

package/commands/elsabro/progress.md

@@ -12,6 +12,14 @@ allowed-tools:
 
 # ELSABRO: Progress
 
+<state_sync>
+## SINCRONIZACIÓN DE ESTADO
+
+### Al Iniciar
+- Leer `.elsabro/state.json` (si existe)
+- Activar persistent mode: `state.elsabro_mode = true`
+</state_sync>
+
 <objective>
 Mostrar el estado actual del proyecto y guiar al usuario sobre qué hacer a continuación usando **Claude Code Tasks API** como fuente de verdad.
 </objective>

package/commands/elsabro/quick.md

@@ -17,11 +17,13 @@ sync:
 - Leer `.elsabro/state.json`
 - Verificar si hay flujo en progreso
 - Actualizar `current_flow.command` con este comando
+- Activar persistent mode: `state.elsabro_mode = true`
 
 ### Al Completar
 - Registrar en `history`
 - Actualizar `context` con informacion relevante
 - Limpiar `current_flow`
+- Establecer `state.suggested_next = "progress"` en state.json
 </state_sync>
 
 <command-name>quick</command-name>
@@ -81,11 +83,17 @@ ELSABRO: [Ejecuta en <30 segundos]
 3. Execute (15-60 seg)
    └─ Hacer el cambio
    └─ Agregar test si aplica
+   └─ state.current_flow.code_written = true ← MARCAR
 
 4. Verify (10 seg)
    └─ Correr tests afectados
 
-5. Report
+5. Code Review (OBLIGATORIO)
+   └─ Task(pr-review-toolkit:code-reviewer) sobre archivos modificados
+   └─ Si hay issues: fix antes de reportar
+   └─ Si issues == 0: state.current_flow.code_review_passed = true ← MARCAR
+
+6. Report
    └─ Mostrar diff
    └─ Ofrecer commit
 ```
@@ -95,8 +103,9 @@ ELSABRO: [Ejecuta en <30 segundos]
 1. **Max 2 preguntas** - Si necesitas más info, usa `/elsabro:plan`
 2. **Max 3 archivos** - Si afecta más, usa flujo normal
 3. **Auto-test** - Siempre corre tests relacionados
-4. **No docs** - Skip documentación para velocidad
-5. **Offer commit** - Siempre pregunta si commitear
+4. **Auto-review** - SIEMPRE ejecutar code review con `Task(pr-review-toolkit:code-reviewer)` después de escribir código
+5. **No docs** - Skip documentación para velocidad
+6. **Offer commit** - Siempre pregunta si commitear
 
 ## Integración con Agentes
 
@@ -116,3 +125,49 @@ Quick mode usa `elsabro-yolo-dev` (Flash) internamente:
 
   Commit? (y/n/edit message)
 ```
+
+<code_review_gate>
+## Code Review Gate (OBLIGATORIO - NO NEGOCIABLE)
+
+**ANTES de mostrar resultado o ofrecer commit, VERIFICAR:**
+
+```
+¿Se escribió/modificó código?
+│
+├─ SÍ → ¿Se ejecutó code review (Paso 5)?
+│    │
+│    ├─ NO → EJECUTAR AHORA:
+│    │   Task(pr-review-toolkit:code-reviewer)
+│    │   Si issues > 0: fix y re-review
+│    │   Solo cuando issues == 0: continuar
+│    │
+│    └─ SÍ, issues == 0 → Continuar
+│
+└─ NO → Continuar (no aplica)
+```
+
+**VIOLACIÓN CRÍTICA**: Reportar resultado sin code review = ABORTAR OPERACIÓN
+</code_review_gate>
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al completar la tarea rápida, establecer en state.json:
+```javascript
+// GATE CHECK: No escribir suggested_next sin code review
+if (state.current_flow?.code_written && !state.current_flow?.code_review_passed) {
+  // VIOLACIÓN CRÍTICA — ABORTAR. Volver a code_review_gate.
+  throw new Error("CODE_REVIEW_GATE: Cannot proceed without code review");
+}
+state.suggested_next = "progress";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ /elsabro:progress — ver el estado del proyecto
+→ Si hay más cambios pendientes: commit los cambios
+```
+</siguiente_paso>

package/commands/elsabro/remove-phase.md

@@ -16,10 +16,12 @@ sync:
 ### Al Iniciar
 - Leer `.elsabro/state.json`
 - Verificar contexto actual del milestone/phase
+- Activar persistent mode: `state.elsabro_mode = true`
 
 ### Al Completar
 - Registrar cambio en `history`
 - Actualizar `context` si corresponde
+- Establecer `state.suggested_next = "progress"`
 </state_sync>
 
 <command-name>remove-phase</command-name>
@@ -151,3 +153,21 @@ Timeline impact: -2 days
 
 Restore: Use /elsabro:insert-phase with --from-archive flag
 ```
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al eliminar la fase, establecer en state.json:
+```javascript
+state.suggested_next = "progress";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ /elsabro:progress — ver el estado actualizado
+→ /elsabro:plan — replanificar si es necesario
+```
+</siguiente_paso>

package/commands/elsabro/research-phase.md

@@ -16,10 +16,12 @@ sync:
 ### Al Iniciar
 - Leer `.elsabro/state.json`
 - Verificar contexto actual del milestone/phase
+- Activar persistent mode: `state.elsabro_mode = true`
 
 ### Al Completar
 - Registrar cambio en `history`
 - Actualizar `context` si corresponde
+- Establecer `state.suggested_next = "plan"`
 </state_sync>
 
 <command-name>research-phase</command-name>
@@ -189,3 +191,21 @@ Breaking changes from 4.x noted
 
   Ready for: /elsabro:plan or /elsabro:discuss-phase
 ```
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al completar la investigación, establecer en state.json:
+```javascript
+state.suggested_next = "plan";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ /elsabro:plan — planificar con los hallazgos de la investigación
+→ /elsabro:discuss-phase — discutir los resultados antes de planificar
+```
+</siguiente_paso>

package/commands/elsabro/resume-work.md

@@ -27,11 +27,13 @@ sync:
 - Leer `.elsabro/state.json`
 - Verificar si hay flujo en progreso
 - Actualizar `current_flow.command` con este comando
+- Activar persistent mode: `state.elsabro_mode = true`
 
 ### Al Completar
 - Registrar en `history`
 - Actualizar `context` con informacion relevante
 - Limpiar `current_flow`
+- Establecer `state.suggested_next` basado en contexto recuperado (el comando pausado)
 </state_sync>
 
 <command-name>resume-work</command-name>
@@ -414,3 +416,22 @@ Al reanudar exitosamente, **MERGE** (no reemplazar) los campos:
 
 **IMPORTANTE:** No sobrescribir `recovery` completo, solo agregar `resumedFrom` y `resumedAt`.
 </session_validation>
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al completar, establecer en state.json:
+```javascript
+// Sugerir el comando que estaba pausado
+state.suggested_next = state.context?.paused_command || "progress";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ /elsabro:[comando pausado] — continuar donde lo dejaste
+→ /elsabro:progress — ver el estado general antes de continuar
+```
+</siguiente_paso>

package/commands/elsabro/set-profile.md

@@ -7,6 +7,18 @@ description: Cambiar el perfil de comportamiento de ELSABRO
 
 <command-name>set-profile</command-name>
 
+<state_sync>
+## SINCRONIZACIÓN DE ESTADO
+
+### Al Iniciar
+- Leer `.elsabro/state.json` (si existe)
+- Guardar `state.context.previous_suggested_next = state.suggested_next` (para restaurar al completar)
+- Activar persistent mode: `state.elsabro_mode = true`
+
+### Al Completar
+- Restaurar `state.suggested_next` al valor anterior (flujo previo) desde `state.context.previous_suggested_next`
+</state_sync>
+
 ## Propósito
 
 Cambiar rápidamente el perfil de comportamiento de ELSABRO. Los perfiles son presets que ajustan múltiples settings a la vez.
@@ -214,3 +226,29 @@ Active settings:
 - Stored en `.elsabro/config.json`
 - Full settings con `/elsabro:settings`
 - Affects all ELSABRO behavior
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al iniciar, guardar la sugerencia actual:
+```javascript
+// ANTES de cualquier cambio, guardar suggested_next actual
+state.context = state.context || {};
+state.context.previous_suggested_next = state.suggested_next;
+```
+
+Al completar el cambio de perfil:
+```javascript
+// Restaurar sugerencia del flujo previo
+state.suggested_next = state.context?.previous_suggested_next || "start";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ Volver al flujo anterior con el nuevo perfil
+→ /elsabro:start — empezar algo nuevo con el perfil actualizado
+```
+</siguiente_paso>

package/commands/elsabro/settings.md

@@ -7,6 +7,18 @@ description: Ver y modificar configuración de ELSABRO
 
 <command-name>settings</command-name>
 
+<state_sync>
+## SINCRONIZACIÓN DE ESTADO
+
+### Al Iniciar
+- Leer `.elsabro/state.json` (si existe)
+- Guardar `state.context.previous_suggested_next = state.suggested_next` (para restaurar al completar)
+- Activar persistent mode: `state.elsabro_mode = true`
+
+### Al Completar
+- Restaurar `state.suggested_next` al valor anterior (flujo previo) desde `state.context.previous_suggested_next`
+</state_sync>
+
 ## Propósito
 
 Gestionar la configuración de ELSABRO - perfiles, preferencias, integraciones y comportamientos.
@@ -183,3 +195,29 @@ Settings guardados en `.elsabro/config.json`:
 - Profiles con `/elsabro:set-profile`
 - Affects all ELSABRO commands
 - Project-level config in `.elsabro/`
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al iniciar, guardar la sugerencia actual:
+```javascript
+// ANTES de cualquier cambio, guardar suggested_next actual
+state.context = state.context || {};
+state.context.previous_suggested_next = state.suggested_next;
+```
+
+Al completar, restaurar suggested_next anterior:
+```javascript
+// Restaurar sugerencia del flujo previo
+state.suggested_next = state.context?.previous_suggested_next || "start";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ Volver al flujo anterior
+→ /elsabro:start — empezar algo nuevo
+```
+</siguiente_paso>

package/commands/elsabro/start.md

@@ -106,6 +106,14 @@ Combinar información de ambos agentes para determinar:
 - `existing_plans`: planes existentes en .planning/
 - `current_flow`: flujo en progreso (de state.json)
 
+### 0.4.1 Activar Persistent Mode
+
+```javascript
+// Activar persistent mode al iniciar ELSABRO
+state.elsabro_mode = true;
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
 ### 0.5 Completar Task de inicialización
 
 ```
@@ -290,8 +298,28 @@ Skill("[comando]", "[contexto relevante]")
 ```
 TaskUpdate(id, status: "completed", result: "transitioned_to_[comando]")
 ```
+
 </transition>
 
+<siguiente_paso>
+## Siguiente Paso
+
+Después de la transición al comando elegido, el "Siguiente Paso" lo muestra el comando destino.
+Si el usuario no elige opción, sugerir:
+
+```javascript
+state.suggested_next = "map-codebase";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+```
+## Siguiente Paso
+
+→ /elsabro:map-codebase — explorar y entender el proyecto
+→ /elsabro:plan — planificar directamente si ya sabes qué hacer
+```
+</siguiente_paso>
+
 <skills_integration>
 ## Integración con Skills Profesionales
 
@@ -395,7 +423,9 @@ mkdir -p .elsabro
   ],
 
   "pending_tasks": [],
-  "blocked_on": null
+  "blocked_on": null,
+  "elsabro_mode": false,
+  "suggested_next": null
 }
 ```
 

package/commands/elsabro/update.md

@@ -8,6 +8,17 @@ allowed-tools:
 
 # ELSABRO: Actualización
 
+<state_sync>
+## SINCRONIZACIÓN DE ESTADO
+
+### Al Iniciar
+- Leer `.elsabro/state.json` (si existe)
+- Activar persistent mode: `state.elsabro_mode = true`
+
+### Al Completar
+- Establecer `state.suggested_next = "start"`
+</state_sync>
+
 <objective>
 Actualizar ELSABRO a la última versión disponible, preservando la configuración local.
 </objective>
@@ -71,3 +82,20 @@ Para ver los cambios: https://github.com/cubait/elsabro/releases
 - Los agentes y comandos se reemplazan con la versión más nueva
 - Si hay problemas, puedes reinstalar: `npx elsabro --global`
 </notes>
+
+<siguiente_paso>
+## Siguiente Paso
+
+Al completar la actualización, establecer en state.json:
+```javascript
+state.suggested_next = "start";
+Write(".elsabro/state.json", JSON.stringify(state, null, 2));
+```
+
+Mostrar al usuario:
+```
+## Siguiente Paso
+
+→ /elsabro:start — comenzar a usar la nueva versión
+```
+</siguiente_paso>