Patto con il lettore
Questo libro è per te, se conosci la complessità reale dello sviluppo software e vedi mutare il tuo ruolo: non soltanto scrivere codice, ma orchestrare entità capaci di generarlo.
Oggi la sfida sta nel gestire la natura probabilistica di un agente che può offrire una soluzione brillante o una deviazione costosa; padroneggiare la sintassi e i costrutti di un linguaggio si dà ormai per acquisito. In questa transizione la competenza Senior si sposta dalla scrittura diretta alla progettazione dei sistemi che governano il lavoro dell’agente.
Per dare forma a questa relazione, il libro usa il termine System Harness per l’infrastruttura che avvolge l’agente, ne delimita le mosse e conserva le decisioni insieme alle ragioni che le hanno prodotte. Il perimetro preciso arriva nell’Introduzione; qui basta il nome.
Quello che il libro racconta è un esperimento tecnico: costruire con un agente un rapporto di lavoro che regga nel tempo. Un rapporto così non si dichiara in un prompt di avvio, e regge soltanto se l’agente non riparte da zero a ogni sessione. Disegno, limiti e condizione di smentita stanno in L’esperimento, poco più avanti.
Questo libro non promette produttività automatica, non è un manuale d’uso e non mette a disposizione un repository di codice da scaricare. Quello che offre è ingegneria del rapporto collaborativo: i confini, le responsabilità e le logiche con cui un Senior trasforma la generazione di testo in lavoro governato.
Una precisazione, perché l’equivoco è frequente: questo non è un libro contro gli strumenti, né a favore di uno in particolare. Quale assistente si usi conta molto meno di dove passa il confine della delega, e gli strumenti cambiano più in fretta di quanto un libro si scriva.
Il problema non è usare Claude Code, Cursor o Codex. Il problema è delegare il giudizio invece dell’implementazione.
La delega del giudizio non ha un interruttore, e quasi nessuno la dichiara: avviene per gradi, mentre il lavoro continua a sembrare in ordine. Per questo il libro insiste sui confini, sulle verifiche e sulle condizioni di arresto invece che sulla scelta dello strumento.
Gli esempi del libro sono fittizi: personaggi e situazioni inventati a partire da esperienze di mestiere, per isolare un principio senza il rumore del caso originale. L’harness che racconto fa eccezione: ne descrivo capacità e scelte verificate sulla sua implementazione.
Resta la responsabilità dell’errore. Il Senior delega l’esecuzione e alcune decisioni operative circoscritte, ma non trasferisce all’agente né al System Harness la responsabilità finale delle conseguenze: la esercita attraverso l’harness, che rende espliciti confini, verifiche e condizioni di arresto. Che si usi l’harness descritto in questo libro o un altro, del risultato risponde sempre una persona: il Senior. Nel tuo progetto, quella persona sei tu.