trackops 2.1.0 → 2.2.0

package/skills/trackops-quality-guard/locales/en/references/decision-policy.md

@@ -0,0 +1,16 @@
+# Decision policy
+
+## Semantics
+
+- `trackops quality status` inspects the current state
+- `trackops quality verify` runs declared checks and stores evidence
+- `trackops quality phase-readiness` is advisory
+- `trackops quality release-readiness` is a hard gate for release
+- `trackops quality promote-readiness --target production` is a hard gate for production
+
+## What is not allowed
+
+- reinterpreting runtime blockers
+- declaring release-ready without `release-readiness`
+- recommending production without `promote-readiness`
+- using waivers without explicit human approval and expiration

package/skills/trackops-quality-guard/locales/en/references/output-format.md

@@ -0,0 +1,24 @@
+# Output format
+
+Always answer with these four sections in this order:
+
+## Current state
+
+- summarize the overall quality or readiness state
+- indicate whether the result is advisory, blocked, or ready
+
+## Real blockers
+
+- list only blockers returned by the runtime
+- if there are no blockers, say so explicitly
+
+## Next action
+
+- give the minimum concrete next action
+- if a command still needs to be run, say it here
+
+## Final decision
+
+- `ready`
+- `not ready`
+- `ready only with explicit human approval`

package/skills/trackops-quality-guard/references/commands.md

@@ -0,0 +1,36 @@
+# Comandos
+
+Usa el runtime `trackops quality ...` como fuente única de verdad.
+
+## Orden de ejecución
+
+1. Si el usuario quiere revisar estado o cerrar fase:
+
+   ```bash
+   trackops quality status
+   trackops quality phase-readiness
+   ```
+
+2. Si hubo cambios relevantes en código, entorno, build o smoke:
+
+   ```bash
+   trackops quality verify --scope all
+   ```
+
+3. Si la decisión afecta a release:
+
+   ```bash
+   trackops quality release-readiness
+   ```
+
+4. Si la decisión afecta a producción:
+
+   ```bash
+   trackops quality promote-readiness --target production
+   ```
+
+## Reglas
+
+- no sustituyas estos comandos por juicio subjetivo
+- si el usuario pide un scope concreto, puedes usar `trackops quality verify --scope <scope>`
+- si el runtime falla, informa del fallo antes de sacar conclusiones

package/skills/trackops-quality-guard/references/decision-policy.md

@@ -0,0 +1,16 @@
+# Política de decisión
+
+## Semántica
+
+- `trackops quality status` inspecciona el estado actual
+- `trackops quality verify` ejecuta checks declarados y guarda evidencia
+- `trackops quality phase-readiness` es advisory
+- `trackops quality release-readiness` es gate duro para release
+- `trackops quality promote-readiness --target production` es gate duro para producción
+
+## Qué no está permitido
+
+- reinterpretar blockers del runtime
+- declarar release-ready sin ejecutar `release-readiness`
+- recomendar producción sin ejecutar `promote-readiness`
+- usar waivers sin aprobación humana explícita y caducidad

package/skills/trackops-quality-guard/references/output-format.md

@@ -0,0 +1,24 @@
+# Formato de salida
+
+Responde siempre con estas cuatro secciones y en este orden:
+
+## Estado actual
+
+- resume el estado general de calidad o readiness
+- indica si el resultado es informativo, bloqueado o listo
+
+## Blockers reales
+
+- enumera solo los bloqueos que devuelve el runtime
+- si no hay blockers, dilo explícitamente
+
+## Acción siguiente
+
+- indica la próxima acción concreta y mínima
+- si falta ejecutar un comando, indícalo aquí
+
+## Decisión final
+
+- `listo`
+- `no listo`
+- `listo solo con aprobación humana explícita`

package/skills/trackops-quality-guard/skill.json

@@ -0,0 +1,28 @@
+{
+  "name": "trackops-quality-guard",
+  "shortDescription": "Public quality guard for TrackOps release and production decisions.",
+  "description": "Inspects TrackOps quality status, runs declared verification, and decides release or production readiness without inventing rules outside the runtime.",
+  "skillVersion": "2.2.0",
+  "trackopsVersion": "2.2.0",
+  "npmPackage": "trackops",
+  "supportedAgentsV1": [
+    "antigravity",
+    "claude-code",
+    "codex",
+    "cursor",
+    "gemini-cli",
+    "github-copilot",
+    "kiro-cli"
+  ],
+  "distribution": {
+    "source": "Baxahaun/trackops",
+    "skill": "trackops-quality-guard",
+    "fullDepth": true
+  },
+  "repository": {
+    "provider": "github",
+    "owner": "Baxahaun",
+    "repo": "trackops",
+    "skillPath": "skills/trackops-quality-guard"
+  }
+}

