trackops

Original：🇺🇸 English
Translated

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.

3installs
Sourcebaxahaun/trackops
Added on

NPX Install

npx skill4agent add baxahaun/trackops trackops

Tags

Translated version includes tags in frontmatter
trackopsopera-frameworkai-agent-developmentruntime-installationrepository-activation

SKILL.md Content

View Translation Comparison →

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.