trackops 2.0.3 → 2.0.5

package/skills/trackops/references/activation.md

@@ -1,75 +1,94 @@
-# Activacion
-
-## Instalacion global
-
-```bash
-npx skills add Baxahaun/trackops
-npm install -g trackops
-trackops --version
-```
-
-La skill global instala instrucciones para el agente.
-
-El runtime `trackops` se instala aparte con npm para que el paso sea visible, auditable y facil de verificar.
-
-Antes de seguir:
-
-- confirma que `trackops --version` devuelve una version valida
-- si no aparece, resuelve PATH o reinstala `trackops`
-- la skill no debe intentar instalar el runtime por su cuenta
-
-## Activacion local
-
-Dentro del repo:
-
-```bash
-trackops init
-trackops opera install
-```
-
-Por defecto, `trackops init` crea un workspace split con:
-
-- `app/`
-- `ops/`
-- `/.env`
-- `/.env.example`
-- `.trackops-workspace.json`
-
-## Routing de OPERA
-
-OPERA siempre empieza clasificando:
-
-- nivel tecnico
-- estado del proyecto
-- estado de documentacion
-
-Si el proyecto esta en fase temprana o el usuario es no tecnico, TrackOps escribe:
-
-- `ops/bootstrap/agent-handoff.md`
-- `ops/bootstrap/agent-handoff.json`
-
-El agente debe producir:
-
-- `ops/bootstrap/intake.json`
-- `ops/bootstrap/spec-dossier.md`
-- `ops/bootstrap/open-questions.md` cuando haga falta
-
-Cuando pasa el quality gate, OPERA compila:
-
-- `ops/contract/operating-contract.json`
-- `ops/genesis.md`
-- `ops/policy/autonomy.json`
-
-Reanuda con:
-
-```bash
-trackops opera bootstrap --resume
-```
-
-Controles de idioma:
-
-```bash
-trackops locale get
-trackops locale set es
-trackops doctor locale
-```
+# Activacion
+
+## Instalacion global
+
+```bash
+npx skills add Baxahaun/trackops
+npm install -g trackops
+trackops --version
+```
+
+La skill global instala instrucciones para el agente.
+
+El runtime `trackops` se instala aparte con npm para que el paso sea visible, auditable y facil de verificar.
+
+Antes de seguir:
+
+- confirma que `trackops --version` devuelve una version valida
+- si no aparece, resuelve PATH o reinstala `trackops`
+- la skill no debe intentar instalar el runtime por su cuenta
+
+## Activacion local
+
+Dentro del repo:
+
+```bash
+trackops init
+trackops opera install
+```
+
+`trackops opera install` también activa el equipo de agentes del proyecto:
+- `opera-skill` (coordinadora)
+- `project-starter-skill`, `opera-contract-auditor`, `opera-policy-guard`
+
+Por defecto, `trackops init` crea un workspace split con:
+
+- `app/`
+- `ops/`
+- `/.env`
+- `/.env.example`
+- `.trackops-workspace.json`
+
+## Routing de OPERA
+
+OPERA siempre empieza clasificando:
+
+- nivel tecnico
+- estado del proyecto
+- estado de documentacion
+
+Si el proyecto esta en fase temprana o el usuario es no tecnico, TrackOps escribe:
+
+- `ops/bootstrap/agent-handoff.md`
+- `ops/bootstrap/agent-handoff.json`
+
+El agente debe producir:
+
+- `ops/bootstrap/intake.json`
+- `ops/bootstrap/spec-dossier.md`
+- `ops/bootstrap/open-questions.md` cuando haga falta
+
+Cuando pasa el quality gate, OPERA compila:
+
+- `ops/contract/operating-contract.json`
+- `ops/genesis.md`
+- `ops/policy/autonomy.json`
+
+Reanuda con:
+
+```bash
+trackops opera bootstrap --resume
+```
+
+Controles de idioma:
+
+```bash
+trackops locale get
+trackops locale set es
+trackops doctor locale
+```
+
+## Desinstalacion
+
+Global:
+
+```bash
+npx skills remove --global trackops -y
+npm uninstall -g trackops
+```
+
+Local:
+
+- no existe todavia `trackops uninstall`
+- revisa y elimina manualmente `.trackops-workspace.json`, `ops/` y `app/.env` si solo era bridge
+- no borres `/.env` ni `/.env.example` sin revisar si el proyecto sigue necesitandolos

package/skills/trackops/references/troubleshooting.md

