Communitygithub.com

Loop Goal Runner

Convierte tareas abiertas en bucles con estado utilizando STATE.md, compuertas objetivas y reglas de parada para agentes de IA.

¿Qué es Loop Goal Runner?

Loop Goal Runner es una habilidad para agentes de IA (como Codex, Claude Code, Cursor) que transforma tareas abiertas en bucles ejecutables con estado persistente. Su propósito es garantizar que cada tarea tenga un objetivo claro, una compuerta objetiva (pruebas, lint, compilación, etc.), un archivo de estado STATE.md, y una regla de parada explícita. La habilidad guía al agente a través de un flujo de trabajo estructurado: primero verifica si la tarea es adecuada para un bucle, luego localiza o crea el archivo de estado correcto, define un objetivo medible, ejecuta una iteración del bucle, y decide si continuar, detenerse o escalar. Soporta subagentes y worktrees solo cuando la tarea lo justifica, manteniendo la simplicidad por defecto. Es especialmente útil para tareas repetitivas o de larga duración donde el estado y la verificación continua son críticos.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add AgentPilotLab/loop-goal-runner

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Loop Goal Runner (Ejecutor de Bucles con Objetivo)

Usa esta habilidad para convertir una tarea abierta de Codex en un bucle pequeño y con estado. El bucle debe tener un objetivo claro, estado duradero, una compuerta objetiva y una regla de parada. Mantén la ruta predeterminada ligera; añade subagentes o worktrees solo cuando la tarea justifique el costo extra.

Contrato Principal

Cada ejecución de bucle debe mantener estos cuatro artefactos o decisiones:

  1. Objetivo: el objetivo actual del usuario y los criterios de finalización.
  2. Estado: un archivo STATE.md duradero o un sistema de estado externo explícitamente nombrado.
  3. Compuerta: pruebas, lint, comprobaciones de tipos, compilación, validación de datos, comprobaciones de capturas de pantalla u otro comando de prueba objetivo.
  4. Regla de parada: éxito, bloqueador, intentos máximos, tiempo de ejecución máximo, límite de presupuesto o límite de aprobación humana.

No declares finalización sin evidencia de verificación reciente. Si no hay una compuerta objetiva, mantén el trabajo en modo asesor/manual y di que no es un buen candidato para bucle.

Flujo de Trabajo

1. Ejecutar la Verificación de Idoneidad del Bucle

Antes de construir o continuar un bucle, verifica si la tarea es adecuada:

  • Se repite al menos semanalmente, o es lo suficientemente larga como para que el estado persistente sea importante.
  • Tiene una compuerta objetiva que pueda rechazar resultados incorrectos.
  • Puede ejecutarse en el entorno disponible.
  • Tiene una condición de parada dura.
  • No requiere juicio no supervisado para arquitectura, autenticación, pagos, despliegues en producción o acciones irreversibles.

Si una de estas falla, explica la condición fallida y utiliza un flujo de trabajo único normal a menos que el usuario solicite explícitamente continuar.

2. Localizar o Crear Estado

Trata el estado como limitado al objetivo por defecto. Cada objetivo distinto debe tener su propio archivo de estado duradero a menos que el usuario solicite explícitamente reutilizar un archivo de estado existente o el archivo existente pertenezca claramente al mismo objetivo activo.

Precedencia de la ruta del estado:

  1. Usa la ruta exacta del archivo de estado nombrada por el usuario, si la hay.
  2. Si se continúa un objetivo existente y se conoce su ruta de estado anterior, reutiliza ese mismo archivo.
  3. Si el objetivo crea o modifica principalmente un repositorio de tareas o directorio de artefactos, usa el STATE.md raíz de esa tarea.
  4. De lo contrario, crea un archivo específico para el objetivo en .codex/goals/<slug-del-objetivo>/STATE.md en el espacio de trabajo actual.
  5. Usa el STATE.md raíz del espacio de trabajo solo cuando el espacio de trabajo en sí es el objetivo, o cuando el usuario lo selecciona explícitamente.

Antes de reutilizar cualquier STATE.md existente, inspecciona sus secciones de Objetivo y Estado Actual. Si describen un objetivo diferente, no lo sobrescribas ni lo reutilices. Crea un nuevo archivo de estado limitado al objetivo y menciona brevemente la separación.

Si el archivo de estado seleccionado no existe y se permiten ediciones de archivo, créalo a partir de references/state-template.md. Si no se permiten ediciones, redacta el estado inicial en la respuesta y pídele al usuario que lo coloque.

