ostacky 0.3.1 → 0.3.2

package/README.md

@@ -193,20 +193,20 @@ Tras instalar, el proyecto queda así:
 
 ```json
 {
-    "version": "0.3.1",
+    "version": "0.3.2",
     "lockedAt": "2025-01-01T00:00:00.000Z",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.3.1",
+    "tag": "v0.3.2",
     "agents": {
         "ostacky": {
-            "version": "0.3.1",
+            "version": "0.3.2",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "abc123..."
         }
     },
     "commands": {
         "install-stack": {
-            "version": "0.3.1",
+            "version": "0.3.2",
             "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.3.1`), nunca `main` — instalaciones reproducibles
+- Las URLs de descarga usan **tags de GitHub** (ej. `v0.3.2`), 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/skills/execution-mode-evaluation/README.md

@@ -104,6 +104,8 @@ Los pasos que ejecuta el skill una vez cargado:
 │  ┌─────────────────────────────────────────────────────┐     │
 │  │ taskCount:     cantidad total de tasks               │     │
 │  │ sharedFiles:   { archivo → [tasks que lo modifican] }│     │
+│  │ fileClusters:  [ [taskA,taskB], [taskC], ... ]       │     │
+│  │ clusterCount:  cantidad de clusters                  │     │
 │  │ sequentialDeps: [taskA → taskB]                      │     │
 │  │ filesPerTask:  { task → [archivos] }                 │     │
 │  │ estLines:      líneas estimadas de cambio            │     │
@@ -114,13 +116,25 @@ Los pasos que ejecuta el skill una vez cargado:
 ┌──────────────────────────────────────────────────────────────┐
 │                   5. PASO 3a — MODO GLOBAL                   │
 │                                                              │
-│  5 reglas en orden. La PRIMERA que se cumple decide.        │
+│  PRIMERO: CONSTRUIR CLUSTERS (componentes conectados)        │
+│  - sharedFiles agrupa tareas que modifican los mismos archs  │
+│  - Cierre transitivo: A comparte archivo con B, B con C     │
+│    → A, B, C están en el mismo cluster                      │
+│  - clusterCount: cantidad total de clusters                 │
 │                                                              │
-│  1. ¿sharedFiles > 0?                              → INLINE  │
-│  2. ¿sequentialDeps sin contrato?                  → INLINE  │
-│  3. ¿taskCount < 4?                                → INLINE  │
-│  4. ¿estLines < 30?                                → INLINE  │
-│  5. Ninguna de las anteriores             → SUBAGENT-DRIVEN  │
+│  LUEGO: evaluar en orden:                                    │
+│                                                              │
+│  1. clusterCount==1 y tamaño>1?                    → INLINE  │
+│     (todo comparte archivos, no se puede paralelizar)        │
+│                                                              │
+│  2. clusterCount>=2, clusters con tamaño>1?                  │
+│     a. ¿deps ENTRE clusters sin contrato?         → INLINE   │
+│     b. ¿NO? → SUBAGENT-DRIVEN (cada cluster=1 subagente)     │
+│                                                              │
+│  3. Sin archivos compartidos (clusterCount==taskCount):      │
+│     a. ¿taskCount < 3?                            → INLINE   │
+│     b. ¿estLines < 30?                            → INLINE   │
+│     c. ¿ninguna? → SUBAGENT-DRIVEN (cada task=1 subagente)   │
 │                                                              │
 │  Si el usuario dio instrucciones explícitas:                 │
 │  → anulan todas las reglas, todas las fases heredan el modo  │
@@ -130,7 +144,8 @@ Los pasos que ejecuta el skill una vez cargado:
 │            6. PASO 3b — EVALUACIÓN POR FASES                 │
 │            (solo si el modo global es INLINE)                │
 │                                                              │
-│  Si el modo global es SUBAGENT-DRIVEN → saltar este paso     │
+│  Si el modo global es SUBAGENT-DRIVEN (Rule 2b o 3c)        │
+│  → saltar este paso (ya hay granularidad por cluster/task)  │
 │                                                              │
 │  Por cada fase en tasks.md:                                  │
 │                                                              │
