ostacky 0.2.0 → 0.2.1

package/README.md

@@ -193,20 +193,20 @@ Tras instalar, el proyecto queda así:
 
 ```json
 {
-    "version": "0.2.0",
+    "version": "0.2.1",
     "lockedAt": "2025-01-01T00:00:00.000Z",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.2.0",
+    "tag": "v0.2.1",
     "agents": {
         "ostacky": {
-            "version": "0.2.0",
+            "version": "0.2.1",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "abc123..."
         }
     },
     "commands": {
         "install-stack": {
-            "version": "0.2.0",
+            "version": "0.2.1",
             "installedAt": "2025-01-01T00:00:00.000Z",
             "sha256": "def456..."
         }
@@ -220,25 +220,26 @@ Se recomienda agregar `ostacky-lock.json` al control de versiones para que el eq
 
 Al terminar la instalación, el flujo normal es:
 
-1. **Recargar OpenCode** para que detecte los nuevos archivos en `.opencode/`.
-2. Ya puedes usar el agente:
-    ```
-    @Ostacky
-    ```
-    o seleccionarlo desde la interfaz de OpenCode según la configuración del proyecto. `@Ostacky` invoca al agente que el CLI instaló en `.opencode/agents/ostacky.md`.
+1. **Iniciar OpenCode** (si no está corriendo):
+    - **TUI:** `opencode` en tu terminal
+    - **Web:** `opencode web --port 4096` y abrí `http://localhost:4096`
+2. OpenCode detecta automáticamente los archivos nuevos en `.opencode/` al iniciar, no necesita recarga manual.
+3. Para usar el agente **escribí `@Ostacky`** en el chat de OpenCode (TUI o web) y enviá tu mensaje. También podés seleccionarlo desde el selector de agentes si tu versión de OpenCode lo soporta.
 
-Si por alguna razon querés ejecutar el bootstrap manualmente o regenerar el stack local, también está disponible el command:
+### Regenerar el stack manualmente
 
-```bash
-/install-stack
+El comando `/install-stack` también está disponible **dentro del chat de OpenCode** (TUI o web) por si querés regenerar el stack local sin salir de la sesión:
+
+```text
+@Ostacky /install-stack
 ```
 
-Ese paso es opcional. Si no aparece en la terminal, recargá OpenCode y volvé a tipearlo.
+Es opcional y solo necesario si algo falló durante la instalación o si querés verificar que todo esté en orden.
 
 ## 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.0`), nunca `main` — instalaciones reproducibles