@@ -1,55 +1,73 @@
-# Troubleshooting
-
-## Faltan prerequisitos
-
-- Instala Node 18+ si Node no existe o es demasiado antiguo.
-- Instala una distribucion de Node que incluya npm si npm no existe.
-
-## La skill se instalo, pero `trackops` no arranca
-
-- Confirma que la skill global existe:
-  `npx skills add Baxahaun/trackops`
-- Instala o reinstala el runtime de forma explicita:
-  `npm install -g trackops`
-- Verifica:
-  `trackops --version`
-- Si el binario sigue sin responder:
-  - revisa Node.js (`>= 18`)
-  - revisa que `npm` exista y funcione
-  - revisa PATH y reabre la terminal
-
-## La instalacion explicita del runtime falla
-
-- Reejecuta `npm install -g trackops`.
-- Si `npm` devuelve error, resuelvelo primero; la skill no puede continuar sin el CLI.
-- Si el problema es de permisos globales, usa el metodo recomendado para tu sistema o un prefijo npm controlado por el usuario.
-
-## OPERA derivo el bootstrap al agente
-
-Esto es esperado cuando:
-
-- el usuario no es tecnico
-- el proyecto esta en fase idea
-- la documentacion es debil
-
-Usa:
-
-```bash
-trackops opera handoff --print
-trackops opera bootstrap --resume
-```
-
-## `trackops opera bootstrap --resume` no avanza
-
-TrackOps no inventa contexto faltante.
-
-Comprueba que existan ambos archivos y contengan datos utiles:
-
-- `ops/bootstrap/intake.json`
-- `ops/bootstrap/spec-dossier.md`
-
-## El entorno parece inconsistente
-
-- Ejecuta `trackops env status`.
-- Ejecuta `trackops env sync`.
-- Si el modo bridge es `copy`, no edites `app/.env` directamente.
+# Troubleshooting
+
+## Faltan prerequisitos
+
+- Instala Node 18+ si Node no existe o es demasiado antiguo.
+- Instala una distribucion de Node que incluya npm si npm no existe.
+
+## La skill se instalo, pero `trackops` no arranca
+
+- Confirma que la skill global existe:
+  `npx skills add Baxahaun/trackops`
+- Instala o reinstala el runtime de forma explicita:
+  `npm install -g trackops`
+- Verifica:
+  `trackops --version`
+- Si el binario sigue sin responder:
+  - revisa Node.js (`>= 18`)
+  - revisa que `npm` exista y funcione
+  - revisa PATH y reabre la terminal
+
+## La instalacion explicita del runtime falla
+
+- Reejecuta `npm install -g trackops`.
+- Si `npm` devuelve error, resuelvelo primero; la skill no puede continuar sin el CLI.
+- Si el problema es de permisos globales, usa el metodo recomendado para tu sistema o un prefijo npm controlado por el usuario.
+
+## OPERA derivo el bootstrap al agente
+
+Esto es esperado cuando:
+
+- el usuario no es tecnico
+- el proyecto esta en fase idea
+- la documentacion es debil
+
+Usa:
+
+```bash
+trackops opera handoff --print
+trackops opera bootstrap --resume
+```
+
+## `trackops opera bootstrap --resume` no avanza
+
+TrackOps no inventa contexto faltante.
+
+Comprueba que existan ambos archivos y contengan datos utiles:
+
+- `ops/bootstrap/intake.json`
+- `ops/bootstrap/spec-dossier.md`
+
+## El entorno parece inconsistente
+
+- Ejecuta `trackops env status`.
+- Ejecuta `trackops env sync`.
+- Si el modo bridge es `copy`, no edites `app/.env` directamente.
+
+## Quiero quitar TrackOps por completo
+
+- Quita la skill global:
+  `npx skills remove --global trackops -y`
+- Quita el runtime global:
+  `npm uninstall -g trackops`
+- En el repo, la retirada local sigue siendo manual:
+  - revisa `.trackops-workspace.json`
+  - revisa `ops/`
+  - revisa `app/.env` si era solo bridge
+- No borres `/.env` ni `/.env.example` sin comprobar antes si el proyecto sigue dependiendo de ellos
+
+## `opera-skill` no aparece en el proyecto
+
+- Confirma que OPERA está instalado: `trackops opera status`
+- Si falta la skill: `trackops skill install opera-skill`
+- Verifica: `trackops skill list` debe mostrar `opera-skill` primera

package/skills/trackops/references/workflow.md

