Perché l'IA continua a sbagliare? Non è stupida, sei tu che non l'hai detto chiaro

Partiamo da una scena che con ogni probabilità hai già vissuto.

Chiedi all’IA di costruirti qualcosa, aspetti pieno di aspettative che sforni il risultato, e alla fine quello che tira fuori è a mille miglia da quello che avevi in mente. Correggi una frase, lei sbaglia un punto, avanti e indietro per qualche giro, finché ti scoccia e ti esce di bocca: «Questa IA vale quello che vale.»

In questi mesi uso l’IA per lavorare praticamente ogni giorno, e ogni giorno cado in questa buca. Ma cadendoci e ricadendoci, ho cambiato idea. Perché ho scoperto una regolarità che è una bella lezione di umiltà: stesso requisito, se lo riformulo in un altro modo, lo fa giusto al primo colpo.

Una volta o due è coincidenza, otto o dieci volte non lo è più. Piano piano ho dovuto ammettere una cosa: quando l’IA sbaglia, quasi mai è perché è stupida, è perché io non l’ho detto chiaro.

Non è misticismo, dietro c’è un principio semplicissimo, semplice al punto da risultare quasi crudele:

L’IA non ti legge nel pensiero. Fa solo quello che «dici», non quello che «pensi».

Quel requisito che hai in testa è tridimensionale — ha un contesto, ha delle assunzioni date per scontate di cui neanche ti rendi conto, ha tutto un corredo di ovvietà tipo «ma non è lampante?». Però la frase che digiti nella casella di dialogo, spesso, ne conserva solo un sottile straterello. Quello che l’IA riceve è proprio quello straterello, il resto lo può solo indovinare. Se indovina, sei stato fortunato; se sbaglia, per giunta la accusi di essere stupida.

Dopo aver capito questa cosa, ho smesso di arrovellarmi su «quale IA è più intelligente» e mi sono girato ad allenare una cosa che vale molto di più: come trasferire per intero, dalla testa alla casella di dialogo, quel requisito tridimensionale. Questo pezzo è tutto il mio metodo. È tutto copiabile pari pari, non c’è una sola formula segreta che richieda talento.

E devo dire una cosa: per i product manager è una notizia meravigliosa. Descrivere i requisiti è da sempre il mestiere di casa del PM. Prima spiegavi il requisito allo sviluppatore, adesso lo spieghi all’IA — l’unica differenza è che lo sviluppatore usa l’esperienza per colmare quello che non hai detto e torna anche a chiederti chiarimenti, mentre l’IA è più ubbidiente e più «sincera», fa esattamente quanto le dici. Perciò con l’IA devi dire le cose un pochino più chiaramente di quanto faresti con uno sviluppatore. Proprio questo pochino è la soglia, ed è lo spartiacque.

Un requisito che fa fare all’IA la cosa giusta al primo colpo ha cinque pezzi

Ho preso i requisiti che avevo «detto chiari» e li ho aperti a vedere: mettono sempre insieme cinque cose. Quale manca, su quella l’IA decide al posto mio.

Non serve scriverle tutte e cinque ogni volta, trasformandolo in un modulo burocratico. Ma in testa devi avere queste cinque caselle — prima di premere invio dai un’occhiata: la casella che resta vuota è quella su cui l’IA farà di testa sua.

Pezzo uno: cosa vuoi — prima di tutto azzecca i nomi

Il più basilare, e anche quello su cui è più facile passarci sopra.

Dici «fammi una cosa per la gestione utenti»: questa «cosa» che roba è? Una pagina? Una tabella? Un intero backend? All’IA non resta che sceglierne una a caso.

Cambia in: «Fai una pagina con l’elenco utenti, una tabella che mostra avatar, nome, email, data di registrazione, stato.» — e subito sa da dove partire.

La regola è una sola: sostituisci le parole vaghe come «cosa», «funzione», «modulo» con nomi concreti. Pagina, tabella, pulsante, form, grafico, popup. Solo se riesci a dire che «roba» è davvero, l’IA riesce a prenderla al volo.

Pezzo due: per chi, perché — l’anello più facile da saltare, e quello che vale di più