package/templates/skills/opera-skill/SKILL.md

@@ -186,6 +186,7 @@ Alinear outputs con contrato, revisar calidad y cerrar contradicciones.
 
 ### Skills delegables
 - `opera-contract-auditor`
+- `trackops-quality-guard`
 - `opera-policy-guard`
 
 ### Bloqueo
@@ -213,6 +214,7 @@ Formalizar release, despliegue y automatizacion operativa con seguridad.
 - `trackops sync`
 
 ### Skills delegables
+- `trackops-quality-guard`
 - `opera-policy-guard`
 
 ### Bloqueo
@@ -225,6 +227,7 @@ No pasar de A si la automatizacion rompe politica, entorno o readiness operativo
 ### Delegaciones permitidas
 - `project-starter-skill` — cuando bootstrap esta pendiente o el proyecto sigue en discovery
 - `opera-contract-auditor` — cuando hay huecos, contradicciones o dudas de readiness
+- `trackops-quality-guard` — cuando haya que auditar calidad, verificar readiness o decidir release o producción
 - `opera-policy-guard` — cuando hay riesgo, side effects o permisos dudosos
 - `commiter` — cuando el usuario pida commit o el bloque de implementacion ya este listo
 - `changelog-updater` — despues de commit, si el flujo del repo lo requiere
@@ -279,6 +282,7 @@ No dejes pasar por intuicion.
 
 - lee `references/phase-dod.md` cuando se pida cerrar fase, se dude del readiness o el agente tenga que justificar por que no puede avanzar
 - lee la skill `project-starter-skill` cuando estes en Fase O y necesites hacer discovery
+- lee la skill `trackops-quality-guard` cuando tengas que decidir calidad, release o producción
 - lee la skill `opera-contract-auditor` cuando necesites validar el contrato operativo
 - lee la skill `opera-policy-guard` cuando vayas a ejecutar acciones con riesgo
 

package/templates/skills/opera-skill/locales/en/SKILL.md

@@ -186,6 +186,7 @@ Align outputs with contract, review quality, and close contradictions.
 
 ### Delegable skills
 - `opera-contract-auditor`
+- `trackops-quality-guard`
 - `opera-policy-guard`
 
 ### Blocking
@@ -213,6 +214,7 @@ Formalize release, deployment, and operational automation with safety.
 - `trackops sync`
 
 ### Delegable skills
+- `trackops-quality-guard`
 - `opera-policy-guard`
 
 ### Blocking
@@ -225,6 +227,7 @@ Do not pass A if automation breaks policy, environment, or operational readiness
 ### Allowed delegations
 - `project-starter-skill` — when bootstrap is pending or the project is still in discovery
 - `opera-contract-auditor` — when there are gaps, contradictions, or readiness doubts
+- `trackops-quality-guard` — when quality, readiness, release, or production decisions must be audited against the TrackOps runtime
 - `opera-policy-guard` — when there is risk, side effects, or dubious permissions
 - `commiter` — when the user requests a commit or the implementation block is ready
 - `changelog-updater` — after commit, if the repo workflow requires it
@@ -279,6 +282,7 @@ Do not let it pass by intuition.
 
 - read `references/phase-dod.md` when asked to close a phase, when doubting readiness, or when the agent needs to justify why it cannot advance
 - read the `project-starter-skill` when in Phase O and discovery is needed
+- read the `trackops-quality-guard` when you need to decide quality, release, or production readiness
 - read the `opera-contract-auditor` when the operating contract needs validation
 - read the `opera-policy-guard` when about to execute risky actions
 

