trackops 2.0.6 → 2.2.0

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

@@ -0,0 +1,78 @@
+---
+name: "trackops-quality-guard"
+description: "Public TrackOps skill for inspecting quality, running declared verification, and deciding readiness before release or production recommendations."
+metadata:
+  version: "1.0"
+  type: "global"
+  triggers:
+    - "quality"
+    - "calidad"
+    - "auditar"
+    - "auditoría"
+    - "readiness"
+    - "release readiness"
+    - "production readiness"
+    - "verifica calidad"
+---
+
+# TrackOps Quality Guard
+
+Use this localized file when the conversation and project should run in English.
+
+## Mission
+
+Complement TrackOps with an explicit quality and production-readiness guard.
+
+## When to use it
+
+Use this skill when the user:
+
+- asks for a project quality audit
+- wants to know whether something is ready for release
+- wants to know whether something can go to production
+- needs a real blocker review before closing a phase or delivering
+
+## What it does not do
+
+This skill does not:
+
+- replace the `trackops quality ...` runtime
+- invent checks or criteria outside the runtime
+- soften blockers to make them look acceptable
+- 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 when there is explicit human approval
+- a waiver must have an expiration
+- a waiver does not erase evidence or turn a blocker into “nothing happened”
+
+## 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/skills/trackops-quality-guard/locales/en/references/commands.md

@@ -0,0 +1,36 @@
+# 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
+   ```
+
+## Rules
+
+- do not replace these commands with subjective judgment
+- if the user requests a specific scope, you may run `trackops quality verify --scope <scope>`
+- if the runtime fails, report the failure before drawing conclusions

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

@@ -51,6 +51,12 @@ Antes de asumir nada, ejecuta:
 trackops status
 ```
 
+Y antes de cerrar una fase, release o recomendacion de despliegue, ejecuta:
+
+```bash
+trackops quality status
+```
+
 - si `trackops status` falla, no sigas
 - si no existe TrackOps activo, redirige a la skill global `trackops`
 - si OPERA no esta instalado, indica `trackops opera install`
@@ -180,6 +186,7 @@ Alinear outputs con contrato, revisar calidad y cerrar contradicciones.
 
 ### Skills delegables
 - `opera-contract-auditor`
+- `trackops-quality-guard`
 - `opera-policy-guard`
 
 ### Bloqueo
@@ -202,9 +209,12 @@ Formalizar release, despliegue y automatizacion operativa con seguridad.
 - `trackops status`
 - `trackops workspace status`
 - `trackops env status`
+- `trackops quality release-readiness`
+- `trackops quality promote-readiness --target production`
 - `trackops sync`
 
 ### Skills delegables
+- `trackops-quality-guard`
 - `opera-policy-guard`
 
 ### Bloqueo
@@ -217,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
@@ -271,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

@@ -51,6 +51,12 @@ Before assuming anything, run:
 trackops status
 ```
 
+And before closing a phase, a release, or a deployment recommendation, run:
+
+```bash
+trackops quality status
+```
+
 - if `trackops status` fails, stop
 - if there is no active TrackOps, redirect to the global `trackops` skill
 - if OPERA is not installed, indicate `trackops opera install`
@@ -180,6 +186,7 @@ Align outputs with contract, review quality, and close contradictions.
 
 ### Delegable skills
 - `opera-contract-auditor`
+- `trackops-quality-guard`
 - `opera-policy-guard`
 
 ### Blocking
@@ -202,9 +209,12 @@ Formalize release, deployment, and operational automation with safety.
 - `trackops status`
 - `trackops workspace status`
 - `trackops env status`
+- `trackops quality release-readiness`
+- `trackops quality promote-readiness --target production`
 - `trackops sync`
 
 ### Delegable skills
+- `trackops-quality-guard`
 - `opera-policy-guard`
 
 ### Blocking
@@ -217,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
@@ -271,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`