CCW · L2 · 1 / 16
Claude Code Workshop · Gruppo 1

L2 — Costruiamo.

Essedi Training Services · Workshop L2
La sessione di oggi

Tre sezioni.

Sezione 1
Guida l'AI
Il CLAUDE.md generato da Claude è una bozza. Voi lo affinate — e capite perché conta.
Sezione 2
Abitudini di build
Tre abitudini per costruire senza sorprese: definisci fatto, schizza la forma, controlla le dipendenze.
Sezione 3
Cattura e componi
La prima skill l'avete già usata. Oggi catturate la prossima dal build di questa sessione.
Dove siamo

Piano → Struttura → Costruzione.

Lezione 1
Piano
Piano di progetto ricco di contesto. L'input che governa tutto il resto.
Pre-L2
Struttura
Progetto reale su disco, CLAUDE.md generato, prima skill installata.
Oggi · L2
Costruzione
Prima slice funzionante, CLAUDE.md raffinato, abitudini di build acquisite.
Avete già fatto le prime due fasi. Oggi guadagnano senso.
Quello che avete già fatto

L'avete già vissuto.

01
Strutturato un progetto. Cartella reale, orientamento a Claude, scheletro con CLAUDE.md e docs/.
02
Claude ha scritto il vostro CLAUDE.md. Non a mano — lo ha generato Claude. Oggi lo criticate voi.
03
Installato e usato Grill Me. Prima skill installata globalmente. Primo contatto concreto con il concetto di skill.
Avete sentito come funziona. Adesso diamo un nome al perché.
Sezione 1 · Guida l'AI

L'output dell'AI è un punto di partenza.

Claude Code è potente. Ma l'AI non è infallibile — siete voi a dare la direzione. Il CLAUDE.md che Claude ha generato per voi è la prova: è una bozza, non il prodotto finito.

"L'AI costruisce quello che descrivi. Se la descrizione è vaga, l'output è educatamente vago."
Il vostro lavoro è affinare il contesto — non solo eseguire.
Sezione 1 · Guida l'AI

Anatomia di un buon CLAUDE.md.

PERCHÉ
Cosa stai costruendo e perché esiste questo progetto. Il contesto che orienta ogni scelta di Claude.
VINCOLI
Cosa non fare mai. Limiti di scope, sicurezza, stile. Le regole fisse che non si negoziano.
COME
Pattern, convenzioni, dove guardare. Punta a docs/ (la cartella reference che avete creato) invece di incollare tutto inline.
Regola: ≤ 60 righe. Punta a docs/ invece di incollare. Il brief permanente per Claude — riletto ad ogni sessione.
→ Riflessione: cosa è gonfio nel vostro CLAUDE.md?
Sezione 1 · Guida l'AI

Perché snello vince.

01
Gonfio = meno efficace

Un CLAUDE.md troppo lungo mangia il contesto che Claude serve per il lavoro vero. Meno spazio per il problema, più spazio per le istruzioni.

02
È un file vivo

Non è fatto per sempre. Affinate quando imparate qualcosa di nuovo sul progetto — non lasciatelo invecchiare.

03
Puntate fuori, non incollate dentro

Le regole lunghe vanno in docs/. Il CLAUDE.md indica dove guardare — non sostituisce la documentazione.

"Un CLAUDE.md ben curato vale più di dieci prompt perfetti."
Sezione 2 · Abitudini di build

Quando le cose si rompono.

La maggior parte dei problemi con Claude Code non vengono da Claude. Vengono da noi — da come diamo (o non diamo) il via.

→
Costruisci prima di definire l'obiettivo
Output vago da un input vago — nessun errore, nessun avviso. Solo un risultato che sembra giusto ma non lo è.
→
Avvii il codice prima di schizzare la forma
Le decisioni non prese diventano scelte arbitrarie di Claude. Difficili da correggere quando un diff già esiste.
→
Ti fermi prima di controllare le dipendenze
Le parti che si aspettavano il vecchio valore si rompono in silenzio — nessun errore, risultati vuoti un giorno dopo.
Tre abitudini eliminano questi tre momenti.
Abitudine 1

Definisci "fatto."

Prima di aprire Claude Code: scrivi 3 criteri concreti e verificabili.

Esempio: form di contatto
  • Il form si invia senza ricaricare la pagina
  • Appare una riga in contacts.csv dopo l'invio
  • Un errore chiaro se l'email è vuota