Questo anello, chi ha una formazione tecnica lo salta spesso, ed è proprio il campo di casa del PM — sei fatto per interessarti a «chi lo usa e perché».

Confrontiamo. Dici «fammi un cruscotto dati, metti su ogni tipo di dato», e ti riempie uno schermo di grafici che forse non guardi nemmeno.

Cambia in: «Fai un cruscotto dati, per il direttore del punto vendita che lo guarda ogni mattina. A lui interessa soprattutto quanto ha venduto ieri, se rispetto all’altroieri è su o giù, quale categoria vende meglio: questi tre in bella evidenza, il resto secondario.»

Vedi la differenza? Aggiungendo «chi lo usa + cosa gli interessa di più», l’IA sa cosa mettere in risalto e cosa smorzare — comincia ad avere un «punto focale», invece di spalmare tutte le informazioni a terra in modo uniforme.

Ormai ho quasi preso l’abitudine: dopo ogni requisito, aggiungo una riga su «per chi è, quale problema vuole risolvere». Questa frase, spesso, vale più di tutta la descrizione che viene prima messa insieme.

Pezzo tre: la forma concreta — dì «che aspetto ha»

L’idea nella tua testa ha un’immagine, ma tu butti fuori solo una parola astratta.

«Fammi una funzione di filtro» — l’IA non sa cosa vuoi filtrare né come.

«Sopra la tabella aggiungi una fila di filtri: un selettore di intervallo di date, un menù a tendina ‘stato’ (tutti / attivo / disabilitato), un campo di ricerca (cerca per nome o email); il filtro è istantaneo, appena selezioni si aggiorna subito, senza premere conferma.» — e questa te la riproduce uno a uno.

Non serve che tu sappia fare design, ti basta descrivere a parole tue quell’immagine che hai in testa: quali blocchi ci sono, cos’è ciascun blocco, dove sta, come si usa. Se riesci a descriverla, lei riesce a riprodurla; se non riesci a descriverla, vuol dire che non l’hai ancora chiarita nemmeno a te stesso — e va benissimo, è un segnale, più avanti spiego come usarlo per aiutarti a chiarirla.

Pezzo quattro: i confini — lo spartiacque tra «sembra funzionare» e «funziona davvero»

Su questo anello devo spendere due parole in più, perché è la vera differenza tra il principiante e il PM.

Il principiante descrive il requisito solo nel «caso normale»: l’utente compila per bene, i dati sono tutti a posto, la rete è sempre su. Ma nel mondo reale l’utente compila a casaccio, i dati sono vuoti, la rete cade, l’input è troppo lungo. Questi sono i «casi limite», ed è ciò di cui il PM deve più preoccuparsi e che ha più bisogno di dire esplicitamente all’IA.

Dici «fammi un form per inviare feedback, con nome, email, contenuto, un pulsante di invio», e lei ti fa il percorso normale e chiude la pratica.

Se invece dici così:

«…attenzione a questi casi: quando il formato dell’email è sbagliato, sotto il campo mostra un avviso in rosso e non lasciarlo inviare; quando il contenuto del feedback è vuoto, il pulsante di invio non si può cliccare; a invio riuscito svuota il form e mostra ‘grazie per il feedback’; a invio fallito (per esempio rete assente), non svuotare quello che l’utente ha già scritto, e mostra ‘invio fallito, riprova’.»

Queste righe in più sono la professionalità del PM. L’IA è perfettamente in grado di gestire questi casi, ma se non lo dici, di default fa solo il «percorso normale». Elenchi i confini, e lei te lo fa completo al primo colpo.

Tra parentesi, anche «cosa conta come fatto» e «cosa non fare» sono confini, e vanno detti allo stesso modo. Una frase come «questa versione fa solo elenco e filtro, per ora niente aggiunta/modifica/eliminazione» ti para un mucchio di cose che in questo giro non vuoi affatto.

Pezzo cinque: il riferimento — dàlle un metro

Stile, colori, esperienza: queste cose «a sensazione» sono le più difficili da spiegare a parole. Il modo più comodo: dai un riferimento.

