CCW · L4 · 1 / 26
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

Due 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
La mappa agentica

Un progetto tutto vostro dove vivono i modi di lavorare di queste quattro lezioni — e che cresce con voi, sessione dopo sessione.

Un breve ripasso in apertura, e la chiusura del cerchio alla fine.
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 · 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 · La mappa agentica

Un progetto che cresce con voi.

Noi ne abbiamo uno: un progetto «madre» dove vivono i nostri modi di lavorare, le buone pratiche, i processi. Non serve a produrre un materiale: è la guida a cui torniamo 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 2 · 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 2 · 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 2 · 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
Spiegami un concetto nel mio contesto. «Cosa sono gli hook, e 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 2 · 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
Insieme, e che cresce

Lavorare in team e una mappa che evolve con voi.

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