trackops 2.0.4 → 2.0.5

package/scripts/sync-skill-version.js

@@ -1,21 +1,21 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const path = require("path");
-
-const ROOT = path.resolve(__dirname, "..");
-const PACKAGE_FILE = path.join(ROOT, "package.json");
-const SKILL_FILE = path.join(ROOT, "skills", "trackops", "skill.json");
-
-function main() {
-  const pkg = JSON.parse(fs.readFileSync(PACKAGE_FILE, "utf8"));
-  const skill = JSON.parse(fs.readFileSync(SKILL_FILE, "utf8"));
-
-  skill.skillVersion = pkg.version;
-  skill.trackopsVersion = pkg.version;
-
-  fs.writeFileSync(SKILL_FILE, `${JSON.stringify(skill, null, 2)}\n`, "utf8");
-  console.log(`Synced skills/trackops/skill.json to version ${pkg.version}.`);
-}
-
-main();
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const ROOT = path.resolve(__dirname, "..");
+const PACKAGE_FILE = path.join(ROOT, "package.json");
+const SKILL_FILE = path.join(ROOT, "skills", "trackops", "skill.json");
+
+function main() {
+  const pkg = JSON.parse(fs.readFileSync(PACKAGE_FILE, "utf8"));
+  const skill = JSON.parse(fs.readFileSync(SKILL_FILE, "utf8"));
+
+  skill.skillVersion = pkg.version;
+  skill.trackopsVersion = pkg.version;
+
+  fs.writeFileSync(SKILL_FILE, `${JSON.stringify(skill, null, 2)}\n`, "utf8");
+  console.log(`Synced skills/trackops/skill.json to version ${pkg.version}.`);
+}
+
+main();

package/scripts/validate-skill.js