«Fai i colori più belli, più professionali» — «bello» e «professionale» li intendono in cento modi diversi cento persone.

«Colore principale il blu del brand #3B82F6, per la palette generale e gli spazi bianchi ispirati a quello stile pulito e sobrio del sito di Stripe.» — ora ha un metro, e non deve tirare a indovinare il «bello» che hai in testa.

Il riferimento può essere un valore colore, un prodotto che ti piace («come Notion»), uno standard. Dato il riferimento, l’IA non deve scommettere sul tuo gusto.

I cinque «non l’ho detto chiaro» più comuni, e come si aggiustano

Sopra c’è lo smontaggio in positivo. Sotto ci sono le cinque buche che vedo di più e in cui pure io casco di più, una per una da controllare su sé stessi.

Buca uno, troppo generico. «Fammi una pagina bella» — ti dà una cosa mediocre e per giunta non sai dire cosa non va. Aggiustamento: spingi di un livello verso il concreto, sostituisci gli aggettivi con nomi e dettagli.

Buca due, dai solo ordini, senza dare contesto. «Aggiungi una funzione di esportazione» — esporta cosa? Dove? In che formato? Aggiunta dove? Aggiustamento: completa «dove + esporta cosa + in che formato», per esempio «in alto a destra nella pagina report aggiungi un pulsante ‘esporta’, al clic esporta in CSV scaricabile la tabella con i filtri attuali».

Buca tre, ne sparo un mucchio in una volta. Infili quindici requisiti in un solo messaggio, il risultato è un pasticcio e non sai nemmeno da dove correggere. Aggiustamento: passi piccoli e veloci, uno alla volta. Prima monta lo scheletro, fallo girare per vedere l’effetto, poi aggiungi un pezzo alla volta. Questa è la più importante di tutte, senza eccezioni.

Buca quattro, niente riferimento, tutto affidato al suo indovinare il gusto. Aggiustamento vedi pezzo cinque: dai valori colore, oggetti di riferimento, standard.

Buca cinque, dici solo il normale, non l’anomalo. La demo scorre liscia, ma appena la dai in mano a un utente crolla in mille modi. Aggiustamento: prima di inviare il requisito fatti tre domande — cosa succede se i dati sono vuoti? cosa succede se l’utente compila a casaccio? cosa succede se la rete cade? Scrivi le risposte dentro il requisito.

Tre mosse: trasformare l’IA da «mano» a «cervello»

Allenato bene quanto sopra, hai già superato la maggior parte delle persone. Le tre mosse qui sotto le uso per trasformare l’IA da «un paio di mani ubbidienti» a «un cervello che mi aiuta a pensare».

Prima mossa, falle prima fare domande, non farla partire subito. È quella che uso di più, ed è anche la più controintuitiva: più il requisito è importante, meno devi farla partire subito, e più devi farti prima interrogare.

«Ho un’idea: fare uno strumento per raccogliere e analizzare i feedback dei clienti. Non metterci mano ancora — prima fammi cinque domande, le più cruciali, per farmi chiarire utente target, uso principale, funzioni indispensabili e confini.»

Le domande che tira fuori sono, nove volte su dieci, proprio i punti che tu stesso non hai ancora chiarito. Il processo con cui rispondi è il processo che spinge il requisito da «un ammasso confuso» a «una cosa chiara». Quando hai finito di rispondere, lei ha già in mano un requisito completo, e il risultato viene naturalmente giusto. L’essenza di questa mossa è usare l’IA per aiutarti a pensare con chiarezza, non solo per aiutarti a costruire — chiarito il pensiero, fare la cosa giusta viene da sé.

Seconda mossa, dai un esempio positivo e uno negativo. Quando le parole non bastano, l’esempio è il modo più rapido, soprattutto per il «voglio questo, non quello».

«Aiutami a scrivere il testo dell’avviso dopo il clic su questo pulsante. Deve essere così: breve, colloquiale, che dà sicurezza — ‘Salvato, tranquillo’. Non così: burocratico, prolisso — ‘La Sua operazione è stata inoltrata con successo al server e la memorizzazione persistente è stata completata’.»

Un esempio positivo più uno negativo valgono più di tre righe di aggettivi che potresti scrivere.

