Agent Harness Engineering

À retenir

1. Date et auteur. 19 avril 2026, Addy Osmani (Google, Cloud + Gemini, ex-Chrome).
2. Équation pivot. (créditée à Viv Trivedy) : "Agent = Model + Harness. If you're not the model, you're the harness." Reformulation Osmani : "a decent model with a great harness beats a great model with a bad harness".
3. Crédits explicites :
4. Viv Trivedy. a créé le terme harness engineering, post "Anatomy of an Agent Harness" est la dérivation la plus claire.
5. Dex Horthy / HumanLayer. framing "skill issue" — la plupart des échecs d'agent sont des problèmes de config, pas de poids.
6. Anthropic Engineering. meilleur breakdown public sur le design de harnais long-running.
7. Birgitta Böckeler. bonne vue côté utilisateur.
8. Ratchet principle. "Every line in a good AGENTS.md should be traceable back to a specific thing that went wrong." On n'ajoute une contrainte qu'après une vraie défaillance. On ne la retire que quand un modèle plus capable l'a rendue redondante.
9. Skill issue reframe (HumanLayer). "It's not a model problem. It's a configuration problem." Le default "wait for the next version" est explicitement rejeté.
10. Terminal Bench data. (Trivedy/HumanLayer cité) : sur Terminal Bench 2.0, Claude Opus 4.6 dans Claude Code score nettement plus bas que le même modèle dans un harnais custom. L'équipe Trivedy a fait passer un coding agent de Top 30 à Top 5 en ne changeant que le harnais. Preuve empirique massive.
11. Pattern "working backwards from behaviour" : "behaviour we want (or want to fix) → harness design to help the model achieve this". Si tu ne peux pas nommer le comportement qu'un composant délivre, il ne devrait pas être là.
12. 7 primitives du harnais. 1. Filesystem & Git : état durable, workspace partagé humains/agents, versioning gratuit. 2. Bash & code execution : "the difference between teaching someone to use a single kitchen gadget and handing them a kitchen." Willison cité. 3. Sandboxes : isolation, bons défauts (runtimes pré-installés, headless browser pour vérification). 4. Memory & search : AGENTS.md rechargé à chaque tour + MCP/Context7 pour combler le cutoff. 5. Battling context rot : 3 techniques — compaction (résumés intelligents), tool-call offloading (head/tail tokens, output complet sur disque), skills with progressive disclosure (révéler tools/instructions à la demande). Anthropic ajoute le full context reset avec hand-off file structuré. 6. Long-horizon execution : Ralph Loop (hook qui ré-injecte le prompt original dans une fresh context window), planning avec plan file, planner/generator/evaluator split (Anthropic explicite : "separating generation from evaluation outperforms self-evaluation"), sprint contract (négocier la condition de "done" avant le code). 7. Hooks : enforcement layer. Principe HumanLayer : "success is silent, failures are verbose". Block destructive bash, run typecheck après edit, require approval avant push main.
13. AGENTS.md. "flat markdown rulebook at the root of your repo... lands in the system prompt every turn." HumanLayer garde le sien sous 60 lignes. "Pilot's checklist, not style guide. Earn each line."
14. Tool economy. "Ten focused tools outperform fifty overlapping ones because the model can hold the menu in its head." Sécurité MCP : tool descriptions = trusted text, MCP malveillant peut prompt-inject avant que tu tapes quoi que ce soit.
15. Architecture Claude Code en couches. (référence Fareed Khan) : input layer (UI, session manager, permission gate) → knowledge layer (skill registry, context compressor, task graph, memory store) → integration layer (MCP runtime) → execution layer (tool dispatch, streaming runtime, prompt cache) → output layer → observability layer → multi-agent layer (subagent spawning, mailboxes, FSM protocol, autonomous board, worktree isolator). Master agent loop au centre.
16. "Harnesses don't shrink, they move". (Anthropic) : aphorisme structurant. Opus 4.6 a tué le mode d'échec context-anxiety de Sonnet 4.5 → toute la scaffolding "anxiety-mitigation" est désormais dead code. Mais le plafond a bougé : nouvelles tâches débloquées → nouvelles failure modes → nouveau scaffolding (memory policy multi-jours, coordination de 3 agents spécialisés, evaluators design-quality).
17. Citation Anthropic clé. "every component in a harness encodes an assumption about what the model can't do on its own."
18. Model-harness training loop. primitive découverte dans le harnais → standardisée dans le produit → utilisée pour post-training du modèle suivant → modèle suivant meilleur sur cette primitive. Cycle. Crée du co-training / overfitting : "a genuinely general model wouldn't care whether you used apply_patch or str_replace, but co-training creates overfitting." Explique pourquoi Opus 4.6 "feels different inside Claude Code than inside someone else's harness".
19. Harness-as-a-Service (HaaS). framing Trivedy. Bascule de "build on LLM APIs (completion)" → "build on harness APIs (runtime)". Triade citée : Claude Agent SDK, Codex SDK, OpenAI Agents SDK. Quatre piliers de configuration : system prompt, tools, context, subagents. Aphorisme Trivedy : "good agent building is an exercise in iteration. You can't do iterations if you don't have a v0.1."
20. 3 ouvertures pour la suite. 1. Multi-agent orchestration sur codebase partagée. 2. Harnais auto-analytiques qui détectent et corrigent leurs propres failure modes. 3. JIT tool/context assembly — "harnesses stop being static config and start becoming something closer to a compiler."
21. Observation de fond : "Look at the top coding agents side by side (Claude Code, Cursor, Codex, Aider, Cline) and they look more like each other than their underlying models do. The models are different. The harness patterns are converging."
22. Articulation dossier veille : pièce de consolidation doctrinale entre Trivedy (fondateur du terme, mars 2026), Böckeler (vue utilisateur, avril 2026), Seale (semantic agent, avril 2026). Osmani agrège et stabilise le vocabulaire commun.