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
-
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. -
Detectar reanudación vs nueva. Escanea
.easy-loop/runs/*/state.json(con raíz en la raíz del repositorio) en busca destatus: runningoawaiting_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). -
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## Limitsdel 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 markdownreport.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ícitamentecontract.md. -
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, escribespec.md(objetivo + aceptación + esa base), copia elcontract.mdaprobado, escribe elstate.jsoninicial (iteration: 1,phase: "generate",best_score: -1,status: "running") y unlog.jsonlvacío. Hecho cuando el directorio de ejecución coincide con esa estructura ystate.jsoncontiene esos valores iniciales. -
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 aguideline.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. -
Enrutar el resultado del ejecutor. Tras la notificación de finalización, lee
state.jsony actúa segúnstatus:done→ reporta éxito (contrato cumplido).awaiting_approval→ muestra el hallazgo/operación pendiente dereport.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.
-
Reanudar una ejecución. Lee el
state.jsonde la ejecución. Siawaiting_approval→ ve al paso 5. Sirunning→ concilia contralog.jsonly continúa desde la siguiente fase segúnreferences/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.