Agli agenti serve una fabbrica, non un prompt migliore
Se i Suoi agenti producono buon lavoro il lunedì e si degradano silenziosamente entro venerdì, il problema non è il prompt: è che nulla, al di fuori del prompt, sopravvive alla sessione. Il 25 luglio 2026 Guillermo Rauch ha condensato l'alternativa in una frase: la fabbrica del software è il prodotto (Rauch su X). Quando abbiamo messo dieci agenti di programmazione contemporaneamente sulla nostra base di codice, il limite non è mai stato la qualità del modello, bensì la velocità con cui una persona riusciva a rivedere ciò che tornava indietro. È un problema di fabbrica, e i problemi di fabbrica si risolvono con la struttura.
La tesi della fabbrica e perché arriva proprio adesso
L'amministratore delegato di Vercel e creatore di Next.js è stato netto: «La fabbrica del software è il prodotto. Il vostro prodotto vale quanto valgono gli agenti che predisponete per mantenerlo in autonomia» (Rauch su X). L'intuizione la attribuisce a ciò che Tesla ha capito della produzione industriale: la linea che costruisce l'automobile è un problema ingegneristico più difficile e più prezioso dell'automobile stessa.
Resterebbe una bella metafora, se i numeri non si muovessero nella stessa direzione. Guillermo Rauch afferma inoltre che gli agenti avviano ormai più della metà di tutti i rilasci sulla piattaforma di Vercel (Startup Fortune, 26 luglio 2026). Quando gli agenti rappresentano la maggior parte di ciò che arriva in produzione, la domanda non riguarda più il modo di formulare una richiesta, ma l'aspetto del meccanismo che genera quei cambiamenti di continuo.
La maggior parte dei team è ancora ferma alla prima domanda: conserva una raccolta di prompt ben riusciti, ne lima le formulazioni e affronta ogni sessione come una trattativa nuova con il modello. Regge finché il lavoro non supera la durata della sessione, ed è esattamente il punto in cui l'ingegneria agentica si separa dall'improvvisazione.
Di che cosa è fatta davvero una fabbrica di agenti
Tolta la metafora, i componenti hanno ben poco di spettacolare.
1. Un file di istruzioni duraturo. Un unico punto che descrive il funzionamento del repository: comandi di compilazione, convenzioni, regole di test e i vincoli che un agente non può ricavare leggendo il codice. È esattamente ciò per cui AGENTS.md è stato pensato (specifica).
2. Un insieme di file con il lavoro pregresso. Guillermo Rauch descrive la propria impostazione come una cartella di ricerca, un file di istruzioni e un agente da riga di comando al di sopra, senza applicazioni e senza grafi della conoscenza, con l'agente che collega le conoscenze raccolte nelle sessioni precedenti (Rauch su X). File semplici, consultabili e versionati.
3. Tetti alle iterazioni. Un limite ai tentativi concessi all'agente prima che si fermi e chieda. Senza quel limite, un agente disorientato consuma il budget per dimostrare di essere disorientato.
4. Un ciclo di validazione. Test, soglie di valutazione e una fase di revisione che stabilisce che cosa viene integrato. È la parte che quasi tutti saltano.
Nulla di tutto ciò è esotico: si tratta di infrastruttura ingrata, per la cui costruzione nessuno riceve riconoscimenti, ed è proprio questa la ragione per cui a essere incolpato è sempre il prompt.
Il file di istruzioni regge tutto, ed è più breve di quanto si creda
Il formato è volutamente dimesso: markdown, titoli ed elenchi puntati, nessun campo obbligatorio, nessuna sintassi speciale (specifica). Il repository di riferimento mostra le sezioni consuete, ovvero indicazioni sull'ambiente di sviluppo, istruzioni di test e convenzioni (repository di riferimento). Ciò che vi trova posto è l'orientamento operativo che un agente davvero non può dedurre: comandi di compilazione, convenzioni di scrittura, regole di test e vincoli inderogabili (guida di Augment Code, aggiornata il 18 giugno 2026).
A questo punto scatta il riflesso di scrivere di più. Le evidenze di luglio 2026 dicono il contrario. Anthropic ha rimosso circa l'80% del prompt di sistema di Claude Code per i modelli della generazione Claude 5 e ha reso pubblico ciò che ne ha appreso sulla scrittura di prompt di sistema, competenze e file di istruzioni (ingegnere di Anthropic su X, 24 luglio 2026), con un'analisi approfondita di Developers Digest. I modelli più capaci hanno bisogno di meno istruzioni, non di più. Un file di istruzioni gonfio è una fabbrica che ha scambiato la documentazione per uno strumento di lavoro.
La stessa disciplina compare nelle raccomandazioni di Anthropic sulla redazione delle competenze degli agenti: mantenere il corpo del testo sotto le 500 righe e spostare i dettagli in file richiamati anziché inserirli per intero (documentazione di Anthropic). Metta per iscritto le regole che cambiano il comportamento ed elimini il resto. Per esaminare quanto è già presente, la nostra guida alla verifica delle competenze degli agenti indica da dove conviene partire.
Un archivio di file batte una finestra di contesto più ampia
Se una cartella di ricerca porta un vantaggio, la ragione è meccanica e non estetica. All'avvio gli agenti caricano solo la denominazione e la descrizione di ciascuna competenza, all'incirca da 30 a 50 token per voce, recuperano le istruzioni complete quando un compito corrisponde e i file richiamati soltanto al momento dell'esecuzione (la divulgazione progressiva spiegata, 1º luglio 2026). Un archivio di file è quindi l'indice più economico possibile: l'agente paga solo ciò che apre.
L'alternativa consiste nel ricopiare in ogni richiesta le decisioni degli ultimi tre mesi. Costa token a ogni singola esecuzione e peggiora con l'aumentare del volume. Scrivere su disco non costa nulla per esecuzione e produce interessi composti. Questo squilibrio riassume l'intero argomento a favore di un'architettura fondata sui file, ed è la stessa ragione per cui l'orchestrazione di più agenti su larga scala funziona solo se lo stato risiede fuori dalla conversazione.
C'è poi un effetto di secondo ordine che spesso sfugge. Quando il lavoro pregresso è su disco in un formato coerente, l'agente può collegare una sessione all'altra: quali decisioni sono state prese, che cosa è già stato tentato, che cosa è fallito. Non serve alcun grafo della conoscenza: bastano una cartella e una convenzione di denominazione.
Senza validazione l'autonomia non scala
È qui che si apre il vero divario. Una ricognizione delle pratiche del 2026 lo dice senza giri di parole: la maggior parte dei team che porta agenti in produzione non li verifica, e la proposta è valutare le esecuzioni in base al completamento del compito, all'uso degli strumenti, al costo e alla sicurezza (argomento a favore di un banco di prova, 8 giugno 2026). Le risposte sotto il messaggio di Guillermo Rauch arrivano alla stessa conclusione dal lato opposto: una fabbrica vale quanto i suoi cicli di retroazione e, senza una validazione affidabile, l'autonomia non scalerà (discussione sul messaggio).
Ci siamo arrivati dal lato della produttività. Far girare dieci agenti in parallelo non ha decuplicato il risultato: ha moltiplicato il volume di lavoro in attesa di una decisione umana, ed è per questo che la revisione si è rivelata il vero collo di bottiglia. Aggiungere agenti a un sistema privo di una soglia automatica non produce più lavoro consegnato, ma una coda più lunga.
Il settore sta convergendo su questa lettura. Un confronto fra agenti di programmazione pubblicato a giugno 2026 ordina l'intera categoria secondo impalcatura tecnica, costo e accuratezza anziché secondo la sola scelta del modello (Firecrawl, 10 giugno 2026).
Open Agents, l'applicazione di riferimento di Vercel, è istruttiva per la stessa ragione: ciò che viene consegnato è la metà ingrata, ovvero l'interfaccia web, l'ambiente di esecuzione, la gestione degli spazi isolati e il collegamento al repository (Open Agents). Nessuno ha dovuto costruire un modello migliore per rendere utile tutto questo: è stato necessario costruire la stanza in cui il modello lavora. È lo stesso schema che avevamo seguito nel cambio di piattaforma di Vercel nel 2026.
Dove il prompt estemporaneo resta vincente e da che cosa conviene partire
L'obiezione è fondata e non va liquidata. Se un compito capita una volta sola, il prompt è più rapido e la fabbrica è puro sovraccarico. Il lavoro esplorativo, quando la forma del problema è ancora ignota, viene addirittura danneggiato da istruzioni rigide, perché queste fissano ipotesi non ancora verificate. Alle basi di codice piccole, seguite da una sola persona, manca spesso la ripetizione necessaria perché la struttura si ripaghi. Infine, un file di istruzioni superato è peggio della sua assenza, poiché indirizza gli agenti con sicurezza verso convenzioni abbandonate da mesi.
I due criteri sono la ricorrenza e la durata. Questo compito si ripresenterà, e il suo risultato deve sopravvivere alla sessione? Due no significano scrivere un prompt e proseguire. Due sì significano metterlo per iscritto.
Se entrambe le risposte sono affermative, proceda in quest'ordine:
- Prima il file di istruzioni. Solo ciò che un agente non può dedurre dal codice. Cominci breve, perché le evidenze di luglio 2026 depongono a favore della sobrietà (guida all'ingegneria del contesto).
- Poi l'archivio di file. Una cartella per il lavoro pregresso, con una convenzione di denominazione che verrà davvero rispettata.
- Quindi il tetto. Un limite fermo alle iterazioni prima che l'agente si fermi e chieda.
- Da ultimo la validazione, senza mai ometterla. Qualunque sia la soglia che decide l'integrazione, automatizzi la parte automatizzabile.
L'ordine conta, perché ogni passo rende meno costoso il successivo. Istruzioni senza validazione producono risultati rapidi, sicuri di sé e mai riletti. Validazione senza istruzioni respinge lavoro per motivi che all'agente non sono mai stati comunicati.
L'aspetto scomodo della tesi di Guillermo Rauch è che nulla di tutto ciò riguarda l'arte del prompt. È lo stesso lavoro che vent'anni fa ha reso preziosa l'integrazione continua, rivolto a una nuova categoria di forza lavoro. I team che nel 2027 otterranno rendimenti crescenti dagli agenti sono quelli che nel 2026 scrivono i file ingrati.
Se preferisce far progettare questo strato anziché ricomporlo da articoli di blog, il nostro team lo costruisce per chi opera, dalle istruzioni alla struttura del lavoro pregresso, fino alle soglie che decidono che cosa viene rilasciato.
Domande frequenti
Che cos'è una fabbrica di agenti? Una fabbrica di agenti è il sistema duraturo che circonda un agente: file di istruzioni persistente, archivio consultabile del lavoro pregresso, tetti alle iterazioni e una soglia di validazione. Incide sulla qualità del risultato più della formulazione del prompt (Rauch su X).
AGENTS.md è obbligatorio oppure posso usare un altro file? AGENTS.md è un formato aperto, non un obbligo: markdown puro, senza campi obbligatori e senza intestazione YAML (specifica). Conta meno il nome del file che l'esistenza di un punto stabile letto dagli agenti a ogni esecuzione.
Quanto dovrebbe essere lungo il file di istruzioni? Più breve di quanto suggerisca l'istinto. Anthropic ha rimosso circa l'80% del prompt di sistema di Claude Code per i modelli Claude 5 e le sue stesse raccomandazioni limitano il corpo del testo a 500 righe, spostando i dettagli in file richiamati (documentazione di Anthropic).
Servono una base vettoriale o un grafo della conoscenza per il lavoro pregresso? No. Guillermo Rauch descrive la propria impostazione come una cartella di ricerca, un file di istruzioni e un agente da riga di comando, senza applicazioni e senza grafi della conoscenza (Guillermo Rauch su X). File e una convenzione di denominazione coprono la gran parte dei casi.
Quando una fabbrica non vale lo sforzo? Quando il compito capita una volta sola, quando la forma del problema è ancora in esplorazione oppure quando la base di codice offre troppa poca ripetizione per ammortizzarne l'impianto. Per il lavoro usa e getta il prompt resta lo strumento corretto (confronto fra impalcature tecniche).
Fonti
- Rauch su X: «La fabbrica del software è il prodotto» — 25 luglio 2026
- Ingegnere di Anthropic su X: le nuove regole dell'ingegneria del contesto per i modelli Claude 5 — 24 luglio 2026
- Le nuove regole dell'ingegneria del contesto per i modelli Claude 5 — 24 luglio 2026
- Guillermo Rauch: gli agenti avviano più della metà dei rilasci su Vercel — 26 luglio 2026
- AGENTS.md, un formato aperto per guidare gli agenti di programmazione — specifica in evoluzione, verificata il 27 luglio 2026
- Repository di riferimento agents.md — repository in evoluzione, verificato il 27 luglio 2026
- Anthropic: buone pratiche per la redazione delle competenze degli agenti — documentazione in evoluzione, verificata il 27 luglio 2026
- Applicazione di riferimento Open Agents di Vercel — verificata il 27 luglio 2026
- I migliori agenti di programmazione nel 2026: impalcatura tecnica, costo e accuratezza a confronto — 10 giugno 2026
- Come costruire il proprio AGENTS.md — aggiornato il 18 giugno 2026
- Valutazione degli agenti nel 2026: costruire un banco di prova — 8 giugno 2026
- Che cosa sono le competenze di Claude? Le competenze degli agenti spiegate — 1º luglio 2026