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

L4 — Lavorare insieme, crescere da soli.

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

La settimana del tagliando.

Nel pre-work avete fatto il tagliando 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 rompere il lavoro altrui.

Pensatelo come Google Docs, ma per un progetto software. Ognuno ha la sua copia su cui lavorare, un modo per salvare, un modo per chiedere una revisione, un modo per unire il lavoro di tutti. Git è solo lo strumento che lo rende possibile.

I comandi li esegue Claude. Il vostro compito è sapere cosa deve succedere dopo.
Sezione 1 · I sei concetti

La casa del progetto.

Su GitHub c'è UNA copia condivisa del progetto: la sua casa. È lì che vivono tutti i file, ed è lì che il team si ritrova. Ognuno lavora sulla propria copia, ma la casa è una sola.

📁 progetto/
  app
  immagini
  documenti
🏠 Una sola casa, su GitHub. Tutto il resto sono copie di questa.
Sezione 1 · I sei concetti

Il vostro banco di prova.

Ognuno scarica la sua copia sul proprio computer. Lì potete provare, sbagliare, rompere: nessun altro lo vede finché non decidete voi. È il vostro spazio sicuro.

🏠
GitHub
la casa condivisa
scarichi
💻
Il tuo computer
qui puoi rompere tutto
Il vostro computer è il vostro banco di prova.
Sezione 1 · I sei concetti

Il commit: una foto nel tempo.

Un commit è come premere «Salva» con un'etichetta. Ogni commit è una foto dell'intero progetto in quel momento — e l'etichetta dice cosa è cambiato.

Salva #1 · "Prima versione"
📁 src/
  index.ts
  style.css
  package.json
a1b2c3d
Salva #2 · "Aggiunta pagina login"
📁 src/
  index.ts
  login.ts
  package.json
b2c3d4e
Salva #3 · "Corretto un refuso"
📁 src/
  index.ts
  login.ts
  package.json
c3d4e5f
Ogni foto resta. Potete sempre tornare a com'era.
Sezione 1 · I sei concetti

Push e pull: su e giù.

Il vostro lavoro esiste solo sul vostro computer finché non lo caricate. Push = mando i miei salvataggi su GitHub. Pull = porto sul mio computer il lavoro più recente di tutti gli altri.

💻
Il tuo computer
push
pull
🏠
GitHub
Push = «manda su». Pull = «porta giù». Solo due direzioni.
Sezione 1 · I sei concetti

Il branch: una linea a parte.

Per lavorare in sicurezza non toccate la linea principale (main): ne aprite una a fianco, tutta vostra. Provate lì. Se qualcosa va storto, main resta intatta.

main il tuo branch — lavori qui, in sicurezza
La regola semplice: un lavoro → un branch. Niente di più.
Sezione 1 · I sei concetti

Il merge: due genitori.

Quando il lavoro sul vostro branch è pronto, rientra nella linea principale. Quel punto di unione ha «due genitori»: la linea principale e la vostra. Da lì in poi il vostro lavoro fa parte del progetto.

merge due genitori
Merge = accettare quel lavoro nel progetto condiviso.
Sezione 1 · Il concetto più importante

La Pull Request: chiedere il permesso.

Prima che il vostro lavoro entri nel progetto, si apre una Pull Request. È un processo sociale, non tecnico:

Finisci il lavoro Apri la PR Qualcuno rivede Approvato Aggiunto al progetto
La PR chiede una cosa sola: "Possiamo aggiungere il mio lavoro al progetto?"
È lo stesso cancello dell'approvazione del piano che usate dalla Lezione 1.
Sezione 1 · Il quadro completo

Tutto insieme, in un'immagine.

GitHub — la casa del progetto Alice il suo computer Bob il suo computer push pull
Ognuno: pull → lavora → commit → push → apre una PR. La casa resta una sola.
Sezione 1 · La routine

La routine in 7 passi.

Questa è la sequenza da ripetere ogni volta che lavorate. Sempre la stessa:

1 Apri il progetto 2 Pull 3 Modifica 4 Testa 5 Commit 6 Push 7 Apri la PR
Ripetetela ogni sessione e le buone abitudini vengono da sole — senza capire cosa fa Git dentro.
Sezione 1 · La routine

Dove sono? Cosa faccio dopo?

Sto iniziando a lavorarePull
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. Riconoscete solo cosa deve succedere dopo.
Sezione 1 · Il bigliettino

Il bigliettino.

Clone
Scarico il progetto la prima volta
Pull
Prendo il lavoro più recente di tutti
Edit
Faccio il mio lavoro
Commit
Salvo con un'etichetta
Push
Carico il mio lavoro salvato
PR
Chiedo di aggiungere il mio lavoro
Merge
Il lavoro entra nel progetto
I comandi li scrive Claude. Questo vi basta per settimane.
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.
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
La routine di GitHub in 7 passi
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.

Apriamo la nostra mappa agentica e guardiamo tre cose: com'è fatta dentro, come ci finisce una buona pratica, e cosa succede quando le chiediamo un consiglio prima di iniziare qualcosa.

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 · Dove va a finire

E il passo dopo?

C'è un ultimo mattone: il guardrail che rende un errore impossibile — codice che parte da solo a ogni evento, senza che nessuno debba ricordarsene.

Si chiamano hook. Non li facciamo oggi: è lì che questo percorso va a finire, quando ne avrete bisogno.

La porta resta aperta. E la vostra mappa saprà accompagnarvici.
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