@@ -153,12 +168,18 @@ Los pasos que ejecuta el skill una vez cargado:
 │    "mode": "inline" | "subagent-driven",                     │
 │    "confidence": 0.95,                                       │
 │    "reasons": ["..."],                                       │
-│    "globalRuleTriggered": 1,                                 │
-│    "taskAnalysis": { ... },                                  │
-│    "phaseRecommendations": [                                 │
-│      { "phase": "2. Core", "mode": "inline", ... },          │
-│      { "phase": "4. Tests", "mode": "subagent-driven", ... } │
-│    ]                                                         │
+│    "codegraphUsed": ["codegraph_context"],                    │
+│    "globalRuleTriggered": "2b",                              │
+│    "taskAnalysis": {                                         │
+│      "taskCount": 5,                                         │
+│      "sharedFiles": {...},                                   │
+│      "fileClusters": [["t1","t2"], ["t3","t4"], ["t5"]],     │
+│      "clusterCount": 3,                                      │
+│      "sequentialDeps": [],                                   │
+│      "estLines": 85,                                         │
+│      "hasExplicitContract": false                            │
+│    },                                                        │
+│    "phaseRecommendations": [...]                              │
 │  }                                                           │
 └──────────────────────────┬───────────────────────────────────┘
                            ▼
@@ -168,12 +189,15 @@ Los pasos que ejecuta el skill una vez cargado:
 │  Agent definition usa el output:                             │
 │                                                              │
 │  - mode "inline" → el agente ejecuta todo en su sesión       │
-│  - mode "subagent-driven" → carga subagent-driven-development│
+│  - mode "subagent-driven" (Rule 3c) → subagent-driven-dev   │
+│  - mode "subagent-driven" (Rule 2b) → cluster dispatch:      │
+│    cada cluster se asigna a un subagente                     │
 │  - phaseRecommendations: inline PRIMERO, subagent DESPUÉS    │
 │                                                              │
 │  Orden de fases:                                             │
 │    1º Fases inline (establecen contratos)                    │
 │    2º Fases subagent-driven (consumen contratos)             │
+│    3º Cluster dispatch → subagentes en paralelo              │
 └──────────────────────────────────────────────────────────────┘
 ```
 
@@ -181,15 +205,16 @@ Los pasos que ejecuta el skill una vez cargado:
 
 ## Reglas que gobiernan la decisión
 
-### Modo global (Paso 3a)
+### Modo global (Paso 3a) — basado en clusters
 
-| 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 |
+| Regla | Condición | Decisión | Detalle |
+|-------|-----------|----------|---------|
+| 1 | clusterCount == 1 Y tamaño > 1 | **INLINE** | Todo conectado por archivos compartidos. Imposible paralelizar. |
+| 2a | clusterCount >= 2, hay clusters con tamaño > 1, deps ENTRE clusters SIN contrato | **INLINE** | Clusters independientes pero relacionados sin contrato explícito. |
+| 2b | clusterCount >= 2, hay clusters con tamaño > 1, SIN deps entre clusters (O contrato existe) | **SUBAGENT-DRIVEN** | Clusters independientes. Cada cluster = 1 subagente. Tasks intra-cluster secuenciales. |
+| 3a | Sin archivos compartidos (clusterCount == taskCount), taskCount < 3 | **INLINE** | Muy pocas tasks para amortizar subagentes. |
+| 3b | Sin archivos compartidos, estLines < 30 | **INLINE** | Cambio pequeño, inline más eficiente. |
+| 3c | Sin archivos compartidos, ninguna condición anterior | **SUBAGENT-DRIVEN** | Tasks independientes. Cada task = 1 subagente. |
 
 ### Modo por fase (Paso 3b)
 
@@ -211,14 +236,22 @@ Los pasos que ejecuta el skill una vez cargado:
 
 ## Orden de ejecución recomendado
 
+### Si el modo global es "inline" (con phaseRecommendations):
 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`
 
