Qué es un harness

Un restaurante con solo ingredientes

La lección 02 del repositorio abre con una imagen: mucha gente dice «harness» cuando en realidad habla de un archivo de instrucciones. Es como abrir un restaurante con solo ingredientes: sin fogones, sin cuchillos, sin recetas, sin forma de emplatar. Eso no es un restaurante, es una nevera.

La definición, con tres voces

Las fuentes del curso lo dicen casi igual:

• VS Code: un harness es la capa de software que ejecuta una sesión de agente. Convierte un modelo de lenguaje en un agente conectándolo con contexto y herramientas, coordinando el bucle del agente y manteniendo el estado de la sesión mientras avanza el trabajo.
• Microsoft: es la infraestructura de ejecución que lleva las llamadas al modelo y a las herramientas, gestiona estado y contexto de la conversación, aplica políticas de aprobación y puede hacer que el agente siga avanzando en tareas de varios pasos.
• El repositorio del curso: todo lo que existe en la infraestructura de ingeniería fuera de los pesos del modelo.

La analogía del recién llegado

Imagina que entras nuevo en un proyecto sin documentación: no hay README, nadie te dice cómo lanzar las pruebas, la configuración está escondida. Podrías sacarlo adelante, pero perderías el tiempo averiguando de qué va todo en vez de resolver el problema. Y tú al menos puedes preguntar a un compañero.

Un agente no puede darle un toquecito a nadie. Solo ve los archivos que le pongas delante y los comandos que pueda ejecutar. Por eso el repositorio lo plantea así: lo que el agente no puede ver, a todos los efectos, no existe.

Qué incluye un harness

Para un agente de programación que trabaja en un repositorio local, el ejemplo del curso lista:

Modelo:  el LLM en sí

Harness:
- instrucciones del sistema y AGENTS.md
- herramienta de terminal (bash)
- lectura y escritura de archivos
- acceso a git
- sistema de archivos local
- scripts de arranque y comandos de prueba
- comprobaciones de estilo (lint)
- un bucle de evaluación

Y la regla práctica: si cambias cualquiera de esas piezas, cambias el agente efectivo, aunque el modelo sea el mismo.

Algunos harness que quizá ya conoces

El repositorio recorre varios para ilustrarlo. Un asistente que lee un archivo de reglas del repo, ejecuta comandos de terminal y puede lanzar pruebas ya muestra «pensamiento de harness». Si no le cuentas cómo lanzar las pruebas, la ventana de control de calidad está rota y nadie sabe si el plato está cocinado. En el otro extremo, el repositorio pone de ejemplo de lo que ocurre sin gestión de estado ni retroalimentación a un agente autónomo muy conocido que se enreda en tareas largas: no falla la «materia prima», falla la cocina.