CCW · L4 · 1 / 34
Claude Code Workshop · Gruppo 1

L4 — Lavorare insieme, crescere con il tuo coach.

GitHub & la mappa agentica · Essedi Training Services · Workshop L4
Prima di iniziare · voi

La settimana del checkup.

Nel pre-work avete fatto il checkup del VOSTRO progetto: rilettura del CLAUDE.md, un documento di riferimento, una regola, una skill — e alla fine session-insights girato sulla sessione stessa. Prima di andare avanti, una verifica veloce: è tutto chiaro?

"C'è qualcosa del pre-work che è rimasto poco chiaro?"
Due minuti, non una lezione. Poi apriamo l'ultima parte del percorso.
La mappa di oggi

Tre cose, l'ultima lezione.

1
Lavorare sullo stesso progetto

Git e GitHub — non come tecnici, ma come un modo per lavorare insieme senza rompere il lavoro degli altri. Visto dal vivo sul progetto che conoscete.

2
Gli hook

Il controllo che parte da solo quando accade un evento: sempre, senza dovervelo ricordare.

3
La tua Agentic Map

Il vostro progetto personale: qui vivono i modi di lavorare di queste quattro lezioni e cresce con voi, sessione dopo sessione.

Un breve ripasso in apertura, e la chiusura del cerchio alla fine.
Sezione 1 di 3

Lavorare sullo stesso progetto.

Sezione 1 · Lavorare insieme

Non è Git. È lavorare insieme senza pestarsi i piedi.

Immaginate di scrivere un libro in più persone. Git è quello che ve lo fa fare senza pestarvi i piedi — un po' come lavorare con cartelle condivise piene di file di Office, ma per un progetto. Ognuno ha la sua copia, un modo per salvare, uno per chiedere una revisione, uno per unire tutto.

I comandi li esegue Claude. Il vostro compito è sapere cosa deve succedere dopo.
Sezione 1 · Sul tuo computer

Il progetto vive sul tuo computer.

computer

Il progetto (il tuo libro) vive sul tuo computer. Git sta qui, in locale: GitHub non serve ancora.

Sezione 1 · Sul tuo computer

Salvi: un commit.

computer

Salvi una versione: è un commit. Come salvare «capitolo_v1» in Word — una foto di tutto il progetto in quel momento. Tutto sul tuo computer.

Sezione 1 · Sul tuo computer

Salvi ancora: v2.

computermain

Un altro commit: v2. La storia cresce sul tuo computer. Fin qui, da solo, GitHub non serve: git funziona benissimo così.

Sezione 1 · Condividere

Quando condividi: push.

GitHubcomputerpush ↑

Vuoi condividere il progetto (o solo tenerne un backup)? Lo mandi su GitHub: è il push. La tua storia sale, e ora c'è una copia condivisa in alto.

Sezione 1 · Condividere

Un collega va avanti.

GitHubcomputercommit di un collegaGitHub è avanti di 1

Mentre lavoravi, un collega ha fatto un commit e l'ha spinto su GitHub (quello blu). Ora la copia condivisa è avanti di un commit rispetto alla tua: tu non ce l'hai ancora.

Sezione 1 · Condividere

Il lavoro degli altri: pull.

GitHubcomputerpull ↓

Porti giù il commit del collega (blu): è il pull. Ora la tua copia e GitHub combaciano di nuovo — parti sempre dall'ultima versione di tutti.

Sezione 1 · Lavorare in due

La storia, fin qui.

La storia del progetto— la stessa sul tuo computer e su GitHubmain

Questa è la storia del progetto: la tua, più il commit del collega (blu). Dopo il push e il pull, è la stessa sul tuo computer e su GitHub. Ci lavorate in più: come per un libro, si scrive su capitoli diversi senza pestarsi i piedi — a patto di non toccare lo stesso capitolo insieme.

Sezione 1 · Lavorare in due

Un capitolo a parte.

La storia del progetto— la stessa sul tuo computer e su GitHubmainil tuo capitolo

Per lavorare senza disturbare gli altri, apri un branch: una linea tutta tua, dove porti avanti il tuo capitolo in sicurezza. Il branch nasce sul tuo computer; quando è pronto lo mandi su GitHub per la revisione.

Sezione 1 · Perché un branch

Perché lavorare a parte conviene.

Tre cose concrete che un branch vi dà:

1
I conflitti si vedono. Se in due toccate la stessa frase, git si ferma e ve lo chiede: non unisce di nascosto. Un problema diventa una decisione, non un incidente.
2
Solo dove serve davvero. Tu lavori al capitolo 2, il collega al 5? Si uniscono senza attriti. Git segnala solo le righe che avete cambiato entrambi.
3
Il lavoro a metà resta tuo. La tua bozza non tocca la versione condivisa finché non dici «è pronto»: sperimenti in pace, e condividi solo quando sei pronto.

