Perché questo libro
Vent’anni di esperienza sul campo, passati a scrivere codice e a rilasciare servizi e prodotti digitali, mi hanno insegnato che non c’è nulla di più stimolante che risolvere problemi complessi e costruire strumenti che semplificano la vita ad aziende e utenti. Ora quel mestiere sta cambiando, e questo libro nasce per capire in che cosa.
Da quando lavoro con un agente, scrivere codice mi occupa meno tempo di prima, e cresce tutto ciò che sta attorno: decidere che cosa costruire, stabilire fin dove l’agente può spingersi, controllare quello che torna indietro dalle iterazioni. Finché questa capacità di discernimento e direzione resta mia, il mestiere non si impoverisce. Il rischio è cederla senza accorgermene.
Contro questo rischio sto costruendo quello che il libro racconta: un metodo, un harness e un progetto vero su cui collaudare l’uno e l’altro.
Il libro ha due parti.
La prima riguarda il mestiere: che cosa resta del lavoro di un Senior quando scrivere righe di codice non è più il collo di bottiglia, che differenza c’è fra esperienza e discernimento, come si formula un mandato, come si verifica un lavoro che non si è svolto in prima persona, come sopravvive alla sessione ciò che Senior e agente hanno compreso insieme. Questa parte non dipende da un framework agentico in particolare: i principi valgono con l’assistente di oggi e, spero, con quello che lo sostituirà.
La seconda parte scende dove quei principi si materializzano in comportamento: i punti di un framework agentico su cui un Senior può mettere le mani — il testo che vincola l’agente, le procedure che l’agente può richiamare, gli strumenti di cui dispone, il ciclo di vita della sessione, gli hook di Git. Racconto le scelte che ho fatto, comprese quelle che non hanno retto, perché il metro non è che il lettore capisca il mio harness: è che sappia dove intervenire nel proprio.
Chi è il Senior amplificato
Il soggetto di questo libro è una persona, non uno strumento: il Senior — chi conosce il lavoro, decide e risponde delle conseguenze — nel momento in cui l’intelligenza artificiale ne estende la portata senza sostituirne il giudizio. «Amplificato» dice questo: non un Senior rimpiazzato dall’agente, ma un Senior che arriva più lontano restando sé stesso, con l’esperienza, i vincoli e i pattern che ha maturato negli anni.
In concreto, amplificare vuol dire non lasciare che l’agente improvvisi: trasformare quel patrimonio in vincoli riusabili e conservarli in modo che l’agente li ritrovi e li applichi.
Il metodo e l’harness con cui metto alla prova la mia tesi sono SAF, Senior Amplification Framework. Lo dico subito: SAF è un banco di prova, non il protagonista del libro; è l’esperimento con cui verifico come l’amplificazione avvenga davvero.
Oltre le istruzioni: la cabina di pilotaggio
Quei vincoli non si costruiscono scrivendo semplici prompt. Credo che il settore si sia concentrato troppo sulla parte facile: le istruzioni nel contesto del modello, dalla singola richiesta alle regole di comportamento. Servono, ma un’istruzione orienta la risposta, non la determina: i modelli producono output probabilistici, e la stessa istruzione può portare a esiti diversi da una sessione all’altra.
Quando l’agente tocca il lavoro vero, lo scarto tra istruzione ed esito diventa il problema.
L’approccio serio comincia dove le istruzioni finiscono: nella personalizzazione del framework agentico — come costruisce il contesto, quali eventi espone, dove un hook rifiuta un’azione. Questa è la cabina di pilotaggio: chi scrive gli strumenti decide che cosa l’agente può fare, su quale ambiente e con quale traccia di esecuzione.
Un’istruzione chiede al modello di evitare un’azione; uno strumento che non esiste gliela rende impossibile lungo quel percorso.
In tutto questo non c’è niente di esotico: è il mestiere di sempre dello sviluppatore, che si confronta con API, SDK e punti di estensione. Chi costruiva servizi con le proprie mani ora costruisce i vincoli attorno all’agente. Il libro segue questo spostamento: dalle istruzioni agli strumenti e ai vincoli che delimitano le mosse dell’agente. Il primo passo, però, non riguarda ancora gli strumenti: riguarda ciò che a una sessione di lavoro non sopravvive.