+### Si el modo global es "subagent-driven" por clusters (Rule 2b):
+1. Cada cluster del `fileClusters` se asigna a un subagente
+2. Los subagentes se ejecutan en **paralelo** (los clusters no comparten archivos)
+3. Tasks dentro del mismo cluster se ejecutan **secuencialmente** dentro del subagente
+4. Si hay dependencias ENTRE clusters, deben ejecutarse en orden respetando la dependencia
+
 ---
 
 ## 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.
+- El clustering asume que dos tasks que modifican el mismo archivo SIEMPRE van a conflictuar si se ejecutan en paralelo. Esto es conservador pero correcto para subagentes independientes.
 - 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

@@ -82,6 +82,7 @@ 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
+fileClusters:    [ ["taskA", "taskB"], ["taskC"], ... ]  // componentes conectados por archivos compartidos
 filesPerTask:    { task -> [archivos que modifica] }
 estLines:        estimación conservadora de líneas totales de cambio
 hasExplicitContract: true/false  // design.md especifica contratos entre tasks?
@@ -96,6 +97,16 @@ hasExplicitContract: true/false  // design.md especifica contratos entre tasks?
 - 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 construir fileClusters (clusters por archivos compartidos):**
+- Usar `sharedFiles` para agrupar tareas en clusters (componentes conectados del grafo).
+- Inicializar: cada tarea es su propio cluster.
+- Para cada archivo en `sharedFiles`: todas las tasks que modifican ese archivo → mismo cluster.
+- Aplicar cierre transitivo: si taskA comparte archivo con taskB, y taskB con taskC, entonces A/B/C están en el mismo cluster.
+- El resultado son los grupos de tareas que comparten archivos entre sí.
+- Un cluster de tamaño 1 significa que esa task NO comparte archivos con ninguna otra.
+- `clusterCount == taskCount` → no hay archivos compartidos en absoluto.
+- `clusterCount == 1` → todas las tareas están conectadas por archivos compartidos.
+
 **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
@@ -107,49 +118,110 @@ No es necesario ser exacto. Una estimación conservadora alcanza.
 
 ---
 
-### Paso 3a: Modo global del cambio
+### Paso 3a: Modo global del cambio — basado en clusters
+
+Antes de aplicar reglas, construir CLUSTERS de tareas por archivos compartidos usando `sharedFiles` y `fileClusters` del Paso 2.
 
-Aplicar ESTRICTAMENTE en este orden. Evaluar cada condición. En la PRIMERA que se cumpla, esa es la decisión global.
+**Construcción de clusters (componentes conectados):**
+1. Inicializar: cada tarea es su propio cluster de tamaño 1.
+2. Para cada archivo en `sharedFiles`: todas las tasks que modifican ese archivo → mismo cluster.
+3. Cierre transitivo: si taskA comparte archivo con taskB, y taskB comparte archivo con taskC, entonces A/B/C están en el mismo cluster.
+4. Resultado: componentes conectados del grafo "tareas que comparten archivos".
 
 ```
-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."
+Ejemplo:
+  task1 y task2 modifican workflow-factories.ts → cluster [task1, task2]
+  task3 y task4 modifican structured-call.ts    → cluster [task3, task4]
+  task5 modifica tests/unit.test.ts             → cluster [task5]
+  
+  clusterCount: 3
+  clusters independientes entre sí: ✅ (cada uno en sus archivos)
 ```
 