L’analogia. Caricare un file con lo stesso nome in una cartella condivisa sovrascrive l’altro, e un lavoro sparisce senza avvisare. Il branch è l’opposto: fotocopie separate che confrontate in chiaro — senza confusione — decidendo con calma quale versione tenere.

Sezione 1 · Lavorare in due

Prima di unire: la revisione.

La storia del progetto— la stessa sul tuo computer e su GitHub✓ PRmainil tuo capitolo

Quando il capitolo è pronto, non lo unisci di nascosto: apri una Pull Request. Qualcuno rilegge e approva — lo stesso cancello dell'approvazione del piano, da L1.

Sezione 1 · Lavorare in due

Approvato: merge.

La storia del progetto— la stessa sul tuo computer e su GitHub✓ PRmainil tuo capitolo

Approvato, il capitolo rientra nel libro condiviso: è il merge. Due linee che tornano una — i «due genitori».

Sezione 1 · La routine

Dove sono? Cosa faccio dopo?

Sto iniziando a lavorarePull
Sto per iniziare una modificaBranch
Ho finito un pezzo che ha sensoCommit
Voglio che il team lo vedaPush
È pronto per la revisioneApri la PR
La PR è approvataMerge
Non memorizzate i comandi: li scrive Claude. Voi riconoscete cosa deve succedere dopo. Il bigliettino completo è nei materiali.
Sezione 1 · Quando capita un intoppo

E se due persone toccano la stessa riga?

Immaginate due persone che modificano la stessa frase in un Google Doc. Git chiede: quale versione teniamo?

Si chiama «conflitto». Non è un disastro: è una domanda. E capita di rado, se fate pull spesso e seguite un lavoro → un branch.

Quando capita, Claude vi accompagna a sceglierne una. Nulla di più profondo, per ora.
Sezione 1 · Dal vivo Demo

Il progetto va su GitHub.

Il Generatore di Asset — quello costruito in L2 e cresciuto in L3 — è vissuto tre settimane solo sul nostro computer. Oggi lo portiamo dove il team può lavorarci insieme.

1
Claude inizializza git, crea il repo su GitHub e fa il primo push.
2
Cambiamo un'etichetta visibile nell'app — «Genera i materiali del case study».
3
Commit con etichetta, poi push.
4
Apriamo una PR e leggiamo il diff: una riga, verde.
5
Merge, poi pull: il cambiamento è nel progetto condiviso.

In pratica non leggete riga per riga: chiedete a Claude di rivedere il diff e segnalare solo ciò che merita davvero la vostra attenzione.

Ora si passa a VS Code — i passi restano qui
Sezione 1 · Perché serve

Senza GitHub, cosa può andare storto?

1
Sovrascrivere il lavoro di un collega. Due file con lo stesso nome, una modifica sparisce senza che nessuno se ne accorga.
2
Perdere l'ultima versione che funzionava. Una modifica rompe qualcosa e non sapete più a quale copia tornare.
3
Unire modifiche che nessuno ha rivisto. Il cambiamento entra nel progetto senza un punto in cui fermarsi, guardarlo e approvarlo.
GitHub vi dà una storia, copie separate e un cancello di revisione.
Sezione 1 · Dal vivo Demo

GitHub può anche raccontarvi cosa è successo.

Claude legge la storia che GitHub conserva e ve la restituisce in parole semplici.

1
Una Pull Request: cosa è cambiato, perché e cosa merita attenzione prima di approvarla.
2
Una settimana di lavoro: chi ha contribuito, cosa è entrato nel progetto e cosa resta aperto.
3
La decisione resta vostra: Claude fa il riepilogo; voi controllate e decidete.
Ora si passa a VS Code — i passi restano qui
Sezione 1 · Dopo la demo

Quello che avete appena visto.

Una modifica minuscola — una riga — ha fatto tutto il giro: salvata, caricata, rivista nel diff, unita. Adesso è nella casa del progetto: chiunque faccia pull se la ritrova.

Oggi l'avete vista. Questa settimana la rifate sul vostro progetto — la guida passo-passo è nel materiale post-lezione.
Sezione 2 di 3

Gli hook.

Sezione 2 · L'ultimo meccanismo

Quando un controllo deve partire da solo.

Finora abbiamo visto azioni che scegliamo di avviare: fare pull, aprire un branch, rivedere una PR. Ma alcuni controlli sono troppo importanti per dipendere dalla memoria. Devono partire da soli, ogni volta che succede qualcosa. È esattamente questo il lavoro di un hook.
Succede un evento Hook Parte uno script o un comando
Skill
Come risolvo questo compito?
Ragiona e orchestra più passaggi.
Script
Come eseguo questa operazione?
Ripete una sequenza fissa.
Hook
Quando deve partire da sola?
Aspetta l'evento e fa scattare l'azione.
Sezione 2 · Dal vivo Demo

Ogni sessione parte dal punto giusto.

