Formato e verifiche: come parlare al modello dell’output

Un output utile non è solo “una buona risposta”. È una risposta che puoi leggere, confrontare, validare e usare nel workflow. Formato e verifiche trasformano il risultato da testo generico ad artefatto operativo.

Perché questa lezione conta

Molti prompt falliscono alla fine: l’obiettivo è chiaro, il contesto è buono, i vincoli ci sono, ma la risposta arriva in una forma difficile da usare. Troppo lunga, troppo narrativa, senza comandi, senza diff, senza test, senza criteri di accettazione.

Se non specifichi formato e verifica, il modello sceglie da solo cosa significa “rispondere bene”.

Formato: che cosa vuoi ricevere

Il formato dipende dal task. Alcuni esempi:

Task	Formato utile
Analisi tecnica	assunzioni, rischi, opzioni, raccomandazione
Code review	finding con severità, file/riga, impatto, fix
Debug	ipotesi, prova per falsificarla, prossimo passo
Generazione codice	piano, diff, test, note di integrazione
Estrazione dati	JSON conforme a schema
Decisione architetturale	alternative, trade-off, decisione, conseguenze

Il formato deve ridurre lavoro umano, non aumentarlo.

Verifiche: come capisci che è fatto

Le verifiche possono essere automatiche o manuali:

• comando di build;
• test unitari;
• controllo lint/typecheck;
• parser JSON;
• scenario manuale;
• confronto screenshot;
• checklist di accessibilità;
• review del diff;
• eval set per prompt.

Una buona verifica è specifica. “Controlla che funzioni” è debole. “npm run build passa e il link alla lezione 10 genera pagina statica” è forte.

Procedura richiesta

Puoi anche chiedere al modello di seguire una procedura:

Procedura:
1. riepiloga l'obiettivo in una frase;
2. elenca assunzioni e dati mancanti;
3. proponi un piano breve;
4. applica solo modifiche nel perimetro;
5. esegui o indica le verifiche;
6. chiudi con rischi residui.

Questa struttura è particolarmente utile con agenti che modificano file.

Esempio operativo

Prompt senza formato:

Fai una review del prompt.

Prompt con formato e verifica:

Revisiona questo prompt.

Formato risposta:
1. Problemi bloccanti: massimo 5, ciascuno con motivo e correzione.
2. Ambiguità: domande da chiarire prima di usarlo.
3. Versione riscritta del prompt.
4. Checklist per verificare l'output prodotto dal prompt.

Non commentare stile o tono se non incidono su correttezza, sicurezza o verificabilità.

Il secondo prompt produce un artefatto immediatamente riutilizzabile.

Laboratorio guidato

Costruisci un prompt completo a sei sezioni:

1. ruolo;
2. contesto;
3. obiettivo;
4. vincoli;
5. formato;
6. verifiche.

Usa un task reale: review di un diff, generazione di test, debug di un errore, aggiornamento documentazione o progettazione di una feature.

Poi esegui lo stesso task con due prompt:

• uno senza formato/verifiche;
• uno con formato/verifiche.

Confronta:

Criterio	Senza formato	Con formato
Tempo per leggere
Output azionabile
Verifica chiara
Rischi dichiarati
Possibilità di riuso

Output atteso

Un template prompt modulare a sei sezioni da usare come scheletro per ogni richiesta importante.

Esempio:

Ruolo:

Contesto:

Obiettivo:

Vincoli:

Formato risposta:

Verifiche richieste:

Questo template non va riempito sempre con la stessa lunghezza. Alcuni task richiedono due righe, altri una scheda completa. La struttura serve a non dimenticare pezzi critici.

Checklist di verifica

• il formato richiesto corrisponde al task;
• le verifiche sono eseguibili o osservabili;
• il modello sa cosa fare se una verifica non può essere eseguita;
• l’output evita testo non necessario;
• il prompt completo può essere riusato come template.

Errori comuni

Chiedere un formato troppo generico. “Rispondi in modo chiaro” non è un formato.

Chiedere verifiche impossibili. Se il modello non può eseguire comandi, deve dichiararlo e indicare cosa eseguire localmente.

Mescolare piano e patch. Per task rischiosi, prima chiedi il piano, poi la modifica.

Collegamenti

• Modulo: Anatomia del prompt operativo — lezione 10 del corso.
• Lezione precedente: Vincoli: file ammessi, dipendenze, pattern, divieti.
• Prossimo modulo: Tecniche di prompting.