Harness de agente: qué es y de qué se compone

Definición

El harness de un agente (agent harness) es la envoltura de software que rodea al modelo de lenguaje: todo lo que no es el modelo en sí, pero que influye en cómo trabaja el agente. La fórmula es Agente = Modelo + Harness. El modelo sabe razonar y escribir código; el harness decide qué ve, qué acciones puede realizar, dónde se ejecutan los comandos, qué se conserva entre sesiones y cómo se entera el agente de sus errores.

Cinco partes del harness

• Instrucciones — el prompt del sistema y los archivos del proyecto como CLAUDE.md y AGENTS.md, los documentos temáticos y los skills.
• Herramientas — ejecución de comandos en shell, edición de archivos, un navegador, conexiones mediante MCP.
• Entorno — un entorno aislado o un contenedor donde el agente ejecuta código sin riesgo para producción.
• Estado — archivos de plan y de progreso, historial de git: una memoria que sobrevive al cierre de la sesión.
• Retroalimentación — pruebas, linters, comprobación de tipos, hooks que devuelven al agente una señal de error.

El harness no es un único archivo de prompt. Un AGENTS.md muy largo no servirá de nada si el agente no tiene acceso a las pruebas o si el entorno no arranca. La fiabilidad la determina la más débil de las cinco partes.

Ejemplo

El agente lleva tres sesiones seguidas corrigiendo el mismo error: tras cada reinicio no recuerda lo que ya probó. Parece que la culpa es del modelo. En realidad, lo que falla es el subsistema de estado. La solución es un archivo PROGRESS.md en el que el agente anota, al final de cada sesión, las hipótesis que no funcionaron y el siguiente paso:

## Error: doble cargo al reintentar la petición
Comprobado y descartado:
- timeout del cliente HTTP — sin efecto
- condición de carrera en el manejador del webhook — no se pudo reproducir
Siguiente paso: revisar la clave de idempotencia en payments/service.py

Una sesión nueva lee el archivo y continúa de inmediato por el punto correcto. El modelo no ha cambiado: ha cambiado el harness.

Resumen

El harness de un agente son las instrucciones, herramientas, entorno, estado y retroalimentación que rodean al modelo. Es lo que determina si el mismo agente trabaja de forma fiable o se rompe. Cómo construir cada parte se explica en la práctica en el curso de harness engineering.