📖 Glosario vivo (lee antes — vuelve siempre que lo necesites)
Esta es la ruta Avanzado. Ya conoces modelo, agente, skill y harness (Ruta 1). Aquí entran los términos nuevos sobre cómo te posicionas en relación con el agente — fija estos:
🤝 Humano en el circuito
🧠 Imagínalo así: tú estás enseñándole a alguien a conducir. Al principio, te sientas en el asiento del copiloto con el pie cerca del freno: en cada curva verificas, comentas, corriges. Tú estás dentro del proceso, juntos, listo para intervenir. Este es el modo "humano en el ciclo".
Cuando usas un agente de IA para programar, la forma más común —y la que todo principiante usa primero— es el human-in-the-loop (humano en el loop). Te quedas junto del agente: propone un cambio, lo lees y lo apruebas o corriges; ejecuta un comando y lo confirmas; edita un archivo y lo revisas. Estás dentro del bucle de ejecución, con el control todo el tiempo.
Este modo es correcto en muchos momentos — no está «mal», es una de las dos marchas. Pocock es claro sobre cuándo tiene sentido: planificar, implementaciones complejas y trabajo sin definir el alcance (es decir, cuando todavía no está definido qué hay que hacer exactamente). En esos momentos quieres estar presente, dando dirección, porque el agente todavía no tiene lo que necesita para acertar por sí solo. El porqué es simple: mientras la tarea sea ambigua, tu presencia en el loop es lo que evita que el agente se ponga a construir algo equivocado con mucha confianza. El error común es lo opuesto: quedarse en el loop para todo, incluso tareas ya bien definidas y repetitivas; entonces tú te conviertes en el cuello de botella de tu propio trabajo.
En el human-in-the-loop, cada paso pasa por ti antes de que el agente continúe.
⚠️ Error común de principiante
Creer que human-in-the-loop es «la forma segura y única» de trabajar. Es necesario cuando hay incertidumbre, pero si nunca sales del loop, tu velocidad queda limitada por la rapidez de tus clics de aprobación. Nunca aprovechas la verdadera ventaja del agente.
En 1 frase: human-in-the-loop es como si fueras de copiloto, aprobando cada curva: esencial cuando el camino aún no está claro.
Profundiza (opcional): ¿por qué «loop»?
Un agente trabaja en ciclos: piensa, actúa (edita un archivo, ejecuta una prueba), observa el resultado y repite; ese es el «loop» del agente. «Humano en el loop» significa literalmente incluirte en ese ciclo, como una etapa más de revisión entre «actuar» y «repetir». «AFK» es el mismo loop funcionando sin esta etapa humana. La pregunta avanzada no es "loop o no loop", sino "cuánto de ti necesita el loop".
🛰️ Qué es AFK
🧠 Imagínalo así: volviendo a la dirección: llega el momento en que te bajas del auto, das la dirección y dejas que la persona vaya sola a comprar el pan. No sigues cada semáforo. Le das una tarea clara y se va a hacer otra cosa. Cuando vuelve, el pan está en la mesa.
AFK quiere decir Away From Keyboard — «lejos del teclado». Es lo opuesto al human-in-the-loop: en vez de aprobar paso a paso, tú lanza al agente con una tarea específica y se va. Como describe Pocock, el AFK "sácate de la ecuación": el agente toma la tarea y simplemente la realiza de principio a fin, sin interrumpirte.
La condición para que esto funcione es que la tarea esté bien delimitada — definida lo suficiente como para que no te necesite en medio del proceso. Por eso dice que no hay que pensar tanto en «ejecutar como un bucle infinito», sino en "solo necesito que el agente AFK tome una tarea específica y la haga". O porqué de que AFK sea tan poderoso: mientras el agente trabaja sin ti, tienes tiempo libre para planear lo siguiente, revisar otra cosa o iniciar otro agente. El error común es poner una tarea vaga en modo AFK ("mejora la app"): sin alcance, el agente se pierde y descubres el desastre cuando vuelves. AFK no es magia: Pocock advierte que "requiere algo de trabajo configurarlo, pero después rinde mucho".
Recuperación rápida: ¿qué significa AFK en el contexto de los agentes?
En 1 frase: AFK = asignar una tarea clara, alejarte del teclado y volver cuando esté lista.
🔓 Cómo destrabar el AFK
🧠 Imagínalo así: imagina que contratas a tu primer empleado de confianza. Antes, todo pasaba por tus manos. Después, delegas y descubres que puedes llevar tres proyectos al mismo tiempo. No fue que te volvieras más inteligente: fuiste tú quien salió del cuello de botella. El AFK es ese momento.
Esta es la frase central del módulo, directamente de Pocock: "el momento en que descubrí AFK fue cuando realmente empecé a programar con IA." Fíjate en la fuerza de esto: no dice "cuando cambié de modelo" ni "cuando aprendí a hacer prompts". El desbloqueo no vino del motor (el modelo); vino de un cambio en el harness y en la forma de trabajar: quitarte del camino.
¿Por qué esto lo desbloquea tanto? Porque mientras estás human-in-the-loop, eres el límite de velocidad. Cada aprobación tuya es un peaje. Por rápido que sea el agente, avanza a la velocidad de tus clics. En cuanto el agente empieza a encargarse de tareas acotadas por su cuenta, ese peaje desaparece y, lo que es más importante, te libera para activar otro agente. Aquí es donde nace el «dos, tres, cuatro de ti» (tema 6). El error común es confundir el desbloqueo con «comprar un modelo mejor»: la mejora de Pocock no fue de inteligencia bruta, sino de posicionamiento — dejó de ser el cuello de botella. Recuerda la Trilha 1: el salto está en el chasis, no en el motor.
El desbloqueo no depende de un mejor modelo: depende de que dejes de ser el cuello de botella.
En 1 frase: el modo AFK te libera porque dejas de ser el límite de velocidad de tu propio trabajo.
🎚️ Cuando se quede en bucle
🧠 Imagínalo así: un cirujano delega el vendaje y el transporte del paciente — pero la incisión principal la hace con su propia mano. Saber lo que delegar y qué reservarte no es una debilidad: es lo que distingue al profesional del aficionado.
AFK no es «dejarle todo a la IA para siempre». Es una marcha que activas en el momento justo — y human-in-the-loop es la otra. La regla de Pocock es directa. Tú te quedas en el loop cuando el trabajo es: planificación (decidir qué y por qué), implementaciones complejas (donde una decisión temprana equivocada contamina todo) y trabajo sin alcance definido (aún mal definido, donde tu dirección es lo que le da forma). Tú mandas AFK cuando la tarea ya está clara, delimitada y puedes verificar el resultado.
O porqué de esta división sigue la misma lógica de delegar a un júnior (Trilha 2): tú dibujas las partes difíciles y la interfaz, y delegas la ejecución con un alcance definido. El movimiento estratégico —que vas a retomar en "Checkpoints & review fluido" (4.6)— es "acercar cada vez más los puntos de control con participación humana al resultado final": en lugar de aprobar cada pasito, solo apruebas al final, cuando realmente importa. El error común aquí es ser demasiado binario: gente que se queda pegada al ciclo para todo o deja tareas AFK que todavía no tienen el alcance definido. La habilidad está en encontrar el equilibrio.
🔬 Ejemplo resuelto: una feature, dos velocidades
Tarea real: "agregar la exportación de informes en PDF a la app". Mira cómo Pocock dividiría esto entre las dos marchas:
- En el loop (tú junto al agente): sentarte con el agente y decidir lo que entra en el PDF, qué biblioteca usar, cómo queda el diseño, dónde encaja en el menú. Trabajo sin alcance definido y de diseño: tu dirección lo moldea todo.
- AFK (te vas): ahora la tarea está clara: «implementa el botón Exportar PDF usando la lib X, siguiendo el patrón de auth del proyecto, con pruebas». Lo pones en marcha y te vas a almorzar.
- Checkpoint al final (loop, al salir): al volver, revisas el PR — no cada commit, solo el resultado. Punto de control llevado «cerca de la salida final».
Resultado: dedicaste tu tiempo solo a lo que requería tu criterio (decisión + revisión final) y dejaste que la ejecución acotada avanzara sola.
En 1 frase: quédate en el loop para decidir y diseñar; manda a AFK a ejecutar lo que ya está claro — y revisa solo al final.
🔐 Permisos y fricción
🧠 Imagínalo así: darle la llave del auto a alguien. Si la persona tiene que llamarte en cada esquina para preguntarte «¿puedo doblar?», el viaje no avanza. Pero si le das la llave de un auto en un estacionamiento cerrado, puedes dejarlo actuar: el daño posible es pequeño. El permiso y el entorno seguro van juntos.
Para que un agente trabaje AFK, no puede detenerse a cada paso para pedir autorización. Cada pausa de esas es fricción, y la fricción te mantiene frente al teclado: lo opuesto a AFK. La solución es dar permisos más amplias, para que actúe solo. Pero ahí reside un peligro real.
Pocock es explícito sobre el riesgo: un agente suelto, sin un entorno aislado, puede "borrar tu directorio home o exfiltrar tus variables de entorno" (filtrar tus contraseñas y claves). Por eso, los permisos amplios avanzan de la mano con el sandbox (lo verás en el módulo 4.2): le das permiso al agente dentro de un entorno aislado (Docker/Podman o sandboxes en la nube), donde, aunque algo salga mal, el daño queda contenido. El porqué: AFK exige menos fricción (más permisos), y menos fricción solo es seguro con más aislamiento. O error común, y peligroso es hacer solo la mitad: darle permiso total al agente en tu máquina real, sin sandbox. Así cambiaste la fricción por el riesgo de una catástrofe.
Antes de dar mais PERMISSAO e soltar o agente AFK, cheque: [ ] ESCOPO -- a tarefa esta clara o bastante pra rodar sem mim? [ ] SANDBOX -- o agente esta num ambiente isolado (Docker/Podman/nuvem)? [ ] SEGREDOS -- minhas chaves e .env estao fora do alcance dele? [ ] VERIFICACAO -- existe teste/check que diz se ele acertou? [ ] SAIDA -- o resultado sai como PR/branch (nao direto no main)? Se algum [ ] esta vazio, NAO solte na maquina real. Sandbox primeiro.
En 1 frase: reduce la fricción al dar permisos amplios — pero solo dentro de un sandbox, nunca suelto en la máquina real.
👥 Dos, tres, cuatro de ustedes
🧠 Imagínalo así: un director de orquesta no toca los instrumentos: dirige varios al mismo tiempo. Cada músico (agente) ejecuta su parte por su cuenta; el director (tú) se asegura de que todo suene en conjunto. No es una persona haciéndolo todo, sino una persona multiplicada.
Aquí es donde AFK muestra su mayor efecto. Cuando no necesitas seguir el proceso de cada agente, puedes ejecutar varios al mismo tiempo — es lo que Pocock llama tener "dos, tres, cuatro, cinco de mí". Cada agente AFK toma una tarea acotada y la ejecuta en en paralelo; dejas de ser una persona que hace una cosa y te conviertes en una persona orquestando varias. Es exactamente por eso que desbloquear el tema 3 importa tanto: salir del cuello de botella es lo que permite la multiplicación. Como resume Pocock, el AFK "es simplemente increíble: cuesta un poco configurarlo, pero después llega lejos". La parte de "configurar" es el sandbox y la fila de tareas: exactamente lo que desglosan los próximos módulos de este recorrido (4.2 sandboxes, 4.3 GitHub Actions, 4.4 filas). No te conviertes en el cuello de botella de tus agentes; te conviertes en su director de orquesta.
"Dos, tres, cuatro de mí" — diriges varios agentes en paralelo, cada uno con su propia tarea.
Recuperación rápida: ¿qué hace posible tener «dos, tres, cuatro de ti»?
En 1 frase: salir del ciclo te multiplica: de una persona haciendo una cosa a un director que coordina varios agentes.
🧾 Resumen del módulo
Próximo módulo:
4.2 — Paralelizar & sandboxes: el «cómo» del AFK seguro — Docker/Podman, Sand Castle y cómo ejecutar una flota de agentes aislados.