funziona sembra giusto
Se non riesci a scrivere tre criteri, il compito non è ancora definito.
Abitudine 2

Schizza la forma prima del codice.

Un paragrafo in testo semplice che descrive la forma — prima che Claude scriva una sola riga. Non è una specifica tecnica: è uno starter di conversazione da due minuti. Condividetelo con Claude e chiedete: "Corrisponde a quello che hai capito?"

Esempio: dashboard di stato

"Tre colonne: In attesa / In corso / Completato. Ogni task = una card con titolo, assegnatario e scadenza. Clic su una card apre un pannello laterale con i dettagli. I dati vengono da tasks.csv."

"Forza a notare le decisioni che non sono ancora state prese — prima che un diff esista."
Abitudine 3

Controlla cosa dipende da questo.

Quando cambiate qualcosa di condiviso — un nome di campo, un formato, dove stanno i file — le parti che si aspettavano il vecchio valore si rompono in silenzio. Nessun errore. Solo risultati vuoti.

Esempio

Rinominate il campo "Azienda" → "Account" nei contatti. Il report settimanale cerca ancora "Azienda" — torna vuoto. Nessun errore. Solo un report silenziosamente sbagliato.

L'abitudine: prima di considerarlo fatto, chiedete a Claude:

"Cos'altro in questo progetto usa questo?"
L'errore più ricorrente nel build. Si rompe in silenzio un giorno dopo.
Il ciclo completo

Il loop di build.

voi
Definisci i criteri
3 criteri verificabili prima di aprire Claude Code.
voi
Schizza la forma
Un paragrafo — condiviso con Claude prima di scrivere codice.
Claude Code
Costruisce
Claude esegue dal piano condiviso.
voi
Verifica i criteri
I 3 criteri sono rispettati? Se sì, è fatto. Se no, affinate e rieseguite.
Gate
voi
Controlla le dipendenze
"Cos'altro dipende da quello che ho appena cambiato?" — poi chiudete il ciclo.
Prima di costruire

Quanto controllo dai a Claude.

Il selettore che avete usato per Plan Mode (Shift+Tab) ha altri livelli. Ogni modalità decide quanto Claude vi chiede prima di agire.

01
Plan

Propone e aspetta. Non tocca nessun file. Per iniziare qualsiasi cosa di nuovo.

02
Default — chiedi sempre

Approvazione per ogni azione. La modalità giusta mentre imparate: vedete tutto quello che succede.

03
Accept edits — auto-accetta le modifiche

Approva da solo le modifiche ai file, chiede ancora per i comandi. Per lavoro ripetitivo di cui vi fidate.

04
Dangerously skip permissions

Non chiede niente. Il nome è l'avvertimento: solo esperimenti a basso rischio in progetti usa-e-getta — mai sul lavoro vero. Ci giocheremo prima di L3.

In dubbio, scendete di un livello. L'approvazione è il vostro cancello di controllo — non regalatelo.
Sezione 3 · Cattura e componi

Avete già usato una skill.

/
Grill Me
L'avete installata globalmente in Pre-L2 e usata per costruire il piano del vostro progetto. Questo è esattamente il concetto.
Invocata con /grill-me · disponibile in ogni progetto
Cos'è una skill
Un'istruzione salvata e riutilizzabile, attivata su richiesta con /nome. Claude la legge al momento dell'invocazione — non prima, non sempre. È contesto on-demand.
L1 = pianificazione. Pre-L2 = prima skill. L2 = catturi la prossima dal build di oggi.
Cattura mentre costruisci

Una volta che si ripete, catturalo.

Se un passaggio si è ripetuto durante il build di oggi — un controllo, un tipo di istruzione, un pattern — quello è la vostra prossima skill. Non inventate: catturate ciò che è già successo.

"Una volta che un processo si ripete, catturalo come skill."
Cosa viene dopo
Rules, MCP, workflow skill = Lezione 3. Oggi catturate il gesto semplice — L3 costruisce sopra.
Cosa portate via

Alla fine di oggi.

01
CLAUDE.md raffinato
Che avete criticato voi stessi — non il risultato grezzo dell'AI.
02
Prima slice costruita
3 criteri soddisfatti. End-to-end, funzionante. Il piano prende corpo.
03
3 abitudini di build
Definisci fatto · Design preview · Controlla le dipendenze — sentite sul lavoro vero.
La frizione che avete sentito oggi è esattamente il motivo per cui L3 diventa immediata.