Español

Qué es TrackOps

TrackOps es una capa local de control para trabajar con agentes de IA sin perder el gobierno del proyecto.

No sustituye tu producto. Ordena el trabajo que ocurre alrededor del producto:

• define una fuente de verdad operativa dentro del repo
• separa producto y operaciones para que no se mezclen
• da contexto persistente a los agentes entre sesiones
• expone estado, tareas, Quality Guard, readiness y release desde CLI y dashboard

Si quieres ir más allá, puedes instalar OPERA, la metodología opcional que añade discovery, contrato operativo, readiness y un equipo coordinado de especialistas.

Cómo funciona

TrackOps trabaja en tres capas:

1. skill global prepara al agente con instrucciones comunes
2. runtime global instala la CLI real de forma explícita con npm
3. activación local por repo crea el workspace operativo dentro del proyecto

La separación es deliberada:

• la skill sigue siendo auditable como capa de instrucciones
• la instalación del runtime queda visible y controlada por el usuario
• cada repositorio se activa de forma explícita, no por magia

Instalación recomendada

npx skills add Baxahaun/trackops --skill trackops --agent "*" --global -y
npm install -g trackops@latest
trackops --version

Si el idioma global no queda fijado durante la instalación:

trackops locale set es
trackops locale set en

Activar un proyecto

cd ruta/a/tu/proyecto
trackops init

trackops init activa el control local del repo. Funciona sobre proyectos nuevos, repos existentes y workspaces ya activados.

Si quieres el framework operativo completo:

trackops opera install

Qué añade OPERA

OPERA no es obligatoria. Se instala cuando quieres que el proyecto siga un protocolo operativo más estricto.

Con OPERA obtienes:

• bootstrap guiado según el nivel técnico del usuario y el estado del proyecto
• handoff al agente cuando todavía no hay especificación suficiente
• contrato operativo compilado
• fases O.P.E.R.A. para discovery, validación, construcción, refinado y automatización
• equipo de agentes especializados coordinados por opera-skill

Flujo completo

npx skills add Baxahaun/trackops --skill trackops --agent "*" --global -y
npm install -g trackops@latest
trackops --version
cd ruta/a/tu/proyecto
trackops init
trackops opera install

Si OPERA deriva el arranque al agente:

trackops opera handoff --print
trackops opera bootstrap --resume

Si el proyecto ya está suficientemente definido, OPERA entra por bootstrap directo y continúa sin handoff.

Lo que TrackOps gestiona

En un workspace split, la estructura base queda así:

.trackops-workspace.json
.env
.env.example
app/
ops/project_control.json
ops/task_plan.md
ops/progress.md
ops/findings.md

Con OPERA instalado se añaden, entre otros:

ops/bootstrap/
ops/contract/operating-contract.json
ops/genesis.md
ops/policy/autonomy.json
ops/.agents/skills/

La fuente de verdad operativa vive en ops/project_control.json.

Trabajo diario

trackops status
trackops next
trackops task start <id>
trackops sync
trackops dashboard
trackops quality status

Si quieres una skill pública centrada en esta capa de auditoría, verificación y readiness:

npx skills add Baxahaun/trackops --skill trackops-quality-guard --agent "*" --global -y

Para release:

trackops quality verify --scope all
trackops quality release-readiness --json
npm run release:check

trackops release publica solo app/. Nunca publica ops/, /.env ni .trackops-workspace.json.

Documentación

• guía completa: UserGUIDE.md
• web pública: https://baxahaun.github.io/trackops/
• paquete npm: https://www.npmjs.com/package/trackops

English

What TrackOps is

TrackOps is a local control layer for working with AI agents without losing control of the project.

It does not replace your product. It organizes the work around the product:

• defines an operational source of truth inside the repository
• keeps product and operations separate
• gives agents persistent context across sessions
• exposes status, tasks, Quality Guard, readiness, and release state through CLI and dashboard

If you need a stricter operating model, you can install OPERA, the optional methodology that adds discovery, an operating contract, readiness checks, and a coordinated team of specialists.

How it works

TrackOps works in three layers:

1. global skill prepares the agent with shared instructions
2. global runtime installs the actual CLI explicitly with npm
3. local per-repo activation creates the operational workspace inside the project

That split is intentional:

• the skill remains auditable as an instruction layer
• runtime installation stays visible and user-controlled
• each repository is activated explicitly

Recommended install

npx skills add Baxahaun/trackops --skill trackops --agent "*" --global -y
npm install -g trackops@latest
trackops --version

If the global language was not set during install:

trackops locale set es
trackops locale set en

Activate a project

cd path/to/your/project
trackops init

trackops init activates local control in the repository. It works on new projects, existing repositories, and already initialized workspaces.

If you want the full operating framework:

trackops opera install

What OPERA adds

OPERA is optional. Install it when you want the project to follow a stricter operating protocol.

With OPERA you get:

• guided bootstrap based on user profile and project state
• agent handoff when the project is still underdefined
• compiled operating contract
• O.P.E.R.A. phases for discovery, validation, build, refinement, and automation
• a team of specialized agents coordinated by opera-skill

Full flow

npx skills add Baxahaun/trackops --skill trackops --agent "*" --global -y
npm install -g trackops@latest
trackops --version
cd path/to/your/project
trackops init
trackops opera install

If OPERA routes discovery to the agent:

trackops opera handoff --print
trackops opera bootstrap --resume

If the project is already defined enough, OPERA continues through direct bootstrap with no handoff.

What TrackOps manages

In a split workspace, the base structure looks like this:

.trackops-workspace.json
.env
.env.example
app/
ops/project_control.json
ops/task_plan.md
ops/progress.md
ops/findings.md

With OPERA installed, TrackOps also adds items such as:

ops/bootstrap/
ops/contract/operating-contract.json
ops/genesis.md
ops/policy/autonomy.json
ops/.agents/skills/

The operational source of truth lives in ops/project_control.json.

Day-to-day work

trackops status
trackops next
trackops task start <id>
trackops sync
trackops dashboard
trackops quality status

If you want a public skill focused on this audit, verification, and readiness layer:

npx skills add Baxahaun/trackops --skill trackops-quality-guard --agent "*" --global -y

For release:

trackops quality verify --scope all
trackops quality release-readiness --json
npm run release:check

trackops release publishes only app/. It never publishes ops/, /.env, or .trackops-workspace.json.

Documentation

• full guide: UserGUIDE.md
• public site: https://baxahaun.github.io/trackops/
• npm package: https://www.npmjs.com/package/trackops