Lezione 15: Far lavorare l'agente — file, comandi e permessi

Introduzione e obiettivi

Nella lezione precedente hai avviato Claude Code e fatto un primo task. Ora impariamo a guidarlo per bene: perché più un agente è potente, più conta dargli contesto chiaro e confini precisi. La buona notizia: gli strumenti per farlo sono semplici e li conosci già in parte (il file di istruzioni è cugino delle istruzioni di Progetto della Lezione 3).

Vedremo:

• Come dare istruzioni efficaci a un agente che agisce.
• Il file di istruzioni di progetto per dargli contesto stabile.
• Le modalità di permesso: cosa fa da solo e cosa deve chiederti.
• Come rivedere e approvare le sue azioni, lavorando in sicurezza.

Dare istruzioni efficaci a un agente

Valgono i principi del prompting (Lezione 2), con un'aggiunta importante: con un agente che agisce, devi essere chiaro anche su obiettivo, confini e criterio di «fatto». Una buona istruzione per Claude Code contiene:

• Obiettivo: cosa deve ottenere (non i singoli comandi, il risultato).
• Contesto: su quali file/cartelle lavorare, cosa evitare.
• Confini: cosa non deve toccare.
• Criterio di successo: come capiamo che è finito bene.

Confronta un'istruzione vaga con una buona:

Sistema questa cartella.

Obiettivo: riordinare la cartella "documenti-cliente".
- Sposta i PDF in "documenti-cliente/pdf" e le immagini in "img".
- Rinomina i file con il formato AAAA-MM-GG_titolo.
- NON toccare la sottocartella "originali".
Alla fine, crea un file "indice.txt" con l'elenco ordinato.

Nota la riga in maiuscolo: con un agente, dire cosa NON fare protegge i tuoi dati. È l'abitudine più importante di tutto il modulo.

Il file di istruzioni di progetto

Come per i Progetti dell'app (Lezione 3), anche con Claude Code puoi dare un contesto stabile che l'agente legge sempre, senza ripeterlo ogni volta. Si fa con un file di istruzioni nella cartella del progetto: convenzionalmente si chiama CLAUDE.md.

Dentro ci scrivi, in italiano, le regole permanenti del progetto:

# Istruzioni per l'agente

## Contesto
Questa cartella contiene i materiali del cliente X.

## Regole
- Non modificare mai i file nella cartella "originali".
- I nomi dei file seguono il formato AAAA-MM-GG_titolo.
- Prima di eliminare qualcosa, chiedimi conferma.

## Preferenze
- Rispondimi in italiano e spiega cosa stai per fare
  prima di farlo.

È lo stesso principio delle istruzioni di Progetto: scrivi le regole una volta, valgono sempre. Un buon CLAUDE.md rende l'agente molto più affidabile e riduce le sorprese.

Le modalità di permesso

Ecco il cuore della sicurezza. Claude Code non fa tutto di testa sua: prima di azioni che contano (modificare file, eseguire comandi) chiede il tuo permesso. Puoi regolare quanto chiedere, a seconda della fiducia e del contesto:

La regola pratica: parti prudente (chiedi sempre), poi, man mano che ti fidi e conosci il compito, allenta. Su dati importanti, tieni sempre le conferme attive.

Rivedere e approvare le azioni

Quando l'agente propone un'azione («sto per rinominare questi 12 file», «sto per eseguire questo comando»), tu vedi cosa farà prima che lo faccia e dai (o neghi) il via libera. Come comportarti:

• Leggi la proposta: cosa vuole fare, su quali file. Se non è chiaro, chiedi «spiegami cosa stai per fare e perché».
• Approva a piccoli passi: soprattutto all'inizio, un passaggio alla volta, verificando il risultato.
• Nega o correggi: se qualcosa non ti torna, dì di no e riformula («no, i PDF vanno in un'altra cartella»).
• Attenzione alle azioni irreversibili: eliminazioni, sovrascritture, comandi che cambiano molte cose. Lì, massima prudenza.

Laboratorio: un task in più passaggi

Mettiamo insieme file di istruzioni, permessi e approvazione su un compito reale.

Consegna

1. Riprendi (o ricrea) una cartella di prova con alcuni file.
2. Crea un file CLAUDE.md con 3-4 regole (cosa non toccare, formato dei nomi, chiedi conferma prima di eliminare).
3. Imposta i permessi su «chiedi sempre» e affida un compito in più passaggi (es. riordina + rinomina + crea un indice).
4. Approva un passaggio alla volta, leggendo cosa propone, e verifica il risultato finale.

Consegna finale

Il tuo CLAUDE.md, la descrizione del task multi-step, e una nota su cosa l'agente ha proposto/tu hai approvato o negato (con un prima/dopo della cartella).

Mini-test di autoverifica

Sezione A: risposta multipla

1. In un'istruzione per un agente, indicare «cosa NON fare» serve a:
   a) allungare il testo   b) proteggere i tuoi dati e mettere confini   c) rallentarlo   d) nulla
2. Il file CLAUDE.md serve a:
   a) installare Claude   b) dare contesto e regole stabili al progetto   c) pagare   d) pubblicare
3. Le modalità di permesso servono a decidere:
   a) il modello   b) quanto l'agente chiede prima di agire   c) il prezzo   d) lo stile
4. All'inizio conviene impostare i permessi su:
   a) più autonomo   b) chiedi sempre   c) nessuno   d) dipende dal colore
5. Quando l'agente propone un'azione, tu:
   a) non vedi nulla   b) vedi cosa farà prima e dai il via libera   c) devi accettare   d) cambi piano
6. Le azioni più delicate da sorvegliare sono:
   a) le letture   b) eliminazioni e sovrascritture (irreversibili)   c) i riassunti   d) le domande

Sezione B: risposta aperta

7. (3 punti) Scrivi 3 regole che metteresti nel CLAUDE.md di una cartella del tuo lavoro.
8. (3 punti) Spiega la regola «delega l'esecuzione, non il giudizio» con un esempio concreto.

Riepilogo della lezione