N2 — Advanced Operator ▾
Advanced Operator
Playbook
Claude Code come sistema di lavoro professionale. 10 moduli per costruire, fare debug, refactoring, automatizzare, documentare e collaborare senza perdere il controllo del progetto.
Cosa imparerai
Diagramma — Come lavora un operatore avanzato
Obiettivo
Cosa vuoi costruire o migliorare
Architettura del progetto
Struttura, cartelle, convenzioni
Contesto + CLAUDE.md avanzato
Regole, stack, vincoli, flusso
Git + debugging + refactor
Modifiche piccole, reversibili, verificabili
Automazioni + MCP
Strumenti connessi con criterio
Deploy + documentazione
Pubblicare, versionare, trasferire
Sistema scalabile
Un altro operatore può continuare senza attriti
Completa il Livello 1 per sbloccare
L'Advanced Operator Playbook si sblocca quando completi Operator Foundations. Il Livello 1 ti dà la base che questo livello dà per scontata.
Vai al Livello 1 — Operator Foundations →Architettura dei progetti
Obiettivo
Strutturare un progetto in modo che Claude possa capirlo e modificarlo senza romperlo.
Risultato
Repo pulito, README chiaro, cartelle coerenti e regole iniziali documentate.
mapa-arquitectura.md INSIGHT AVANZATO
Organizza la struttura come se Claude dovesse leggere il repo a freddo. Se la cartella è confusa per te, produrrà codice disallineato fin dal primo messaggio.
CLAUDE.md avanzato
Obiettivo
Creare regole operative approfondite per un progetto complesso.
Risultato
Claude capisce stile, limiti, stack, comandi, sicurezza e modo di lavorare.
CLAUDE.md v2 INSIGHT AVANZATO
Un CLAUDE.md v2 non è più lungo della v1 — è più denso. Una regola specifica ("non aggiungere dipendenze senza giustificazione") vale più di tre generiche ("sii prudente").
Controllo del contesto
Obiettivo
Imparare cosa dare a Claude, cosa non dargli e quando riassumere.
Risultato
Meno token sprecati, risposte più precise, sessioni più efficienti.
brief-proyecto.md INSIGHT AVANZATO
Quando il contesto cresce troppo, non cancellarlo: riassumilo. Un brief-sesión.md di 20 righe è più utile di 5000 token di cronologia senza ordine.
Git workflow professionale
Obiettivo
Lavorare con commit, branch e diff senza caos né perdita di lavoro.
Risultato
Modifiche piccole, reversibili e revisionabili. Una cronologia che racconta una storia.
git-workflow.md documentado INSIGHT AVANZATO
Fai commit piccoli e frequenti. Un commit che descrive "aggiungere footer" è utile. Un commit con 12 file modificati e messaggio "migliorie" è una bomba a orologeria.
Debugging assistito
Obiettivo
Usare Claude per trovare errori senza affidarti ciecamente ai suoi suggerimenti.
Risultato
Bug isolati con ipotesi chiare e fix piccoli e reversibili.
bug-report + solución aplicada INSIGHT AVANZATO
Prima di chiedere a Claude di "sistemare questo", chiedigli di spiegare cosa pensa stia succedendo. Se non sa spiegarlo, il fix proposto può essere plausibile ma sbagliato.
Refactor sicuri
Obiettivo
Migliorare il codice senza rompere funzionalità esistenti né introdurre nuovo debito.
Risultato
Refactor per fasi con build passing dopo ogni modifica.
before/after documentado con diff INSIGHT AVANZATO
Fai il refactoring di una cosa alla volta. Verifica la build. Poi la successiva. La fiducia nel refactor viene dalle build verdi, non dalla sensazione che "dovrebbe funzionare".
Automazioni e MCP
Obiettivo
Capire quando connettere strumenti esterni e quando è sovra-ingegnerizzazione.
Risultato
Mappa di automazioni utili con una giustificazione per ciascuna.
diagrama-automatizacion.md INSIGHT AVANZATO
Connettere un MCP è facile. Sapere cosa esegue a tuo nome e quando non usarlo non lo è. Non aggiungere strumenti di cui non capisci cosa fanno in background.
Testing e validazione
Obiettivo
Non fidarti solo del fatto che "sembra funzionare" prima di pubblicare.
Risultato
Checklist di test manuali eseguita prima di ogni deploy.
qa-checklist.md INSIGHT AVANZATO
La QA checklist non è burocrazia: è memoria esternalizzata. Senza di essa, c'è sempre qualcosa che hai dimenticato di controllare il giorno del deploy.
Deploy e manutenzione
Obiettivo
Pubblicare senza rompere la produzione e mantenere attivo il ciclo di miglioramento.
Risultato
Flusso deploy → revisione → correzione → versionamento documentato ed eseguibile.
sop-deploy.md INSIGHT AVANZATO
Documenta il primo deploy mentre lo esegui. La seconda volta ci metti la metà. La decima, minuti. La documentazione viva è la risorsa che si ammortizza di più.
Documentazione operativa
Obiettivo
Trasformare il proprio lavoro in un sistema riutilizzabile da altre persone o agenti.
Risultato
Processi documentati con un livello di dettaglio sufficiente per delegare.
sop-proceso.md INSIGHT AVANZATO
Test della SOP delegabile: un'altra persona (o Claude) può eseguirla senza chiederti nulla? Se la risposta è "no", la SOP è incompleta.
Quattro scenari completi con Claude Code come sistema di produzione.
Creare una landing completa
Dal brief al deploy. Hero, copy, struttura, componenti, SEO di base e push.
Verificare un sistema esistente
Leggere il codice, documentare cosa fa, identificare i rischi e proporre un piano di miglioramento.
Trasformare un processo manuale in sistema
Mappare i passaggi, identificare quelli automatizzabili, progettare il flusso e documentare la SOP.
Preparare il repo per la collaborazione
CLAUDE.md, README, .gitignore, struttura delle cartelle e regole di contribuzione.
- × Chiedere troppo in una volta — Claude perde il contesto e produce codice che rompe altre parti.
- × Non isolare le modifiche — un refactor che tocca 5 file alla volta è impossibile da revisionare.
- × Non usare i commit — se qualcosa si rompe, non puoi tornare a nessun punto stabile precedente.
- × Non leggere i diff — approvare modifiche che non capisci è garanzia di bug silenziosi.
- × Caricare segreti — una API key su GitHub può generare debito in poche ore.
- × Usare l'IA senza validare — l'output di Claude può essere plausibile ma sbagliato.
- × Lasciare che Claude rifaccia tutto — chiedi modifiche chirurgiche, non riscritture massive.
Agisci come architetto software senior. Analizza la struttura di questo progetto: [incolla qui l'albero dei file o descrivi le cartelle] Valuta: 1. L'organizzazione delle cartelle ha senso per il tipo di progetto? 2. Quali file sono in eccesso, mancano o sono nel posto sbagliato? 3. Quali convenzioni di naming potrebbero essere migliorate? 4. Come organizzeresti tutto questo perché Claude possa navigare senza ambiguità? Proposta: suggerisci una struttura alternativa se quella attuale ha problemi. Sii specifico. Non generalizzare.
Agisci come architetto di istruzioni per Claude Code. Questo è il contesto del progetto: [descrivi il progetto, il suo stack e i suoi obiettivi] Crea un CLAUDE.md avanzato che includa: 1. Descrizione del progetto e scopo in una sola riga 2. Stack tecnico con versioni esatte 3. Comandi critici (build, test, lint, deploy) 4. Regole di architettura: cosa fare e cosa non fare mai 5. Convenzioni di naming e organizzazione dei file 6. Flusso di lavoro atteso: come Claude deve proporre le modifiche 7. Regole di sicurezza: quali file o variabili non toccare mai 8. Segnali di successo: come capire se il lavoro è fatto bene Massimo 60 righe. Denso. Senza riempitivi.
Agisci come ingegnere del refactoring. Voglio migliorare questo frammento di codice: [incolla il codice] Prima di modificare qualsiasi cosa, mi serve un piano di refactor che includa: 1. Quali problemi ha il codice attuale (specifici, non vaghi) 2. Cosa cambieresti e perché 3. I rischi di ogni modifica proposta 4. In quale ordine fare le modifiche perché il codice non resti mai rotto 5. Come validare che ogni modifica non abbia introdotto regressioni Non iniziare a scrivere codice finché non approvo il piano.
Verifica di aver completato i 10 moduli prima di segnare il livello:
- ✓ Mappa di architettura di un progetto reale documentata
- ✓ CLAUDE.md avanzato con le 8 sezioni operative
- ✓ Brief di progetto di massimo 20 righe creato
- ✓ Flusso Git con branch, commit semantico e merge documentato
- ✓ Debugging assistito eseguito su un bug reale
- ✓ Refactor limitato con before/after documentato
- ✓ Diagramma di automazione non ancora implementato
- ✓ QA checklist con almeno 10 punti di validazione
- ✓ SOP di deploy documentata ed eseguita una volta
- ✓ SOP di processo delegabile di massimo 1 pagina
LIVELLO 2 COMPLETATO
Livello 3 sbloccato: ChatGPT → Claude Migration System