@@ -1,103 +1,103 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const path = require("path");
-
-const ROOT = path.resolve(__dirname, "..");
-const PACKAGE_FILE = path.join(ROOT, "package.json");
-const SKILL_DIR = path.join(ROOT, "skills", "trackops");
-const SKILL_FILE = path.join(SKILL_DIR, "skill.json");
-const REQUIRED_FILES = [
-  path.join(SKILL_DIR, "SKILL.md"),
-  path.join(SKILL_DIR, "skill.json"),
-  path.join(SKILL_DIR, "references", "activation.md"),
-  path.join(SKILL_DIR, "references", "workflow.md"),
-  path.join(SKILL_DIR, "references", "troubleshooting.md"),
-];
-
-function fail(message) {
-  console.error(message);
-  process.exit(1);
-}
-
-function main() {
-  const pkg = JSON.parse(fs.readFileSync(PACKAGE_FILE, "utf8"));
-  const skill = JSON.parse(fs.readFileSync(SKILL_FILE, "utf8"));
-  const skillMd = fs.readFileSync(path.join(SKILL_DIR, "SKILL.md"), "utf8");
-
-  for (const file of REQUIRED_FILES) {
-    if (!fs.existsSync(file)) {
-      fail(`Missing required skill file: ${path.relative(ROOT, file)}`);
-    }
-  }
-
-  if (!Array.isArray(pkg.files) || !pkg.files.includes("skills/")) {
-    fail("package.json must publish the skills/ directory.");
-  }
-
-  if (skill.name !== "trackops") {
-    fail("skills/trackops/skill.json must declare name 'trackops'.");
-  }
-
-  if (skill.skillVersion !== pkg.version || skill.trackopsVersion !== pkg.version) {
-    fail(`skills/trackops/skill.json must be synced to package version ${pkg.version}.`);
-  }
-
-  if (skill.npmPackage !== pkg.name) {
-    fail(`skills/trackops/skill.json must target npm package '${pkg.name}'.`);
-  }
-
-  if (skill.bootstrapPolicy !== "explicit_install") {
-    fail("skills/trackops/skill.json must use bootstrapPolicy 'explicit_install'.");
-  }
-
-  const supportedAgents = Array.isArray(skill.supportedAgentsV1) ? skill.supportedAgentsV1 : [];
-  for (const agent of ["antigravity", "claude-code", "codex", "cursor", "gemini-cli", "github-copilot", "kiro-cli"]) {
-    if (!supportedAgents.includes(agent)) {
-      fail(`skills/trackops/skill.json must include supported agent '${agent}'.`);
-    }
-  }
-
-  if (!skill.distribution || skill.distribution.source !== "Baxahaun/trackops") {
-    fail("skills/trackops/skill.json must declare distribution.source 'Baxahaun/trackops'.");
-  }
-
-  if (skill.distribution.skill !== "trackops") {
-    fail("skills/trackops/skill.json must declare distribution.skill 'trackops'.");
-  }
-
-  if (skill.distribution.fullDepth !== true) {
-    fail("skills/trackops/skill.json must declare distribution.fullDepth true.");
-  }
-
-  for (const requiredPhrase of [
-    "npx skills add Baxahaun/trackops",
-    "npm install -g trackops",
-    "trackops --version",
-    "trackops init",
-    "trackops opera install",
-    "trackops opera bootstrap --resume",
-  ]) {
-    if (!skillMd.includes(requiredPhrase)) {
-      fail(`skills/trackops/SKILL.md must mention '${requiredPhrase}'.`);
-    }
-  }
-
-  for (const forbiddenPhrase of [
-    "node scripts/bootstrap-trackops.js",
-    "ensures the runtime on first use",
-    "asegura el runtime en el primer uso",
-  ]) {
-    if (skillMd.includes(forbiddenPhrase)) {
-      fail(`skills/trackops/SKILL.md must not mention '${forbiddenPhrase}'.`);
-    }
-  }
-
-  if (fs.existsSync(path.join(SKILL_DIR, "scripts", "bootstrap-trackops.js"))) {
-    fail("skills/trackops must not publish scripts/bootstrap-trackops.js.");
-  }
-
-  console.log("skills/trackops validated successfully.");
-}
-
-main();
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+const ROOT = path.resolve(__dirname, "..");
+const PACKAGE_FILE = path.join(ROOT, "package.json");
+const SKILL_DIR = path.join(ROOT, "skills", "trackops");
+const SKILL_FILE = path.join(SKILL_DIR, "skill.json");
+const REQUIRED_FILES = [
+  path.join(SKILL_DIR, "SKILL.md"),
+  path.join(SKILL_DIR, "skill.json"),
+  path.join(SKILL_DIR, "references", "activation.md"),
+  path.join(SKILL_DIR, "references", "workflow.md"),
+  path.join(SKILL_DIR, "references", "troubleshooting.md"),
+];
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+function main() {
+  const pkg = JSON.parse(fs.readFileSync(PACKAGE_FILE, "utf8"));
+  const skill = JSON.parse(fs.readFileSync(SKILL_FILE, "utf8"));
+  const skillMd = fs.readFileSync(path.join(SKILL_DIR, "SKILL.md"), "utf8");
+
+  for (const file of REQUIRED_FILES) {
+    if (!fs.existsSync(file)) {
+      fail(`Missing required skill file: ${path.relative(ROOT, file)}`);
+    }
+  }
+
+  if (!Array.isArray(pkg.files) || !pkg.files.includes("skills/")) {
+    fail("package.json must publish the skills/ directory.");
+  }
+
+  if (skill.name !== "trackops") {
+    fail("skills/trackops/skill.json must declare name 'trackops'.");
+  }
+
+  if (skill.skillVersion !== pkg.version || skill.trackopsVersion !== pkg.version) {
+    fail(`skills/trackops/skill.json must be synced to package version ${pkg.version}.`);
+  }
+
+  if (skill.npmPackage !== pkg.name) {
+    fail(`skills/trackops/skill.json must target npm package '${pkg.name}'.`);
+  }
+
+  if (skill.bootstrapPolicy !== "explicit_install") {
+    fail("skills/trackops/skill.json must use bootstrapPolicy 'explicit_install'.");
+  }
+
+  const supportedAgents = Array.isArray(skill.supportedAgentsV1) ? skill.supportedAgentsV1 : [];
+  for (const agent of ["antigravity", "claude-code", "codex", "cursor", "gemini-cli", "github-copilot", "kiro-cli"]) {
+    if (!supportedAgents.includes(agent)) {
+      fail(`skills/trackops/skill.json must include supported agent '${agent}'.`);
+    }
+  }
+
+  if (!skill.distribution || skill.distribution.source !== "Baxahaun/trackops") {
+    fail("skills/trackops/skill.json must declare distribution.source 'Baxahaun/trackops'.");
+  }
+
+  if (skill.distribution.skill !== "trackops") {
+    fail("skills/trackops/skill.json must declare distribution.skill 'trackops'.");
+  }
+
+  if (skill.distribution.fullDepth !== true) {
+    fail("skills/trackops/skill.json must declare distribution.fullDepth true.");
+  }
+
+  for (const requiredPhrase of [
+    "npx skills add Baxahaun/trackops",
+    "npm install -g trackops",
+    "trackops --version",
+    "trackops init",
+    "trackops opera install",
+    "trackops opera bootstrap --resume",
+  ]) {
+    if (!skillMd.includes(requiredPhrase)) {
+      fail(`skills/trackops/SKILL.md must mention '${requiredPhrase}'.`);
+    }
+  }
+
+  for (const forbiddenPhrase of [
+    "node scripts/bootstrap-trackops.js",
+    "ensures the runtime on first use",
+    "asegura el runtime en el primer uso",
+  ]) {
+    if (skillMd.includes(forbiddenPhrase)) {
+      fail(`skills/trackops/SKILL.md must not mention '${forbiddenPhrase}'.`);
+    }
+  }
+
+  if (fs.existsSync(path.join(SKILL_DIR, "scripts", "bootstrap-trackops.js"))) {
+    fail("skills/trackops must not publish scripts/bootstrap-trackops.js.");
+  }
+
+  console.log("skills/trackops validated successfully.");
+}
+
+main();