Quando si apre una nuova conversazione, un hook SessionStart controlla lo stato Git prima ancora che dobbiate ricordarvelo.

Nuova conversazione SessionStart Controlla Git Informa Claude
PROGETTO marketing-asset-generator
BRANCH main
MODIFICHE NON SALVATE 2
GITHUB 1 aggiornamento da scaricare
→ Prima salva il lavoro; poi proponi un branch. Non fare pull adesso.
L'hook garantisce il controllo. Claude propone; voi decidete.
Ora si passa a VS Code — i passi restano qui
Sezione 2 · Gli eventi

Dove possono essere usati gli hook?

Categoria Quando scatta Esempio di evento Azione automatica
Conversazione Succede qualcosa nella sessione L'utente avvia una nuova conversazione Mostra lo stato del progetto: attività, blocchi e prossimo passo
L'utente allega un documentoAvvia il riepilogo del documento
L'utente chiede informazioni su un clienteRecupera i file del progetto del cliente
Tool Claude usa uno strumento Dopo che Claude modifica un file Mostra esattamente cosa è cambiato
Prima che Claude modifichi un fileCrea una copia di sicurezza del file
Prima che Claude esegua un comandoChiede conferma se il comando può eliminare file
File Un file cambia Un file viene rinominato Aggiorna i collegamenti che rimandano al file
Viene creato un nuovo fileAggiunge il modello di file usato dal team
Un file viene salvatoFormatta automaticamente il file
Flusso Git Succede qualcosa in Git Prima di creare un commit Controlla gli errori più comuni
Dopo aver creato un commitGenera un riepilogo di ciò che è cambiato
Prima di condividere il lavoro con il teamEsegue un rapido controllo di qualità
Clicca una categoria per vedere altri due esempi.
Sezione 3 di 3

La tua Agentic Map.

Sezione 3 · La mappa agentica

La tua Agentic Map.

È il vostro progetto personale: un progetto «madre» dove vivono modi di lavorare, buone pratiche e processi. È la guida a cui tornate prima di ogni nuovo progetto con Claude Code.

Non un'altra cosa da fare. Il posto dove tutto quello che avete imparato resta e si sistema.
Sezione 3 · La mappa agentica

Cosa ci vive dentro.

I mattoni di queste quattro lezioni, in un unico progetto che Claude può leggere:

Pianificare prima di fare — il loop di L1
Le convenzioni per un buon CLAUDE.md
Le vostre regole, con la loro casa
Le vostre skill e quando usarle
Quando uno script, quando l'AI
Il giro su GitHub: branch, PR, merge
La memoria di tutto, in un formato che Claude capisce.
Sezione 3 · La mappa agentica

Si evolve con voi.

La alimentate: le domande che avete, le cose che trovate online, un pattern nuovo, la documentazione ufficiale di Claude Code. Lei si adatta alle vostre esigenze e cresce nel tempo.

Le fate domande, vi guida
Ci mettete cose trovate online
Si arricchisce con i doc ufficiali
Diventa sempre più vostra
Più la usate, più diventa la vostra coach personale.
Sezione 3 · Dal vivo Show

La nostra, dal vivo.

La mappa non è un documento morto: è un progetto a cui parlate. Tre esempi di cosa chiederle:

1
Come funziona il mio sistema? «Fammi una panoramica di come ho organizzato regole, skill e memoria.»
2
Applica un concetto al mio sistema. «Ora che so cosa sono gli hook, dove avrebbero senso viste le mie regole e skill?»
3
Dammi un parere su un'idea. «Ho trovato questo progetto su GitHub: guardalo e dimmi cosa ha senso adottare nel mio sistema.» (es. da github.com/topics/claude-code)
Ora si passa a VS Code — i passi restano qui
Sezione 3 · La mappa agentica

Il vostro punto di partenza.

Non partite da un foglio bianco. Dopo la lezione vi diamo un documento di partenza, già pieno: i mattoni di questo corso, in un formato pronto per Claude Code, arricchito con la documentazione ufficiale.

Lo mettete in un progetto nuovo e avete la vostra coach dal primo giorno.
Chiusura · L'effetto composto

Il cerchio si chiude.

L1
Pianificare e approvare

Leggere il piano prima che Claude esegua.

L2
Costruire con metodo

CLAUDE.md, il loop di costruzione, la verifica.

L3
Regole, skill, tool

Il sistema che smette di ripetersi.

L4
Collaborare, automatizzare, crescere

Lavorare in team, far partire i controlli da soli e alimentare la vostra mappa.

Ogni correzione fatta una volta sola. Il sistema migliora ogni settimana.
Chiusura

Grazie. Domande?

Continuate a costruire, alimentate la vostra mappa, e usate il canale del gruppo quando qualcosa non torna. Il corso finisce; il vostro sistema no.

Claude Code Workshop · Essedi Training Services · Fine del percorso