Terza mossa, falle ripetere e confermare, poi metti mano. Quando il requisito è complesso, falle prima ridire la sua comprensione, e solo dopo che confermi che è giusta la fa partire.

«Il requisito che ho appena detto, non farlo ancora. In tre frasi confermami: cosa hai intenzione di fare, in quanti blocchi lo dividi, se c’è qualche punto di cui non sei sicura. Quando ho confermato, allora inizi.»

Questo passo costa trenta secondi e ti risparmia mezz’ora di rilavorazione. Mentre ripete, spesso ti accorgi lì per lì «ehi, qui quello che ho detto non è quello che pensavo» — approfittane finché non ha ancora messo mano, e correggi subito.

Un giro completo: da una frase vaga a farla giusta al primo colpo

Mettendo insieme tutto quanto sopra, guardiamo un giro reale del processo. Poniamo che in testa io abbia solo una frase vaga: «Voglio una cosa che mi faccia vedere i feedback degli utenti.»

Primo passo, non mi affretto a farla partire, prima le faccio aiutarmi a chiarire (prima mossa): le faccio fare cinque domande cruciali. Chiederà: chi lo usa (i colleghi dell’operations)? Da dove arrivano i feedback (un file CSV)? Cosa voglio ricavarne di più (capire in fretta di cosa si lamentano tutti di più)? Ordinare per gravità (sì)? Serve il filtro in questa versione (per ora no)?

Secondo passo, monto le risposte in un requisito completo, e i cinque pezzi ci sono giusti giusti: per l’operations, con lo scopo di vedere in fretta di cosa si lamentano di più gli utenti (per chi, perché); in alto un’area di caricamento per il CSV, sotto mostra in automatico la classificazione per tema dei feedback, quanti per ogni categoria, con che percentuale, ordinati per numero di segnalazioni (cosa voglio, forma); se il CSV è vuoto o di formato sbagliato mostra «lettura fallita, controlla il formato», in questa versione per ora niente filtro né ricerca (confini); pulito e sobrio, colore principale #3B82F6, impaginazione ispirata a Notion (riferimento). Prima montala con dati finti, e avvia un servizio locale per farmela vedere in anteprima.

Terzo passo, girata e visto l’effetto, aggiungo a piccoli passi (aggiustamento della buca tre): uno alla volta — «dopo ogni tema aggiungi una barra di avanzamento che mostra la percentuale», «al clic su un tema espandilo per mostrare tre feedback originali di quella categoria», «colora i temi per gravità: rosso alta frequenza, giallo media, grigio bassa».

Quarto passo, le faccio trovare i problemi da sola: «Clicca ogni punto cliccabile, individua errori, blocchi, cose non conformi alle attese, e fanne un elenco.»

In tutto il processo non ho scritto una riga di codice, ma a ogni passo ho detto le cose chiarissime. Questo è il quotidiano di oggi — tu ti occupi di pensarci chiaro e dirlo chiaro, lei si occupa di costruirlo.

Per finire

Prima di premere invio, di solito mi prendo dieci secondi e in testa ripasso queste caselle: cosa voglio (è un nome concreto?), per chi e perché, che aspetto ha, confini (dati vuoti, compilazione a casaccio, fallimento, cosa non fare — li ho detti tutti?), riferimento, e infine — questa volta ho proposto un solo requisito? Se su sei ne passano quattro o cinque, la fa praticamente giusta al primo colpo.

Chi sa usare l’IA sono sempre di più, ma chi sa dire chiaramente i requisiti resta una minoranza. La prima cosa è una soglia, la può varcare chiunque; la seconda è uno spartiacque, che divide le persone in due gruppi.

E tu, come product manager, sei da sempre quello che conosce meglio gli utenti, che conosce meglio le priorità, che conosce meglio quei confini di cui nessuno si preoccupa al posto tuo. Quello che ti è sempre mancato non sono queste cose, è l’abitudine a dirle. Allenati un mese e scoprirai che non è l’IA a essere diventata più intelligente, sei tu che hai finalmente imparato a consegnare per intero quel requisito che hai in testa.