package/skills/trackops/SKILL.md

@@ -1,122 +1,126 @@
----
-name: "trackops"
-description: "Skill global de TrackOps para explicar que hace TrackOps, exigir la instalacion explicita del runtime con npm y guiar la activacion local de proyectos y OPERA en cada repositorio."
----
-
-# TrackOps
-
-Si la conversacion y el proyecto deben trabajar en ingles, lee `locales/en/SKILL.md` antes de seguir.
-
-TrackOps sirve para trabajar con agentes sobre proyectos reales sin mezclar la aplicacion y la capa operativa.
-
-Esta skill es la puerta de entrada cuando alguien:
-
-- quiere arrancar un proyecto con agentes IA
-- ya tiene un repo y necesita orden operativo
-- necesita activar TrackOps y, si hace falta, OPERA
-- quiere trabajar en espanol o en ingles con el mismo flujo
-
-## Que hace esta skill
-
-Esta skill:
-
-- explica que es TrackOps y cuando conviene usarlo
-- exige una instalacion explicita y visible del runtime
-- guia la activacion por repositorio
-- ayuda a decidir si OPERA debe seguir por `direct bootstrap` o por `agent handoff`
-
-## Que no hace esta skill
-
-Esta skill no:
-
-- instala paquetes por su cuenta
-- ejecuta codigo remoto en silencio
-- modifica un repositorio antes de que el runtime exista
-- sustituye al runtime `trackops`
-
-## Flujo rapido
-
-Instala la skill del marketplace con:
-
-```bash
-npx skills add Baxahaun/trackops
-```
-
-Despues, confirma que el runtime `trackops` existe. Si no esta disponible, pide al usuario que lo instale de forma explicita:
-
-```bash
-npm install -g trackops
-trackops --version
-```
-
-Reglas:
-
-- la skill no debe instalar paquetes ni ejecutar codigo remoto por si sola
-- el runtime se instala con un paso visible y auditable
-- la skill puede verificar `trackops --version`, pero no debe encadenar instalaciones silenciosas
-- la skill no debe crear archivos dentro de un repositorio por si sola
-
-## Activacion en un proyecto
-
-Dentro del repositorio:
-
-```bash
-trackops init
-trackops opera install
-```
-
-Reglas base:
-
-- trata la skill global como capa de instrucciones
-- trata la instalacion del runtime como explicita y separada
-- usa `ops/contract/operating-contract.json` como contrato de maquina cuando exista
-- usa `ops/project_control.json` como fuente de verdad operativa
-- usa `ops/policy/autonomy.json` antes de acciones sensibles
-- usa `/.env` y `/.env.example` como contrato de entorno
-- deja la documentacion operativa generada dentro de `ops/`
-- usa `trackops locale get|set` y `trackops doctor locale` cuando el idioma importe
-
-## Como entra OPERA
-
-OPERA ya no asume que todo usuario es tecnico.
-
-TrackOps clasifica:
-
-- nivel tecnico del usuario
-- estado actual del proyecto
-- documentacion disponible
-
-Luego elige una de dos rutas:
-
-- `direct bootstrap`
-  para usuarios tecnicos y repos ya definidos
-- `agent handoff`
-  para ideas tempranas, usuarios no tecnicos o documentacion debil
-
-Si TrackOps deriva al agente:
-
-- lee `ops/bootstrap/agent-handoff.md`
-- o imprimelo con `trackops opera handoff --print`
-- exige como salida:
-  - `ops/bootstrap/intake.json`
-  - `ops/bootstrap/spec-dossier.md`
-  - `ops/bootstrap/open-questions.md` cuando queden huecos importantes
-- reanuda con:
-
-```bash
-trackops opera bootstrap --resume
-```
-
-## Que debe entender alguien que llega desde skills.sh
-
-- la skill global instala instrucciones en el agente
-- el runtime se instala por separado con npm
-- `trackops init` activa el proyecto
-- `trackops opera install` anade el framework operativo completo solo cuando hace falta
-- TrackOps separa producto y operacion para que el repo no se vuelva caotico
-
-## Que referencia leer y cuando
-
-- lee `references/activation.md` solo para instalacion, verificacion del runtime, locale bootstrap y activacion de un repo
-- lee `references/workflow.md` solo cuando TrackOps ya esta activo y haga falta operar el dia a dia del repositorio
-- lee `references/troubleshooting.md` solo cuando fallen la instalacion explicita, la deteccion de `trackops`, el resume o el contrato de entorno
+---
+name: "trackops"
+description: "Skill global de TrackOps para explicar que hace TrackOps, exigir la instalacion explicita del runtime con npm y guiar la activacion local de proyectos y OPERA en cada repositorio."
+---
+
+# TrackOps
+
+Si la conversacion y el proyecto deben trabajar en ingles, lee `locales/en/SKILL.md` antes de seguir.
+
+TrackOps es un sistema local de control y coordinación para desarrollo de software con agentes IA.
+
+Esta skill es la puerta de entrada al sistema. Úsala cuando alguien:
+
+- quiere arrancar un proyecto con agentes IA
+- ya tiene un repo y necesita orden operativo
+- necesita activar TrackOps y, si hace falta, OPERA
+- quiere trabajar en espanol o en ingles con el mismo flujo
+
+## Que hace esta skill
+
+Esta skill:
+
+- explica qué es TrackOps y cuándo conviene usarlo
+- exige una instalación explícita y visible del runtime
+- guía la activación por repositorio
+- ayuda a decidir si OPERA debe seguir por `direct bootstrap` o por `agent handoff`
+- explica que al instalar OPERA se activa un equipo de agentes coordinados por `opera-skill`
+
+## Que no hace esta skill
+
+Esta skill no:
+
+- instala paquetes por su cuenta
+- ejecuta codigo remoto en silencio
+- modifica un repositorio antes de que el runtime exista
+- sustituye al runtime `trackops`
+
+## Flujo rapido
+
+Instala la skill del marketplace con:
+
+```bash
+npx skills add Baxahaun/trackops
+```
+
+Despues, confirma que el runtime `trackops` existe. Si no esta disponible, pide al usuario que lo instale de forma explicita:
+
+```bash
+npm install -g trackops
+trackops --version
+```
+
+Reglas:
+
+- la skill no debe instalar paquetes ni ejecutar codigo remoto por si sola
+- el runtime se instala con un paso visible y auditable
+- la skill puede verificar `trackops --version`, pero no debe encadenar instalaciones silenciosas
+- la skill no debe crear archivos dentro de un repositorio por si sola
+
+## Activacion en un proyecto
+
+Dentro del repositorio:
+
+```bash
+trackops init
+trackops opera install
+```
+
+Reglas base:
+
+- trata la skill global como capa de instrucciones
+- trata la instalacion del runtime como explicita y separada
+- usa `ops/contract/operating-contract.json` como contrato de maquina cuando exista
+- usa `ops/project_control.json` como fuente de verdad operativa
+- usa `ops/policy/autonomy.json` antes de acciones sensibles
+- usa `/.env` y `/.env.example` como contrato de entorno
+- deja la documentacion operativa generada dentro de `ops/`
+- usa `trackops locale get|set` y `trackops doctor locale` cuando el idioma importe
+
+## Como entra OPERA
+
+OPERA ya no asume que todo usuario es tecnico.
+
+TrackOps clasifica:
+
+- nivel tecnico del usuario
+- estado actual del proyecto
+- documentacion disponible
+
+Luego elige una de dos rutas:
+
+- `direct bootstrap`
+  para usuarios tecnicos y repos ya definidos
+- `agent handoff`
+  para ideas tempranas, usuarios no tecnicos o documentacion debil
+
+Una vez activo, OPERA instala automáticamente un equipo de agentes especializados en `ops/.agents/skills/`. La coordinadora (`opera-skill`) decide en qué fase está el proyecto, qué agente debe actuar, cuándo delegar y cuándo frenar el avance.
+
+Si TrackOps deriva al agente:
+
+- lee `ops/bootstrap/agent-handoff.md`
+- o imprímelo con `trackops opera handoff --print`
+- exige como salida:
+  - `ops/bootstrap/intake.json`
+  - `ops/bootstrap/spec-dossier.md`
+  - `ops/bootstrap/open-questions.md` cuando queden huecos importantes
+- reanuda con:
+
+```bash
+trackops opera bootstrap --resume
+```
+
+## Que debe entender alguien que llega desde skills.sh
+
+- la skill global instala instrucciones en el agente
+- el runtime se instala por separado con npm
+- `trackops init` activa el proyecto
+- `trackops opera install` anade el framework operativo completo solo cuando hace falta
+- TrackOps separa producto y operacion para que el repo no se vuelva caotico
+
+## Que referencia leer y cuando
+
+- lee `references/activation.md` solo para instalación, verificación del runtime, locale bootstrap y activación de un repositorio
+- lee `references/workflow.md` solo cuando TrackOps ya está activo y haga falta operar el día a día del repositorio
+- lee `references/troubleshooting.md` solo cuando fallen la instalación explícita, la detección de `trackops`, el resume o el contrato de entorno
+- `opera-skill` es una skill de proyecto, no una referencia de esta skill global. Se instala con OPERA y coordina el trabajo dentro del repositorio.

package/skills/trackops/agents/openai.yaml

@@ -1,7 +1,7 @@
-interface:
-  display_name: "TrackOps"
-  short_description: "Explain TrackOps and guide explicit install"
-  default_prompt: "Use $trackops to explain what TrackOps does, require explicit npm installation of the TrackOps runtime, and then activate TrackOps and OPERA in this repository."
-
-policy:
-  allow_implicit_invocation: true
+interface:
+  display_name: "TrackOps"
+  short_description: "Explain TrackOps and guide explicit install"
+  default_prompt: "Use $trackops to explain what TrackOps does, require explicit npm installation of the TrackOps runtime, and then activate TrackOps and OPERA in this repository."
+
+policy:
+  allow_implicit_invocation: true