Harness engineering: cómo construir un agente de IA fiable
Artículos: 8
El harness engineering es la disciplina que consiste en construir alrededor de un modelo de lenguaje un entorno en el que un agente de IA realice trabajo real de forma fiable. La fórmula del tema es: Agente = Modelo + Harness. El mismo modelo trabaja como un desarrollador experimentado en un proyecto, pero en otro pierde el contexto e informa de que una funcionalidad rota está lista. La diferencia casi siempre está en el harness, no en el modelo.
Esta guía es un mapa del tema. Reúne los conceptos clave y el orden en que conviene aprenderlos. Cada tema se trata en detalle en un artículo aparte.
Los cinco subsistemas del harness
- Instrucciones — archivos CLAUDE.md y AGENTS.md, documentos temáticos y skills: lo que el agente sabe del proyecto.
- Herramientas — shell, edición de archivos, navegador, servidores MCP: cómo actúa el agente.
- Entorno — entorno aislado, contenedor, copia de trabajo independiente: dónde ejecuta los comandos el agente.
- Estado — archivos de plan y de progreso, historial de git: la memoria entre sesiones.
- Retroalimentación — pruebas, linters, hooks, un verificador independiente: cómo se entera el agente de sus errores.
Los subsistemas forman un circuito cerrado. Si se quita cualquiera, el circuito se rompe: sin comprobaciones el agente no ve sus errores; sin estado, cada sesión empieza de cero.
Por dónde empezar
Si el tema le resulta nuevo, empiece por el artículo sobre qué es el harness engineering y en qué se diferencia del prompt engineering y del context engineering. Una definición breve con ejemplo está en el artículo sobre el harness de un agente.
Después pase a la práctica. El primer archivo con el que todo el mundo se encuentra son las instrucciones del proyecto: qué poner en CLAUDE.md y AGENTS.md, qué no poner, y por qué el agente ignora una regla que aparece escrita explícitamente en el archivo.
Cuando el agente ya trabaja en el proyecto, surge la cuestión de la fiabilidad. Un plan paso a paso lleva desde el registro de fallos y las métricas MTBF y MTTR, pasando por la reversión barata, los bucles de retroalimentación y la memoria en archivos, hasta el ciclo autónomo en el que el agente trabaja horas sin supervisión.
Principios básicos
- El agente no está roto: lo que está roto es el entorno. Busque primero el hueco en el harness, no otro modelo.
- Empiece por la retroalimentación: un comando de comprobación aporta más que una página de instrucciones.
- Las instrucciones son un mapa, no un manual: un archivo de entrada corto y los detalles bajo demanda.
- Lo que importa vive en archivos, no en la ventana de contexto.
- Mida: un registro de fallos en lugar de sensaciones.
Todos los subsistemas y el ensamblaje del harness completo se trabajan en la práctica en el curso de harness engineering.