Siempre Listo Escuela
← Volver al listado de tecnologías

Harness Engineering — Índice

Por: Artiko
agentesclaudeharnessiaanthropicthoughtworks

Harness Engineering

Tutorial sobre harness engineering: la disciplina que estudia cómo construir la infraestructura de soporte alrededor de un modelo de IA para que se comporte como un agente confiable.

Agent = Model + Harness

El modelo es la inteligencia bruta. El harness es todo lo que lo rodea — guías, sensores, scripts, archivos de estado, convenciones — que convierte esa inteligencia en trabajo útil, repetible y verificable.

¿Por qué este tutorial?

Cuando entregás una tarea a un agente de IA y obtenés un resultado mediocre, el instinto es culpar al modelo. Pero la mayoría de las veces el problema es el harness: el agente no tiene contexto suficiente, no tiene cómo verificar su propio trabajo, no sabe qué hizo en sesiones previas, no entiende las convenciones del proyecto.

Este tutorial cubre tres perspectivas complementarias sobre cómo diseñar ese harness, un cuarto capítulo operativo dirigido a agentes, y un quinto sobre la investigación que automatiza el proceso:

  • Capítulo 1 — Perspectiva práctica (Anthropic): cómo construir harnesses concretos para agentes que trabajan durante horas o días, con archivos de estado, listas de features y scripts de bootstrap.

  • Capítulo 2 — Perspectiva de ingeniería (Martin Fowler / Thoughtworks): el marco conceptual que generaliza el patrón. Define qué es un harness, sus componentes, sus limitaciones, y cómo encaja en una práctica madura de ingeniería.

  • Capítulo 3 — Perspectiva del trayecto (Mitchell Hashimoto): las seis fases por las que pasa un ingeniero serio hasta integrar agentes en su día a día. El caso real que muestra cómo el harness emerge desde la práctica.

  • Capítulo 4 — Protocolo para agentes: capítulo operativo dirigido directamente a un agente IA. Diseñado para que tu agente lo lea y construya el harness del proyecto en el que estás trabajando, aplicando las mejores prácticas de los capítulos 1, 2 y 3.

  • Capítulo 5 — Perspectiva de investigación (HarnessCompass): traducción completa del paper que automatiza la evolución del harness. Es autoconclusivo: incluye el método, todas las tablas de resultados y los prompts íntegros del apéndice, así que leerlo equivale a leer el paper original.

Estructura

flowchart LR
    A["Capítulo 1<br/>Anthropic"] -->|"el qué<br/>y el cómo"| C["Tu harness"]
    B["Capítulo 2<br/>Martin Fowler"] -->|"el porqué<br/>y el dónde"| C
    M["Capítulo 3<br/>Mitchell Hashimoto"] -->|"el cómo se<br/>llega ahí"| C
    P["Capítulo 5<br/>HarnessCompass"] -->|"cómo evoluciona<br/>sin sobreajustar"| C
    C --> D["Agentes<br/>confiables"]
#CapítuloFuenteFoco
1Harnesses para agentes de larga duraciónAnthropic EngineeringImplementación: feature list, progress file, init.sh
2Harness Engineering — el marco de ingenieríaMartin Fowler / ThoughtworksTeoría: feedforward/feedback, harnessability, ley de Ashby
3El viaje de adopción de Mitchell Hashimotomitchellh.comPráctica vivida: 6 fases de adopción real, AGENTS.md, slam dunks
4Protocolo para agentes: construí tu harnessSíntesis ejecutablePara agentes IA: protocolo paso a paso para crear el harness de un proyecto
5HarnessCompass: evolución automática de harnessesarXiv:2608.01918 (Zhang et al.)Paper completo traducido: compuerta de generalización, feedback proactivo, fusión R³, resultados SWE-bench y prompts íntegros

Cómo leerlo

  • Si nunca construiste un harness: empezá por el capítulo 1. Tiene una receta concreta que podés copiar y adaptar a tu proyecto en una tarde.
  • Si ya tenés un harness funcionando y querés mejorarlo: el capítulo 2 te dará el vocabulario y los principios para razonar sobre dónde están los huecos.
  • Si lo que queres es decidir si invertir en harness engineering en tu equipo: leé el capítulo 2 primero — el modelo mental hace ver el ROI antes de bajarse a la implementación.
  • Si recién empezás a usar agentes y todo te parece frustrante: saltá al capítulo 3. El relato de Hashimoto te ubica en qué fase estás y qué podés esperar de la siguiente.
  • Si lo que querés es delegarle a tu agente que construya el harness: leé los capítulos 1-3 para ganar criterio, después invocá al agente diciéndole “leé el capítulo 4 del tutorial de harness engineering y construí el harness para este proyecto”.
  • Si tu harness ya creció y sospechás que acumuló reglas que no sirven: andá al capítulo 5. La compuerta de generalización y el paso de poda te dan un criterio duro para decidir qué se queda y qué se borra. Es el capítulo más largo — está escrito para reemplazar la lectura del paper, no para acompañarla.

Lecturas de referencia

← Volver al listado de tecnologías