Harness Engineering — Índice
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, más un cuarto capítulo operativo dirigido a agentes:
-
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.
Estructura
flowchart LR
A[Capítulo 1\nAnthropic] -->|"el qué\ny el cómo"| C[Tu harness]
B[Capítulo 2\nMartin Fowler] -->|"el porqué\ny el dónde"| C
M[Capítulo 3\nMitchell Hashimoto] -->|"el cómo se\nllega ahí"| C
C --> D[Agentes\nconfiables]| # | Capítulo | Fuente | Foco |
|---|---|---|---|
| 1 | Harnesses para agentes de larga duración | Anthropic Engineering | Implementación: feature list, progress file, init.sh |
| 2 | Harness Engineering — el marco de ingeniería | Martin Fowler / Thoughtworks | Teoría: feedforward/feedback, harnessability, ley de Ashby |
| 3 | El viaje de adopción de Mitchell Hashimoto | mitchellh.com | Práctica vivida: 6 fases de adopción real, AGENTS.md, slam dunks |
| 4 | Protocolo para agentes: construí tu harness | Síntesis ejecutable | Para agentes IA: protocolo paso a paso para crear el harness de un proyecto |
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”.
Lecturas de referencia
- Effective Harnesses for Long-Running Agents — Justin Young, Anthropic Engineering
- Harness Engineering for Users of Coding Agents — Birgitta Böckeler, martinfowler.com
- My AI Adoption Journey — Mitchell Hashimoto, mitchellh.com