Deja de Preguntar a los Agentes: Diseña Bucles que Orquesten Agentes de Codificación de IA
Pasa de las indicaciones manuales a diseñar sistemas de bucle que orquesten agentes de codificación de IA. Explora patrones, herramientas CLI y un inicio rápido de 5 minutos.
Por Qué es Importante la Ingeniería de Bucles
Peter Steinberger capturó el cambio perfectamente: "Ya no deberías estar dando indicaciones a los agentes de codificación. Deberías estar diseñando bucles que den indicaciones a tus agentes." Boris Cherny, jefe de Claude Code en Anthropic, se hace eco de esto: "Ya no le doy indicaciones a Claude. Tengo bucles ejecutándose que le dan indicaciones a Claude y deciden qué hacer. Mi trabajo es escribir bucles."
El punto de apalancamiento ha pasado de elaborar indicaciones individuales a diseñar los sistemas de control que orquestan agentes a lo largo del tiempo. Esta es la idea central detrás de la ingeniería de bucles — una metodología práctica para construir flujos de trabajo automatizados impulsados por agentes.
¿Qué es la Ingeniería de Bucles?
La ingeniería de bucles te reemplaza a ti como la persona que da indicaciones manualmente a un agente. En su lugar, diseñas un sistema — un bucle — que lo hace por ti. Este sistema programa tareas, gestiona el estado, ejecuta en entornos aislados y bloquea acciones arriesgadas detrás de la aprobación humana.
El repositorio de referencia, cobusgreyling/loop-engineering, proporciona patrones prácticos, herramientas CLI y puntos de partida para implementar este enfoque con agentes de codificación de IA como Grok, Claude Code, Codex, Cursor y OpenClaw.
Los Cinco Bloques de Construcción + Memoria
Cada bucle se compone de cinco primitivas más una capa de memoria/estado:
| Primitiva | Trabajo en el Bucle |
|---|---|
| Automatizaciones / Programación | Descubrimiento + clasificación en un ritmo |
| Árboles de trabajo | Ejecución paralela segura |
| Habilidades | Conocimiento persistente del proyecto |
| Plugins y Conectores | Acceso a tus herramientas reales (MCP) |
| Subagentes | División creador/verificador |
| + Memoria / Estado | Columna vertebral duradera fuera de cualquier conversación |
Estas primitivas forman la anatomía de un bucle:
flowchart LR
A[Programación / Automatización] --> B[Habilidad de Clasificación]
B --> C[Leer + Escribir ESTADO / Memoria]
C --> D[Árbol de Trabajo Aislado]
D --> E[Subagente Implementador]
E --> F[Subagente Verificador<br/>pruebas + compuertas]
F --> G[MCP / Git / Tickets]
G --> H{¿Compuerta Humana?}
H -->|seguro / en lista blanca| I[Commit / PR / Acción]
H -->|arriesgado / ambiguo| J[Escalar a humano<br/>con contexto completo]
I --> A
J --> A
Patrones de Producción
El repositorio incluye siete patrones de bucle listos para producción, cada uno con un ritmo definido, plantilla de inicio y costo estimado de tokens:
| Patrón | Ritmo | Costo de Tokens |
|---|---|---|
| Clasificación Diaria | 1d–2h | Bajo |
| Niñera de PR | 5–15m | Alto |
| Limpiador de CI | 5–15m | Muy alto |
| Limpiador de Dependencias | 6h–1d | Medio |
| Redactor de Registro de Cambios | 1d o etiqueta | Bajo |
| Limpieza Post-Fusión | 1d–6h | Bajo |
| Clasificación de Issues | 2h–1d | Bajo |
¿No estás seguro de cuál elegir? Usa el selector interactivo de patrones o consulta patterns/registry.yaml.
Herramientas CLI: Comienza en 5 Minutos
El repositorio incluye varias herramientas CLI publicadas en npm:
- loop-init: Crea estructuras iniciales + presupuesto/registro de ejecución + restricciones
- loop-audit: CLI de Puntuación de Preparación del Bucle (v1.5 + puntuación de restricciones)
- loop-cost: Estimador de gasto de tokens
- loop-sync: Detección de desviaciones entre STATE.md y LOOP.md
- loop-context: Gestor de memoria con estado + interruptor de circuito para ejecuciones largas
- loop-mcp-server: Búsqueda en tiempo de ejecución de MCP para patrones, habilidades, estado
Inicio Rápido
# 1. Crea estructura + obtén tu puntuación de Preparación del Bucle (impresa automáticamente)
npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok
# 2. Estima el gasto de tokens para tu ritmo
npx @cobusgreyling/loop-cost --pattern daily-triage --level L1
# 3. Re-audita después de mejoras
npx @cobusgreyling/loop-audit . --suggest
# Opcional: pega la insignia de Preparación del Bucle en tu README
npx @cobusgreyling/loop-audit . --badge
# 4. Ve cómo suben las puntuaciones: vacío → L1 → L2
bash scripts/before-after-demo.sh
# 5. Comienza solo con informe (ejemplo con Grok)
/loop 1d Ejecutar loop-triage. Actualizar STATE.md. Sin corrección automática en la primera semana.
Todas las CLI se publican en npm desde versiones etiquetadas — no se requiere clonación.
Operación y Seguridad
La ingeniería de bucles amplifica el juicio — tanto bueno como malo. Advertencias clave:
- Los costos de tokens pueden explotar con subagentes y bucles de larga duración.
- La verificación sigue siendo tu responsabilidad. Los bucles desatendidos cometen errores desatendidos.
- La deuda de comprensión crece más rápido a menos que leas lo que el bucle produce.
- Dos personas pueden ejecutar el mismo bucle y obtener resultados opuestos. El bucle no lo sabe. Tú sí.
Como dice Addy Osmani: "Construye el bucle. Pero constrúyelo como alguien que pretende seguir siendo el ingeniero, no solo la persona que presiona el botón de inicio."
El repositorio incluye documentación detallada sobre modos de fallo, antipatrones, coordinación de múltiples bucles y seguridad (lista negra, fusión automática, ámbitos de MCP).
Contribuciones
El proyecto acepta contribuciones, especialmente historias de fallos y patrones de producción. Consulta CONTRIBUTING.md para la escalera de contribuciones y la lista de issues iniciales.
Conclusión
La ingeniería de bucles es un cambio de paradigma para los desarrolladores que trabajan con agentes de codificación de IA. En lugar de dar indicaciones manualmente, diseñas sistemas que orquestan agentes a lo largo del tiempo — con programación, gestión de estado, compuertas de seguridad y conciencia de costos. Las herramientas y patrones en este repositorio te brindan un punto de partida práctico para implementar este enfoque hoy.