Un turno, paso a paso

Pides algo y pasa mucho más de lo que ves

Escribes en el chat de tu editor: «Arregla el test que falla». Unos segundos después ves cambios en el código y un resumen. Entre medias ocurrió una pequeña coreografía. La documentación de VS Code la describe como un turno con cinco pasos.

Los cinco pasos

1. El harness recibe tu petición y el estado de la sesión. Prepara las instrucciones, el contexto y las definiciones de las herramientas disponibles, y se lo pasa al modelo.
2. El modelo razona y responde. Puede contestar directamente o pedir llamar a una herramienta («lee este archivo»).
3. Si pide una herramienta, el harness la gestiona. Aplica las reglas de permisos y aprobaciones, envía la llamada al entorno donde se ejecuta y recoge el resultado.
4. El harness devuelve el resultado al modelo. El modelo decide: ¿llamo a otra herramienta, pregunto algo al usuario o termino?
5. El harness guarda todo en la sesión (mensajes, llamadas, resultados, cambios en el código) y muestra el estado actual.

Los pasos 2 a 4 se repiten tantas veces como haga falta. Es el bucle de la primera lección: mirar, decidir, actuar y comprobar.

Dibujémoslo

Un ejemplo imaginario

Sigamos con «arregla el test que falla»:

Modelo  -> pide: ejecutar los tests
Harness -> pregunta permiso si hace falta, ejecuta, devuelve el fallo
Modelo  -> pide: leer src/suma.js
Harness -> lee el archivo y se lo da
Modelo  -> pide: editar src/suma.js
Harness -> aplica el cambio y lo anota en la sesión
Modelo  -> pide: ejecutar los tests otra vez
Harness -> devuelve "todo pasa"
Modelo  -> responde: "Arreglado. El fallo estaba en..."

Observa que en todo el rato el modelo solo ha producido peticiones y texto. Cada acción real la ha hecho el harness, y cada una ha pasado por sus reglas de permisos.

Por qué te conviene saberlo

Si algo sale mal, sabes dónde mirar. ¿El modelo recibió el contexto correcto (paso 1)? ¿Tenía la herramienta que necesitaba (paso 2)? ¿Se bloqueó una acción por permisos (paso 3)? ¿El resultado volvió completo (paso 4)? Es el mapa del bucle diagnóstico del módulo anterior.