Al inicio de cada ejecución de bucle:

  • Lee el archivo de estado seleccionado y limitado al objetivo antes de planificar.
  • Lee el AGENTS.md aplicable más cercano o las instrucciones equivalentes del proyecto cuando estén disponibles.
  • Extrae la última ejecución, el estado actual, los bloqueadores abiertos, las próximas acciones, el historial de verificación, las lecciones aprendidas y la ruta del archivo de estado.

Al final de cada ejecución de bucle:

  • Actualiza solo el archivo de estado seleccionado y limitado al objetivo con las acciones reales realizadas.
  • Registra los comandos de verificación y sus resultados.
  • Registra la próxima acción o la razón de la parada.
  • Conserva las lecciones que deban sobrevivir a la compactación o futuras ejecuciones.
  • No muevas, archivos ni reescribas el estado de un objetivo no relacionado a menos que el usuario lo solicite explícitamente.

3. Dar Forma al Objetivo

Para el modo Objetivo de Codex, escribe el objetivo de manera que sea medible:

/goal <objetivo>. Hecho cuando: <la compuerta objetiva pasa>. Restricciones: actualizar el archivo de estado seleccionado y limitado al objetivo cada ejecución; detenerse después de <N> intentos fallidos o cuando se necesite juicio humano.

Si un objetivo ya está activo, usa el objetivo actual como fuente de verdad a menos que el usuario lo cambie. Si no hay ningún objetivo activo, infiere un objetivo de trabajo a partir de la solicitud del usuario y establécelo brevemente.

4. Ejecutar una Iteración del Bucle

Usa esta forma de iteración:

  1. Leer el estado y las instrucciones.
  2. Elegir la siguiente acción útil más pequeña.
  3. Ejecutar la acción.
  4. Ejecutar la compuerta relevante o explicar por qué no puede ejecutarse.
  5. Revisar el diff o la salida.
  6. Actualizar el archivo de estado seleccionado y limitado al objetivo.
  7. Decidir continuar, detener o escalar.

Mantén los cambios acotados. Prefiere una ejecución manual confiable antes de programar la automatización.

5. Decidir si Usar Subagentes

Por defecto, usa un solo agente. Usa subagentes solo cuando se aplique al menos una de las siguientes condiciones:

  • Las investigaciones independientes pueden ejecutarse en paralelo.
  • Una división creador/verificador reduciría materialmente el riesgo.
  • La tarea tiene varias fallas, subsistemas o documentos no relacionados.
  • El usuario solicita explícitamente agentes en paralelo o subagentes.

Al usar subagentes, aplica estos patrones:

  • Creador/verificador: un agente implementa o investiga, otro revisa el cumplimiento de la especificación y la calidad del código.
  • Despacho en paralelo: un agente por dominio problemático independiente.
  • Verificador: un agente nuevo revisa la evidencia, no el razonamiento oculto.

No trates la opinión de un subagente como una compuerta estricta. La verificación objetiva sigue siendo la que prevalece.

6. Decidir si Usar Worktrees

Usa worktrees para cambios de código cuando múltiples agentes o ramas de larga duración puedan escribir concurrentemente. Omite los worktrees para investigación de solo lectura, análisis de documentos, ediciones pequeñas de un solo archivo o espacios de trabajo que no son repositorios.

Si se necesitan worktrees, prefiere el soporte de worktree nativo de Codex cuando esté disponible. De lo contrario, usa worktrees de Git solo después de confirmar el repositorio de destino y asegurarte de que el directorio del worktree no se confirmará accidentalmente.

7. Finalización y Escalado

Detente e informa claramente cuando:

  • La compuerta pase y se cumplan los criterios del objetivo.
  • Se alcance el límite de intentos máximos, tiempo de ejecución o presupuesto.
  • Se necesiten permisos, credenciales, servicios externos o juicio humano.
  • El mismo bloqueador se repita en tres vueltas consecutivas del bucle.
  • El bucle necesite tocar arquitectura, autenticación, pagos, despliegues en producción, secretos o permisos amplios sin aprobación humana explícita.

La respuesta final debe incluir el estado actual, la evidencia de verificación y la próxima acción recomendada.

Fiabilidad del Disparo

El disparo de la habilidad se basa en la descripción. Para que esta habilidad se ejecute automáticamente con el uso futuro del modo Objetivo, añade el fragmento en references/agents-snippet.md a un AGENTS.md global o del proyecto.

Referencias

  • references/state-template.md: plantilla para nuevos archivos STATE.md.
  • references/agents-snippet.md: instrucción duradera opcional para hacer que Codex invoque esta habilidad cada vez que el usuario inicie o discuta un objetivo.

Skills relacionados