⚡ Los tres comandos fundamentales
Antes de armar cualquier sistema de loop, necesitas entender los tres primitivos que Claude Code ofrece de forma nativa. Son los bloques básicos de cualquier automatización cíclica. Como plantea Cole Medin: "La ingeniería de loops no es tan complicada. Ni siquiera sé si merece tener su propio término."
🧱 Los tres primitivos
/loop - Intervalo de ejecución
Define un intervalo (por ejemplo, cada 5 minutos) para que el agente se active y ejecute un prompt. El uso más común: monitorear algo externo (issues de GitHub, una cola de tareas) y actuar cuando haya trabajo.
"Cada cinco minutos voy a revisar si hay issues nuevas de GitHub en este repo y a encargarme de las que aparezcan." - Cole Medin
/goal - Criterio de finalización
Tú defines qué significa "listo". El agente trabaja hasta satisfacer el criterio, sin intervalo fijo. Es parecido al concepto de Ralph loops que se viralizó: trabaja hasta terminar.
/routines - Jobs programados
Jobs programados recurrentes. Ej.: "Cada hora, despierta, lee el documento de especificaciones y ejecuta la próxima tarea pendiente." Es el cron del mundo de los agentes.
"Cada hora, quiero que te despiertes, revises un documento de especificaciones más amplio y luego te encargues de la siguiente tarea." - Cole Medin
💡 Consejo práctico
En la mayoría de los casos, solo necesitas el /loop con un plan.md. Las otras dos son herramientas complementarias. No compliques las cosas si el problema es simple.
📋 Cómo crear el plan.md
O plan.md es el corazón de cualquier loop básico. Es un archivo Markdown sencillo con una lista de tareas. El agente lo lee, ejecuta la primera tarea pendiente, la valida, la marca como hecha y duerme hasta el siguiente ciclo. Cole Medin lo demostró en vivo: "Solo tengo esto como ejemplo. Estas son las tareas que queríamos completar de forma incremental."
📄 Plantilla de plan.md
# Plano de Tarefas
## Contexto
Projeto: [nome do projeto]
Objetivo: [o que queremos construir/fazer]
Regras: uma tarefa por ciclo, validar antes de marcar
## Tarefas
- [ ] Tarefa 1: Criar estrutura base do projeto
Criterio: pasta criada, package.json init, deps instaladas
- [ ] Tarefa 2: Implementar componente principal
Criterio: componente renderiza sem erros
- [ ] Tarefa 3: Adicionar testes unitarios
Criterio: npm test passa com 0 falhas
- [ ] Tarefa 4: Configurar linting e formatacao
Criterio: npm run lint sem warnings
- [ ] Tarefa 5: Documentar API no README
Criterio: README com exemplos de uso
## Notas
- Nao pular tarefas
- Se uma tarefa falhar, reportar o erro e parar
- Cada tarefa deve ser auto-contida✓ Buen plan.md
- ✓Tareas atómicas e independientes
- ✓Criterio de validación explícito
- ✓Contexto del proyecto al inicio
- ✓Casillas de verificación de Markdown para el seguimiento
✗ Plan.md problemático
- ✗Tareas vagas ("mejorar el código")
- ✗Sin criterio de "listo"
- ✗Tareas demasiado interdependientes
- ✗10+ tareas en un solo plan
🤔 Punto de reflexión
El plan.md es esencialmente un contrato entre tú y el agente. Cuanto más explícito sea el criterio de validación, menos posibilidades habrá de que el agente "crea" que terminó cuando no es así. Pregúntate: si le doy este plan a un pasante, ¿sabría cuándo está terminada cada tarea?
🚀 El prompt que arma el loop por sí solo
La parte más elegante del sistema: no tienes que configurar el loop manualmente. Le pides a Claude Code que cargar la loop skill y configura el ciclo por su cuenta. Cole Medin mostró exactamente esto: "Simplemente le dices que use la loop skill. La herramienta tiene una capacidad integrada que sabe cómo configurar estos sistemas de loop según lo que le pidamos."
📦 Prompt Pack: Configuración del Loop
Copia y pega directamente en Claude Code. El agente configurará todo por su cuenta.
PROMPT 1 - Configuración básica
Load the loop skill. Read plan.md in the project root.
Work through the tasks one at a time. For each cycle:
1. Find the first unchecked task
2. Execute it completely
3. Validate against the criteria listed
4. Mark it as done with [x] in plan.md
5. Schedule a quick wake-up for the next task
If all tasks are complete, report back with a summary.PROMPT 2 - Con intervalo definido
/loop 5m
Check plan.md. Execute the next unchecked task.
Validate the result. Mark complete if validation passes.
If validation fails, note the error in plan.md and move on.PROMPT 3 - Lo que usó Cole Medin (simplificado)
/loop work through plan.md one task at a time"Yo no escribí este prompt para nada... el sistema lo escribió: /loop work through plan.md one task at a time." - Cole Medin
💡 Cómo funciona por dentro
Cuando dices "carga la skill de loop", Claude Code:
- Reconoce que existe una capacidad interna de loop
- Lee el plan.md para entender el alcance
- Ejecuta la primera tarea pendiente
- Valida el resultado
- Configura el
/loopwake-up automáticamente - Repite hasta que todo esté marcado como hecho
👁️ Activación automática y monitoreo
El mecanismo wake-up es lo que transforma una ejecución única en un loop real. Después de completar una tarea, Claude Code programa por sí solo el siguiente ciclo. "Configura /loop por su cuenta. Y si bajamos después de que completa y valida la primera tarea, podemos ver que reanuda con una activación de /loop."
Lectura del plan.md
Primer ciclo
El agente lee el archivo, identifica que es una "sequential task list" y encuentra la primera tarea sin marcar.
Ejecución + Validación
Trabajo real
Ejecuta la tarea, realiza las pruebas o verificaciones definidas en el criterio, marca [x] en el plan.md.
Wake-Up automático
Continuidad
El agente programa un /loop wake-up con el prompt que él mismo escribió: "avanza por plan.md una tarea a la vez". En el siguiente ciclo, repite desde el paso 1.
Conclusión
Fin del loop
Cuando todas las tareas están marcadas, el agente deja de programar wake-ups e informa el resultado final.
⚠️ Limitación importante
El terminal debe permanecer abierto durante todo el proceso. Si cierras el terminal, el loop muere. Esto es diferente de un daemon o servicio en segundo plano. Cole Medin advierte: "Mientras nuestra terminal esté abierta y Claude Code esté funcionando, puede encargarse de esto de forma autónoma." Esto significa: sin terminal, sin bucle.
🔧 Contexto y buenas prácticas
El loop básico es sencillo, pero tiene trampas que sabotean el resultado si no tienes cuidado. La más peligrosa: saturación de contexto. En un loop, todo se ejecuta en la misma sesión. Cada ciclo acumula más contexto y, con el tiempo, el LLM se sobrecarga.
✓ Buenas prácticas
- ✓Tareas cortas (1-2 archivos por ciclo)
- ✓Criterios de validación automatizables
- ✓Plan.md con un máximo de 5-7 tareas
- ✓Monitorear la sesión periódicamente
✗ Qué evitar
- ✗Loops con más de 20 tareas en la misma sesión
- ✗Dejarlo ejecutándose durante horas sin mirar
- ✗Tareas que dependen de un resultado anterior
- ✗Ignorar los errores y dejar que el ciclo continúe
📊 Datos del mundo real
Cole Medin probó el loop básico y compartió resultados concretos:
- 2 minutos para completar las 2 primeras tareas de un plan simple
- Automático el agente escribió su propio prompt de activación
- Secuencial una tarea por ciclo, sin intentar hacerlo todo de una vez
"Volví unos minutos después y ya había terminado las dos primeras tareas. Así que ya había completado dos iteraciones del loop." - Cole Medin
🤔 Punto de reflexión
El loop básico es potente para tareas simples y secuenciales. Pero fíjate: todo se ejecuta en una sola sesión, con un solo modelo y sin observabilidad. Para cualquier cosa más compleja, necesitarás los recursos de las siguientes secciones (Archon, dashboard, combinación de modelos). El loop básico es el "Hello World" de Loop Engineering, no un sistema de producción.
❓ Preguntas y límites
El loop básico es la forma más sencilla de Loop Engineering, pero plantea preguntas que debes considerar antes de invertir tiempo en este enfoque.
Preguntas abiertas
¿Boris realmente gestiona «tens of thousands of agents per day»?
Cole Medin cuestiona abiertamente: "Boris Cherny dice que hay días en que gestiona decenas de miles de agentes de IA a la vez. En serio, ¿eso es realmente práctico? ¿Va a escalar?" La respuesta honesta: probablemente sí para la escala de Anthropic. Para ti y para mí, no necesariamente.
¿Y si el loop se atasca a mitad de camino?
Sin state externo, un crash de la terminal hace que pierdas todo el progreso. El plan.md guarda una parte (las tareas que ya están marcadas), pero el contexto de la sesión desaparece. Por eso los próximos módulos cubren la durabilidad mediante una base de datos externa.
¿Vale la pena el costo para tareas simples?
Un loop de 5 tareas simples puede costar decenas de miles de tokens solo en overhead de orquestación. Si puedes hacer lo mismo con 5 prompts directos, el loop no tiene sentido desde el punto de vista financiero. El valor real aparece en tareas repetitivas donde el humano sería un cuello de botella.
🎯 Cuando el loop básico brilla
- •Pruebas de concepto rápidas
- •Listas de tareas mecánicas (refactorización, migración)
- •Aprendizaje y experimentación con loops
- •Prototipado antes de invertir en infraestructura más pesada
📝 Resumen del módulo
Módulo siguiente:
3.2 - Flujos deterministas con Archon: cómo ir más allá del ciclo básico con procesos controlados y combinación de modelos