Ingeniería de Bucles: Diseña Sistemas que Guíen a tus Agentes de Codificación de IA
Deja de guiar manualmente a los agentes de IA. Aprende a diseñar bucles que orquesten agentes con patrones, herramientas CLI y memoria para automatización de nivel de producción.
Ingeniería de Bucles: Diseña Sistemas que Guíen a tus Agentes de Codificación de IA
Si todavía estás escribiendo indicaciones manualmente en Claude Code, Grok o Codex, estás dejando apalancamiento sobre la mesa. La próxima evolución del desarrollo asistido por IA no son mejores indicaciones, sino diseñar bucles que guíen a los agentes por ti.
Como dice Peter Steinberger: "Ya no deberías estar guiando a los agentes de codificación. Deberías estar diseñando bucles que guíen a tus agentes." Boris Cherny, Jefe de Claude Code en Anthropic, lo repite: "Ya no guío a Claude. Tengo bucles ejecutándose que guían a Claude y deciden qué hacer. Mi trabajo es escribir bucles."
Esta es la idea central detrás de la Ingeniería de Bucles, un repositorio de referencia práctica de Cobus Greyling que proporciona patrones, iniciadores y herramientas CLI para construir sistemas de orquestación de agentes. Está inspirado en el trabajo de Addy Osmani sobre el tema y está diseñado para desarrolladores que usan Grok, Claude Code, Codex, Cursor y otros agentes de codificación de IA.
Por Qué Esto Importa
El punto de apalancamiento ha cambiado. En lugar de crear indicaciones individuales, ahora diseñas sistemas de control que orquestan agentes a lo largo del tiempo. Esto significa:
- Automatización en un ritmo: Los agentes se ejecutan en horarios (cada hora, diariamente, en PR) sin que estés presente.
- Ejecución paralela segura: Los árboles de trabajo aíslan cambios para que los agentes no interfieran entre sí.
- Conocimiento persistente del proyecto: Los archivos de habilidades codifican las convenciones, arquitectura y restricciones de tu proyecto.
- Integración real de herramientas: Los conectores MCP (Protocolo de Contexto de Modelo) dan a los agentes acceso a tus herramientas reales: Git, tickets, CI.
- Memoria y estado: Una columna vertebral duradera fuera de cualquier conversación, para que los agentes no olviden el contexto entre ejecuciones.
Los Cinco Bloques de Construcción + Memoria
El repositorio define cinco primitivas que forman la base de cualquier bucle:
| Primitiva | Trabajo en el Bucle |
|---|---|
| Automatizaciones / Programación | Descubrimiento + triaje en un ritmo |
| Árboles de trabajo | Ejecución paralela segura |
| Habilidades | Conocimiento persistente del proyecto |
| Plugins y Conectores | Acceso a tus herramientas reales (MCP) |
| Sub-agentes | División creador / verificador |
| + Memoria / Estado | Columna vertebral duradera fuera de cualquier conversación |
Los detalles completos están en docs/primitives.md, y una matriz entre herramientas está disponible en docs/primitives-matrix.md.
Anatomía de un Bucle
Un flujo típico de bucle se ve así:
flowchart LR
A[Programación / Automatización] --> B[Habilidad de Triaje]
B --> C[Leer + Escribir ESTADO / Memoria]
C --> D[Árbol de Trabajo Aislado]
D --> E[Sub-agente Implementador]
E --> F[Sub-agente Verificador<br/>pruebas + compuertas]
F --> G[MCP / Git / Tickets]
G --> H{¿Compuerta Humana?}
H -->|seguro / en lista blanca| I[Commit / PR / Acción]
H -->|riesgoso / ambiguo| J[Escalar a humano<br/>con contexto completo]
I --> A
J --> A
Este ciclo se ejecuta en un horario, lee y escribe estado, ejecuta en aislamiento, verifica resultados, y ya sea hace commit o escala. La compuerta humana es un mecanismo de seguridad crítico: los bucles desatendidos pueden cometer errores desatendidos.
Patrones de Producción
El repositorio incluye siete patrones de bucle listos para producción, cada uno con un ritmo definido, plantilla inicial y costo estimado de tokens:
| Patrón | Ritmo | Iniciador | Semana 1 | Costo de Tokens |
|---|---|---|---|---|
| Triaje Diario | 1d–2h | bucle-mínimo | Informe L1 | Bajo |
| Niñera de PR | 5–15m | niñera-pr | Vigilancia L1 | Alto |
| Limpiador de CI | 5–15m | limpiador-ci | L2 cauteloso | Muy alto |
| Limpiador de Dependencias | 6h–1d | limpiador-dependencias | L2 solo-parches | Medio |
| Redactor de Registro de Cambios | 1d o etiqueta | redactor-registro-cambios | Borrador L1 | Bajo |
| Limpieza Post-Fusión | 1d–6h | limpieza-post-fusión | L1 fuera de horas pico | Bajo |
| Triaje de Incidencias | 2h–1d | triaje-incidencias | L1 solo-propuesta | Bajo |
¿No estás seguro de cuál elegir? Usa el selector interactivo de patrones o consulta patterns/registry.yaml para un índice legible por máquina.
Comenzando en 5 Minutos
# 1. Andamiaje + obtén tu Puntaje de Bucle Listo (impreso 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 Bucle Listo en tu README
npx @cobusgreyling/loop-audit . --badge
# 4. Ve cómo suben los puntajes: vacío → L1 → L2
bash scripts/before-after-demo.sh
# 5. Comienza solo con informes (ejemplo Grok)
/loop 1d Ejecutar triaje-bucle. Actualizar STATE.md. Sin auto-corrección en la semana uno.
Los tres CLI se publican en npm desde versiones etiquetadas, no se necesita clonación. Si contribuyes desde el código fuente, puedes desarrollar desde el monorepositorio:
cd tools/loop-init && npm ci && npm test && node dist/cli.js /path/to/project --pattern daily-triage --tool grok
cd tools/loop-audit && npm ci && npm test && node dist/cli.js /path/to/project --suggest
cd tools/loop-cost && npm ci && npm test && node dist/cli.js --pattern ci-sweeper --cadence 15m
Se recomienda un despliegue por fases: L1 (solo informes) → L2 (correcciones asistidas) → L3 (desatendido). Consulta la lista de verificación de diseño de bucles para más detalles.
Herramientas CLI
El repositorio incluye varios paquetes npm:
- loop-audit: CLI de Puntaje de Preparación del Bucle (v1.5 + puntuación de restricciones) —
npx @cobusgreyling/loop-audit . --suggest - loop-init: Andamiaje de iniciadores + presupuesto/registro de ejecución + restricciones —
npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok - loop-cost: Estimador de gasto de tokens —
npx @cobusgreyling/loop-cost - loop-sync: Detección de desviación entre STATE.md y LOOP.md —
npx @cobusgreyling/loop-sync . - loop-context: Gestor de memoria con estado + interruptor de circuito para ejecuciones largas —
npx @cobusgreyling/loop-context --check --ledger run.json - loop-mcp-server: Búsqueda en tiempo de ejecución de MCP para patrones, habilidades, estado (repo v1; npm pendiente)
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 sub-agentes 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 envía.
- Dos personas pueden ejecutar el mismo bucle y obtener resultados opuestos. El bucle no lo sabe. Tú sí.
El repositorio incluye documentación completa de seguridad:
- Modos de Falla — catálogo estilo incidente
- Anti-patrones — errores de diseño antes de producción
- Coordinación de Múltiples Bucles — cuando los bucles chocan
- Operación de Bucles — costo, registro, cuándo matar
- Seguridad — lista de denegación, auto-fusión, ámbitos MCP
- Seguridad — informes y riesgos de automatización desatendida
Contribuciones
El proyecto acepta contribuciones, especialmente historias de fallos y nuevos mapeos de patrones. Consulta el inicio rápido para contribuyentes para tareas de ~10 min a ~1 hr con revisión el mismo día para historias y adoptantes.
Conclusión
La ingeniería de bucles es un cambio de paradigma. En lugar de ser la persona que guía al agente, te conviertes en la persona que diseña el sistema que guía al agente. Este repositorio te proporciona los patrones, herramientas y prácticas de seguridad para hacer ese cambio práctico.
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."
Esta publicación se basa en el repositorio Loop Engineering de Cobus Greyling, licenciado bajo MIT.