package/templates/skills/trackops-quality-guard/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: "trackops-quality-guard"
+description: "Skill local de TrackOps para inspeccionar calidad, ejecutar verificaciones declaradas y decidir readiness antes de release o recomendaciones de producción."
+metadata:
+  version: "1.0"
+  type: "project"
+  triggers:
+    - "quality"
+    - "calidad"
+    - "auditar"
+    - "auditoría"
+    - "readiness"
+    - "release readiness"
+    - "production readiness"
+    - "verifica calidad"
+---
+
+# TrackOps Quality Guard
+
+## Misión
+
+Complementar TrackOps y OPERA con una guardia explícita de calidad y readiness de salida.
+
+## Cuándo usarla
+
+- cuando el usuario pida una auditoría de calidad
+- cuando haya que decidir si algo está listo para release
+- cuando haya que decidir si algo puede recomendarse para producción
+- cuando haga falta revisar blockers reales antes de cerrar fase o entregar
+
+## Qué no hace
+
+- no sustituye al runtime `trackops quality ...`
+- no inventa checks ni criterios
+- no suaviza blockers del runtime
+- no publica, despliega ni aprueba por su cuenta
+
+## Comandos obligatorios
+
+- antes de cerrar una fase o declarar estabilidad, ejecuta `trackops quality status`
+- si la decisión afecta a fase, consulta también `trackops quality phase-readiness`
+- tras cambios relevantes en código, entorno, build o smoke, ejecuta `trackops quality verify`
+- antes de `trackops release`, ejecuta `trackops quality release-readiness`
+- antes de recomendar producción, ejecuta `trackops quality promote-readiness --target production`
+
+## Reglas de decisión
+
+- `phase-readiness` es informativo
+- `release-readiness` decide si se puede liberar
+- `promote-readiness` decide si se puede recomendar producción
+- si el runtime marca bloqueo, no inventes excepciones
+
+## Política de waivers
+
+- solo usa waivers si existe aprobación humana explícita
+- un waiver debe tener caducidad
+- un waiver no borra la evidencia
+
+## Salida obligatoria
+
+Responde siempre con este orden exacto:
+
+1. `Estado actual`
+2. `Blockers reales`
+3. `Acción siguiente`
+4. `Decisión final`
+
+## Qué referencia leer y cuándo
+
+- lee `references/commands.md` para decidir qué comando corre en cada momento
+- lee `references/decision-policy.md` para interpretar advisory vs gate duro
+- lee `references/output-format.md` antes de responder si la salida puede afectar una decisión de release o producción

package/templates/skills/trackops-quality-guard/locales/en/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: "trackops-quality-guard"
+description: "Local TrackOps skill for inspecting quality, running declared verification, and deciding readiness before release or production recommendations."
+metadata:
+  version: "1.0"
+  type: "project"
+  triggers:
+    - "quality"
+    - "calidad"
+    - "auditar"
+    - "auditoría"
+    - "readiness"
+    - "release readiness"
+    - "production readiness"
+    - "verifica calidad"
+---
+
+# TrackOps Quality Guard
+
+## Mission
+
+Complement TrackOps and OPERA with an explicit quality and production-readiness guard.
+
+## When to use it
+
+- when the user asks for a quality audit
+- when something must be judged as release-ready
+- when something must be judged as safe to recommend for production
+- when real blockers must be reviewed before closing a phase or delivering
+
+## What it does not do
+
+- it does not replace the `trackops quality ...` runtime
+- it does not invent checks or criteria
+- it does not soften runtime blockers
+- it does not publish, deploy, or approve by itself
+
+## Mandatory commands
+
+- before closing a phase or declaring stability, run `trackops quality status`
+- if the decision affects a phase, also run `trackops quality phase-readiness`
+- after relevant code, environment, build, or smoke changes, run `trackops quality verify`
+- before `trackops release`, run `trackops quality release-readiness`
+- before recommending production, run `trackops quality promote-readiness --target production`
+
+## Decision rules
+
+- `phase-readiness` is advisory
+- `release-readiness` decides whether release is allowed
+- `promote-readiness` decides whether production can be recommended
+- if the runtime blocks, do not invent exceptions
+
+## Waiver policy
+
+- only use waivers with explicit human approval
+- a waiver must expire
+- a waiver never erases evidence
+
+## Required output
+
+Always answer in this exact order:
+
+1. `Current state`
+2. `Real blockers`
+3. `Next action`
+4. `Final decision`
+
+## Which reference to read and when
+
+- read `locales/en/references/commands.md` to decide which command to run
+- read `locales/en/references/decision-policy.md` to interpret advisory vs hard gate
+- read `locales/en/references/output-format.md` before replying when the answer may affect a release or production decision

package/templates/skills/trackops-quality-guard/locales/en/references/commands.md

@@ -0,0 +1,30 @@
+# Commands
+
+Use the `trackops quality ...` runtime as the single source of truth.
+
+## Execution order
+
+1. If the user wants a status check or phase close review:
+
+   ```bash
+   trackops quality status
+   trackops quality phase-readiness
+   ```
+
+2. If there were relevant code, environment, build, or smoke changes:
+
+   ```bash
+   trackops quality verify --scope all
+   ```
+
+3. If the decision affects release:
+
+   ```bash
+   trackops quality release-readiness
+   ```
+
+4. If the decision affects production:
+
+   ```bash
+   trackops quality promote-readiness --target production
+   ```

package/templates/skills/trackops-quality-guard/locales/en/references/decision-policy.md

@@ -0,0 +1,14 @@
+# Decision policy
+
+- `trackops quality status` inspects the current state
+- `trackops quality verify` runs declared checks and stores evidence
+- `trackops quality phase-readiness` is advisory
+- `trackops quality release-readiness` is a hard gate for release
+- `trackops quality promote-readiness --target production` is a hard gate for production
+
+Not allowed:
+
+- reinterpreting runtime blockers
+- declaring release-ready without `release-readiness`
+- recommending production without `promote-readiness`
+- using waivers without explicit human approval and expiration

