Harness Engineering

Harness Engineering

La idea central (Viv Trivedy, popularizada por Addy Osmani) es una ecuación:

Agente = Modelo + Harness

El harness es todo lo que rodea al modelo para que funcione de forma fiable: instrucciones, herramientas, permisos, memoria, el contexto que recibe en cada paso, hooks y verificación. El modelo es el motor; el harness es el chasis, la dirección y los frenos.

Harness Engineering consiste en tratar ese entorno como un artefacto de ingeniería —que se diseña, se mide y se ajusta—, no como un montón de prompts sueltos. La tesis: un modelo decente con un gran harness supera a un gran modelo con un mal harness. Su corolario: cuando el agente falla, rara vez es problema del modelo; suele ser de configuración.

Su núcleo: la ingeniería de contexto

La subdisciplina más importante es curar el conjunto óptimo de información que el modelo ve en cada paso. El contexto es un recurso limitado con rendimientos decrecientes: la atención se degrada a medida que crece (lo que se conoce como context rot, la degradación del contexto). El objetivo: el menor número de datos de alto valor que logre el resultado.

Técnicas clave:

• El nivel de detalle adecuado (right altitude) en las instrucciones: ni lógica rígida ni vaguedad.
• Carga bajo demanda (progressive disclosure): traer skills y referencias cuando hacen falta, no todas a la vez.
• Al vuelo (just-in-time): obtener los datos en el momento (p. ej. con context7) en lugar de precargarlos.
• Compactación y notas estructuradas: resumir y guardar el estado fuera de la ventana de contexto.
• Subagentes: devuelven un resumen destilado, no todo su contexto.

Cómo debe crecer un harness

Una buena configuración crece a base de fallos reales, no de buenas intenciones:

Cada línea de un buen AGENTS.md debería poder rastrearse hasta algo concreto que salió mal.

Es el efecto ratchet (como una carraca, que solo avanza): añades una regla solo tras un fallo observado y, cuando el agente se equivoca, refuerzas el entorno (una skill, un hook, una descripción) en lugar de acumular texto. Otra máxima: el éxito es silencioso; los fallos son ruidosos. Así se evita el exceso de instrucciones (instruction bloat) que arruina el nivel de detalle adecuado.

Tres niveles, no los confundas

• Ingeniería de prompts afina una pregunta.
• Ingeniería de contexto afina lo que el modelo ve en cada paso.
• Harness Engineering es la disciplina mayor: diseñar y ajustar todo el entorno como ingeniería — porque ahí, y no en el modelo, está la mayor parte de la diferencia entre un agente mediocre y uno fiable.

A fondo: harness-engineering.md.