TrackOps

locales/en/SKILL.md

• 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

• 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

• 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

npx skills add Baxahaun/trackops

trackops

npm install -g trackops
trackops --version

• 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

trackops init
trackops opera install

• 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

• nivel tecnico del usuario
• estado actual del proyecto
• documentacion disponible

• direct bootstrap

  para usuarios tecnicos y repos ya definidos

• agent handoff

  para ideas tempranas, usuarios no tecnicos o documentacion debil

ops/.agents/skills/

opera-skill

• 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:

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.