package/templates/skills/trackops-quality-guard/locales/en/references/output-format.md

@@ -0,0 +1,21 @@
+# Output format
+
+Always answer with these four sections in this order:
+
+## Current state
+
+- summarize the overall state
+
+## Real blockers
+
+- list only runtime blockers
+
+## Next action
+
+- give the minimum concrete next action
+
+## Final decision
+
+- `ready`
+- `not ready`
+- `ready only with explicit human approval`

package/templates/skills/trackops-quality-guard/references/commands.md

@@ -0,0 +1,30 @@
+# Comandos
+
+Usa el runtime `trackops quality ...` como fuente única de verdad.
+
+## Orden de ejecución
+
+1. Si el usuario quiere revisar estado o cerrar fase:
+
+   ```bash
+   trackops quality status
+   trackops quality phase-readiness
+   ```
+
+2. Si hubo cambios relevantes en código, entorno, build o smoke:
+
+   ```bash
+   trackops quality verify --scope all
+   ```
+
+3. Si la decisión afecta a release:
+
+   ```bash
+   trackops quality release-readiness
+   ```
+
+4. Si la decisión afecta a producción:
+
+   ```bash
+   trackops quality promote-readiness --target production
+   ```

package/templates/skills/trackops-quality-guard/references/decision-policy.md

@@ -0,0 +1,14 @@
+# Política de decisión
+
+- `trackops quality status` inspecciona el estado actual
+- `trackops quality verify` ejecuta checks declarados y guarda evidencia
+- `trackops quality phase-readiness` es advisory
+- `trackops quality release-readiness` es gate duro para release
+- `trackops quality promote-readiness --target production` es gate duro para producción
+
+No está permitido:
+
+- reinterpretar blockers del runtime
+- declarar release-ready sin `release-readiness`
+- recomendar producción sin `promote-readiness`
+- usar waivers sin aprobación humana explícita y caducidad

package/templates/skills/trackops-quality-guard/references/output-format.md

@@ -0,0 +1,21 @@
+# Formato de salida
+
+Responde siempre con estas cuatro secciones y en este orden:
+
+## Estado actual
+
+- resume el estado general
+
+## Blockers reales
+
+- enumera solo los bloqueos del runtime
+
+## Acción siguiente
+
+- indica la próxima acción mínima y concreta
+
+## Decisión final
+
+- `listo`
+- `no listo`
+- `listo solo con aprobación humana explícita`

package/templates/skills/opera-quality-guard/SKILL.md

@@ -1,26 +0,0 @@
----
-name: "opera-quality-guard"
-description: "Guardia local de calidad para proyectos OPERA. Obliga al agente a consultar estado de calidad, ejecutar verificaciones declaradas y comprobar readiness antes de release o recomendacion de despliegue."
-metadata:
-  version: "1.0"
-  type: "project"
----
-
-# OPERA Quality Guard
-
-## Mision
-
-Complementar OPERA con una capa de calidad continua y readiness de salida.
-
-## Reglas
-
-- antes de cerrar una fase, ejecuta `trackops quality status`
-- tras cambios relevantes en codigo, entorno, build o smoke, ejecuta `trackops quality verify`
-- antes de `trackops release`, ejecuta `trackops quality release-readiness`
-- antes de recomendar produccion, ejecuta `trackops quality promote-readiness --target production`
-- si la readiness esta bloqueada, no inventes excepciones: explica el bloqueo real y los pasos para resolverlo
-- solo usa waivers si existe una aprobacion humana explicita y con caducidad
-
-## Prioridad
-
-La calidad complementa OPERA; no sustituye backlog, contrato ni politica.

package/templates/skills/opera-quality-guard/locales/en/SKILL.md

@@ -1,26 +0,0 @@
----
-name: "opera-quality-guard"
-description: "Local quality guard for OPERA projects. Forces the agent to inspect quality status, run declared verification, and check readiness before release or deployment recommendations."
-metadata:
-  version: "1.0"
-  type: "project"
----
-
-# OPERA Quality Guard
-
-## Mission
-
-Complement OPERA with continuous quality and production-readiness checks.
-
-## Rules
-
-- before closing a phase, run `trackops quality status`
-- after relevant code, environment, build, or smoke changes, run `trackops quality verify`
-- before `trackops release`, run `trackops quality release-readiness`
-- before recommending production, run `trackops quality promote-readiness --target production`
-- if readiness is blocked, report the real blocker and the concrete remediation steps
-- only use waivers when there is explicit human approval and an expiry
-
-## Priority
-
-Quality complements OPERA; it does not replace backlog, contract, or policy.