ostacky 0.2.1 → 0.3.1

package/README.md

@@ -193,20 +193,20 @@ Tras instalar, el proyecto queda así:
 
 ```json
 {
-    "version": "0.2.1",
+    "version": "0.3.1",
     "lockedAt": "2025-01-01T00:00:00.000Z",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.2.1",
+    "tag": "v0.3.1",
     "agents": {
         "ostacky": {
-            "version": "0.2.1",
+            "version": "0.3.1",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "abc123..."
         }
     },
     "commands": {
         "install-stack": {
-            "version": "0.2.1",
+            "version": "0.3.1",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "def456..."
         }
@@ -239,7 +239,7 @@ Es opcional y solo necesario si algo falló durante la instalación o si querés
 ## Seguridad
 
 - `opencode.jsonc` se versiona en el repo para compartir permisos y MCP de forma reproducible.
-- Las URLs de descarga usan **tags de GitHub** (ej. `v0.2.1`), nunca `main` — instalaciones reproducibles
+- Las URLs de descarga usan **tags de GitHub** (ej. `v0.3.1`), nunca `main` — instalaciones reproducibles
 - Cada path de archivo descargado es validado para prevenir **path traversal**
 - Los archivos incluyen **checksum SHA-256** opcional; si el manifest lo define, el contenido se verifica antes de escribir
 - El cache local (`~/.opencode/cache/`) también valida integridad al servir archivos cacheados

package/assets/agents/ostacky.md

@@ -106,13 +106,23 @@ Si el usuario no responde, **detenete y esperá**. No asumas un camino.
 
 ### 4. Execution
 
-1. Elegir el modo antes de ejecutar:
-   - **Inline** para Nivel 0, la ruta `directo` de Nivel 0+1 y cambios contenidos de Nivel 1+.
-   - **Subagent-driven** solo si la tarea se puede partir en slices autonomos con briefs mucho mas chicos que el contexto del coordinador y sin estado compartido.
-2. **Superpowers** es el unico orquestador de ejecucion, TDD, review y delegacion.
-3. Los subagentes son **execution-only**.
-4. Los subagentes no se usan para "hacerlo mas rapido" por defecto: se usan para aislar complejidad cuando eso reduce contexto total.
-5. Los subagentes no crean proposals, no planifican, no inician nueva delegacion y no repiten retrieval ya resuelto por el coordinador.
+1. **Cargar AHORA el skill `execution-mode-evaluation` usando el Skill tool.**
+   Seguir el procedimiento del skill (Paso 0 a Paso 4) estrictamente, con reglas en orden de precedencia.
+   **No continuar al paso 2 hasta tener el output JSON del skill en contexto.**
+   Si el output no está disponible o está incompleto, recargar el skill.
+
+2. **Elegir el modo SEGUN el output del skill:**
+   - Si `mode` es `"inline"` → ejecutar inline (norma general)
+   - Si `mode` es `"subagent-driven"` → ejecutar con subagentes
+   - Usar `phaseRecommendations` para planificar el orden de ejecucion:
+     * Ejecutar primero las fases con `mode: "inline"`
+     * Despues las fases con `mode: "subagent-driven"`
+   - Si el output no tiene `phaseRecommendations`, todo el cambio va en el modo global.
+
+3. **Superpowers** es el unico orquestador de ejecucion, TDD, review y delegacion.
+4. Los subagentes son **execution-only**.
+5. Los subagentes no se usan para "hacerlo mas rapido" por defecto: se usan para aislar complejidad cuando eso reduce contexto total.
+6. Los subagentes no crean proposals, no planifican, no inician nueva delegacion y no repiten retrieval ya resuelto por el coordinador.
 
 ### 5. Sync y cierre
 
@@ -153,6 +163,7 @@ Engram es el sistema de memoria persistente del stack. Su uso es **obligatorio y
 
 - Discovery: `brainstorming`
 - Planning: `writing-plans`
+- Decision de ejecucion: `execution-mode-evaluation` (usar antes de implementar)
 - Ejecucion compleja: `subagent-driven-development` o `dispatching-parallel-agents`
 - Calidad y tests: `tdd`, `review`
 - OpenSpec: `openspec-explore`, `openspec-propose`, `openspec-apply-change`, `openspec-archive-change`

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

@@ -0,0 +1,224 @@
+# execution-mode-evaluation
+
+Decide entre ejecución **inline** o **subagent-driven** según datos concretos de CodeGraph. Evaluación multicapa: modo global + recomendaciones por fase.
+
+---
+
+## Contexto de uso
+
+El skill se carga dentro del flujo del agente Ostacky, específicamente en la etapa **Execution** cuando el cambio requiere una decisión informada (Nivel 1+ o Nivel 0+1 con spec):
+
+```
+                    ┌──────────────┐
+                    │  USER REQUEST │
+                    └──────┬───────┘
+                           ▼
+                    ┌──────────────┐
+                    │ 1. DISCOVERY │
+                    │ (CodeGraph)  │
+                    └──────┬───────┘
+                           ▼
+              ┌────────────┴────────────┐
+              ▼                         ▼
+     ┌────────────────┐       ┌──────────────────┐
+     │  Nivel 0       │       │  Nivel 0+1       │
+     │  trivial       │       │                   │
+     └───────┬────────┘       └────────┬──────────┘
+             ▼                         ▼
+     Inline directo           ┌────┴────┐
+                              ▼         ▼
+                        OpenSpec    Directo
+                           │           │
+                           ▼           ▼
+                     ┌──────────┐  Inline directo
+                     │ Planning │  (sin skill)
+                     └────┬─────┘
+                          ▼
+                    ┌──────────────┐
+                    │  Nivel 1+    │
+                    │  (OpenSpec)  │
+                    └──────┬───────┘
+                           ▼
+              ┌────────────────────────┐
+              │ 4. EXECUTION           │
+              │                        │
+              │ ┌── 1. Cargar SKILL ──┐│
+              │ │   Skill tool ->     ││ <- FORZOSO
+              │ │   execution-mode-   ││
+              │ │   evaluation        ││
+              │ └─────────────────────┘│
+              │ ┌  NO CONTINUAR       ┐│
+              │ │  SIN OUTPUT JSON    ││
+              │ └─────────────────────┘│
+              │                        │
+              │ 2. Elegir modo segun   │
+              │    output del skill    │
+              │                        │
+              │ 3. Ejecutar            │
+              └────────────────────────┘
+```
+
+---
+
+## Flujo completo del skill
+
+Los pasos que ejecuta el skill una vez cargado:
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                   1. GATILLO                                 │
+│                                                              │
+│  Agent definition (ostacky.md) dice:                         │
+│  "Cargar AHORA el skill execution-mode-evaluation"           │
+│  "No continuar sin el output JSON"                           │
+│                                                              │
+│  → Se invoca el Skill tool → se carga este SKILL.md         │
+└──────────────────────────┬───────────────────────────────────┘
+                           ▼
+┌──────────────────────────────────────────────────────────────┐
+│                   2. PASO 0 — CHECK DE DATOS                 │
+│                                                              │
+│  ¿Ya hay codegraph_context en el contexto de la sesión?      │
+│  ├── SÍ y tiene los archivos por task → saltar Paso 1       │
+│  └── NO o incompleto → continuar a Paso 1                   │
+└──────────────────────────┬───────────────────────────────────┘
+                           ▼
+┌──────────────────────────────────────────────────────────────┐
+│                   3. PASO 1 — CODEGRAPH (si necesario)       │
+│                                                              │
+│  Ejecutar codegraph_context sobre el área del cambio         │
+│  Buscar: archivos, símbolos, relaciones                     │
+│                                                              │
+│  Si hace falta más precisión: codegraph_impact               │
+│                                                              │
+│  Si CodeGraph no disponible: fallback a inline con conf 0.3  │
+│                                                              │
+│  Output: datos de archivos y símbolos involucrados           │
+└──────────────────────────┬───────────────────────────────────┘
+                           ▼
+┌──────────────────────────────────────────────────────────────┐
+│                   4. PASO 2 — MAPA DE DEPENDENCIAS           │
+│                                                              │
+│  Se construye con tasks.md + datos de CodeGraph:             │
+│                                                              │
+│  ┌─────────────────────────────────────────────────────┐     │
+│  │ taskCount:     cantidad total de tasks               │     │
+│  │ sharedFiles:   { archivo → [tasks que lo modifican] }│     │
+│  │ sequentialDeps: [taskA → taskB]                      │     │
+│  │ filesPerTask:  { task → [archivos] }                 │     │
+│  │ estLines:      líneas estimadas de cambio            │     │
+│  │ hasExplicitContract: diseño explícita contratos?     │     │
+│  └─────────────────────────────────────────────────────┘     │
+└──────────────────────────┬───────────────────────────────────┘
+                           ▼
+┌──────────────────────────────────────────────────────────────┐
+│                   5. PASO 3a — MODO GLOBAL                   │
+│                                                              │
+│  5 reglas en orden. La PRIMERA que se cumple decide.        │
+│                                                              │
+│  1. ¿sharedFiles > 0?                              → INLINE  │
+│  2. ¿sequentialDeps sin contrato?                  → INLINE  │
+│  3. ¿taskCount < 4?                                → INLINE  │
+│  4. ¿estLines < 30?                                → INLINE  │
+│  5. Ninguna de las anteriores             → SUBAGENT-DRIVEN  │
+│                                                              │
+│  Si el usuario dio instrucciones explícitas:                 │
+│  → anulan todas las reglas, todas las fases heredan el modo  │
+└──────────────────────────┬───────────────────────────────────┘
+                           ▼
+┌──────────────────────────────────────────────────────────────┐
+│            6. PASO 3b — EVALUACIÓN POR FASES                 │
+│            (solo si el modo global es INLINE)                │
+│                                                              │
+│  Si el modo global es SUBAGENT-DRIVEN → saltar este paso     │
+│                                                              │
+│  Por cada fase en tasks.md:                                  │
+│                                                              │
+│  ┌─────────────────────────────────────────────────────┐     │
+│  │ a. ¿sharedFiles DENTRO de la fase?      → INLINE     │     │
+│  │ b. ¿sharedFiles con fases INLINE?       → INLINE     │     │
+│  │ c. ¿sequentialDeps sin contrato?        → INLINE     │     │
+│  │ d. ¿taskCount < 4?                      → INLINE     │     │
+│  │ e. ¿estLines < 30?                      → INLINE     │     │
+│  │ f. Ninguna de las anteriores → SUBAGENT-DRIVEN       │     │
+│  └─────────────────────────────────────────────────────┘     │
+│                                                              │
+│  Output: un modo por fase (no modifica el modo global)       │
+└──────────────────────────┬───────────────────────────────────┘
+                           ▼
+┌──────────────────────────────────────────────────────────────┐
+│                   7. PASO 4 — OUTPUT JSON                    │
+│                                                              │
+│  {                                                           │
+│    "mode": "inline" | "subagent-driven",                     │
+│    "confidence": 0.95,                                       │
+│    "reasons": ["..."],                                       │
+│    "globalRuleTriggered": 1,                                 │
+│    "taskAnalysis": { ... },                                  │
+│    "phaseRecommendations": [                                 │
+│      { "phase": "2. Core", "mode": "inline", ... },          │
+│      { "phase": "4. Tests", "mode": "subagent-driven", ... } │
+│    ]                                                         │
+│  }                                                           │
+└──────────────────────────┬───────────────────────────────────┘
+                           ▼
+┌──────────────────────────────────────────────────────────────┐
+│                   8. POST-DECISIÓN                           │
+│                                                              │
+│  Agent definition usa el output:                             │
+│                                                              │
+│  - mode "inline" → el agente ejecuta todo en su sesión       │
+│  - mode "subagent-driven" → carga subagent-driven-development│
+│  - phaseRecommendations: inline PRIMERO, subagent DESPUÉS    │
+│                                                              │
+│  Orden de fases:                                             │
+│    1º Fases inline (establecen contratos)                    │
+│    2º Fases subagent-driven (consumen contratos)             │
+└──────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Reglas que gobiernan la decisión
+
+### Modo global (Paso 3a)
+
+| Regla | Condición | Decisión |
+|-------|-----------|----------|
+| 1 | Archivos compartidos entre tasks | INLINE |
+| 2 | Dependencias secuenciales sin contrato explícito | INLINE |
+| 3 | Menos de 4 tasks | INLINE |
+| 4 | Menos de 30 líneas estimadas | INLINE |
+| 5 | Ninguna condición anterior | SUBAGENT-DRIVEN |
+
+### Modo por fase (Paso 3b)
+
+| Regla | Condición | Decisión |
+|-------|-----------|----------|
+| a | Archivos compartidos dentro de la fase | INLINE |
+| b | Comparte archivos con fases inline | INLINE |
+| c | Dependencias secuenciales sin contrato | INLINE |
+| d | Menos de 4 tasks en la fase | INLINE |
+| e | Menos de 30 líneas en la fase | INLINE |
+| f | Ninguna condición anterior | SUBAGENT-DRIVEN |
+
+### Excepciones
+
+- **Instrucción del usuario** anula todo el skill — si el usuario dice "hacé todo inline" o "usá subagentes", eso tiene prioridad absoluta.
+- **CodeGraph no disponible** — fallback a inline con confianza baja, no bloquear.
+
+---
+
+## Orden de ejecución recomendado
+
+1. **Primero** fases con `mode: "inline"` — establecen interfaces, tipos y módulos
+2. **Después** fases con `mode: "subagent-driven"` — consumen lo establecido
+3. Si hay dependencias entre fases subagent-driven, respetar el orden de `tasks.md`
+
+---
+
+## Limitaciones
+
+- El skill depende de CodeGraph para los datos. Si CodeGraph no está disponible, decide inline por defecto.
+- Si `tasks.md` no está organizado en fases, `phaseRecommendations` será un array vacío.
+- La decisión es point-in-time: si se agregan tasks a mitad de cambio, re-ejecutar el skill.

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

@@ -0,0 +1,385 @@
+---
+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: "1.0"
+---
+
+# Skill: execution-mode-evaluation
+
+## Propósito
+
+Determinar el modo de ejecución óptimo entre **inline** y **subagent-driven** para un cambio, usando datos concretos de CodeGraph (no especulación del modelo). La decisión sigue reglas estrictas en orden de precedencia.
+
+## Input necesario
+
+El modelo DEBE tener disponible en contexto (o accesible vía el procedimiento):
+
+| Dato | Fuente | Obligatorio |
+|------|--------|-------------|
+| Tasks del change | `tasks.md` del cambio activo | ✅ Sí |
+| Archivos que modifica cada task | `codegraph_context` o lectura directa de tasks | ✅ Sí |
+| Relaciones entre símbolos | `codegraph_context` | Recomendado |
+| Blast radius por símbolo | `codegraph_impact` | Para alta precisión |
+| Contratos explícitos entre tasks | `design.md` | Para evaluar dependencias |
+
+## Procedimiento
+
+Seguir los pasos en orden. No saltear ni reordenar.
+
+---
+
+### Paso 0: Verificar datos existentes en contexto
+
+Revisá el contexto actual de la sesión.
+
+**Si ya tenés disponible:**
+- El output de `codegraph_context` para el área del cambio **Y**
+- Ese output incluye los archivos específicos que cada task modifica
+
+→ **Saltá el Paso 1.** Usá los datos que ya están en contexto.
+
+**Si no los tenés, o tenés dudas sobre su completitud:**
+→ Ejecutá el Paso 1.
+
+**Regla:** si el `codegraph_context` que tenés solo dio una visión general pero no alcanza a distinguir archivos por task, no es suficiente. Ejecutá de nuevo.
+
+---
+
+### Paso 1: Obtener datos de CodeGraph
+
+Ejecutá esta consulta:
+
+```
+codegraph_context con task: "<descripción del cambio>"
+```
+
+Buscá específicamente en el output:
+- Lista de archivos involucrados
+- Símbolos principales y sus archivos
+- Relaciones (quién importa a quién, quién extiende a quién)
+
+**Si el output es muy general o no distingue archivos por task:**
+
+Ejecutá `codegraph_impact` sobre los símbolos centrales que aparezcan en el output. Esto te da el blast radius preciso de cada símbolo (qué archivos se rompen si lo cambiás).
+
+**Si CodeGraph reporta que el proyecto no está inicializado:**
+
+→ DEVOLVÉ: `{ "mode": "inline", "confidence": 0.3, "reasons": ["CodeGraph no disponible - fallback a inline"], "codegraphUsed": [] }`
+
+No bloquees. En proyectos sin CodeGraph, la decisión por defecto es inline.
+
+---
+
+### Paso 2: Construir mapa de dependencias
+
+Con tasks.md + datos de CodeGraph, construí este mapa:
+
+```
+taskCount:       número total de tasks (solo las de implementación)
+sharedFiles:     { archivo -> [tasks que lo modifican] }
+sequentialDeps:  [ [taskA, taskB], ... ]  // B necesita que A esté hecho
+filesPerTask:    { task -> [archivos que modifica] }
+estLines:        estimación conservadora de líneas totales de cambio
+hasExplicitContract: true/false  // design.md especifica contratos entre tasks?
+```
+
+**Para detectar sharedFiles:**
+- Si dos tasks mencionan modificar el mismo archivo → sharedFile.
+- Usá `codegraph_impact` si hay dudas sobre qué archivos toca cada símbolo.
+
+**Para detectar sequentialDeps:**
+- Buscá en tasks.md frases como: "extender", "usar lo creado en", "modificar el [módulo] de la task anterior", "depende de".
+- Si task B dice "Update [X] to handle [Y]" y task A dice "Add [Y] to [X]" → dependencia secuencial.
+- Si el diseño (design.md) explicita contratos (interfaces, tipos compartidos), la dependencia es manejable con subagentes.
+
+**Para estimar estLines:**
+- Tasks de configuración/setup: ~2-3 líneas
+- Tasks de implementación simple (agregar un enum, un flag): ~5-10 líneas
+- Tasks de implementación compleja (nuevo módulo, lógica): ~15-30 líneas
+- Tasks de tests: ~10-20 líneas
+- Tasks de documentación: ~5-15 líneas
+
+No es necesario ser exacto. Una estimación conservadora alcanza.
+
+---
+
+### Paso 3a: Modo global del cambio
+
+Aplicar ESTRICTAMENTE en este orden. Evaluar cada condición. En la PRIMERA que se cumpla, esa es la decisión global.
+
+```
+1. SI sharedFiles tiene 1+ archivos compartidos entre 2+ tasks
+   → INLINE (global)
+   → Razón: "Archivos compartidos: {archivos}. Subagentes causarían conflictos de merge."
+
+2. SI sequentialDeps tiene 1+ dependencias Y hasExplicitContract == false
+   → INLINE (global)
+   → Razón: "Dependencias secuenciales sin contrato explícito en design.md.
+              Subagentes podrían definir contratos inconsistentes."
+   
+   EXCEPCIÓN: sequentialDeps pero hasExplicitContract == true
+   → NO aplicar esta regla. Continuar a la siguiente.
+
+3. SI taskCount < 4
+   → INLINE (global)
+   → Razón: "{taskCount} tasks. El overhead de dispatchear subagentes supera el beneficio."
+
+4. SI estLines < 30
+   → INLINE (global)
+   → Razón: "Cambio pequeño (~{estLines} líneas). Inline es más eficiente en tokens."
+
+5. SI NINGUNA condición anterior se cumplió
+   → SUBAGENT-DRIVEN (global)
+   → Razón: "{taskCount} tasks independientes sin archivos compartidos.
+              Subagentes aíslan contexto y evitan saturación."
+```
+
+**Importante:** a diferencia de antes, NO saltear las reglas restantes al encontrar la primera. Anotar cuál regla se cumplió y por qué, pero CONTINUAR al Paso 3b para evaluar por fases. Solo si el modo global es SUBAGENT-DRIVEN (regla 5), saltear el Paso 3b porque no hay fases que optimizar.
+
+**Excepción global:** si el usuario dio instrucciones EXPLÍCITAS sobre el modo de ejecución
+("hacé todo inline", "usá subagentes"), esas instrucciones tienen PRIORIDAD TOTAL sobre estas reglas. En ese caso, todas las fases heredan el modo del usuario.
+
+---
+
+### Paso 3b: Evaluación por fases (solo si el modo global es inline)
+
+Si el modo global es SUBAGENT-DRIVEN (regla 5), saltear este paso — todas las fases van como subagentes.
+
+Si el modo global es INLINE (reglas 1-4), evaluar CADA FASE de `tasks.md` por separado para determinar si alguna puede ejecutarse como subagentes independientes.
+
+**Para cada fase en tasks.md:**
+
+1. Extraer solo las tasks de esa fase.
+2. Construir un mapa reducido: sharedFiles intra-fase, sequentialDeps intra-fase, taskCount de la fase, estLines de la fase.
+3. Verificar si las tasks de esta fase comparten archivos con tasks de fases que van inline (usar el mapa global del Paso 2).
+4. Aplicar estas reglas en orden. La PRIMERA que se cumpla decide el modo de la fase:
+
+```
+a. SI sharedFiles intra-fase > 0
+   → INLINE para esta fase
+   → Razón: "Archivos compartidos dentro de la fase: {archivos}."
+
+b. SI sharedFiles con fases inline > 0
+   → INLINE para esta fase
+   → Razón: "Comparte archivos con fase inline: {archivos}. Riesgo de conflictos cross-fase."
+
+c. SI sequentialDeps intra-fase > 0 Y hasExplicitContract == false
+   → INLINE para esta fase
+   → Razón: "Dependencias secuenciales sin contrato explícito."
+
+d. SI taskCount de la fase < 4
+   → INLINE para esta fase
+   → Razón: "{N} tasks en la fase. Overhead de subagentes no se amortiza."
+
+e. SI estLines de la fase < 30
+   → INLINE para esta fase
+   → Razón: "Fase pequeña (~{N} líneas). Inline más eficiente."
+
+f. SI NINGUNA condición anterior se cumplió
+   → SUBAGENT-DRIVEN para esta fase
+   → Razón: "{N} tasks independientes sin archivos compartidos."
+```
+
+**Output del Paso 3b:** una recomendación por fase. No modifica el modo global, pero le da al coordinador un plan de ejecución granular.
+
+---
+
+### Paso 4: Devolver decisión
+
+El output DEBE ser un JSON válido en este formato:
+
+```json
+{
+  "mode": "inline" | "subagent-driven",
+  "confidence": 0.0 - 1.0,
+  "reasons": ["razón principal", "razón secundaria"],
+  "codegraphUsed": ["codegraph_context"],
+  "globalRuleTriggered": 1,
+  "taskAnalysis": {
+    "taskCount": 13,
+    "sharedFiles": {
+      "src/logging.ts": ["2.2", "2.4", "2.5"]
+    },
+    "sequentialDeps": [],
+    "estLines": 45,
+    "hasExplicitContract": false
+  },
+  "phaseRecommendations": [
+    {
+      "phase": "2. Core Implementation",
+      "mode": "inline",
+      "reason": "Archivos compartidos dentro de la fase: src/logging.ts"
+    },
+    {
+      "phase": "4. Testing",
+      "mode": "subagent-driven",
+      "reason": "4 tests independientes sin archivos compartidos"
+    }
+  ]
+}
+```
+
+**Campos:**
+
+| Campo | Descripción |
+|-------|-------------|
+| `mode` | Modo global: `inline` o `subagent-driven` |
+| `confidence` | Qué tan seguro estás de la decisión (0.0 = nada, 1.0 = totalmente). Bajar si CodeGraph no se pudo usar. |
+| `reasons` | Array de strings. La primera razón es la principal (por qué se gatilló la regla global). |
+| `codegraphUsed` | Lista de tool calls de CodeGraph que se ejecutaron. Vacío si el Paso 0 encontró datos suficientes. |
+| `globalRuleTriggered` | Número de la regla que decidió el modo global (1-5). Para trazabilidad. |
+| `taskAnalysis` | Mapa global construido en el Paso 2. Incluir siempre para trazabilidad. |
+| `phaseRecommendations` | Array con el modo recomendado por fase. Cada entrada tiene `phase`, `mode` y `reason`. Vacío si el modo global es subagent-driven o si tasks.md no tiene fases separadas. |
+
+---
+
+## Ejemplos
+
+### Ejemplo 1: Multicapa — archivos compartidos, fases independientes
+
+**Input:** change `update-ostacky-5-levels`
+- Fase 2: 5 tasks de implementación (algunas comparten `src/logging.ts`)
+- Fase 4: 4 tests independientes en `tests/*.ts`
+- ~143 líneas totales
+
+**Decisión:**
+
+```json
+{
+  "mode": "inline",
+  "confidence": 0.95,
+  "reasons": [
+    "Archivos compartidos: src/logging.ts (tasks 2.2, 2.4, 2.5). Subagentes causarían conflictos de merge.",
+    "Dependencias secuenciales: 2.1→2.2→2.4/2.5 sin contrato explícito en design.md."
+  ],
+  "codegraphUsed": ["codegraph_context", "codegraph_search"],
+  "globalRuleTriggered": 1,
+  "taskAnalysis": {
+    "taskCount": 13,
+    "sharedFiles": {
+      "src/logging.ts": ["2.2", "2.4", "2.5"],
+      "src/cli.ts": ["2.3", "3.1"]
+    },
+    "sequentialDeps": [["2.1", "2.2"], ["2.2", "2.4"], ["2.2", "2.5"], ["2.1", "2.3"]],
+    "estLines": 143,
+    "hasExplicitContract": false
+  },
+  "phaseRecommendations": [
+    {
+      "phase": "2. Core Implementation",
+      "mode": "inline",
+      "reason": "Archivos compartidos dentro de la fase: src/logging.ts, src/cli.ts"
+    },
+    {
+      "phase": "3. Documentation",
+      "mode": "inline",
+      "reason": "2 tasks en la fase. Overhead de subagentes no se amortiza."
+    },
+    {
+      "phase": "4. Testing",
+      "mode": "subagent-driven",
+      "reason": "4 tests independientes sin archivos compartidos entre sí ni con fase inline."
+    },
+    {
+      "phase": "5. Release & Cleanup",
+      "mode": "inline",
+      "reason": "2 tasks en la fase. Overhead de subagentes no se amortiza."
+    }
+  ]
+}
+```
+
+### Ejemplo 2: Cambio chico sin fases
+
+**Input:**
+- 3 tasks
+- Archivos diferentes
+- Sin dependencias
+
+**Decisión:**
+
+```json
+{
+  "mode": "inline",
+  "confidence": 0.85,
+  "reasons": [
+    "3 tasks. El overhead de dispatchear subagentes supera el beneficio."
+  ],
+  "codegraphUsed": [],
+  "globalRuleTriggered": 3,
+  "taskAnalysis": {
+    "taskCount": 3,
+    "sharedFiles": {},
+    "sequentialDeps": [],
+    "estLines": 20,
+    "hasExplicitContract": false
+  },
+  "phaseRecommendations": []
+}
+```
+
+### Ejemplo 3: Tasks globalmente independientes
+
+**Input:**
+- 8 tasks, cada una en su propio archivo
+- Sin dependencias secuenciales
+- ~120 líneas totales
+
+**Decisión:**
+
+```json
+{
+  "mode": "subagent-driven",
+  "confidence": 0.9,
+  "reasons": [
+    "8 tasks independientes sin archivos compartidos. Subagentes evitan saturación de contexto."
+  ],
+  "codegraphUsed": ["codegraph_context"],
+  "globalRuleTriggered": 5,
+  "taskAnalysis": {
+    "taskCount": 8,
+    "sharedFiles": {},
+    "sequentialDeps": [],
+    "estLines": 120,
+    "hasExplicitContract": false
+  },
+  "phaseRecommendations": []
+}
+```
+
+---
+
+## Reglas complementarias
+
+- **Fases sin tasks de implementación:** si una fase solo tiene tasks de documentación, release o configuración, evaluar igual pero con sesgo a inline (regla 3 y 4 suelen gatillar para fases de 1-3 tasks).
+
+- **Orden de ejecución:** las fases con modo inline deben ejecutarse PRIMERO que las fases subagent-driven, porque las fases inline establecen los contratos (interfaces, tipos, módulos) que las fases subagent-driven consumen. Documentar el orden en `phaseRecommendations` incluyendo un orden sugerido de ejecución.
+
+- **CodeGraph no disponible:** si el proyecto target no tiene CodeGraph inicializado, la decisión por defecto es inline global con confianza baja (0.3). No bloquear. Saltar Paso 3b.
+
+- **Prioridad del usuario:** si el usuario explicitó el modo ("usá subagentes", "hacé todo inline"), esa instrucción anula cualquier decisión de este skill. Todas las fases heredan ese modo.
+
+- **Re-evaluación:** si se agregan tasks a mitad del cambio, re-ejecutar este skill. Las condiciones pueden cambiar (nuevas fases, sharedFiles que aparecen o desaparecen).
+
+## Orden de ejecución recomendado
+
+Cuando hay `phaseRecommendations`, seguir este orden:
+
+1. Ejecutar todas las fases marcadas como **inline** primero (establecen la base)
+2. Después ejecutar las fases marcadas como **subagent-driven** (consumen la base)
+3. Si una fase subagent-driven depende de los resultados de otra fase subagent-driven, ejecutarlas secuencialmente respetando el orden de fases en tasks.md
+
+## Checklist de verificación
+
+- [ ] ¿Ejecuté o verifiqué `codegraph_context`?
+- [ ] ¿Construí el mapa de dependencias GLOBAL (Paso 2)?
+- [ ] ¿Apliqué las reglas globales en orden? (1 → 2 → 3 → 4 → 5)
+- [ ] ¿Anoté cuál regla global se gatilló?
+- [ ] ¿Si el modo global es inline, ejecuté el Paso 3b por cada fase?
+- [ ] ¿Para cada fase evalué sharedFiles intra-fase Y cross-fase?
+- [ ] ¿El usuario dio instrucciones explícitas que anulen las reglas?
+- [ ] ¿El output es JSON válido con todos los campos incluyendo `phaseRecommendations`?

package/dist/cli.js

@@ -161,7 +161,7 @@ var require_picocolors = __commonJS((exports, module) => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.2.1",
+  version: "0.3.1",
   description: "Instalador interactivo de agentes y comandos para OpenCode",
   type: "module",
   bin: {
@@ -876,15 +876,15 @@ var L2 = () => {
 import { join as join5 } from "path";
 // manifest.json
 var manifest_default = {
-  version: "0.2.1",
+  version: "0.3.1",
   repo: "JaimeHoracio/Ostacky",
-  tag: "v0.2.1",
+  tag: "v0.3.1",
   agents: [
     {
       name: "ostacky",
       file: "assets/agents/ostacky.md",
       description: "Agente principal de desarrollo con ejecución inline-first y local-first",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: null
     }
   ],
@@ -893,86 +893,93 @@ var manifest_default = {
       name: "install-stack",
       file: "assets/commands/install-stack.md",
       description: "Instala el stack tecnológico del proyecto",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: null
     },
     {
       name: "opsx-sync",
       file: "assets/commands/opsx-sync.md",
       description: "Sincroniza delta specs del change activo (wrapper de openspec update)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: null
     }
   ],
   skills: [
+    {
+      name: "execution-mode-evaluation",
+      file: "assets/skills/execution-mode-evaluation/SKILL.md",
+      description: "Skill de decision de modo de ejecucion inline vs subagent-driven con CodeGraph",
+      version: "0.3.1",
+      sha256: "eaa7cd3205b22c6db79a5d5f542ea554d5f1ca2d57127490011ba3abe4cb912b"
+    },
     {
       name: "brainstorming",
       file: "assets/skills/brainstorming/SKILL.md",
       description: "Skill de descubrimiento y exploración (Superpowers)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: "ad15458c54912007ae3f708c698a11f0a4a58e2a7c7860a1ae8874db573c9e98"
     },
     {
       name: "writing-plans",
       file: "assets/skills/writing-plans/SKILL.md",
       description: "Skill de planificación de implementación (Superpowers)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: "4d675df944b9c846e9066ff971861ad1c9673cd2c88375081b00a75872ad621a"
     },
     {
       name: "tdd",
       file: "assets/skills/tdd/SKILL.md",
       description: "Skill de test-driven development (Superpowers)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: "7eacd8ee81dc5c0b85065c0392e37ee10314661f7edb59dd8e70a9e0dae8f371"
     },
     {
       name: "subagent-driven-development",
       file: "assets/skills/subagent-driven-development/SKILL.md",
       description: "Skill de ejecución con subagentes (Superpowers)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: "14e0f685b1dc1d7e02b7226d18f037fe4b6cba49b512a1fadf67cfad2a9dcc96"
     },
     {
       name: "dispatching-parallel-agents",
       file: "assets/skills/dispatching-parallel-agents/SKILL.md",
       description: "Skill de dispatch paralelo de agentes (Superpowers)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: "281edf0c38f358497c7e2066fa8217a2ba3e2a39b4205c4af0c41d328fc035a1"
     },
     {
       name: "review",
       file: "assets/skills/review/SKILL.md",
       description: "Skill de revisión de código (Superpowers)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: "c78d3beff45e9bb6b5e9e1d7155910f379e082d7aaf3c61b90d651d09e0d2e2a"
     },
     {
       name: "openspec-explore",
       file: "assets/skills/openspec-explore/SKILL.md",
       description: "Skill de exploración pre-spec (OpenSpec)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: "1c75cab8672c2eb8b12f27a0b31f0b7fdb73c21c72583c1e8a566e09fe4108a6"
     },
     {
       name: "openspec-propose",
       file: "assets/skills/openspec-propose/SKILL.md",
       description: "Skill de generación de proposal (OpenSpec)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: "ab88e9aa22db09559ccf7987d08adc0469b7c6fbe46498e63a3b64926f19e66b"
     },
     {
       name: "openspec-apply-change",
       file: "assets/skills/openspec-apply-change/SKILL.md",
       description: "Skill de aplicación de change (OpenSpec)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: "847c2f88a66e8d5946c1fec422a5367c89eca5340839b659bbaaeb6f0bdac487"
     },
     {
       name: "openspec-archive-change",
       file: "assets/skills/openspec-archive-change/SKILL.md",
       description: "Skill de archivo de change (OpenSpec)",
-      version: "0.2.1",
+      version: "0.3.1",
       sha256: "3d35905ec40a081b8fd77b144426e540c67b1f50cc5801b655313a4fdfaa087a"
     }
   ]
@@ -1158,7 +1165,7 @@ function clearLockfile(opencodeRoot) {
   const lockfile = readLockfile(opencodeRoot);
   if (!lockfile) {
     writeLockfile(opencodeRoot, {
-      version: "0.2.1",
+      version: "0.3.1",
       lockedAt: new Date().toISOString(),
       repo: "",
       tag: "",
@@ -1569,12 +1576,14 @@ async function loadLatestManifest() {
 }
 function printPostInstallSteps() {
   ye([
-    "Recargá OpenCode",
-    "Usá @Ostacky para invocar al agente",
-    "Las skills bundleadas viven en .opencode/skills/ — revisá cuáles activás",
-    "Si ves errores en la instalación del stack, ejecutá /install-stack desde OpenCode como referencia"
+    "Iniciá OpenCode (si no está corriendo):",
+    "  TUI → opencode",
+    "  Web → opencode web --port 4096",
+    "Escribí @Ostacky en el chat (TUI o web) para invocar al agente",
+    "Skills bundleadas en .opencode/skills/ — revisá cuáles activás",
+    "¿Errores en el stack? Ejecutá /install-stack desde el chat de OpenCode"
   ].join(`
-  → `), "Próximos pasos");
+`), "Próximos pasos");
 }
 async function doInstallStack() {
   const spin = L2();

package/manifest.json

@@ -1,13 +1,13 @@
 {
-    "version": "0.2.1",
+    "version": "0.3.1",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.2.1",
+    "tag": "v0.3.1",
     "agents": [
         {
             "name": "ostacky",
             "file": "assets/agents/ostacky.md",
             "description": "Agente principal de desarrollo con ejecución inline-first y local-first",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": null
         }
     ],
@@ -16,86 +16,93 @@
             "name": "install-stack",
             "file": "assets/commands/install-stack.md",
             "description": "Instala el stack tecnológico del proyecto",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": null
         },
         {
             "name": "opsx-sync",
             "file": "assets/commands/opsx-sync.md",
             "description": "Sincroniza delta specs del change activo (wrapper de openspec update)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": null
         }
     ],
     "skills": [
+        {
+            "name": "execution-mode-evaluation",
+            "file": "assets/skills/execution-mode-evaluation/SKILL.md",
+            "description": "Skill de decision de modo de ejecucion inline vs subagent-driven con CodeGraph",
+            "version": "0.3.1",
+            "sha256": "eaa7cd3205b22c6db79a5d5f542ea554d5f1ca2d57127490011ba3abe4cb912b"
+        },
         {
             "name": "brainstorming",
             "file": "assets/skills/brainstorming/SKILL.md",
             "description": "Skill de descubrimiento y exploración (Superpowers)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": "ad15458c54912007ae3f708c698a11f0a4a58e2a7c7860a1ae8874db573c9e98"
         },
         {
             "name": "writing-plans",
             "file": "assets/skills/writing-plans/SKILL.md",
             "description": "Skill de planificación de implementación (Superpowers)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": "4d675df944b9c846e9066ff971861ad1c9673cd2c88375081b00a75872ad621a"
         },
         {
             "name": "tdd",
             "file": "assets/skills/tdd/SKILL.md",
             "description": "Skill de test-driven development (Superpowers)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": "7eacd8ee81dc5c0b85065c0392e37ee10314661f7edb59dd8e70a9e0dae8f371"
         },
         {
             "name": "subagent-driven-development",
             "file": "assets/skills/subagent-driven-development/SKILL.md",
             "description": "Skill de ejecución con subagentes (Superpowers)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": "14e0f685b1dc1d7e02b7226d18f037fe4b6cba49b512a1fadf67cfad2a9dcc96"
         },
         {
             "name": "dispatching-parallel-agents",
             "file": "assets/skills/dispatching-parallel-agents/SKILL.md",
             "description": "Skill de dispatch paralelo de agentes (Superpowers)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": "281edf0c38f358497c7e2066fa8217a2ba3e2a39b4205c4af0c41d328fc035a1"
         },
         {
             "name": "review",
             "file": "assets/skills/review/SKILL.md",
             "description": "Skill de revisión de código (Superpowers)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": "c78d3beff45e9bb6b5e9e1d7155910f379e082d7aaf3c61b90d651d09e0d2e2a"
         },
         {
             "name": "openspec-explore",
             "file": "assets/skills/openspec-explore/SKILL.md",
             "description": "Skill de exploración pre-spec (OpenSpec)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": "1c75cab8672c2eb8b12f27a0b31f0b7fdb73c21c72583c1e8a566e09fe4108a6"
         },
         {
             "name": "openspec-propose",
             "file": "assets/skills/openspec-propose/SKILL.md",
             "description": "Skill de generación de proposal (OpenSpec)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": "ab88e9aa22db09559ccf7987d08adc0469b7c6fbe46498e63a3b64926f19e66b"
         },
         {
             "name": "openspec-apply-change",
             "file": "assets/skills/openspec-apply-change/SKILL.md",
             "description": "Skill de aplicación de change (OpenSpec)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": "847c2f88a66e8d5946c1fec422a5367c89eca5340839b659bbaaeb6f0bdac487"
         },
         {
             "name": "openspec-archive-change",
             "file": "assets/skills/openspec-archive-change/SKILL.md",
             "description": "Skill de archivo de change (OpenSpec)",
-            "version": "0.2.1",
+            "version": "0.3.1",
             "sha256": "3d35905ec40a081b8fd77b144426e540c67b1f50cc5801b655313a4fdfaa087a"
         }
     ]

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ostacky",
-    "version": "0.2.1",
+    "version": "0.3.1",
     "description": "Instalador interactivo de agentes y comandos para OpenCode",
     "type": "module",
     "bin": {