elsabro 2.0.1 → 2.2.0

package/commands/elsabro/add-phase.md

@@ -1,10 +1,27 @@
 ---
 name: add-phase
 description: Agregar una nueva fase al final del milestone actual
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json"]
 ---
 
 # /elsabro:add-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>add-phase</command-name>
 
 ## Propósito

package/commands/elsabro/add-todo.md

@@ -1,6 +1,11 @@
 ---
 name: add-todo
 description: Agregar un item al todo list del proyecto actual
+allowed-tools:
+  - TaskCreate
+  - TaskList
+  - Read
+  - AskUserQuestion
 ---
 
 # /elsabro:add-todo
@@ -9,7 +14,7 @@ description: Agregar un item al todo list del proyecto actual
 
 ## Propósito
 
-Agregar tareas rápidas al todo list del proyecto. Para items que no merecen ser una fase o story completa.
+Agregar tareas rápidas al todo list del proyecto usando **Claude Code Tasks API** como backend. Para items que no merecen ser una fase o story completa.
 
 ## Cuándo Usar
 
@@ -63,96 +68,149 @@ Agregar tareas rápidas al todo list del proyecto. Para items que no merecen ser
 | `medium` | Normal (default) |
 | `low` | Cuando haya tiempo |
 
-## Almacenamiento
+---
 
-Todos se guardan en `.planning/TODOS.md`:
+## Implementación (Tasks API)
 
-```markdown
-# Project TODOs
+<implementation>
+Cuando el usuario ejecuta `/elsabro:add-todo`:
 
-## Critical 🔴
-- [ ] Fix authentication token refresh (#123)
+### 1. Parse Arguments
 
-## High Priority 🟠
-- [ ] Update React to v18.3 (tech-debt)
-- [ ] Add loading states to dashboard (ux)
+```
+INPUT: /elsabro:add-todo "Fix typo in README" --priority=high --category=docs
+PARSE:
+  - description: "Fix typo in README"
+  - priority: "high" (default: "medium")
+  - category: "docs" (default: "chore")
+  - due: null (opcional)
+  - milestone: null (opcional)
+```
 
-## Medium Priority 🟡
-- [ ] Fix typo in README (docs) - Added 2024-01-20
-- [ ] Add error boundary (tech-debt)
-- [ ] Document API endpoints (docs)
+### 2. Crear Task
+
+```javascript
+TaskCreate({
+  subject: "Fix typo in README",
+  description: "User-created TODO: Fix typo in README\n\nCategory: docs\nPriority: high",
+  activeForm: "Working on: Fix typo in README",
+  metadata: {
+    type: "todo",
+    priority: "high",
+    category: "docs",
+    due_date: null,
+    milestone_id: null,
+    created_by: "user",
+    source_command: "add-todo",
+    created_at: "ISO-8601 timestamp"
+  }
+})
+```
 
-## Low Priority ⬜
-- [ ] Investigate dark mode (idea)
-- [ ] Consider adding PWA support (idea)
+### 3. Output
 
-## Completed ✅
-- [x] Set up CI pipeline (2024-01-18)
-- [x] Add basic tests (2024-01-19)
 ```
