How-To OPS

Esta seccion explica como operar OPS paso a paso. No es una referencia tecnica completa; es una guia practica para saber que hacer, en que orden hacerlo y por que ese orden evita errores.

La idea base es sencilla: OPS funciona mejor cuando el trabajo queda trazable desde el principio. Cada tarea deberia saber a que workspace pertenece, en que proyecto vive, quien o que la ejecuta, que credenciales necesita, cuando debe detenerse y como se verifica el resultado.

Para quien es esta seccion

Usa estas guias si:

entras por primera vez al sistema;
necesitas explicar OPS a otra persona;
vas a preparar un workspace o proyecto nuevo;
quieres crear tareas, flujos o recurrentes sin improvisar;
necesitas revisar por que una automatizacion no hizo lo esperado;
quieres mantener el sistema simple, robusto y predecible.

Orden recomendado

El orden recomendado es:

Por que este orden

El orden no es burocracia. Evita que el sistema se llene de trabajo dificil de auditar:

Si no hay workspace claro, no hay aislamiento ni permisos claros.
Si no hay proyecto, las tareas y horas quedan sin contexto.
Si no hay credenciales verificadas, dispatch puede crear bloqueos falsos.
Si no hay perfiles y skills revisados, el agente puede ejecutar con criterios incorrectos.
Si no hay plan, las tareas se vuelven una lista suelta sin direccion.
Si no hay criterios de terminado, se cierran cosas sin evidencia.
Si no hay revision diaria, los errores pequenos se convierten en ruido operativo.

Modelo mental

Piensa en OPS como una cadena:

workspace -> proyecto -> plan -> tareas -> ejecucion -> evidencia -> tiempo -> cierre

Las automatizaciones y flujos no sustituyen esa cadena. Solo ayudan a repetirla con menos friccion.

Regla de oro

Cada vez que crees o edites algo, deberias poder responder:

Que problema resuelve?
A que proyecto pertenece?
Quien lo ejecuta: humano, asistente, perfil IA o runtime automatico?
Que necesita para empezar?
Cuando debe parar y pedir decision?
Como se comprueba que esta bien?
Donde queda registrada la evidencia?

Si una de esas respuestas no esta clara, conviene dejar la tarea en waiting o review, no cerrarla.

Diferencia entre piezas

Workspace: contenedor aislado de clientes, proyectos, permisos y configuracion.
Proyecto: unidad de trabajo medible, con tareas, horas, plan y documentacion.
Tarea: unidad minima ejecutable y cerrable.
Perfil/Subagente: rol operativo especializado, por ejemplo auditor, frontend, reviewer o planner.
Skill: procedimiento o conocimiento reusable que mejora como trabaja un perfil.
Runtime: herramienta o proveedor que ejecuta trabajo IA, por ejemplo OpenCode o MiniMax.
Credencial: secreto controlado que permite usar un runtime, proveedor o despliegue.
Flujo: receta reutilizable para crear trabajo de forma consistente.
Recurrente: plantilla que genera trabajo en una fecha o frecuencia.
Dispatch: mecanismo que reclama tareas en cola y las entrega a workers/agentes.

Como usar estas guias

No hace falta leer todo de golpe. Usa la guia que corresponde al momento:

Si estas empezando, lee Arranque desde cero.
Si vas a preparar un cliente o producto, lee Workspace y proyecto.
Si una IA no ejecuta, lee Credenciales y runtimes.
Si no sabes que credencial crear, lee Recetas de credenciales.
Si no sabes que tareas crear, lee Plan de proyecto.
Si quieres revisar o crear proyectos con IA, lee Asistente de proyecto.
Si tienes un backlog externo y runner local, lee Importar un plan y preparar ejecucion local.
Si quieres automatizar algo diario, lee Tareas recurrentes.
Si el sistema se desordena, lee Verificacion diaria y Editar y mantener.

Resultado esperado

Al aplicar esta seccion, OPS deberia sentirse menos como un panel con muchas opciones y mas como un sistema operativo de trabajo:

sabes por donde empezar;
sabes que revisar antes de ejecutar;
sabes que no debe hacerse automaticamente;
sabes como dejar trazabilidad;
sabes como recuperar el contexto cuando algo falla.