-**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.
+Luego aplicar estas reglas en orden. La PRIMERA que se cumpla decide el modo global:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                                                                 │
+│  1. clusterCount == 1 Y cluster tiene tamaño > 1                │
+│     → INLINE (global)                                           │
+│     → globalRuleTriggered: "1"                                  │
+│     → Razón: "Todas las tareas comparten archivos en un único   │
+│               cluster ({N} tasks). Imposible paralelizar sin    │
+│               conflictos de merge."                             │
+│     → Continuar al Paso 3b para evaluar por fases.              │
+│                                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  2. clusterCount >= 2 Y hay clusters con tamaño > 1             │
+│     (hay archivos compartidos, pero en grupos independientes)    │
+│                                                                 │
+│     → Verificar dependencias secuenciales ENTRE clusters:       │
+│       Si sequentialDeps contiene [taskA, taskB] donde A∈clusterX,│
+│       B∈clusterY, X≠Y → hay deps entre clusters.               │
+│       Deps INTRA-cluster (A y B en mismo cluster) no afectan.   │
+│                                                                 │
+│     a. SI hay deps entre clusters Y hasExplicitContract == false │
+│        → INLINE (global)                                        │
+│        → globalRuleTriggered: "2a"                              │
+│        → Razón: "{clusterCount} clusters pero con dependencias  │
+│                  secuenciales entre clusters sin contrato        │
+│                  explícito en design.md."                       │
+│        → Continuar al Paso 3b para evaluar por fases.           │
+│                                                                 │
+│     b. SI NO (clusters sin deps entre sí, O contrato explícito) │
+│        → SUBAGENT-DRIVEN (global), CADA CLUSTER como unidad     │
+│          de subagente. Tasks dentro del mismo cluster se        │
+│          ejecutan secuencialmente (comparten archivos).         │
+│        → globalRuleTriggered: "2b"                              │
+│        → Razón: "{clusterCount} clusters independientes sin     │
+│                  archivos compartidos entre clusters. Cada       │
+│                  cluster → 1 subagente."                        │
+│        → Saltar Paso 3b (granularidad ya está por cluster).     │
+│                                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  3. NO hay archivos compartidos (clusterCount == taskCount,     │
+│     todos los clusters son de tamaño 1)                         │
+│                                                                 │
+│     a. SI taskCount < 3                                         │
+│        → INLINE (global)                                        │
+│        → globalRuleTriggered: "3a"                              │
+│        → Razón: "{taskCount} tasks independientes pero muy      │
+│                  pocas para amortizar overhead de subagentes."   │
+│        → Continuar al Paso 3b para evaluar por fases.           │
+│                                                                 │
+│     b. SI estLines < 30                                         │
+│        → INLINE (global)                                        │
+│        → globalRuleTriggered: "3b"                              │
+│        → Razón: "Cambio pequeño (~{estLines} líneas). Inline    │
+│                  más eficiente en tokens."                      │
+│        → Continuar al Paso 3b para evaluar por fases.           │
+│                                                                 │
+│     c. SI NINGUNA condición anterior                            │
+│        → SUBAGENT-DRIVEN (global), cada task como subagente     │
+│        → globalRuleTriggered: "3c"                              │
+│        → Razón: "{taskCount} tasks independientes sin archivos  │
+│                  compartidos. Subagentes aíslan contexto."       │
+│        → Saltar Paso 3b.                                        │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
 
 **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.
 
+**Nota sobre subagentes con clusters (Rule 2b):** Cuando el modo global es SUBAGENT-DRIVEN por clusters, cada cluster se convierte en una unidad de trabajo atómica para un subagente. El subagente NO recibe tasks individuales sino el CLUSTER COMPLETO, y las resuelve secuencialmente (porque comparten archivos). Diferentes clusters se ejecutan en paralelo porque NO comparten archivos entre sí.
+
+**Nota sobre deps entre clusters (Rule 2a):** Es raro pero posible. Por ejemplo, task1 en archivo A, task2 en archivo B, task3 en archivo A (hereda/depende de task1). Los clusters son [task1, task3] y [task2]. clusterCount=2 pero task3 depende de task1. Si no hay contrato explícito en design.md, el riesgo es alto → inline.
+
 ---
 
 ### 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 SUBAGENT-DRIVEN, saltear este paso — todas las fases van como subagentes (o clusters completos como subagentes si aplica Rule 2b).
 
-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.
+Si el modo global es INLINE, evaluar CADA FASE de `tasks.md` por separado para determinar si alguna puede ejecutarse como subagentes independientes.
 
 **Para cada fase en tasks.md:**
 
@@ -198,12 +270,19 @@ El output DEBE ser un JSON válido en este formato:
   "confidence": 0.0 - 1.0,
   "reasons": ["razón principal", "razón secundaria"],
   "codegraphUsed": ["codegraph_context"],