+✓ TODO added (Task #<ID>)
 
-## Interactivo
+  Subject: Fix typo in README
+  Priority: high
+  Category: docs
+  Due: -
 
-```bash
-/elsabro:add-todo
+  View all: /elsabro:check-todos
 ```
 
+### 4. Contar TODOs existentes
+
+```javascript
+// Listar todos los tasks tipo "todo"
+TaskList()
+  .filter(t => t.metadata?.type === "todo" && t.status !== "completed")
+
+// Mostrar conteo por prioridad
+  Total TODOs: 8 (2 high, 4 medium, 2 low)
 ```
-Add new TODO:
+</implementation>
 
-Description: Update error messages
-Priority (critical/high/medium/low): high
-Category (bug/tech-debt/docs/chore/idea/question): ux
-Due date (optional):
+---
+
+## Modo Interactivo
 
-Added: "Update error messages" [high/ux]
+```bash
+/elsabro:add-todo
 ```
 
+Si no se proporciona descripción, usar AskUserQuestion:
+
+```javascript
+AskUserQuestion({
+  questions: [
+    {
+      question: "What TODO do you want to add?",
+      header: "Description",
+      options: [
+        { label: "Bug fix", description: "Minor bug to fix" },
+        { label: "Tech debt", description: "Code improvement" },
+        { label: "Documentation", description: "Docs to write" },
+        { label: "Other", description: "Custom description" }
+      ],
+      multiSelect: false
+    }
+  ]
+})
+```
+
+---
+
 ## Opciones
 
 ```bash
 --priority, -p     # critical/high/medium/low
 --category, -c     # Category tag
---due, -d          # Due date
---milestone, -m    # Link to milestone
---phase            # Link to phase
+--due, -d          # Due date (ISO-8601)
+--milestone, -m    # Link to milestone ID
+--phase            # Link to phase ID
 ```
 
-## Quick Add
+## Quick Add (Batch)
 
-Para agregar múltiples todos rápidamente:
+Para agregar múltiples todos:
 
 ```bash
 /elsabro:add-todo --batch
 ```
 
+```javascript
+// Crear múltiples Tasks en paralelo
+TaskCreate({ subject: "Fix button alignment", metadata: {...} })
+TaskCreate({ subject: "Add form validation", metadata: {...} })
+TaskCreate({ subject: "Update user docs", metadata: {...} })
 ```
-Enter TODOs (one per line, empty to finish):
-> Fix button alignment
-> Add form validation
-> Update user docs
->
 
-Added 3 TODOs (all medium priority)
-```
-
-## Output
+---
 
+## Metadata Schema
+
+```json
+{
+  "type": "todo",
+  "priority": "critical|high|medium|low",
+  "category": "bug|tech-debt|docs|chore|idea|question",
+  "due_date": "ISO-8601 | null",
+  "milestone_id": "M001 | null",
+  "phase_id": "P001 | null",
+  "created_by": "user|system",
+  "source_command": "add-todo",
+  "created_at": "ISO-8601"
+}
 ```
-✓ TODO added
 
-  Description: Fix typo in README
-  Priority: medium
-  Category: docs
-  Due: -
-
-  Total TODOs: 8 (2 high, 4 medium, 2 low)
-
-  View all: /elsabro:check-todos
-```
+---
 
 ## Integración
 
 - View with `/elsabro:check-todos`
 - Referenced in `/elsabro:progress`
 - Can be promoted to phase task with `/elsabro:add-phase`
+- Persists across sessions via Tasks API
+- Supports dependencies with `blocks/blockedBy`

package/commands/elsabro/audit-milestone.md

@@ -1,10 +1,29 @@
 ---
 name: audit-milestone
 description: Auditar el estado actual de un milestone - progreso, riesgos y recomendaciones
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # /elsabro:audit-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>audit-milestone</command-name>
 
 ## Propósito

package/commands/elsabro/check-todos.md

@@ -1,6 +1,12 @@
 ---
 name: check-todos
 description: Ver y gestionar el todo list del proyecto
+allowed-tools:
+  - TaskList
+  - TaskGet
+  - TaskUpdate
+  - Read
+  - AskUserQuestion
 ---
 
 # /elsabro:check-todos
@@ -9,7 +15,7 @@ description: Ver y gestionar el todo list del proyecto
 
 ## Propósito
 
-Revisar, filtrar y gestionar los TODOs del proyecto. Vista completa de tareas pendientes.
+Revisar, filtrar y gestionar los TODOs del proyecto usando **Claude Code Tasks API**. Vista completa de tareas pendientes con capacidad de gestión directa.
 
 ## Cuándo Usar
 
@@ -45,7 +51,69 @@ Revisar, filtrar y gestionar los TODOs del proyecto. Vista completa de tareas pe
 /elsabro:check-todos --completed
 ```
 
-## Vista Principal
+---
+
+## Implementación (Tasks API)
+
+<implementation>
+Cuando el usuario ejecuta `/elsabro:check-todos`:
+
+### 1. Obtener TODOs
+
+```javascript
+// Listar todas las Tasks
+const allTasks = TaskList();
+
+// Filtrar por tipo "todo"
+const todos = allTasks.filter(t => t.metadata?.type === "todo");
+```
+
+### 2. Aplicar Filtros
+
+```javascript
+// Si --priority especificado
+if (args.priority) {
+  todos = todos.filter(t => t.metadata?.priority === args.priority);
+}
+
+// Si --category especificado
+if (args.category) {
+  todos = todos.filter(t => t.metadata?.category === args.category);
+}
+
+// Si --pending (default)
+if (args.pending || !args.completed) {
+  todos = todos.filter(t => t.status !== "completed");
+}
+
+// Si --completed
+if (args.completed) {
+  todos = todos.filter(t => t.status === "completed");
+}
+
+// Si --overdue
+if (args.overdue) {
+  const now = new Date();
+  todos = todos.filter(t =>
+    t.metadata?.due_date &&
+    new Date(t.metadata.due_date) < now &&
+    t.status !== "completed"
+  );
+}
+```
+
+### 3. Agrupar por Prioridad
+
+```javascript
+const grouped = {
+  critical: todos.filter(t => t.metadata?.priority === "critical"),
+  high: todos.filter(t => t.metadata?.priority === "high"),
+  medium: todos.filter(t => t.metadata?.priority === "medium"),
+  low: todos.filter(t => t.metadata?.priority === "low")
+};
+```
+
+### 4. Mostrar Vista
 
 ```
 ╔══════════════════════════════════════════════════╗
@@ -53,75 +121,144 @@ Revisar, filtrar y gestionar los TODOs del proyecto. Vista completa de tareas pe
 ╠══════════════════════════════════════════════════╣
 ║                                                  ║
 ║  🔴 CRITICAL (1)                                 ║
-║  #1 Fix auth token refresh [bug]                ║
+║  #<ID> Fix auth token refresh [bug]              ║
 ║                                                  ║
 ║  🟠 HIGH (3)                                     ║
-║  #2 Update React to v18.3 [tech-debt]           ║
-║  #3 Add loading states [ux]                     ║
-║  #4 Update error messages [ux]                  ║
+║  #<ID> Update React to v18.3 [tech-debt]        ║
+║  #<ID> Add loading states [ux]                  ║
+║  #<ID> Update error messages [ux]               ║
 ║                                                  ║
 ║  🟡 MEDIUM (4)                                   ║
-║  #5 Fix typo in README [docs]                   ║
-║  #6 Add error boundary [tech-debt]              ║
-║  #7 Document API endpoints [docs]               ║
-║  #8 Add unit tests for utils [test]             ║
+║  #<ID> Fix typo in README [docs]                ║
+║  #<ID> Add error boundary [tech-debt]           ║
+║  #<ID> Document API endpoints [docs]            ║
+║  #<ID> Add unit tests for utils [test]          ║
 ║                                                  ║
 ║  ⬜ LOW (2)                                      ║
-║  #9 Investigate dark mode [idea]                ║
-║  #10 Consider PWA support [idea]                ║
+║  #<ID> Investigate dark mode [idea]             ║
+║  #<ID> Consider PWA support [idea]              ║
 ║                                                  ║
 ╠══════════════════════════════════════════════════╣
 ║  Total: 10 | Completed today: 2                  ║
 ╚══════════════════════════════════════════════════╝
 ```
+</implementation>
+
+---
 
 ## Gestión de TODOs
 
-### Marcar como completado
+### Marcar como Completado
 
 ```bash
-/elsabro:check-todos --complete=5
+/elsabro:check-todos --complete=<task-id>
 ```
 
+```javascript
+TaskUpdate({
+  taskId: "<task-id>",
+  status: "completed",
+  metadata: {
+    completed_at: new Date().toISOString()
+  }
+});
 ```
-✓ Completed: #5 "Fix typo in README"
+
+Output:
+```
+✓ Completed: #<ID> "Fix typo in README"
 ```
 
-### Cambiar prioridad
+### Cambiar Prioridad
 
 ```bash
-/elsabro:check-todos --prioritize=6 --to=high
+/elsabro:check-todos --prioritize=<task-id> --to=high
+```
+
+```javascript
+// Obtener task actual
+const task = TaskGet({ taskId: "<task-id>" });
+
+// Actualizar prioridad en metadata
+TaskUpdate({
+  taskId: "<task-id>",
+  metadata: {
+    ...task.metadata,
+    priority: "high",
+    updated_at: new Date().toISOString()
+  }
+});
 ```
 
+Output:
 ```
-✓ #6 "Add error boundary" priority: medium → high
+✓ #<ID> "Add error boundary" priority: medium → high
 ```
 
 ### Eliminar TODO
 
 ```bash
-/elsabro:check-todos --delete=9
+/elsabro:check-todos --delete=<task-id>
+```
+
+```javascript
+// Confirmar con usuario
+AskUserQuestion({
+  questions: [{
+    question: `Delete #<ID> "${task.subject}"?`,
+    header: "Confirm",
+    options: [
+      { label: "Yes, delete", description: "Permanently remove this TODO" },
+      { label: "No, keep it", description: "Cancel deletion" }
+    ],
+    multiSelect: false
+  }]
+});
+
+// Si confirmado
+TaskUpdate({ taskId: "<task-id>", status: "deleted" });
 ```
 
+Output:
 ```
-Delete #9 "Investigate dark mode"? (y/n)
-> y
-✓ Deleted
+✓ Deleted: #<ID> "Investigate dark mode"
 ```
 
 ### Editar TODO
 
 ```bash
-/elsabro:check-todos --edit=3
+/elsabro:check-todos --edit=<task-id>
 ```
 
+```javascript
+// Obtener task actual
+const task = TaskGet({ taskId: "<task-id>" });
+
+// Solicitar nueva descripción
+AskUserQuestion({
+  questions: [{
+    question: `Current: "${task.subject}"\nNew description?`,
+    header: "Edit",
+    options: [
+      { label: "Keep current", description: "No changes" },
+      { label: "Modify", description: "Enter new description" }
+    ],
+    multiSelect: false
+  }]
+});
+
+// Si modifica
+TaskUpdate({
+  taskId: "<task-id>",
+  subject: newSubject,
+  metadata: {
+    ...task.metadata,
+    updated_at: new Date().toISOString()
+  }
+});
 ```
-Current: "Add loading states"
-New description (or Enter to keep):
-> Add loading states to all API calls
 
-✓ Updated #3
-```
+---
 
 ## Filtros
 
@@ -133,7 +270,7 @@ New description (or Enter to keep):
 --category=bug|tech-debt|docs|chore|idea|question
 
 # Por estado
---pending          # Solo pendientes
+--pending          # Solo pendientes (default)
 --completed        # Solo completados
 --overdue          # Con fecha vencida
 
@@ -145,12 +282,47 @@ New description (or Enter to keep):
 --milestone=M001
 ```
 
+---
+
 ## Estadísticas
 
 ```bash
 /elsabro:check-todos --stats
 ```
 
+<stats_implementation>
+```javascript
+const todos = TaskList().filter(t => t.metadata?.type === "todo");
+const pending = todos.filter(t => t.status !== "completed");
+const completed = todos.filter(t => t.status === "completed");
+
+// Por prioridad
+const byPriority = {
+  critical: pending.filter(t => t.metadata?.priority === "critical").length,
+  high: pending.filter(t => t.metadata?.priority === "high").length,
+  medium: pending.filter(t => t.metadata?.priority === "medium").length,
+  low: pending.filter(t => t.metadata?.priority === "low").length
+};
+
+// Por categoría
+const byCategory = pending.reduce((acc, t) => {
+  const cat = t.metadata?.category || "uncategorized";
+  acc[cat] = (acc[cat] || 0) + 1;
+  return acc;
+}, {});
+
+// Completion rate (últimos 7 días)
+const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
+const recentlyCompleted = completed.filter(t =>
+  new Date(t.metadata?.completed_at) > sevenDaysAgo
+);
+const completionRate = Math.round(
+  (recentlyCompleted.length / (recentlyCompleted.length + pending.length)) * 100
+);
+```
+</stats_implementation>
+
+Output:
 ```
 ╔══════════════════════════════════════════════════╗
 ║  TODO STATISTICS                                 ║
@@ -172,6 +344,8 @@ New description (or Enter to keep):
 ╚══════════════════════════════════════════════════╝
 ```
 
+---
+
 ## Output Formatos
 
 ```bash
@@ -185,8 +359,13 @@ New description (or Enter to keep):
 /elsabro:check-todos --format=minimal
 ```
 
+---
+
 ## Integración
 
 - Add with `/elsabro:add-todo`
-- Syncs with `.planning/TODOS.md`
-- Can promote to phase with actions
+- Backend: Claude Code Tasks API
+- Persiste entre sesiones
+- Soporta dependencias (`blocks/blockedBy`)
+- Visible en `/elsabro:progress`
+- Promovible a fase con `/elsabro:add-phase`

package/commands/elsabro/complete-milestone.md

@@ -1,10 +1,29 @@
 ---
 name: complete-milestone
-description: Cerrar un milestone completado con retrospectiva y documentación de logros
+description: Cerrar un milestone completado con retrospectiva y documentacion de logros
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # /elsabro:complete-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>complete-milestone</command-name>
 
 ## Propósito

package/commands/elsabro/debug.md

@@ -13,10 +13,29 @@ allowed-tools:
   - AskUserQuestion
   - mcp__plugin_context7_context7__*
 argument-hint: "[descripción del problema]"
+sync:
+  reads: [".elsabro/state.json"]
+  writes: [".elsabro/state.json", ".elsabro/context.md"]
 ---
 
 # ELSABRO: Debug
 
+<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>
 Investigar y resolver bugs usando el método científico, no adivinando.