Quando usarlo

Due segnali. Il primo: ti accorgi di riscrivere lo stesso prompt con piccole varianti per la terza volta in un mese. Il secondo, più costoso: due colleghi fanno lo stesso compito con l’AI e i risultati non si somigliano, perché ognuno ha il suo prompt improvvisato. In entrambi i casi la soluzione ha la stessa forma: un prompt riusabile non è un prompt lungo, è un prompt con dei buchi espliciti.

Cosa serve

Gli ultimi tre prompt che hai scritto per compiti dello stesso tipo (cercali nella cronologia delle conversazioni: ci sono) e un posto condiviso dove il risultato vivrà. Niente altro.

I passi

1 · Separa la parte fissa dalla parte variabile. Metti i tre prompt uno sotto l’altro e guarda cosa resta uguale: chi legge il risultato, la forma dell’output, i criteri di qualità, gli errori da evitare. Quella è la parte fissa. Quello che cambia (il caso di oggi, il materiale) diventa un buco con un’etichetta. Se non vedi la separazione a occhio, falla fare all’assistente:

Ecco tre prompt che ho scritto per compiti simili: [incollali]. Individua cosa resta uguale nei tre e cosa cambia. Riscrivi la parte comune come prompt riusabile, con segnaposto tra parentesi quadre per le parti variabili.

2 · Rendi la parte fissa verificabile. «Tono professionale» lo interpreta ognuno a modo suo; «massimo mezza pagina, senza frasi tipo “purtroppo non è stato possibile”, con la nuova data sempre esplicita» si controlla a colpo d’occhio. Ogni criterio vago nella parte fissa è una divergenza futura tra colleghi. Se hai un esempio di output venuto bene, incollalo dentro la parte fissa: un esempio vale tre paragrafi di criteri.

3 · Prova il prompt su un caso che non è tra i tre di partenza. È il collaudo minimo: se funziona solo sui casi da cui l’hai distillato, non è ancora riusabile. Un caso nuovo, un giro, e guarda se il risultato regge senza istruzioni aggiunte a voce.

4 · Mettilo dove il team lo trova, con un nome che si cerca. Le tre soluzioni in ordine di impegno: un documento condiviso con un titolo per prompt; le istruzioni permanenti di uno spazio condiviso dell’assistente (Project di Claude, GPT condiviso, Gem), dove la parte fissa è già caricata e si incolla solo il caso; oppure, per chi lavora con i file, un prompt.md nel repository del progetto. Il criterio di scelta è uno solo: dove guarderà il collega che ne ha bisogno tra due settimane?

5 · Stabilisci chi lo aggiorna, e quando. La regola pratica: se riempendo i buchi aggiungi la stessa istruzione extra per la seconda volta, quella istruzione entra nella parte fissa. Chi se ne accorge la aggiunge, come su una wiki. Un prompt condiviso che nessuno può toccare muore in un mese; uno che tutti correggono migliora a ogni uso.

Un esempio completo

Prendi il compito di smistamento delle dieci email di esempio del corso. Parte fissa: «Sei l’assistente di uno studio web. Per ogni email nel materiale: mittente, tema, urgenza (alta, media, bassa, nessuna) e prossima azione in una riga. Le proposte commerciali non richieste hanno urgenza nessuna. Gli avvisi automatici che riguardano siti di clienti non sono spam: valutali per l’impatto sul cliente. Raggruppa le email dello stesso mittente prima di classificare.» Buco: «Materiale di oggi: [incolla le email]». Le ultime due frasi della parte fissa vengono dritte dagli errori tipici documentati nell’output atteso: è così che un prompt riusabile accumula esperienza, una frase per ogni errore visto una volta.

Gli errori tipici

Il prompt-romanzo. Dieci criteri di qualità, tre esempi, avvertenze per ogni caso mai capitato: nessuno lo legge e nessuno lo usa. La parte fissa cresce solo per errori realmente visti (passo 5), non per fantasia preventiva.

I buchi senza etichetta. «[incolla qui]» non dice cosa incollare. «[le email di oggi, così come sono arrivate, senza pulirle]» sì. L’etichetta del buco è un’istruzione anche lei.

La libreria senza manutentore. Se il prompt condiviso è «di tutti», non è di nessuno: dopo il primo cambiamento nel lavoro resta indietro e il team torna a improvvisare. Il passo 5 non è opzionale.

La variante team

Con più di tre o quattro prompt condivisi serve un indice: una pagina con nome, quando usarlo e link, nello stesso posto delle altre procedure. Da lì in poi vale il playbook «Il primo workflow agentico del tuo team» per far adottare ogni nuova ricetta. La stessa idea, impacchettata per chi lavora con strumenti da sviluppatore, sono le skill: riusare una volta per tutte ciò che funziona. Per i principi di scrittura dietro il passo 2, la guida di Anthropic al prompt engineering resta il riferimento che consiglio.