@@ -1,32 +1,55 @@
-# Flujo diario
-
-Precondicion:
-
-- la skill global ya esta instalada
-- `trackops --version` responde correctamente
-- el repo ya fue activado con `trackops init`
-
-Usa TrackOps cuando el repositorio ya esta gestionado y necesites operar el dia a dia.
-
-1. Ejecuta `trackops status`.
-2. Ejecuta `trackops next`.
-3. Mueve el estado de tareas con `trackops task ...`.
-4. Ejecuta `trackops sync` despues de cambios relevantes.
-5. Ejecuta `trackops env status` cuando las credenciales importen.
-
-Reglas operativas:
-
-- en workspaces split, usa `ops/project_control.json` como fuente de verdad
-- la documentacion operativa generada vive en `ops/`
-- el codigo de producto vive en `app/`
-- los secretos reales viven en `/.env`
-- el contrato publico de entorno vive en `/.env.example`
-- `app/.env` solo es un puente de compatibilidad
-
-Si OPERA esta instalado:
-
-- `ops/contract/operating-contract.json` guarda el contrato de maquina
-- `ops/genesis.md` guarda la vista humana compilada
-- `ops/policy/autonomy.json` guarda la politica ejecutable
-- `ops/bootstrap/` guarda artefactos de onboarding
-- `ops/.agent/hub/` y `ops/.agents/skills/` guardan artefactos gestionados de agente
+# Flujo diario
+
+Precondicion:
+
+- la skill global ya esta instalada
+- `trackops --version` responde correctamente
+- el repo ya fue activado con `trackops init`
+
+Usa TrackOps cuando el repositorio ya esta gestionado y necesites operar el dia a dia.
+
+1. Ejecuta `trackops status`.
+2. Ejecuta `trackops next`.
+3. Mueve el estado de tareas con `trackops task ...`.
+4. Ejecuta `trackops sync` despues de cambios relevantes.
+5. Ejecuta `trackops env status` cuando las credenciales importen.
+
+Reglas operativas:
+
+- en workspaces split, usa `ops/project_control.json` como fuente de verdad
+- la documentacion operativa generada vive en `ops/`
+- el codigo de producto vive en `app/`
+- los secretos reales viven en `/.env`
+- el contrato publico de entorno vive en `/.env.example`
+- `app/.env` solo es un puente de compatibilidad
+
+Si OPERA está instalado:
+
+- `ops/contract/operating-contract.json` guarda el contrato de máquina
+- `ops/genesis.md` guarda la vista humana compilada
+- `ops/policy/autonomy.json` guarda la política ejecutable
+- `ops/bootstrap/` guarda artefactos de arranque
+- `ops/.agents/skills/opera-skill/` coordina el equipo de agentes
+- `ops/.agents/skills/` contiene los demás especialistas del proyecto
+- `ops/.agent/hub/` guarda la configuración del agente principal
+
+## Equipo de agentes del proyecto
+
+Cuando OPERA está instalado, se activa un equipo de agentes especializados:
+
+- `opera-skill` — coordinadora. Decide fase, estado, delegación y bloqueo.
+- `project-starter-skill` — descubrimiento y estructuración
+- `opera-contract-auditor` — auditoría del contrato operativo
+- `opera-policy-guard` — control de riesgo
+
+También se pueden instalar:
+
+- `commiter` — formato de commits
+- `changelog-updater` — registro de cambios
+
+Comandos de gestión:
+
+    trackops skill list
+    trackops skill catalog
+    trackops skill install <nombre>
+    trackops skill remove <nombre>

package/skills/trackops/skill.json

