Diario AI · Parte 2 di 4

Strumenti, non colleghi

Una giornata tipo con gli agenti AI. Cosa delego, cosa non delego mai, dove sbagliano e come me ne accorgo prima che l'errore arrivi in produzione.

Mattinadecidere cosa costruire
Pianoprima del codice
Esecuzionelavorano gli agenti
Revisioneleggo tutto

Quando dico che lavoro “con un team di agenti AI”, la domanda che arriva subito è: ma allora chi scrive il codice? La risposta onesta è: lo scrivono in buona parte gli agenti, ma la responsabilità di ogni riga è mia. Per questo li chiamo strumenti e non colleghi. Un collega risponde del proprio lavoro. Uno strumento no.

Provo a raccontare come si svolge, in concreto, una giornata.

Mattina: decidere cosa costruire

La prima ora non tocca codice. Rileggo le note del giorno prima, i messaggi del cliente, lo stato del progetto. Poi scrivo, in italiano semplice, cosa voglio ottenere oggi: una funzione, un flusso, una correzione.

È la parte che non delego mai. Gli agenti sono bravissimi a eseguire, ma non sanno perché il cliente ha bisogno di quella funzione, quale compromesso è disposto ad accettare, cosa succederà tra sei mesi quando il prodotto crescerà. Queste informazioni le ho solo io, perché sono io che parlo con le persone.

Il piano prima del codice

Prima di far scrivere una riga chiedo un piano: quali file verranno toccati, quali componenti nuovi servono, come verrà verificato il risultato. Lo leggo e quasi sempre lo correggo. A volte l’agente propone una soluzione elegante ma sovradimensionata. Altre volte ignora una convenzione del progetto. Altre ancora non sa che un certo servizio esterno ha limiti che conosco per esperienza.

Correggere un piano costa cinque minuti. Correggere un’implementazione sbagliata ne costa molti di più. È la stessa regola che valeva quando coordinavo persone: si discute sulla lavagna, non sul codice già scritto.

Correggere un piano costa cinque minuti. Correggere un'implementazione sbagliata ne costa molti di più.

Esecuzione: dove gli agenti brillano

Approvato il piano, gli agenti lavorano. Scrivono il codice, i test, aggiornano la documentazione, eseguono la build e leggono gli errori. Su compiti ben definiti sono più veloci di qualunque persona e non si stancano sul lavoro ripetitivo: la quinta schermata simile alla quarta, i test per tutti i casi limite, la migrazione dei dati da un modello all’altro.

Spesso lavorano in parallelo su parti indipendenti. Mentre uno sistema l’interfaccia, un altro scrive i test del servizio di backend. Io intanto penso alla fase successiva o rispondo al cliente.

Revisione: il momento in cui guadagno lo stipendio

Poi arriva la parte più importante. Rivedo tutto, e non in modo superficiale. Le cose che controllo sempre:

  • Fa davvero quello che ho chiesto? Non quello che sembra, quello che ho chiesto. Gli agenti tendono a dichiarare il lavoro finito con grande ottimismo.
  • Sicurezza e dati. Chiavi API, permessi, dati personali. Un errore qui non si sistema con un aggiornamento: è un problema di GDPR, a volte di fiducia del cliente.
  • Le linee guida della piattaforma. Un’app iOS deve comportarsi come un’app iOS. Gli agenti conoscono le Human Interface Guidelines in teoria, ma non sempre le applicano con buon senso.
  • Cosa succede quando va storto. Rete assente, utente che annulla a metà, server lento. Il percorso felice di solito è perfetto, i casi difficili molto meno.
  • Leggibilità. Il codice lo dovrà mantenere qualcuno, magari un’altra persona. Se non lo capisco io a prima lettura, non va bene.

Dove sbagliano (e come me ne accorgo)

Gli errori più frequenti non sono quelli banali di sintassi. Sono più sottili:

  • Inventano. Una funzione di libreria che non esiste, un parametro che non c’è più dalla versione precedente. La build di solito se ne accorge, ma non sempre.
  • Fanno di testa loro. Nella prima versione di Curtain Moments avevo indicato con precisione quali modelli AI usare per leggere i biglietti. L’agente ne aveva scelti altri. L’app funzionava lo stesso, e proprio per questo nessun test se ne sarebbe accorto.
  • Prendono scorciatoie pericolose. Sempre in Curtain, la chiave dell’API di OpenAI era finita dentro l’app. Per un prototipo passa, per un’app pubblica è una chiave regalata a chiunque. L’ho spostata su un server prima del rilascio.
  • Risolvono il sintomo. Un test fallisce e l’agente modifica il test invece del codice. Per questo leggo sempre i test, non solo il risultato “tutto verde”.
  • Perdono il quadro d’insieme. Ogni modifica è ragionevole presa da sola, ma dopo dieci modifiche il progetto ha tre modi diversi di fare la stessa cosa.

Me ne accorgo perché conosco il progetto e perché non accetto nulla che non ho letto. È tutto qui il segreto, e non è un segreto: è la disciplina che si impara quando ogni errore lo vedi esplodere su un banco di prova.

Cosa non delego mai

  1. La conversazione con il cliente.
  2. Le scelte di architettura.
  3. Il via libera al rilascio in produzione.
  4. Tutto quello che riguarda dati personali e sicurezza.
  5. La decisione di dire “no, questa funzione non serve”.

Perché funziona

Il risultato è uno studio piccolo che riesce a fare il lavoro di un team strutturato, senza perdere il contatto diretto con chi il prodotto lo usa. Il cliente parla con chi decide e risponde del risultato. Gli agenti moltiplicano il tempo, io garantisco la qualità.

Nel prossimo articolo racconto un caso concreto: come è nata Curtain Moments, dall’idea alla pubblicazione su App Store, con questo metodo. Comprese le parti che ho dovuto riscrivere a mano.

Hai un’idea da portare in produzione?

Con Venezia.tech progetto e sviluppo app, piattaforme web e integrazioni AI, con lo stesso metodo che racconto qui.

Prenota una call Leggi tutto il diario