Decomposizione: catene di prompt e prompt chaining

Un prompt troppo grande fallisce in modo difficile da diagnosticare. Se chiedi analisi, architettura, codice, test e documentazione insieme, non sai quale parte ha guidato l’errore. La decomposizione trasforma un task complesso in una catena di passaggi controllabili.

Perché questa lezione conta

Gli LLM sono forti nel collegare informazioni, ma i task software hanno dipendenze e rischi. Una modifica su codebase reale dovrebbe spesso passare da analisi, piano, patch, verifica e retrospettiva. Ogni fase ha output diverso e criteri diversi.

Prompt chaining non significa fare più chat per abitudine. Significa progettare una sequenza.

Quando decomporre

Decomponi quando:

• il task tocca più file o responsabilità;
• ci sono decisioni prima del codice;
• il contesto è ampio;
• vuoi approvare un piano prima del diff;
• esistono rischi di regressione;
• il risultato finale ha più artefatti.

Non decomporre task banali: correggere un typo o generare una funzione pura piccola può stare in un solo prompt.

Tre forme di catena

Lineare

Ogni passo usa l’output del precedente.

1. Analizza il problema.
2. Proponi piano.
3. Applica patch.
4. Aggiungi test.
5. Riassumi verifica.

Condizionale

Il passo successivo dipende dall’esito.

Se mancano informazioni, fermati e chiedi chiarimenti.
Se il rischio è basso, proponi patch.
Se il rischio è alto, proponi piano di rollback.

Fan-out

Generi alternative separate e poi le confronti.

Proponi tre architetture indipendenti.
Valutale con gli stessi criteri.
Scegli una e spiega cosa scarti.

Passaggio di stato

In una catena devi decidere cosa portare avanti:

• decisione presa;
• assunzioni;
• file coinvolti;
• vincoli;
• rischi;
• output verificato;
• cose escluse.

Non portare avanti tutto. Se ogni fase eredita tutto il testo precedente, la catena diventa presto rumorosa.

Esempio operativo

Prompt monolitico:

Aggiungi autenticazione completa, aggiorna UI, scrivi test e documentazione.

Catena:

Prompt 1 - Analisi:
Mappa i requisiti minimi di autenticazione e indica dati mancanti. Non scrivere codice.

Prompt 2 - Piano:
Proponi una soluzione in massimo 5 passi, con file coinvolti e rischi.

Prompt 3 - Patch:
Applica solo il primo passo approvato. Non modificare file fuori scope.

Prompt 4 - Verifica:
Indica test automatici e scenari manuali per il comportamento introdotto.

Laboratorio guidato

Prendi un prompt grande che useresti per una feature. Spezzalo in almeno tre passaggi.

Per ogni passaggio definisci:

Passo	Obiettivo	Input necessario	Output	Verifica
1
2
3

Poi esegui prompt monolitico e catena. Confronta qualità, controllo, costo e facilità di debug.

Output atteso

Uno schema di catena riusabile per i workflow ricorrenti del tuo progetto.

Esempio:

Feature AI-assisted:
1. chiarimento requisiti;
2. mappa file e rischi;
3. piano patch;
4. modifica minima;
5. test e review;
6. note finali.

Checklist di verifica

• ogni prompt della catena ha un obiettivo singolo;
• ogni output può essere approvato o corretto;
• lo stato passato al passo dopo è sintetico;
• la catena ha condizioni di stop;
• il costo aggiuntivo è giustificato dal controllo ottenuto.

Errori comuni

Spezzare senza criterio. Più prompt non significa più qualità se ogni passaggio resta vago.

Portare avanti troppo stato. La catena deve comprimere, non accumulare.

Saltare l’approvazione del piano. Se il task è rischioso, il piano è un artefatto, non una formalità.

Collegamenti

• Modulo: Tecniche di prompting — lezione 14 del corso.
• Lezione precedente: Self-critique, self-consistency, rephrase.
• Prossima lezione: Output strutturato: JSON, schema, grammar.