Parlare agli agenti: il prompt engineering che funziona davvero

Panoramica

Il piu grande balzo di risultati, di gran lunga, non viene da un modello migliore ma da un briefing migliore. Parlare bene a un agente e un'abilita di management: poni regole chiare, inquadri il lavoro sulla qualita piuttosto che sulle scorciatoie, inviti la contraddizione e consegni una specifica invece di un'intuizione. Questa lezione ti da gli schemi concreti che separano le sessioni frustranti dagli agenti che centrano il bersaglio al primo colpo.

Cosa imparerai

Imparerai a scrivere assiomi (regole non negoziabili), a usare l'inquadramento budget illimitato che impedisce all'agente di tagliare gli angoli, a chiedere esplicitamente la contraddizione perche l'agente colga i tuoi errori, e a trasformare una richiesta vaga in uno spec sheet con obiettivo, contesto, vincoli e criteri di accettazione.

Prerequisiti

Un setup Claude Code o Codex funzionante dalla lezione precedente. Devi anche ricordare le lezioni sul contesto: un prompt eccellente consiste in parte nel dare il contesto giusto, non solo le parole giuste.

Il problema

Il fallimento classico e il desiderio di una riga: "costruiscimi un sito web". L'agente deve indovinare il pubblico, la stack, il design, il perimetro e la definizione di "finito", e indovina male. Poi te la prendi con l'IA. Il vero problema e che hai istruito un fornitore in cinque parole e ti aspettavi una casa finita. Un buon prompting elimina l'indovinare.

Gli assiomi: porre le regole una volta

Gli assiomi sono regole non negoziabili che poni in anticipo perche l'agente smetta di ridecidersele a ogni compito. Invece di correggere la stessa cosa dieci volte, la scrivi come regola. "Usa sempre TypeScript. Non usare mai em-dash. Ogni nuova funzionalita ha bisogno di un test. Non committare mai segreti." Si leggono come un contratto, e l'agente le tratta come vincoli piuttosto che suggerimenti. Nel Corso 2, le sposterai in un CLAUDE.md durevole, ma persino incollate in cima a una sessione, alzano nettamente la costanza.

• Formula le regole in assoluti: "Sempre...", "Mai...", "Ogni... deve...".
• Copri lo stile, la stack, i test, la sicurezza e il tono - le cose che correggi di continuo.
• Tienile corte e senza ambiguita; un agente segue meglio una regola netta che un paragrafo pieno di sfumature.

L'inquadramento budget illimitato

Gli agenti, come i collaboratori junior, tendono verso la risposta accettabile piu rapida. Se vuoi un lavoro di classe mondiale, bisogna dirlo. Inquadrare il compito come se il budget e il tempo fossero illimitati - "fai la cosa giusta per la salute a lungo termine di questo progetto, non quella facile; non tagliare nessun angolo" - alza in modo misurabile la qualita, perche autorizza l'agente ad aggiungere test, a trattare i casi limite e a rifattorizzare invece di avvitare il correttivo piu rapido. Suona molle, ma sposta in modo affidabile l'output da "funziona tecnicamente" verso "e realmente buono".

Chiedere la contraddizione

Per default, un agente e compiacente e mette volentieri in atto una cattiva idea. La soluzione sta in una frase: "Prima di cominciare, dimmi tutto cio che non va in questo piano, tutto cio che ho mancato, e un approccio migliore se ne esiste uno." Questo fa dell'agente, invece di un esecutore di ordini, un consulente. Coglie requisiti mancanti, segnala falle di sicurezza e propone design piu semplici. Alcuni dei momenti piu preziosi del lavoro agentico vengono dal fatto che l'agente ti contraddice - ma solo se gliene dai esplicitamente il permesso.

Passo passo: scrivere uno spec sheet

Uno spec sheet e la differenza tra un desiderio vago e un briefing eseguibile. Non ha bisogno di essere lungo. Quattro parti bastano, e scriverle ti costringe a prendere le decisioni che l'agente indovinerebbe altrimenti.

• Obiettivo: cio che deve esistere quando e finito, in una o due frasi.
• Contesto: la stack, i file pertinenti, gli esempi da seguire e tutto cio che l'agente non puo dedurre.
• Vincoli: i tuoi assiomi piu i limiti propri del compito (nessuna nuova dipendenza, deve funzionare su mobile, e cosi via).
• Criteri di accettazione: una checklist concreta che definisce "finito", perche tu e l'agente sappiate quando fermarvi.

## Obiettivo
Un form di contatto sulla landing page che mi invia le compilazioni via e-mail.

## Contesto
- Stack: questo progetto Astro, stili esistenti in src/styles.
- Segui lo stile di pulsante gia usato nella sezione hero.

## Vincoli
- Solo TypeScript. Nessuna nuova libreria UI.
- Non esporre mai la chiave API e-mail nel codice client.
- Aggiungi un test per la validazione del form.

## Criteri di accettazione
- [ ] Il form valida nome ed e-mail prima dell'invio.
- [ ] L'invio mostra un messaggio di successo.
- [ ] Il test di validazione passa.

Errori frequenti

Gli errori ricorrenti: il desiderio di una riga senza spec; non porre mai assiomi, cosicche correggi le stesse cose all'infinito; accettare la prima risposta invece di chiedere la contraddizione; e infarcire il prompt di contesto non pertinente, il che innesca il performance cliff della lezione uno. I briefing serrati e strutturati battono quelli lunghi e prolissi.

ROI business

L'abilita di briefing e il moltiplicatore su tutto il resto. Lo stesso agente e lo stesso modello consegnano un lavoro mediocre o eccellente a seconda del solo briefing, e un buon spec sheet trasforma spesso tre turni frustranti in una consegna pulita. Per un fondatore, e il modo piu economico possibile di triplicare il valore di ogni abbonamento di IA che paghi gia.

Checklist

Prima di andare avanti, assicurati di poter produrre ognuno di questi elementi su richiesta, perche ogni lezione successiva suppone che tu sappia istruire bene un agente.

• Una breve lista di assiomi per i tuoi progetti.
• Un compito inquadrato sulla qualita con le righe budget illimitato e contraddizione.
• Uno spec sheet in quattro parti per una vera funzionalita.
• Un senso onesto di quando il tuo prompt e troppo lungo, non troppo corto.

Risorse

Salva i tuoi assiomi da qualche parte di riutilizzabile - li incollerai in un CLAUDE.md nel Corso 2. Il template di brief di compito d'agente nella libreria di risorse e uno scheletro di spec sheet pronto da copiare. Poi, metti tutto cio in pratica per costruire un vero progetto.

La tua missione

Prendi l'idea di progetto che hai scelto due lezioni fa e scrivi uno spec sheet completo per la sua prima funzionalita, includendo i tuoi assiomi, l'inquadramento budget illimitato e la richiesta di contraddizione. Consegnalo al tuo agente e nota quanto il risultato e piu netto di un prompt di una riga.

Prossima lezione

Sai istruire un agente. Ora costruisci qualcosa di reale. La prossima lezione fa lo scaffolding di un vero progetto, lancia un Dev Server perche tu lo veda nel browser, e lo mette sotto version control con Git e un repo GitHub privato.