Harness engineering: come costruire un agente AI affidabile
Articoli: 8
Harness engineering (ingegneria dell'harness) è la disciplina che studia come costruire, attorno a un modello linguistico, un ambiente in cui un agente AI svolge in modo affidabile il lavoro reale. La formula del tema è: Agente = Modello + Harness. Lo stesso modello, in un progetto, lavora come uno sviluppatore esperto e, in un altro, perde il contesto e dichiara pronta una funzionalità che non funziona. La differenza sta quasi sempre nell'harness, non nel modello.
Questa guida è la mappa del tema. Raccoglie i concetti chiave e l'ordine in cui conviene impararli. Ogni argomento è approfondito in un articolo dedicato.
I cinque componenti dell'harness
- Istruzioni — i file CLAUDE.md e AGENTS.md, i documenti tematici e le skills: ciò che l'agente sa del progetto.
- Strumenti — shell, modifica dei file, browser, server MCP: con cosa l'agente agisce.
- Ambiente — sandbox, container, copia di lavoro isolata: dove l'agente esegue i comandi.
- Stato — file di piano e di avanzamento, cronologia git: la memoria tra una sessione e l'altra.
- Feedback — test, linter, hook, un verificatore indipendente: come l'agente scopre i propri errori.
I componenti formano un ciclo chiuso. Se se ne toglie uno, il ciclo si interrompe: senza verifiche l'agente non vede gli errori, senza stato ogni sessione ricomincia da zero.
Da dove iniziare
Se il tema è nuovo, parti dall'articolo che spiega cos'è l'harness engineering e in cosa si distingue dal prompt engineering e dal context engineering. Una definizione breve con un esempio si trova nell'articolo sull'harness dell'agente.
Poi passa alla pratica. Il primo file che incontra chiunque è quello delle istruzioni di progetto: cosa scrivere in CLAUDE.md e AGENTS.md, cosa evitare, e perché l'agente ignora una regola scritta chiaramente nel file.
Quando l'agente lavora già nel progetto, si pone la questione dell'affidabilità. Il piano passo passo parte dal registro dei fallimenti e dalle metriche MTBF e MTTR, passa per il rollback economico, i cicli di feedback e la memoria in file, fino al ciclo autonomo in cui l'agente lavora per ore senza supervisione.
Principi fondamentali
- L'agente non è rotto: è rotto l'ambiente. Cerca prima la falla nell'harness, non cambiare il modello.
- Parti dal feedback: un solo comando di verifica vale più di un'intera pagina di istruzioni.
- Le istruzioni sono una mappa, non un manuale: un file d'ingresso breve e i dettagli da consultare quando servono.
- Ciò che conta vive nei file, non nella finestra di contesto.
- Misura: un registro dei fallimenti invece delle sensazioni.
I cinque componenti e l'assemblaggio completo dell'harness sono trattati in pratica in un corso che lavora su un unico progetto reale.