+- Las URLs de descarga usan **tags de GitHub** (ej. `v0.2.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

@@ -1,5 +1,5 @@
 ---
-description: Agente unico que orquesta OpenSpec + Superpowers + CodeGraph con ruteo inline-first por nivel de impacto y subagentes solo para trabajo realmente independiente.
+description: Agente unico que orquesta CodeGraph + OpenSpec + Superpowers + Engram + Context7 con ruteo inline-first por nivel de impacto y subagentes solo para trabajo realmente independiente.
 mode: primary
 ---
 
@@ -15,11 +15,11 @@ Eres **Ostacky**, el orquestador de desarrollo del proyecto.
 
 ## Regla de oro (obligatoria)
 
-**Siempre describí tu interpretación del cambio al usuario ANTES de actuar.** No importa si te parece obvio o trivial. Mostrale qué entendés, a qué nivel de impacto corresponde y preguntale cómo proceder. Sin esa validación no ejecutes nada. El usuario es quien decide el camino.
+**Siempre describí tu interpretación del cambio al usuario ANTES de actuar.** No importa si te parece obvio o trivial. Sin esa validación no ejecutes nada. El usuario es quien decide el camino.
 
 Patrón obligatorio en cada interacción:
 1. **Interpretá** — "Entendé que querés [X]. Esto afecta a [archivos/áreas]. Lo clasifico como Nivel [0/0+1/1+] porque [razón breve]."
-2. **Preguntá** — "¿Estás de acuerdo? ¿Querés que genere spec con OpenSpec o lo ejecuto directo?"
+2. **Preguntá** — Según el nivel: para Nivel 0/0+1 → "¿Querés spec con OpenSpec o lo ejecuto directo?"; para Nivel 1+ → "Requiere spec con OpenSpec. ¿Procedo?"
 3. **Esperá** — No asumas respuesta. Si el usuario no responde, detenete y esperá.
 4. **Actuá** — Recién después de la confirmación, seguí el flujo correspondiente.
 
@@ -35,14 +35,9 @@ Patrón obligatorio en cada interacción:
 
 ## Flujo obligatorio
 
-### 0. Presentación (siempre ejecutar primero)
+### 0. Presentación (antes de Discovery)
 
-Este paso es **obligatorio antes de cualquier consulta técnica**. Sin excepción.
-
-1. Escuchá el pedido del usuario.
-2. Describí tu interpretación: qué entendés que hay que hacer, qué archivos/áreas están involucrados y por qué clasificás el cambio en ese nivel.
-3. Preguntá al usuario si está de acuerdo con la clasificación y si quiere spec o directo (adaptá la pregunta al nivel).
-4. Recién después de recibir confirmación explícita, pasá a Discovery.
+Aplicá la **Regla de oro** antes de cualquier consulta técnica. Escuchá el pedido, aplicá el patrón Interpretá → Preguntá → Esperá → Actuá, y recién después de recibir confirmación explícita pasá a Discovery.
 
 ### 1. Discovery
 
@@ -161,7 +156,7 @@ Engram es el sistema de memoria persistente del stack. Su uso es **obligatorio y
 - 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`
-- Documentacion viva de librerias/APIs: `context7` (skill instalado por `npx ctx7 setup --opencode`)
+- Documentacion viva de librerias/APIs: `context7` (no incluida en el bundle; se instala por separado con `npx ctx7 setup --opencode`)
 - Comandos: `/opsx:propose`, `/opsx:apply`, `/opsx:sync`, `/opsx:archive`
 
 ### Cuándo usar Context7

package/assets/commands/install-stack.md

@@ -3,7 +3,7 @@ description: Instala CodeGraph, skills curadas, OpenSpec, Engram y Context7 loca
 agent: build
 ---
 
-Instala el stack tecnológico de desarrollo. NOTA: `npx ostacky install` ahora instala automáticamente CodeGraph, OpenSpec, Engram y Context7. Este comando queda como referencia/documentación para instalación manual o verificación.
+Instala el stack tecnológico de desarrollo para OpenCode. **IMPORTANTE:** las herramientas se instalan por separado (cada una con su propio CLI/comando). `npx ostacky install` solo instala el agente y commands de Ostacky en `.opencode/`. Este comando (`/install-stack`) es la guía de referencia para la instalación manual completa paso a paso.
 
 **RESTRICCIÓN ABSOLUTA:** instalar ÚNICAMENTE para OpenCode. Está terminantemente prohibido crear o modificar archivos en `.claude/`, `.kiro/`, `.cursor/`, `.gemini/`, `.codex/`, `.antigravity/`, `.windsurf/` o cualquier otro directorio de plataformas externas.
 
@@ -41,7 +41,7 @@ Verifica que el MCP server esté configurado en `opencode.json` (campo `mcpServe
 
 ## Paso 2 — Skills curadas (bundleadas)
 
-Las 10 skills curadas están bundleadas dentro del paquete Ostacky en `assets/skills/`. No se descargan ni clonan en tiempo de install; ya vienen en el paquete npm.
+Las **10 skills curadas del set base** (6 Superpowers + 4 OpenSpec) están bundleadas dentro del paquete Ostacky en `assets/skills/`. No se descargan ni clonan; ya vienen en el paquete npm. Context7 agrega su propia skill aparte (Paso 6).
 
 Copiá cada skill bundleada a `.opencode/skills/<nombre>/` preservando la estructura interna (incluyendo `SKILL.md` y cualquier subdirectorio como `scripts/` o `references/`):
 
@@ -112,7 +112,7 @@ openspec update
 
 [Engram](https://github.com/Gentleman-Programming/engram) es el sistema de memoria persistente para agentes de IA. Se instala como un único binario Go con SQLite + FTS5, sin Node.js, Python ni Docker.
 
-**RESTRICCIÓN:** configurar ÚNICAMENTE para OpenCode. No crear archivos en `.claude/`, `.cursor/` ni otros directorios de otras plataformas.
+**RESTRICCIÓN:** configurar ÚNICAMENTE para OpenCode. Está terminantemente prohibido crear archivos en `.claude/`, `.kiro/`, `.cursor/`, `.gemini/`, `.codex/`, `.antigravity/`, `.windsurf/` o cualquier otro directorio de plataformas externas.
 
 ### Verificar instalación actual
 
@@ -204,7 +204,7 @@ Corre en el puerto 7437 por defecto. Los datos se almacenan en `~/.engram/engram
 
 [Context7](https://context7.com) provee documentación actualizada de librerías y APIs directamente en el contexto del agente. Se instala como un CLI vía `npx`, sin dependencias globales ni MCP server necesario (aunque también soporta MCP).
 
-**RESTRICCIÓN:** configurar ÚNICAMENTE para OpenCode. No crear archivos en `.claude/`, `.cursor/` ni otros directorios de otras plataformas.
+**RESTRICCIÓN:** configurar ÚNICAMENTE para OpenCode. Está terminantemente prohibido crear archivos en `.claude/`, `.kiro/`, `.cursor/`, `.gemini/`, `.codex/`, `.antigravity/`, `.windsurf/` o cualquier otro directorio de plataformas externas.
 
 ### Verificar instalación actual
 

package/dist/cli.js

@@ -161,7 +161,7 @@ var require_picocolors = __commonJS((exports, module) => {
 // package.json
 var package_default = {
   name: "ostacky",
-  version: "0.2.0",
+  version: "0.2.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.0",
+  version: "0.2.1",
   repo: "JaimeHoracio/Ostacky",
-  tag: "v0.2.0",
+  tag: "v0.2.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.0",
+      version: "0.2.1",
       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.2.0",
+      version: "0.2.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.0",
+      version: "0.2.1",
       sha256: null
     }
   ],
@@ -909,70 +909,70 @@ var manifest_default = {
       name: "brainstorming",
       file: "assets/skills/brainstorming/SKILL.md",
       description: "Skill de descubrimiento y exploración (Superpowers)",
-      version: "0.2.0",
+      version: "0.2.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.0",
+      version: "0.2.1",
       sha256: "4d675df944b9c846e9066ff971861ad1c9673cd2c88375081b00a75872ad621a"
     },
     {
       name: "tdd",
       file: "assets/skills/tdd/SKILL.md",
       description: "Skill de test-driven development (Superpowers)",
-      version: "0.2.0",
+      version: "0.2.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.0",
+      version: "0.2.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.0",
+      version: "0.2.1",
       sha256: "281edf0c38f358497c7e2066fa8217a2ba3e2a39b4205c4af0c41d328fc035a1"
     },
     {
       name: "review",
       file: "assets/skills/review/SKILL.md",
       description: "Skill de revisión de código (Superpowers)",
-      version: "0.2.0",
+      version: "0.2.1",
       sha256: "c78d3beff45e9bb6b5e9e1d7155910f379e082d7aaf3c61b90d651d09e0d2e2a"
     },
     {
       name: "openspec-explore",
       file: "assets/skills/openspec-explore/SKILL.md",
       description: "Skill de exploración pre-spec (OpenSpec)",
-      version: "0.2.0",
+      version: "0.2.1",
       sha256: "1c75cab8672c2eb8b12f27a0b31f0b7fdb73c21c72583c1e8a566e09fe4108a6"
     },
     {
       name: "openspec-propose",
       file: "assets/skills/openspec-propose/SKILL.md",
       description: "Skill de generación de proposal (OpenSpec)",
-      version: "0.2.0",
+      version: "0.2.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.0",
+      version: "0.2.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.0",
+      version: "0.2.1",
       sha256: "3d35905ec40a081b8fd77b144426e540c67b1f50cc5801b655313a4fdfaa087a"
     }
   ]
@@ -1158,7 +1158,7 @@ function clearLockfile(opencodeRoot) {
   const lockfile = readLockfile(opencodeRoot);
   if (!lockfile) {
     writeLockfile(opencodeRoot, {
-      version: "0.2.0",
+      version: "0.2.1",
       lockedAt: new Date().toISOString(),
       repo: "",
       tag: "",

package/manifest.json

@@ -1,13 +1,13 @@
 {
-    "version": "0.2.0",
+    "version": "0.2.1",
     "repo": "JaimeHoracio/Ostacky",
-    "tag": "v0.2.0",
+    "tag": "v0.2.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.0",
+            "version": "0.2.1",
             "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.2.0",
+            "version": "0.2.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.0",
+            "version": "0.2.1",
             "sha256": null
         }
     ],
@@ -32,70 +32,70 @@
             "name": "brainstorming",
             "file": "assets/skills/brainstorming/SKILL.md",
             "description": "Skill de descubrimiento y exploración (Superpowers)",
-            "version": "0.2.0",
+            "version": "0.2.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.0",
+            "version": "0.2.1",
             "sha256": "4d675df944b9c846e9066ff971861ad1c9673cd2c88375081b00a75872ad621a"
         },
         {
             "name": "tdd",
             "file": "assets/skills/tdd/SKILL.md",
             "description": "Skill de test-driven development (Superpowers)",
-            "version": "0.2.0",
+            "version": "0.2.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.0",
+            "version": "0.2.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.0",
+            "version": "0.2.1",
             "sha256": "281edf0c38f358497c7e2066fa8217a2ba3e2a39b4205c4af0c41d328fc035a1"
         },
         {
             "name": "review",
             "file": "assets/skills/review/SKILL.md",
             "description": "Skill de revisión de código (Superpowers)",
-            "version": "0.2.0",
+            "version": "0.2.1",
             "sha256": "c78d3beff45e9bb6b5e9e1d7155910f379e082d7aaf3c61b90d651d09e0d2e2a"
         },
         {
             "name": "openspec-explore",
             "file": "assets/skills/openspec-explore/SKILL.md",
             "description": "Skill de exploración pre-spec (OpenSpec)",
-            "version": "0.2.0",
+            "version": "0.2.1",
             "sha256": "1c75cab8672c2eb8b12f27a0b31f0b7fdb73c21c72583c1e8a566e09fe4108a6"
         },
         {
             "name": "openspec-propose",
             "file": "assets/skills/openspec-propose/SKILL.md",
             "description": "Skill de generación de proposal (OpenSpec)",
-            "version": "0.2.0",
+            "version": "0.2.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.0",
+            "version": "0.2.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.0",
+            "version": "0.2.1",
             "sha256": "3d35905ec40a081b8fd77b144426e540c67b1f50cc5801b655313a4fdfaa087a"
         }
     ]

package/package.json

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