ostacky 0.6.1 → 0.6.2

package/assets/skills/execution-mode-evaluation/SKILL.md

@@ -1,189 +1,189 @@
----
-name: execution-mode-evaluation
-description: Decide entre ejecución inline o subagent-driven según el análisis de CodeGraph. Úsalo cuando tengas tasks de implementación y necesites determinar el modo de ejecución óptimo.
-license: MIT
-compatibility: Requires CodeGraph MCP server and OpenSpec tasks.md
-metadata:
-  author: Ostacky
-  version: "2.0"
----
-
-**IMPORTANT:** Engram is an **MCP server**, not a skill. Tools `mem_save`, `mem_search`, `mem_context` are MCP tools. Do NOT use `skill("engram")` — it doesn't exist.
-
-# Skill: execution-mode-evaluation
-
-Determinar el modo de ejecución óptimo entre **inline** y **subagent-driven** usando datos concretos de CodeGraph. La decisión sigue reglas estrictas en orden de precedencia.
-
-## Input necesario
-
-| Dato | Fuente | Obligatorio |
-|------|--------|-------------|
-| Tasks del change | `tasks.md` del cambio activo | ✅ |
-| Archivos que modifica cada task | `codegraph_explore` o lectura directa | ✅ |
-| Blast radius por símbolo | `codegraph_impact` | Para alta precisión |
-| Contratos entre tasks | `design.md` | Para evaluar dependencias |
-
-## Procedimiento
-
-### Paso 0: Verificar datos existentes en contexto
-
-Si ya tenés output de `codegraph_explore` para el área del cambio **Y** ese output distingue archivos por task → **saltá al Paso 0.5**. Si no, ejecutá el Paso 1.
-
-### Paso 0.1: Consultar Engram por decisiones previas
-
-`mem_search` con keywords del cambio (nombre del módulo, área afectada). Si existe una decisión de modo de ejecución anterior para un cambio similar, considerarla como referencia — no como vinculante. Las condiciones pueden haber cambiado.
-
-### Paso 0.5: Early exit para cambios pequeños
-
-Si el change tiene **≤2 tasks** Y **no comparten archivos entre sí** → devolver directamente:
-
-```json
-{
-  "recommendation": "INLINE",
-  "reasons": ["Cambio pequeño (≤2 tasks independientes sin archivos compartidos)."],
-  "codegraphUsed": [], "taskCount": <N>, "sharedFiles": {},
-  "fileClusters": [<cada task como cluster>], "clusterCount": <taskCount>,
-  "sequentialDeps": [], "estLines": <est>, "hasExplicitContract": false,
-  "filesPerTask": {}, "globalRuleTriggered": "early-exit"
-}
-```
-
-### Paso 1: Obtener datos de CodeGraph
-
-```
-codegraph_explore con query: "<área del cambio>"
-```
-
-Si el output es muy general → `codegraph_impact` sobre símbolos centrales para blast radius preciso.
-Si CodeGraph no está inicializado → devolver `{ "recommendation": "INLINE", "confidence": 0.3, "reasons": ["CodeGraph no disponible"], "codegraphUsed": [] }`.
-
-### Paso 2: Construir mapa de dependencias
-
-```
-taskCount:       total tasks de implementación
-sharedFiles:     { archivo → [tasks que lo modifican] }
-sequentialDeps:  [ [taskA, taskB], ... ]  // B necesita que A esté hecho
-fileClusters:    componentes conectados por sharedFiles (cierre transitivo)
-filesPerTask:    { task → [archivos que modifica] }
-estLines:        estimación conservadora (~2-3 config, ~5-10 simple, ~15-30 complejo, ~10-20 tests)
-```
-
-**Detección de sequentialDeps:** buscar en tasks.md frases como "extender", "usar lo creado en", "depende de", "modificar el [módulo] de la task anterior".
-
-### Paso 3a: Reglas de modo global (en orden, primera que se cumpla decide)
-
-| # | Condición | Modo | Razón |
-|---|-----------|------|-------|
-| **1** | `clusterCount == 1` Y cluster tiene tamaño > 1 | INLINE | Todos comparten archivos en un único cluster — imposible paralelizar |
-| **2a** | `clusterCount >= 2` Y hay deps entre clusters Y `hasExplicitContract == false` | INLINE | Deps secuenciales entre clusters sin contrato explícito |
-| **2b** | `clusterCount >= 2` Y (NO hay deps entre clusters O contrato explícito) | SUBAGENT-DRIVEN | Cada cluster → 1 subagente. Tasks intra-cluster van secuenciales |
-| **3a** | `clusterCount == taskCount` Y `taskCount < 3` | INLINE | Muy pocas tasks para amortizar overhead de subagentes |
-| **3b** | `clusterCount == taskCount` Y `estLines < 30` | INLINE | Cambio pequeño — inline más eficiente en tokens |
-| **3c** | `clusterCount == taskCount` (ninguna anterior) | SUBAGENT-DRIVEN | Tasks independientes — subagentes aíslan contexto |
-
-**Excepción:** instrucciones explícitas del usuario ("hacé todo inline" / "usá subagentes") tienen prioridad total.
-
-**Regla 2b — dispatch por clusters:** el subagente recibe el CLUSTER COMPLETO (no tasks individuales), las resuelve secuencialmente (comparten archivos). Diferentes clusters corren en paralelo.
-
-### Paso 3b: Evaluación por fases (solo si modo global es INLINE)
-
-Si global es SUBAGENT-DRIVEN → saltar (ya está granularizado por cluster).
-
-Para cada fase de `tasks.md`, evaluar intra-fase:
-
-| Condición | Modo fase |
-|-----------|-----------|
-| sharedFiles intra-fase > 0 | INLINE |
-| sharedFiles con fases inline > 0 | INLINE |
-| sequentialDeps intra-fase > 0 Y sin contrato | INLINE |
-| taskCount fase < 4 | INLINE |
-| estLines fase < 30 | INLINE |
-| Ninguna anterior | SUBAGENT-DRIVEN |
-
-**Orden de ejecución:** fases inline primero (establecen base), luego fases subagent-driven (consumen base).
-
-### Paso 4: Output
-
-**Snapshot para el controller (JSON):**
-
-```json
-{
-  "recommendation": "INLINE" | "SUBAGENT_DRIVEN",
-  "reasons": ["razón principal", "razón secundaria"],
-  "codegraphUsed": ["codegraph_explore"],
-  "taskCount": <N>,
-  "sharedFiles": { "src/archivo.ts": ["task1", "task2"] },
-  "fileClusters": [["task1", "task2"], ["task3"]],
-  "clusterCount": <N>,
-  "sequentialDeps": [],
-  "estLines": <N>,
-  "hasExplicitContract": false,
-  "filesPerTask": { "task1": ["src/archivo.ts"] },
-  "globalRuleTriggered": "1" | "2a" | "2b" | "3a" | "3b" | "3c" | "early-exit",
-  "phaseRecommendations": []
-}
-```
-
-**Output para el usuario (mostrar en lenguaje natural):**
-
-```markdown
-## Análisis de modo de ejecución
-
-**Recomendación:** INLINE / SUBAGENT_DRIVEN
-
-### Archivos compartidos entre tasks
-| Archivo | Tasks que lo modifican |
-|---------|------------------------|
-| `src/auth.ts` | task1, task2 |
-| `src/utils.ts` | task3 |
-
-### Clusters detectados
-| Cluster | Tasks | Archivos |
-|---------|-------|----------|
-| A | task1, task2 | src/auth.ts |
-| B | task3 | src/utils.ts |
-
-### Dependencias secuenciales
-- task2 depende de task1 (usa lo creado en)
-
-### Razón principal
-[Regla 2a]: Deps secuenciales entre clusters sin contrato explícito → INLINE
-
-### Estimación
-~45 líneas en 2 archivos
-```
-
-**Campos del snapshot (contrato con controller):**
-
-| Campo | Descripción |
-|-------|-------------|
-| `recommendation` | `INLINE` o `SUBAGENT_DRIVEN` |
-| `reasons` | Array — primera es la principal |
-| `codegraphUsed` | Tools de CodeGraph ejecutados |
-| `filesPerTask` | taskId → [archivos que modifica] |
-| `sharedFiles` | archivo → [tasks que lo tocan] |
-| `fileClusters` | Componentes conectados por sharedFiles |
-| `clusterCount` | `== 1` todo conectado, `== taskCount` todo independiente |
-| `sequentialDeps` | Dependencias secuenciales entre tasks |
-| `estLines` | Estimación conservadora |
-| `hasExplicitContract` | `true` si design.md explicita contratos |
-
-**⚠️ Este skill provee ANÁLISIS, no autorización.** El coordinador muestra el snapshot al usuario y pide confirmación en lenguaje natural, luego espera la respuesta.
-
-## Ejemplo compacto
-
-5 tasks, 3 clusters independientes (A: task1+task2 en `workflow.ts`, B: task3+task4 en `structured.ts`, C: task5 en archivo nuevo), sin deps entre clusters:
-
-→ Rule 2b: SUBAGENT-DRIVEN. SA-1 ejecuta cluster A secuencial, SA-2 ejecuta cluster B secuencial, SA-3 ejecuta cluster C. Los 3 corren en paralelo. ✅
-
-## Checklist
-
-- [ ] Ejecuté `codegraph_explore` (o verifiqué datos existentes)?
-- [ ] Construí mapa de dependencias con `fileClusters`?
-- [ ] Identifiqué clusters (componentes conectados)?
-- [ ] Verifiqué deps ENTRE clusters (no solo intra)?
-- [ ] Apliqué reglas en orden (1→2a/2b→3a/3b/3c)?
-- [ ] Anoté `globalRuleTriggered`?
-- [ ] Si global es inline, ejecuté Paso 3b por fase?
-- [ ] Si global es subagent por clusters (Rule 2b), documenté dispatch?
-- [ ] Output es JSON válido con todos los campos del contrato?
+---
+name: execution-mode-evaluation
+description: Decide entre ejecución inline o subagent-driven según el análisis de CodeGraph. Úsalo cuando tengas tasks de implementación y necesites determinar el modo de ejecución óptimo.
+license: MIT
+compatibility: Requires CodeGraph MCP server and OpenSpec tasks.md
+metadata:
+  author: Ostacky
+  version: "2.0"
+---
+
+**IMPORTANT:** Engram is an **MCP server**, not a skill. Tools `mem_save`, `mem_search`, `mem_context` are MCP tools. Do NOT use `skill("engram")` — it doesn't exist.
+
+# Skill: execution-mode-evaluation
+
+Determinar el modo de ejecución óptimo entre **inline** y **subagent-driven** usando datos concretos de CodeGraph. La decisión sigue reglas estrictas en orden de precedencia.
+
+## Input necesario
+
+| Dato | Fuente | Obligatorio |
+|------|--------|-------------|
+| Tasks del change | `tasks.md` del cambio activo | ✅ |
+| Archivos que modifica cada task | `codegraph_explore` o lectura directa | ✅ |
+| Blast radius por símbolo | `codegraph_impact` | Para alta precisión |
+| Contratos entre tasks | `design.md` | Para evaluar dependencias |
+
+## Procedimiento
+
+### Paso 0: Verificar datos existentes en contexto
+
+Si ya tenés output de `codegraph_explore` para el área del cambio **Y** ese output distingue archivos por task → **saltá al Paso 0.5**. Si no, ejecutá el Paso 1.
+
+### Paso 0.1: Consultar Engram por decisiones previas
+
+`mem_search` con keywords del cambio (nombre del módulo, área afectada). Si existe una decisión de modo de ejecución anterior para un cambio similar, considerarla como referencia — no como vinculante. Las condiciones pueden haber cambiado.
+
+### Paso 0.5: Early exit para cambios pequeños
+
+Si el change tiene **≤2 tasks** Y **no comparten archivos entre sí** → devolver directamente:
+
+```json
+{
+  "recommendation": "INLINE",
+  "reasons": ["Cambio pequeño (≤2 tasks independientes sin archivos compartidos)."],
+  "codegraphUsed": [], "taskCount": <N>, "sharedFiles": {},
+  "fileClusters": [<cada task como cluster>], "clusterCount": <taskCount>,
+  "sequentialDeps": [], "estLines": <est>, "hasExplicitContract": false,
+  "filesPerTask": {}, "globalRuleTriggered": "early-exit"
+}
+```
+
+### Paso 1: Obtener datos de CodeGraph
+
+```
+codegraph_explore con query: "<área del cambio>"
+```
+
+Si el output es muy general → `codegraph_impact` sobre símbolos centrales para blast radius preciso.
+Si CodeGraph no está inicializado → devolver `{ "recommendation": "INLINE", "confidence": 0.3, "reasons": ["CodeGraph no disponible"], "codegraphUsed": [] }`.
+
+### Paso 2: Construir mapa de dependencias
+
+```
+taskCount:       total tasks de implementación
+sharedFiles:     { archivo → [tasks que lo modifican] }
+sequentialDeps:  [ [taskA, taskB], ... ]  // B necesita que A esté hecho
+fileClusters:    componentes conectados por sharedFiles (cierre transitivo)
+filesPerTask:    { task → [archivos que modifica] }
+estLines:        estimación conservadora (~2-3 config, ~5-10 simple, ~15-30 complejo, ~10-20 tests)
+```
+
+**Detección de sequentialDeps:** buscar en tasks.md frases como "extender", "usar lo creado en", "depende de", "modificar el [módulo] de la task anterior".
+
+### Paso 3a: Reglas de modo global (en orden, primera que se cumpla decide)
+
+| # | Condición | Modo | Razón |
+|---|-----------|------|-------|
+| **1** | `clusterCount == 1` Y cluster tiene tamaño > 1 | INLINE | Todos comparten archivos en un único cluster — imposible paralelizar |
+| **2a** | `clusterCount >= 2` Y hay deps entre clusters Y `hasExplicitContract == false` | INLINE | Deps secuenciales entre clusters sin contrato explícito |
+| **2b** | `clusterCount >= 2` Y (NO hay deps entre clusters O contrato explícito) | SUBAGENT-DRIVEN | Cada cluster → 1 subagente. Tasks intra-cluster van secuenciales |
+| **3a** | `clusterCount == taskCount` Y `taskCount < 3` | INLINE | Muy pocas tasks para amortizar overhead de subagentes |
+| **3b** | `clusterCount == taskCount` Y `estLines < 30` | INLINE | Cambio pequeño — inline más eficiente en tokens |
+| **3c** | `clusterCount == taskCount` (ninguna anterior) | SUBAGENT-DRIVEN | Tasks independientes — subagentes aíslan contexto |
+
+**Excepción:** instrucciones explícitas del usuario ("hacé todo inline" / "usá subagentes") tienen prioridad total.
+
+**Regla 2b — dispatch por clusters:** el subagente recibe el CLUSTER COMPLETO (no tasks individuales), las resuelve secuencialmente (comparten archivos). Diferentes clusters corren en paralelo.
+
+### Paso 3b: Evaluación por fases (solo si modo global es INLINE)
+
+Si global es SUBAGENT-DRIVEN → saltar (ya está granularizado por cluster).
+
+Para cada fase de `tasks.md`, evaluar intra-fase:
+
+| Condición | Modo fase |
+|-----------|-----------|
+| sharedFiles intra-fase > 0 | INLINE |
+| sharedFiles con fases inline > 0 | INLINE |
+| sequentialDeps intra-fase > 0 Y sin contrato | INLINE |
+| taskCount fase < 4 | INLINE |
+| estLines fase < 30 | INLINE |
+| Ninguna anterior | SUBAGENT-DRIVEN |
+
+**Orden de ejecución:** fases inline primero (establecen base), luego fases subagent-driven (consumen base).
+
+### Paso 4: Output
+
+**Snapshot para el controller (JSON):**
+
+```json
+{
+  "recommendation": "INLINE" | "SUBAGENT_DRIVEN",
+  "reasons": ["razón principal", "razón secundaria"],
+  "codegraphUsed": ["codegraph_explore"],
+  "taskCount": <N>,
+  "sharedFiles": { "src/archivo.ts": ["task1", "task2"] },
+  "fileClusters": [["task1", "task2"], ["task3"]],
+  "clusterCount": <N>,
+  "sequentialDeps": [],
+  "estLines": <N>,
+  "hasExplicitContract": false,
+  "filesPerTask": { "task1": ["src/archivo.ts"] },
+  "globalRuleTriggered": "1" | "2a" | "2b" | "3a" | "3b" | "3c" | "early-exit",
+  "phaseRecommendations": []
+}
+```
+
+**Output para el usuario (mostrar en lenguaje natural):**
+
+```markdown
+## Análisis de modo de ejecución
+
+**Recomendación:** INLINE / SUBAGENT_DRIVEN
+
+### Archivos compartidos entre tasks
+| Archivo | Tasks que lo modifican |
+|---------|------------------------|
+| `src/auth.ts` | task1, task2 |
+| `src/utils.ts` | task3 |
+
+### Clusters detectados
+| Cluster | Tasks | Archivos |
+|---------|-------|----------|
+| A | task1, task2 | src/auth.ts |
+| B | task3 | src/utils.ts |
+
+### Dependencias secuenciales
+- task2 depende de task1 (usa lo creado en)
+
+### Razón principal
+[Regla 2a]: Deps secuenciales entre clusters sin contrato explícito → INLINE
+
+### Estimación
+~45 líneas en 2 archivos
+```
+
+**Campos del snapshot (contrato con controller):**
+
+| Campo | Descripción |
+|-------|-------------|
+| `recommendation` | `INLINE` o `SUBAGENT_DRIVEN` |
+| `reasons` | Array — primera es la principal |
+| `codegraphUsed` | Tools de CodeGraph ejecutados |
+| `filesPerTask` | taskId → [archivos que modifica] |
+| `sharedFiles` | archivo → [tasks que lo tocan] |
+| `fileClusters` | Componentes conectados por sharedFiles |
+| `clusterCount` | `== 1` todo conectado, `== taskCount` todo independiente |
+| `sequentialDeps` | Dependencias secuenciales entre tasks |
+| `estLines` | Estimación conservadora |
+| `hasExplicitContract` | `true` si design.md explicita contratos |
+
+**⚠️ Este skill provee ANÁLISIS, no autorización.** El coordinador muestra el snapshot al usuario y pide confirmación en lenguaje natural, luego espera la respuesta.
+
+## Ejemplo compacto
+
+5 tasks, 3 clusters independientes (A: task1+task2 en `workflow.ts`, B: task3+task4 en `structured.ts`, C: task5 en archivo nuevo), sin deps entre clusters:
+
+→ Rule 2b: SUBAGENT-DRIVEN. SA-1 ejecuta cluster A secuencial, SA-2 ejecuta cluster B secuencial, SA-3 ejecuta cluster C. Los 3 corren en paralelo. ✅
+
+## Checklist
+
+- [ ] Ejecuté `codegraph_explore` (o verifiqué datos existentes)?
+- [ ] Construí mapa de dependencias con `fileClusters`?
+- [ ] Identifiqué clusters (componentes conectados)?
+- [ ] Verifiqué deps ENTRE clusters (no solo intra)?
+- [ ] Apliqué reglas en orden (1→2a/2b→3a/3b/3c)?
+- [ ] Anoté `globalRuleTriggered`?
+- [ ] Si global es inline, ejecuté Paso 3b por fase?
+- [ ] Si global es subagent por clusters (Rule 2b), documenté dispatch?
+- [ ] Output es JSON válido con todos los campos del contrato?