🔁 El Loop operativo: el cerebro disciplinado
Este es el módulo clave del curso. Un agente disciplinado no corre al teclado: conecta con la realidad, razona, actúa en lotes y se detiene a leer lo que obtuvo y solo entonces decide el siguiente paso. Este ciclo tiene nombre: GROUND → REASON → ACT → OBSERVE → RE-EVALUATE → VERIFY → NARRATE. Aquí vas a entender, paso a paso, el cerebro que separa a un agente que piensa de uno que solo "tantea rápido".
Contenido detallado
Por qué un loop y no un truco
Internet está lleno de «trucos de prompting»: la frase mágica, el jailbreak de moda, la plantilla que «convierte a la IA en un genio». Funcionan durante una tarde y al día siguiente dejan de funcionar. Lo que realmente cambia las reglas del juego no es un truco, sino un hábito de trabajo. Un ciclo que el agente ejecuta en cada turno difícil, siempre igual, siempre en el mismo orden. Eso es lo que diferencia a un agente que piensa de uno que solo actúa rápido.
🧠 La idea en una frase
O Bucle operativo es el cerebro disciplinado del agente: un ciclo de siete pasos — conectar con la realidad, razonar, actuar, observar, reevaluar, verificar, narrar — se ejecuta en cada turno no trivial. No es una frase que pegas; es una forma de trabajar que estableces.
La frase que lo resume todo: "la velocidad viene de hacer lo correcto una vez, no de saltarse el razonamiento." Un truco te da un atajo que a veces funciona; el loop te da un método que siempre verifica.
✗ El truco (frágil)
- ✗Depende de una frase específica que «desbloquea» el modelo
- ✗Funciona en un caso y falla en el caso vecino
- ✗Corre al teclado: actúa sin aterrizar ni verificar
- ✗Cuando algo sale mal, no sabes por qué: era magia
✓ El loop (robusto)
- ✓Es un ciclo de hábitos, igual en todas las tareas
- ✓Generaliza: sirve para el caso que no anticipaste
- ✓Primero aterriza, después actúa y siempre verifica
- ✓Cuando algo falla, sabes en qué paso buscar
Por qué este es el módulo clave
Todos los bloques de la Ruta 2 construyen cómo habla el agenteEste construye cómo trabaja el agente. El bloque <loop_operacional> es lo que más acerca a un agente común a la disciplina de primer nivel; por sí solo, es el truco clave. Domínalo y todo lo demás se vuelve un ajuste fino.
GROUND — aterrizar en el estado real
El ciclo empieza con la regla más sencilla y más ignorada: nunca cambies lo que no entendiste. Antes de proponer una solución, antes de editar una línea, el agente establece el estado real del mundo. Ejecuta el git status, hace el grep, enumera el directorio, lee el archivo que importa. Aterrizar es cambiar el "probablemente está así" por el "acabo de verlo".
🌍 Reconocimiento antes de la mutación
Toda tarea empieza por establecer lo que realmente existe, no imaginando lo que quizá exista. El agente disciplinado empieza con un git status, un grep preciso y la lectura del único archivo que importa: antes de escribir un solo carácter.
Aquí hay un segundo grano de arena: lee la región exacta justo antes de cambiarlaEl contexto de hace cinco pasos es contexto viejo. Una relectura reciente evita una edición que no encaja, un bloque duplicado y un cambio que ya se había hecho.
✓ Aterrizar de verdad
- ✓Revisa el estado (git status, listar dir) antes de proponer
- ✓Usa grep con precisión para encontrar lo que buscas
- ✓Lee el archivo que importa en esta sesión
- ✓Vuelve a leer las líneas exactas poco antes de editarlas
✗ Tantear a ciegas
- ✗Propone la corrección a partir de una suposición
- ✗Edita un archivo cuyo contenido actual no vio
- ✗Edita «de memoria», según lo que probablemente contiene el archivo
- ✗Usa contexto viejo y aplicas un cambio que no encaja
Cómo suena en el system prompt
"Establece el estado real antes de cambiar nada: git status, grep, listar dir, leer el archivo que importa. Nunca cambies lo que no entiendas." Una línea — y cambia por completo la postura del agente, de "adivina y corre" a "observa y actúa".
REASON + ACT — pensar antes, actuar en lotes
Una vez asentado el terreno, vienen dos pasos seguidos. REASONantes de la primera herramienta, di el objetivo, la hipótesis y el plan, aunque sea en una o dos líneas. Nombrar lo que esperas encontrar cambia lo que haces a continuación. ACT: da el siguiente paso deliberado y agrupa lo que es independiente — pero nunca finjas que algo es paralelo si tiene dependencias.
REASON — objetivo + hipótesis + plan, antes de la primera herramienta
Razonar no es un costo extra. Es el trabajo.
"El pie de página aparece dos veces. Probablemente está duplicado en el diseño. Voy a buscar con grep la importación del pie de página y luego leer el diseño." Dos frases, y el agente ya dejó de ejecutar herramientas antes de saber qué está probando.
ACT — paso deliberado, lotes de tareas independientes
Avanza con palanca: agrupa lo homogéneo, paraleliza lo independiente.
Lee los tres archivos de una vez. Ejecuta las comprobaciones independientes en paralelo. Ejecutar en serie tareas independientes es tiempo de pared desperdiciado. La salvedad: si el paso B necesita la salida del paso A, no son paralelos: fingir que lo son produce trabajo cancelado y confusión.
El antipatrón que debes evitar
Activar una llamada a una herramienta antes de haber dicho, aunque sea para ti mismo, qué estás probando. El agente que actúa sin razonar no está siendo rápido: está acumulando pasos que tendrá que deshacer.
OBSERVA + REEVALÚA — el paso que todo el mundo se salta
Este es el corazón del módulo y el hábito que cuanto más se ignoraDespués de que una herramienta devuelve un resultado, detente y lee lo que volvió, de verdadLuego decide el siguiente paso a partir de lo que el resultado mostró en realidad, no del plan que tenías antes de contar con los datos. En la imagen de arriba, es la asa de color cianACT → OBSERVE → RE-EVALUATE, repetida en bucle hasta alcanzar la meta.
👁️ El plan es un borrador; el resultado es la verdad
El ciclo observar-entonces-decidir es la diferencia entre un agente que piensa y uno que solo actúa rápido. Ejecútalo cada cicloLa regla que rige este paso es una sola: actualiza el plan a partir del resultado, no el resultado a partir del plan.
Se ve así: una búsqueda devuelve tres resultados que no esperabas. Haces una pausa, revisas la teoría y ajustas la siguiente acción, en vez de seguir empujando el plan anterior cuesta abajo.
✓ Observar y reevaluar
- ✓Detente y lee la respuesta completa antes del siguiente paso
- ✓Decide a partir de lo que mostró el resultado, no del plan
- ✓Cuando el dato sorprende, revisas la teoría de inmediato
- ✓Repite ACT..RE-EVALUATE hasta alcanzar la meta
✗ Omitir el paso
- ✗Ejecuta una secuencia planificada de antemano como si los resultados no pudieran cambiarla
- ✗Mira el resultado por encima y enseguida lanza la siguiente acción
- ✗Encaja el resultado en el plan en vez de hacer lo contrario
- ✗Sigue insistiendo aunque el dato contradiga la teoría
Por qué esta manija es la pieza canónica
Es el único hábito que, cuando falta, hace que «los buenos planes se conviertan en resultados equivocados». La mayoría de los agentes malos no se equivoca por razonar mal: se equivoca por no leer lo que volvió y seguir el guion anterior. Volver a observar y reevaluar es lo que cierra ese hueco.
VERIFY + NARRATE — comprobación real y reporte fiel
Los dos últimos pasos cierran el ciclo con honestidad. VERIFY: toda edición es una hipótesis; un check que pasa es la evidencia. Ejecuta la prueba, el build o el lint real del proyecto — no un ls ni uno echo. NARRATEdi qué vas a hacer y por qué, confirma las transiciones de fase. No desaparezcas durante veinte llamadas para aparecer solo al final.
✅ De «parece correcto» a «las pruebas pasan, aquí está la salida»
Report outcomes faithfully: if tests fail, say so with the output; if a step was skipped, say that; when something is done and verified, state it plainly without hedging.
En PT: reporta los resultados con fidelidad; si las pruebas fallaron, dilo y muestra la salida; si omitiste un paso, di que lo omitiste; si algo está hecho y verificado, afírmalo sin rodeos. "Probablemente funciona" no significa que esté listo; "las pruebas pasan, aquí está la salida" sí significa que está listo.
⚠️ Aquí, supera a la fuente
El modelo del que se destiló esta mentalidad verifica de forma inconsistente. Debes verificar siempreDos antipatrones que debes eliminar:
- ✗Declarar que un cambio está listo porque «parece correcto» o porque un comando sin relación terminó con código cero
- ✗Desaparecer durante veinte llamadas a herramientas y reaparecer solo al final, sin narrar las transiciones
La confianza se construye con informes exactos
No con un relato optimista. Narrar lo que estás haciendo —incluida la higiene, como «voy a crear una rama» o «estoy aterrizando»— es lo que mantiene auditable una ejecución larga y permite que la persona corrija el rumbo a tiempo.
Ajustar el esfuerzo a la tarea
Una última disciplina, que impide que el loop se vuelva burocracia: ajusta el esfuerzo a la tarea. Un arreglo de una línea no necesita una sala de guerra. Una migración de cincuenta pasos, sin plan ni seguimiento, es la forma en que el trabajo se descarrila sin que nadie se dé cuenta. El ciclo es siempre el mismo; el peso de cada paso es lo que cambia según el tamaño del trabajo.
🪶 Tarea ligera — loop compacto
un fix de una línea, una respuesta directa
- •Aterriza rápido: un grep, una lectura
- •Basta con una línea de razonamiento
- •Actúa, verifica el check real, informa
- •Sin un plan formal ni una lista de tareas
🏗️ Tarea pesada — loop con plan
una migración, una compilación de muchos pasos
- •Plan corto por fases, con aprobación
- •Lista de tareas viva, actualizada sobre la marcha
- •Vuelve al plan en cada límite entre fases
- •Narra las transiciones — mantén la trazabilidad
<loop_operacional> Rode este ciclo a cada turno não-trivial. Escale o esforço à tarefa — um fix de uma linha não precisa de sala de guerra. GROUND (aterrar) Estabeleça o estado real antes de mudar nada: git status, grep, listar dir, ler o arquivo que importa. Nunca mude o que você não entendeu. REASON (raciocinar) Antes da 1ª ferramenta, diga objetivo + hipótese + plano (mesmo 1-2 linhas). Nomear o que você espera muda o que você faz. ACT (agir) Dê o próximo passo deliberado. Agrupe o que é independente; não finja paralelo o que tem dependência. OBSERVE (observar) Pare e LEIA o que voltou. De verdade. Pular este passo é como bons planos viram resultados errados. RE-EVALUATE Atualize o plano a partir do resultado, não o contrário. O plano é rascunho; o resultado é a verdade. (Repita ACT..RE-EVALUATE até a meta.) VERIFY (verificar) Toda edição é hipótese; um check que passa é a evidência. Rode o teste/build/lint REAL do projeto, não um `ls`/`echo`. Verifique SEMPRE — aqui seja melhor que a fonte. NARRATE (narrar) Diga o que vai fazer e por quê; confirme transições de fase. Não suma por 20 chamadas e apareça só no fim. </loop_operacional>
🛠️ Manos a la obra: tu entregable
Antes de seguir, instala el loop en un agente tuyo. En 15 minutos tendrás un agente que piensa, no que tantea.
- 1 Toma un agente tuyo que ejecute tareas en varios pasos (usa herramientas, edita archivos). Pega el bloque <loop_operacional> en el system prompt, exactamente como está arriba.
- 2 Dale una tarea no trivial y observa si conecta con la realidad antes de actuar: ¿comprueba el estado (lista, lee) antes de editar o empieza a hacer cambios de inmediato?
- 3 Si se perdiera el foco en asa ciandespués de cada herramienta, ¿se detiene y lee la respuesta o sigue con el plan anterior? Ese es el paso que más revela disciplina.
- 4 Al final, comprueba el VERIFY + NARRATE: ejecutó una comprobación real (no una ls) e informó sin rodeos? Anota el paso más débil: ahí es donde refuerzas la línea.
📝 Resumen del Módulo
- ✓O Bucle operativo es un hábito de trabajo, no un truco: el cerebro disciplinado del agente
- ✓GROUNDvuelve al estado real y relee la región exacta antes de cambiar nada
- ✓REASON + ACT: di el objetivo, la hipótesis o el plan antes de la primera herramienta; agrupa las tareas independientes, no finjas que son paralelas
- ✓OBSERVA + REEVALÚAel asa cian: lee lo que volvió y actualiza el plan a partir de eso. El paso que todos se saltan
- ✓VERIFY + NARRATEverificación real (no un ls) e informó fielmente: "las pruebas pasan, aquí está la salida" significa que está listo
- ✓Ajusta el esfuerzo a la tarea: el mismo ciclo, distinto peso; un fix de 1 línea no necesita una sala de guerra
➡️ Siguiente Módulo
2.6 — 🛠️ Cómo crear una Skill y un agente. Tienes el cerebro disciplinado en el bolsillo. Ahora vamos a darle manos y memoria: crear una skill reutilizable y un agente completo, con el ciclo operativo funcionando por dentro.