Awesome Loop Engineering
English | 中文 | Español | Français | Deutsch | 日本語 | 한국어 | Português | Ayudar a traducir
Una lista curada y orientada a la implementación para Loop Engineering: la capa por encima de prompt, context y harness engineering para diseñar sistemas recurrentes de agentes de IA.
Prompt engineering mejora lo que le pides al modelo. Context engineering mejora lo que el modelo puede ver. Harness engineering mejora las herramientas, permisos, sandboxes y verificaciones alrededor de una ejecución de agente. Loop Engineering está por encima de las tres: diseña sistemas que activan agentes, los supervisan, verifican resultados, guardan estado y vuelven a ejecutarse.
Un loop descubre trabajo, lo delega a uno o más agentes, verifica el resultado, registra estado, decide la siguiente acción y vuelve a ejecutarse con una cadencia o hasta alcanzar un objetivo verificable.
Este repositorio se centra en el significado nuevo de Loop Engineering para agentes de IA y coding agents. No trata sobre event loops de software, teoría de control, growth loops, automatización genérica o feedback loops no relacionados con IA.
Modelo Mental
- Prompt engineering pregunta: ¿qué debería decirle al modelo?
- Context engineering pregunta: ¿qué estado y conocimiento debería ver el modelo?
- Harness engineering pregunta: ¿qué herramientas, permisos, pruebas, sandboxes y feedback deberían rodear al agente?
- Loop engineering pregunta: ¿qué sistema recurrente debería descubrir trabajo, delegarlo a agentes, verificar resultados, persistir estado, decidir siguientes acciones y volver a ejecutarse?
Prompt, context y harness engineering mejoran una ejecución. Loop Engineering hace que el trabajo de agentes sea repetible, observable y gobernable en el tiempo.
Loop Contract
Un loop útil normalmente necesita estas partes:
| Parte | Pregunta de diseño | Artefacto común |
|---|---|---|
| Objective | ¿Qué debe optimizar el loop? | Goal, issue, PRD, runbook |
| Trigger | ¿Cuándo se ejecuta? | Schedule, webhook, /loop, /goal, automation |
| Discover / Intake | ¿Cómo encuentra trabajo? | GitHub query, Linear filter, CI failure, feedback stream |
| Workspace | ¿Dónde puede actuar el agente con cuidado? | Worktree, sandbox, branch, container |
| Context | ¿Qué conocimiento durable debe cargar? | AGENTS.md, CLAUDE.md, SKILL.md, docs |
| Delegation | ¿Qué agente hace cada parte? | Explorer, implementer, reviewer, judge |
| Verification | ¿Qué decide éxito o fallo? | Tests, typecheck, lint, evals, trace graders |
| State | ¿Qué sobrevive a la siguiente iteración? | Progress file, checkpoint, trace, issue comment |
| Budget | ¿Cuándo debe dejar de gastar? | Max turns, max retries, token budget, time box |
| Escalation | ¿Cuándo interviene una persona? | PR, issue, Slack alert, triage inbox |
| Exit | ¿Cómo sabe que terminó? | Acceptance criteria, passing checks, no work found |
Modelo de Madurez
| Nivel | Nombre | Descripción |
|---|---|---|
| 0 | Manual prompting | Una persona lee el estado y escribe el siguiente prompt. |
| 1 | Scripted retry | Un script devuelve errores al agente. |
| 2 | Scheduled loop | El agente corre con una cadencia y reporta resultados. |
| 3 | Stateful loop | El progreso sobrevive mediante archivos, issues, checkpoints o traces. |
| 4 | Self-verifying loop | Verificaciones deterministas o evaluadores bloquean un cierre incorrecto. |
| 5 | Multi-agent loop | Agentes especializados dividen descubrimiento, implementación, revisión y juicio. |
| 6 | Production-supervised loop | Observabilidad, presupuestos, aprobaciones, rollback y escalación humana son centrales. |
Por Dónde Empezar
La lista completa de recursos vive en el README canónico en inglés: README.md.
Recursos iniciales recomendados:
- Loop Engineering - Definición directa del cambio desde prompting manual hacia sistemas que prompt, verifican y continúan.
- Run long horizon tasks with Codex - Guía práctica para ciclos plan-edit-test-observe-repair-document-repeat.
- Run prompts on a schedule - Mecánica oficial para
/loop, tareas programadas y prompts recurrentes. - Building Effective Agents - Patrones composables para workflows y agentes.
Contribuir
Las contribuciones son bienvenidas. Lee CONTRIBUTING.md antes de abrir un pull request.
Proceso rápido:
- Confirma que el recurso trata de Loop Engineering para agentes de IA/coding agents o de una base directa para ello.
- Busca en el README para evitar duplicados.
- Elige la categoría más específica.
- Añade una entrada con este formato:
- 📄 **Paper** [Title](https://example.com) - One sentence explaining the resource's contribution to Loop Engineering.
- Explica en el PR la relevancia, la categoría, el tipo de recurso y por qué ayuda a builders.
Traducciones
Para mantener o añadir un idioma, lee TRANSLATIONS.md. Las traducciones deben conservar el alcance estrecho: no mezclar event loops, growth loops ni automatización genérica.