Communitygithub.com

tundergod/easy-loop

Ejecuta un bucle de agente tipo Karpathy (planificador/generador/evaluador) en tu repositorio: un gestor negocia un contrato comprobable y luego impulsa un ejecutor de fondo reanudable.

¿Qué es easy-loop?

Easy Loop implementa un patrón de agente de tres roles (gestor, planificador, generador, evaluador) para tareas de desarrollo de larga duración que requieren iteración y verificación independiente. El gestor negocia un contrato comprobable con el usuario, lanza un ejecutor de fondo que itera planificación → generación → evaluación hasta que se cumple el contrato o se necesita intervención humana. El estado se almacena en disco, no en contexto: el bucle sobrevive a fallos o sesiones cerradas porque cada ejecución es reconstruible desde su directorio de ejecución. Soporta reanudación automática, escalado de aprobaciones, límites configurables y generación de informes en markdown o HTML con gráficos. Ideal para tareas que involucran múltiples archivos, evaluación independiente, compuertas de aprobación o reanudación necesaria.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add tundergod/easy-loop

Preguntar en tu IA favorita

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

Documentación

Bucle Fácil

/easy-loop convierte esta sesión en el gestor: negocia un contrato comprobable con el usuario, lanza un ejecutor de fondo que itera planificador → generador → evaluador contra ese contrato, y regresa al usuario solo cuando el contrato se cumple o algo necesita a un humano. Tú eres el gestor — sigue references/role-manager.md.

Dos roles, y no se pueden fusionar — uno habla con el usuario, el otro ejecuta de forma desacoplada:

  • gestor — esta sesión principal. Orientado al usuario: contrato, aprobaciones, lanzamiento, reanudación. Nunca escribe código de aplicación.
  • ejecutor — un subagente de fondo. Impulsa iteraciones, genera un nuevo planificador/generador/evaluador cada ronda, escribe el estado en disco y se detiene cuando necesita a un humano. Nunca habla con el usuario.

El estado reside en disco, no en contexto: el bucle sobrevive a un fallo o una sesión cerrada porque cada ejecución es reconstruible desde su directorio de ejecución. Consulta references/loop-protocol.md para la estructura del directorio de ejecución, esquema de estado, trinquete/reversión, enrutamiento de estado y reglas de reanudación — confías en él en los pasos 1 y 3–6.

Cada subagente que lanzas comienza con contexto vacío. Inyecta lo que necesita en su indicación: guideline.md (disciplina compartida), el references/role-*.md correspondiente y las rutas de archivo del directorio de ejecución. El código de la aplicación se edita en el repositorio según las rutas permitidas del contrato; la contabilidad del bucle permanece en el directorio de ejecución — no se escribe nada más en el repositorio.

Flujo de trabajo

  1. Admisión. Confirma que la tarea es digna de bucle según references/role-manager.md (larga duración, múltiples archivos, necesita evaluación independiente, tiene compuertas de aprobación o debe reanudarse). Si no, hazlo directamente y detente. Hecho cuando la tarea se confirma como digna de bucle.

  2. Detectar reanudación vs nueva. Escanea .easy-loop/runs/*/state.json (con raíz en la raíz del repositorio) en busca de status: running o awaiting_approval. Hecho cuando sabes si estás reanudando una ejecución existente (toma el último run-id → paso 6) o iniciando una nueva (→ paso 2).

  3. Negociar el contrato. Toma el objetivo del usuario. Lanza un planificador para redactar contract.md (una lista de verificación de aserciones comprobables, apunta a 10–30) en una ruta provisional, luego un evaluador en modo plan para criticarlo, luego el planificador una vez más para revisarlo — una ronda, luego preséntalo. Acuerda los límites por ejecución con el usuario (max_iterations, no_progress_rounds, contract_invalid_rounds, operaciones prohibidas) y regístralos en ## Limits del contrato. Al presentar el contrato, señala que los niveles de modelo (## Models) están desactivados por defecto y se pueden activar para controlar el costo; si el usuario lo desea, registra los niveles por rol. También pregunta qué presentación de informe quieren — por defecto es solo markdown report.md, opcionalmente HTML con gráficos — y regístralo en ## Report. Hecho cuando la crítica del evaluador en modo plan se aborda y el usuario aprueba explícitamente contract.md.

  4. Crear el directorio de ejecución. Constrúyelo según references/loop-protocol.md: ejecuta la verificación una vez para capturar el resultado base, escribe spec.md (objetivo + aceptación + esa base), copia el contract.md aprobado, escribe el state.json inicial (iteration: 1, phase: "generate", best_score: -1, status: "running") y un log.jsonl vacío. Hecho cuando el directorio de ejecución coincide con esa estructura y state.json contiene esos valores iniciales.

  5. Lanzar el ejecutor en segundo plano. Lanza el ejecutor con la herramienta Agente usando run_in_background: true, pasando el sobre de entrega (ruta de ejecución, ruta del contrato, operaciones permitidas/prohibidas, límites y punteros a guideline.md + references/role-*.md). El arnés notifica a esta sesión cuando el ejecutor regresa. Dile al usuario que el bucle se está ejecutando y que solo regresarás al completarse o escalar. Hecho cuando el ejecutor en segundo plano se lanza con un sobre completo.

  6. Enrutar el resultado del ejecutor. Tras la notificación de finalización, lee state.json y actúa según status:

    • done → reporta éxito (contrato cumplido).
    • awaiting_approval → muestra el hallazgo/operación pendiente de report.md, obtén una decisión, regístrala, luego relanza (paso 4) con el contrato o aprobación actualizados. Si el escalado es una solicitud de revisión del contrato (CONTRACT_INVALID), vuelve a ejecutar el paso 2 (planificador → aprobación) primero. No está hecho hasta que se relanza o el usuario finaliza la ejecución.
    • failed → reporta el bloqueador y pregunta cómo proceder. Hecho cuando el usuario tiene el resultado y la ejecución está relanzada o finalizada explícitamente.
  7. Reanudar una ejecución. Lee el state.json de la ejecución. Si awaiting_approval → ve al paso 5. Si running → concilia contra log.jsonl y continúa desde la siguiente fase según references/loop-protocol.md, luego relanza el ejecutor (paso 4). Hecho cuando el bucle está funcionando de nuevo o se entrega al usuario.

Escalado

El ejecutor funciona sin intervención y se detiene para un humano solo con los disparadores en references/loop-protocol.md. La finalización es evaluador PASAJE en la lista de verificación de aceptación completa. Cualquier otra cosa, itera sin interrumpir al usuario.

Política de aprobación

Las operaciones con compuerta de aprobación son la lista canónica en references/loop-protocol.md. Un contrato aprobado no las anula — siguen siendo interrupciones que el ejecutor escala a través del gestor.

Skills relacionados