-  "globalRuleTriggered": 1,
+  "globalRuleTriggered": "1",
   "taskAnalysis": {
     "taskCount": 13,
     "sharedFiles": {
       "src/logging.ts": ["2.2", "2.4", "2.5"]
     },
+    "fileClusters": [
+      ["2.2", "2.4", "2.5"],
+      ["2.1"],
+      ["2.3"],
+      ["3.1"]
+    ],
+    "clusterCount": 4,
     "sequentialDeps": [],
     "estLines": 45,
     "hasExplicitContract": false
@@ -231,21 +310,34 @@ El output DEBE ser un JSON válido en este formato:
 | `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. |
+| `globalRuleTriggered` | Código de la regla que decidió el modo global ("1", "2a", "2b", "3a", "3b", "3c"). Para trazabilidad. |
 | `taskAnalysis` | Mapa global construido en el Paso 2. Incluir siempre para trazabilidad. |
+| `taskAnalysis.fileClusters` | Array de arrays: cada sub-array es un cluster de tareas que comparten archivos. Fundamental para la decisión. |
+| `taskAnalysis.clusterCount` | Número total de clusters. `clusterCount == 1` → todo conectado. `clusterCount == taskCount` → todo independiente. |
 | `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
+### Ejemplo 1: Multicapa — clusters conectados, dependencias entre clusters
 
 **Input:** change `update-ostacky-5-levels`
-- Fase 2: 5 tasks de implementación (algunas comparten `src/logging.ts`)
+- Fase 2: 5 tasks de implementación
+  - Tasks 2.2, 2.4, 2.5 comparten `src/logging.ts` → cluster A
+  - Tasks 2.3 y 3.1 comparten `src/cli.ts` → cluster B (cross-fase)
+  - Task 2.1 tiene archivo propio
+  - Dependencias: 2.1→2.2→2.4/2.5, 2.1→2.3 (deps ENTRE clusters)
 - Fase 4: 4 tests independientes en `tests/*.ts`
 - ~143 líneas totales
 
+**Análisis de clusters:**
+- cluster [2.2, 2.4, 2.5] (comparten logging.ts)
+- cluster [2.3, 3.1] (comparten cli.ts)
+- cluster [2.1], cluster resto de tests, etc.
+- Hay dependencias secuenciales ENTRE clusters (2.1→cluster A, 2.1→cluster B) sin contrato explícito
+- → Rule 2a: INLINE global (deps entre clusters sin contrato)
+
 **Decisión:**
 
 ```json
@@ -253,17 +345,30 @@ El output DEBE ser un JSON válido en este formato:
   "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."
+    "5 clusters pero con dependencias secuenciales entre clusters sin contrato explícito en design.md.",
+    "Archivos compartidos dentro de clusters: src/logging.ts, src/cli.ts."
   ],
   "codegraphUsed": ["codegraph_context", "codegraph_search"],
-  "globalRuleTriggered": 1,
+  "globalRuleTriggered": "2a",
   "taskAnalysis": {
     "taskCount": 13,
     "sharedFiles": {
       "src/logging.ts": ["2.2", "2.4", "2.5"],
       "src/cli.ts": ["2.3", "3.1"]
     },
+    "fileClusters": [
+      ["2.2", "2.4", "2.5"],
+      ["2.3", "3.1"],
+      ["2.1"],
+      ["4.1"],
+      ["4.2"],
+      ["4.3"],
+      ["4.4"],
+      ["3.2"],
+      ["5.1"],
+      ["5.2"]
+    ],
+    "clusterCount": 10,
     "sequentialDeps": [["2.1", "2.2"], ["2.2", "2.4"], ["2.2", "2.5"], ["2.1", "2.3"]],
     "estLines": 143,
     "hasExplicitContract": false
@@ -272,7 +377,7 @@ El output DEBE ser un JSON válido en este formato:
     {
       "phase": "2. Core Implementation",
       "mode": "inline",
-      "reason": "Archivos compartidos dentro de la fase: src/logging.ts, src/cli.ts"
+      "reason": "Archivos compartidos dentro de la fase: src/logging.ts, src/cli.ts. Además tiene dependencias entre clusters sin contrato."
     },
     {
       "phase": "3. Documentation",
@@ -293,12 +398,17 @@ El output DEBE ser un JSON válido en este formato:
 }
 ```
 
-### Ejemplo 2: Cambio chico sin fases
+### Ejemplo 2: Cambio chico sin archivos compartidos
 
 **Input:**
-- 3 tasks
-- Archivos diferentes
-- Sin dependencias
+- 3 tasks en archivos diferentes
+- Sin dependencias secuenciales
+- ~20 líneas totales
+
+**Análisis de clusters:**
+- clusterCount == taskCount == 3 (todos los clusters son tamaño 1 — sin archivos compartidos)
+- Rule 3a: 3 < 3? No → skip
+- Rule 3b: 20 < 30? Sí → INLINE
 
 **Decisión:**
 
@@ -307,13 +417,19 @@ El output DEBE ser un JSON válido en este formato:
   "mode": "inline",
   "confidence": 0.85,
   "reasons": [
-    "3 tasks. El overhead de dispatchear subagentes supera el beneficio."
+    "Cambio pequeño (~20 líneas). Inline más eficiente en tokens."
   ],
   "codegraphUsed": [],
-  "globalRuleTriggered": 3,
+  "globalRuleTriggered": "3b",
   "taskAnalysis": {
     "taskCount": 3,
     "sharedFiles": {},
+    "fileClusters": [
+      ["task1"],
+      ["task2"],
+      ["task3"]
+    ],
+    "clusterCount": 3,
     "sequentialDeps": [],
     "estLines": 20,
     "hasExplicitContract": false
@@ -322,13 +438,19 @@ El output DEBE ser un JSON válido en este formato:
 }
 ```
 
-### Ejemplo 3: Tasks globalmente independientes
+### Ejemplo 3: Tasks globalmente independientes (sin archivos compartidos)
 
 **Input:**
 - 8 tasks, cada una en su propio archivo
 - Sin dependencias secuenciales
 - ~120 líneas totales
 
+**Análisis de clusters:**
+- clusterCount == taskCount == 8 (sin archivos compartidos)
+- Rule 3a: 8 < 3? No → skip
+- Rule 3b: 120 < 30? No → skip
+- Rule 3c: → SUBAGENT-DRIVEN
+
 **Decisión:**
 
 ```json
@@ -336,13 +458,24 @@ El output DEBE ser un JSON válido en este formato:
   "mode": "subagent-driven",
   "confidence": 0.9,
   "reasons": [
-    "8 tasks independientes sin archivos compartidos. Subagentes evitan saturación de contexto."
+    "8 tasks independientes sin archivos compartidos. Subagentes aíslan contexto y evitan saturación."
   ],
   "codegraphUsed": ["codegraph_context"],
-  "globalRuleTriggered": 5,
+  "globalRuleTriggered": "3c",
   "taskAnalysis": {
     "taskCount": 8,
     "sharedFiles": {},
+    "fileClusters": [
+      ["task1"],
+      ["task2"],
+      ["task3"],
+      ["task4"],
+      ["task5"],
+      ["task6"],
+      ["task7"],
+      ["task8"]
+    ],
+    "clusterCount": 8,
     "sequentialDeps": [],
     "estLines": 120,
     "hasExplicitContract": false
@@ -351,11 +484,73 @@ El output DEBE ser un JSON válido en este formato:
 }
 ```
 
+### Ejemplo 4: Clusters independientes — el fix del bug (Rule 2b)
+
+Este es el escenario exacto que el diseño anterior NO manejaba correctamente.
+
+**Input:**
+- 5 tasks
+- Task 1 y Task 2 modifican `src/workflow-factories.ts` → cluster A
+- Task 3 y Task 4 modifican `src/structured-call.ts` → cluster B
+- Task 5 crea archivo nuevo `tests/workflow.test.ts` → cluster C
+- Sin dependencias secuenciales entre clusters
+- ~85 líneas totales
+
+**Análisis de clusters:**
+- cluster A: [task1, task2] — comparten `workflow-factories.ts`
+- cluster B: [task3, task4] — comparten `structured-call.ts`
+- cluster C: [task5] — archivo propio
+- clusterCount = 3, hay clusters con tamaño > 1
+- NO hay dependencias secuenciales ENTRE clusters
+- → Rule 2b: SUBAGENT-DRIVEN con cluster dispatch
+
+**Output:**
+
+```json
+{
+  "mode": "subagent-driven",
+  "confidence": 0.95,
+  "reasons": [
+    "3 clusters independientes sin archivos compartidos entre clusters. Cada cluster → 1 subagente.",
+    "Cluster A (tasks 1-2), Cluster B (tasks 3-4), Cluster C (task 5)."
+  ],
+  "codegraphUsed": ["codegraph_context"],
+  "globalRuleTriggered": "2b",
+  "taskAnalysis": {
+    "taskCount": 5,
+    "sharedFiles": {
+      "src/workflow-factories.ts": ["task1", "task2"],
+      "src/structured-call.ts": ["task3", "task4"]
+    },
+    "fileClusters": [
+      ["task1", "task2"],
+      ["task3", "task4"],
+      ["task5"]
+    ],
+    "clusterCount": 3,
+    "sequentialDeps": [],
+    "estLines": 85,
+    "hasExplicitContract": false
+  },
+  "phaseRecommendations": []
+}
+```
+
+**¿Cómo se ejecuta?**
+
+| Subagente | Cluster | Tasks | Ejecución |
+|-----------|---------|-------|-----------|
+| SA-1 | A | task1, task2 | Secuencial (comparten archivo) |
+| SA-2 | B | task3, task4 | Secuencial (comparten archivo) |
+| SA-3 | C | task5 | Directa (archivo nuevo) |
+
+Los 3 subagentes corren en paralelo. NO hay conflictos de merge porque ningún archivo es tocado por más de un subagente. ✨
+
 ---
 
 ## 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).
+- **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 (reglas 3a/3b o d/e 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.
 
@@ -376,10 +571,13 @@ Cuando hay `phaseRecommendations`, seguir este orden:
 ## 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?
+- [ ] ¿Construí el mapa de dependencias GLOBAL (Paso 2) incluyendo `fileClusters`?
+- [ ] ¿Identifiqué los clusters (componentes conectados por archivos compartidos)?
+- [ ] ¿Verifiqué dependencias secuenciales ENTRE clusters (no solo intra-cluster)?
+- [ ] ¿Apliqué las reglas en orden? (1 → 2a/2b → 3a/3b/3c)
+- [ ] ¿Anoté cuál regla global se gatilló (código exacto: "1", "2a", "2b", "3a", "3b", "3c")?
+- [ ] ¿Si el modo global es inline (Rule 1, 2a, 3a, 3b), ejecuté el Paso 3b por cada fase?
 - [ ] ¿Para cada fase evalué sharedFiles intra-fase Y cross-fase?
+- [ ] ¿Si el modo global es subagent-driven por clusters (Rule 2b), documenté qué cluster va a cada subagente?
 - [ ] ¿El usuario dio instrucciones explícitas que anulen las reglas?
-- [ ] ¿El output es JSON válido con todos los campos incluyendo `phaseRecommendations`?
+- [ ] ¿El output es JSON válido con todos los campos: `mode`, `confidence`, `reasons`, `globalRuleTriggered`, `taskAnalysis.fileClusters`, `taskAnalysis.clusterCount`, `phaseRecommendations`?

package/dist/cli.js

@@ -161,7 +161,7 @@ var require_picocolors = __commonJS((exports, module) => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.3.1",
+  version: "0.3.2",
   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.3.1",
+  version: "0.3.2",
   repo: "JaimeHoracio/Ostacky",
-  tag: "v0.3.1",
+  tag: "v0.3.2",
   agents: [
     {
       name: "ostacky",
       file: "assets/agents/ostacky.md",
       description: "Agente principal de desarrollo con ejecución inline-first y local-first",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: null
     }
   ],
@@ -893,14 +893,14 @@ var manifest_default = {
       name: "install-stack",
       file: "assets/commands/install-stack.md",
       description: "Instala el stack tecnológico del proyecto",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: null
     },
     {
       name: "opsx-sync",
       file: "assets/commands/opsx-sync.md",
       description: "Sincroniza delta specs del change activo (wrapper de openspec update)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: null
     }
   ],
@@ -909,77 +909,77 @@ var manifest_default = {
       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",
+      version: "0.3.2",
       sha256: "eaa7cd3205b22c6db79a5d5f542ea554d5f1ca2d57127490011ba3abe4cb912b"
     },
     {
       name: "brainstorming",
       file: "assets/skills/brainstorming/SKILL.md",
       description: "Skill de descubrimiento y exploración (Superpowers)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: "ad15458c54912007ae3f708c698a11f0a4a58e2a7c7860a1ae8874db573c9e98"
     },
     {
       name: "writing-plans",
       file: "assets/skills/writing-plans/SKILL.md",
       description: "Skill de planificación de implementación (Superpowers)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: "4d675df944b9c846e9066ff971861ad1c9673cd2c88375081b00a75872ad621a"
     },
     {
       name: "tdd",
       file: "assets/skills/tdd/SKILL.md",
       description: "Skill de test-driven development (Superpowers)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: "7eacd8ee81dc5c0b85065c0392e37ee10314661f7edb59dd8e70a9e0dae8f371"
     },
     {
       name: "subagent-driven-development",
       file: "assets/skills/subagent-driven-development/SKILL.md",
       description: "Skill de ejecución con subagentes (Superpowers)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: "14e0f685b1dc1d7e02b7226d18f037fe4b6cba49b512a1fadf67cfad2a9dcc96"
     },
     {
       name: "dispatching-parallel-agents",
       file: "assets/skills/dispatching-parallel-agents/SKILL.md",
       description: "Skill de dispatch paralelo de agentes (Superpowers)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: "281edf0c38f358497c7e2066fa8217a2ba3e2a39b4205c4af0c41d328fc035a1"
     },
     {
       name: "review",
       file: "assets/skills/review/SKILL.md",
       description: "Skill de revisión de código (Superpowers)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: "c78d3beff45e9bb6b5e9e1d7155910f379e082d7aaf3c61b90d651d09e0d2e2a"
     },
     {
       name: "openspec-explore",
       file: "assets/skills/openspec-explore/SKILL.md",
       description: "Skill de exploración pre-spec (OpenSpec)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: "1c75cab8672c2eb8b12f27a0b31f0b7fdb73c21c72583c1e8a566e09fe4108a6"
     },
     {
       name: "openspec-propose",
       file: "assets/skills/openspec-propose/SKILL.md",
       description: "Skill de generación de proposal (OpenSpec)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: "ab88e9aa22db09559ccf7987d08adc0469b7c6fbe46498e63a3b64926f19e66b"
     },
     {
       name: "openspec-apply-change",
       file: "assets/skills/openspec-apply-change/SKILL.md",
       description: "Skill de aplicación de change (OpenSpec)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: "847c2f88a66e8d5946c1fec422a5367c89eca5340839b659bbaaeb6f0bdac487"
     },
     {
       name: "openspec-archive-change",
       file: "assets/skills/openspec-archive-change/SKILL.md",
       description: "Skill de archivo de change (OpenSpec)",
-      version: "0.3.1",
+      version: "0.3.2",
       sha256: "3d35905ec40a081b8fd77b144426e540c67b1f50cc5801b655313a4fdfaa087a"
     }
   ]
@@ -1165,7 +1165,7 @@ function clearLockfile(opencodeRoot) {
   const lockfile = readLockfile(opencodeRoot);
   if (!lockfile) {
     writeLockfile(opencodeRoot, {
-      version: "0.3.1",
+      version: "0.3.2",
       lockedAt: new Date().toISOString(),
       repo: "",
       tag: "",

package/manifest.json

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

package/package.json

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