@@ -1,29 +1,29 @@
-{
-  "name": "trackops",
-  "shortDescription": "Global TrackOps skill that explains TrackOps, requires explicit runtime install, and guides per-repository activation.",
-  "description": "Explains what TrackOps does, installs the global skill layer, requires explicit runtime installation with npm, supports Spanish and English, activates TrackOps repository by repository, and routes OPERA onboarding into either direct bootstrap or agent-led discovery.",
-  "skillVersion": "2.0.3",
-  "trackopsVersion": "2.0.3",
-  "npmPackage": "trackops",
-  "bootstrapPolicy": "explicit_install",
-  "supportedAgentsV1": [
-    "antigravity",
-    "claude-code",
-    "codex",
-    "cursor",
-    "gemini-cli",
-    "github-copilot",
-    "kiro-cli"
-  ],
-  "distribution": {
-    "source": "Baxahaun/trackops",
-    "skill": "trackops",
-    "fullDepth": true
-  },
-  "repository": {
-    "provider": "github",
-    "owner": "Baxahaun",
-    "repo": "trackops",
-    "skillPath": "skills/trackops"
-  }
-}
+{
+  "name": "trackops",
+  "shortDescription": "Global TrackOps skill that explains TrackOps, requires explicit runtime install, and guides per-repository activation.",
+  "description": "Explains what TrackOps does, installs the global skill layer, requires explicit runtime installation with npm, supports Spanish and English, activates TrackOps repository by repository, and routes OPERA onboarding into either direct bootstrap or agent-led discovery.",
+  "skillVersion": "2.0.5",
+  "trackopsVersion": "2.0.5",
+  "npmPackage": "trackops",
+  "bootstrapPolicy": "explicit_install",
+  "supportedAgentsV1": [
+    "antigravity",
+    "claude-code",
+    "codex",
+    "cursor",
+    "gemini-cli",
+    "github-copilot",
+    "kiro-cli"
+  ],
+  "distribution": {
+    "source": "Baxahaun/trackops",
+    "skill": "trackops",
+    "fullDepth": true
+  },
+  "repository": {
+    "provider": "github",
+    "owner": "Baxahaun",
+    "repo": "trackops",
+    "skillPath": "skills/trackops"
+  }
+}

package/templates/hooks/post-checkout

@@ -1,2 +1,2 @@
-#!/bin/sh
-npx trackops refresh-repo --quiet >/dev/null 2>&1 || true
+#!/bin/sh
+npx trackops refresh-repo --quiet >/dev/null 2>&1 || true

package/templates/hooks/post-commit

@@ -1,2 +1,2 @@
-#!/bin/sh
-npx trackops refresh-repo --quiet >/dev/null 2>&1 || true
+#!/bin/sh
+npx trackops refresh-repo --quiet >/dev/null 2>&1 || true

package/templates/hooks/post-merge

@@ -1,2 +1,2 @@
-#!/bin/sh
-npx trackops refresh-repo --quiet >/dev/null 2>&1 || true
+#!/bin/sh
+npx trackops refresh-repo --quiet >/dev/null 2>&1 || true

package/templates/opera/agent.md

@@ -1,27 +1,28 @@
-# Agente del Proyecto: {{PROJECT_NAME}}
-
-## Identidad
-Eres el agente principal del proyecto **{{PROJECT_NAME}}**. Operas bajo el protocolo O.P.E.R.A. v3.0.
-
-## Fuente de Verdad
-Tu fuente de verdad de maquina es `ops/contract/operating-contract.json`.
-Tu vista humana compilada es `ops/genesis.md`.
-Para el seguimiento operativo y el estado del backlog, usa `ops/project_control.json`.
-
-## Comportamiento
-- Sigue las reglas definidas en `ops/contract/operating-contract.json` y reflejadas en `ops/genesis.md`.
-- Respeta `ops/policy/autonomy.json` para determinar qué acciones puedes tomar sin aprobacion.
-- Gestiona tareas y estados desde `ops/project_control.json`.
-- No edites manualmente `ops/task_plan.md`, `ops/progress.md` ni `ops/findings.md`; se regeneran con `trackops sync`.
-
-## Skills Disponibles
-Consulta `ops/.agents/skills/_registry.md` para ver las skills instaladas.
-También puedes buscar nuevas skills con `trackops skill catalog`.
-
-## Ciclo de Trabajo
-1. Ejecuta `trackops status` al inicio de cada bloque de trabajo.
-2. Consulta `ops/contract/operating-contract.json` y `ops/genesis.md` para entender el contrato y su vista humana.
-3. Usa `trackops next` para ver la siguiente cola priorizada.
-4. Antes de implementar, marca la tarea con `trackops task start <task-id>`.
-5. Usa el router (`ops/.agent/hub/router.md`) para saber que skill aplicar.
-6. Al terminar, pasa la tarea a `review`, `complete` o `block` y ejecuta `trackops sync`.
+# Agente del Proyecto: {{PROJECT_NAME}}
+
+## Identidad
+Eres el agente principal del proyecto **{{PROJECT_NAME}}**. Operas bajo el protocolo O.P.E.R.A. v3.0.
+
+## Fuente de Verdad
+Tu fuente de verdad de maquina es `ops/contract/operating-contract.json`.
+Tu vista humana compilada es `ops/genesis.md`.
+Para el seguimiento operativo y el estado del backlog, usa `ops/project_control.json`.
+
+## Comportamiento
+- Sigue las reglas definidas en `ops/contract/operating-contract.json` y reflejadas en `ops/genesis.md`.
+- Respeta `ops/policy/autonomy.json` para determinar qué acciones puedes tomar sin aprobacion.
+- Gestiona tareas y estados desde `ops/project_control.json`.
+- No edites manualmente `ops/task_plan.md`, `ops/progress.md` ni `ops/findings.md`; se regeneran con `trackops sync`.
+
+## Skills Disponibles
+Consulta `ops/.agents/skills/_registry.md` para ver las skills instaladas.
+Si `ops/.agents/skills/opera-skill/SKILL.md` existe, tratala como skill coordinadora por defecto antes de elegir otras skills.
+También puedes buscar nuevas skills con `trackops skill catalog`.
+
+## Ciclo de Trabajo
+1. Ejecuta `trackops status` al inicio de cada bloque de trabajo.
+2. Consulta `ops/contract/operating-contract.json` y `ops/genesis.md` para entender el contrato y su vista humana.
+3. Usa `trackops next` para ver la siguiente cola priorizada.
+4. Antes de implementar, marca la tarea con `trackops task start <task-id>`.
+5. Usa el router (`ops/.agent/hub/router.md`) para saber que skill aplicar.
+6. Al terminar, pasa la tarea a `review`, `complete` o `block` y ejecuta `trackops sync`.

