Il tuo primo team di agenti in Claude Code: un supervisore e tre specialisti

1.Come lo uso io

Nella mia azienda i contenuti li prepara un team di agenti: uno scrive i testi, uno fa le copertine, uno i caroselli, uno cerca le idee, uno monta i video. Io parlo con uno solo, il supervisore: gli dico cosa serve, lui divide il lavoro tra gli altri, controlla quello che tornano e mi consegna un risultato quasi finito. L'ultima parola resta mia, ma il 90% del lavoro manuale è sparito.

Questa guida ti fa costruire lo stesso schema, in piccolo, sul tuo lavoro: un supervisore e tre specialisti. Il resto è aggiungere schede.

2.Cosa ti serve

3.Come funziona

Un agente, in Claude Code, è un file di testo con un nome, una descrizione e le istruzioni. Sta nella cartella .claude/agents del progetto. Quando dai un compito, Claude legge le descrizioni degli agenti che ha a disposizione e passa il lavoro a quello giusto. Il supervisore è un agente come gli altri, con una differenza: le sue istruzioni dicono di scomporre la richiesta, delegare, rivedere e consegnare.

1. 1

   TU

   dai il compito al supervisore, in una frase

2. 2

   SUPERVISORE

   lo divide in pezzi e li affida agli specialisti

3. 3

   SPECIALISTI

   ognuno fa il suo pezzo, nel suo formato

4. 4

   SUPERVISORE

   controlla con la sua lista, chiede correzioni, unisce

5. 5

   TU

   approvi, o dici cosa cambiare

4.La scheda agente

Ogni scheda ha due parti. In testa, tra due righe di trattini, i dati che Claude Code legge per decidere: name e description sono obbligatori, tools e model sono facoltativi. Sotto, le istruzioni vere: chi è l'agente, cosa sa, come lavora, cosa consegna, cosa non deve fare.

---
name: analista
description: Usa questo agente quando servono numeri, confronti o una sintesi da file e dati del cliente. Legge i file nella cartella dati, non scrive testi finali.
tools: Read, Grep, Glob
model: sonnet
---

Sei l'analista del team di [nome della tua azienda].

COSA SAI
- Il nostro lavoro: [una riga: cosa fate e per chi].
- I dati stanno in [cartella o file]: [cosa contengono, una riga per file].
- Le parole che usiamo: [3-5 termini interni con il significato].

COME LAVORI
1. Leggi i file che ti indicano. Se un dato manca, dillo: non inventarlo.
2. Confronta sempre con il periodo precedente, se esiste.
3. Segnala le anomalie: numeri fuori scala, buchi, date mancanti.

COSA CONSEGNI
- Un riepilogo di massimo 10 righe: i 5 numeri che contano, cosa è cambiato, cosa non torna.
- Le fonti: da quale file viene ogni numero.

COSA NON FAI
- Non scrivi mail, proposte o testi per il cliente: quello è lo scrittore.
- Non arrotondi né stimi: se non c'è il numero, scrivi «dato mancante».

La description è la parte più importante: è quello che il supervisore legge per capire a chi affidare un pezzo. Scrivila in terza persona, inizia con «Usa questo agente quando», e di' anche cosa non fa. Se due descrizioni si somigliano, il lavoro finirà all'agente sbagliato.

Installala nella tua AI

Il file che scarichi non è un riassunto: è la guida intera più le istruzioni per l'AI, scritte in testa. Tu lo consegni, lei lo legge, ti fa le domande e produce il risultato. Qui: Quattro schede agente in .claude/agents (un supervisore e tre specialisti sul tuo lavoro) e un primo compito eseguito dal team.