package/templates/opera/architecture/dependency-graph.md

@@ -1,24 +1,24 @@
-# Dependency Graph
-
-```mermaid
-flowchart TD
-    A[Explicit global runtime install] --> B[trackops init]
-    B --> C[trackops opera install]
-    C --> D{Routing}
-    D -->|direct_cli| E[Direct intake]
-    D -->|agent_handoff| F[agent-handoff.md/json]
-    F --> G[intake.json + spec-dossier.md]
-    E --> H[quality-report.json]
-    G --> H
-    H --> I[operating-contract.json]
-    I --> J[genesis.md]
-    I --> K[task_plan.md / progress.md / findings.md]
-    I --> L[dashboard + API state]
-    I --> M[env sync + policy enforcement]
-```
-
-## Notes
-
-- `ops/project_control.json` is the operational source of truth for backlog and session state.
-- `ops/contract/operating-contract.json` is the machine contract.
-- `ops/genesis.md` is a compiled human view.
+# Dependency Graph
+
+```mermaid
+flowchart TD
+    A[Explicit global runtime install] --> B[trackops init]
+    B --> C[trackops opera install]
+    C --> D{Routing}
+    D -->|direct_cli| E[Direct intake]
+    D -->|agent_handoff| F[agent-handoff.md/json]
+    F --> G[intake.json + spec-dossier.md]
+    E --> H[quality-report.json]
+    G --> H
+    H --> I[operating-contract.json]
+    I --> J[genesis.md]
+    I --> K[task_plan.md / progress.md / findings.md]
+    I --> L[dashboard + API state]
+    I --> M[env sync + policy enforcement]
+```
+
+## Notes
+
+- `ops/project_control.json` is the operational source of truth for backlog and session state.
+- `ops/contract/operating-contract.json` is the machine contract.
+- `ops/genesis.md` is a compiled human view.

package/templates/opera/architecture/runtime-automation.md

@@ -1,24 +1,24 @@
-# SOP - Runtime Automation
-
-## Objective
-
-Keep validation automatic on every relevant change.
-
-## Trigger policy
-
-- Validate on push to `develop` and `master`.
-- Validate on pull requests targeting `develop` or `master`.
-- Allow manual execution with workflow dispatch.
-
-## Validation circuit
-
-1. Install Node 18 and 20.
-2. Install runtime dependencies.
-3. Run `npm run release:check`.
-4. Fail fast on any smoke, skill or packaging regression.
-
-## Release hygiene
-
-- Do not publish if `release:check` fails.
-- Do not treat local runtime state as deployable proof.
-- Re-run smoke after structural or locale changes.
+# SOP - Runtime Automation
+
+## Objective
+
+Keep validation automatic on every relevant change.
+
+## Trigger policy
+
+- Validate on push to `develop` and `master`.
+- Validate on pull requests targeting `develop` or `master`.
+- Allow manual execution with workflow dispatch.
+
+## Validation circuit
+
+1. Install Node 18 and 20.
+2. Install runtime dependencies.
+3. Run `npm run release:check`.
+4. Fail fast on any smoke, skill or packaging regression.
+
+## Release hygiene
+
+- Do not publish if `release:check` fails.
+- Do not treat local runtime state as deployable proof.
+- Re-run smoke after structural or locale changes.