Dagli prompt agli agenti Claude Code

Gli agenti sono il passo successivo ai prompt: invece di copiare un testo e sostituire le variabili, un agente conversa con te, ti fa le domande giuste per raccogliere il contesto e produce il testo finito. La libreria prompt-pmi-italia include 3 agenti per Claude Code — social-media-manager, customer-care e copywriter-vendite — pronti da usare nelle cartelle del progetto.

---

Prompt vs agente: qual è la differenza

Un prompt è un testo che copi, riempi e invii: ottimo per un compito singolo e occasionale. Un agente è un livello sopra. È un assistente con:

• un ruolo fisso (es. "sei un social media manager per PMI italiane");
• la consapevolezza di quali informazioni gli servono e la capacità di chiedertele se mancano;
• un modo di lavorare definito (hook + corpo + call-to-action per i social, de-escalation per le recensioni, valore-prima-del-prezzo per le offerte).

In pratica: con un prompt guidi tu l'AI passo passo; con un agente è l'agente a guidare la conversazione, raccogliere il contesto e consegnarti il risultato finito. È utile quando un compito torna spesso e vuoi smettere di ricostruire ogni volta il prompt.

I 3 agenti della libreria

Tutti e tre sono costruiti sulla stessa base condivisa (lingua italiana, raccolta del contesto prima dell'output, neutralità rispetto al brand, attenzione a privacy e responsabilità). Ognuno copre un'area e rimanda agli altri due quando il compito non è suo.

1. social-media-manager

Crea e pianifica contenuti social — Instagram, Facebook, LinkedIn, TikTok. Lo usi per caption, calendari editoriali, declinazione di una notizia su più canali e risposte ai commenti. Sa che ogni caption ha bisogno di un hook iniziale forte, di un corpo concreto e di una call-to-action, e adatta il testo al canale invece di copiarlo ovunque.

→ .claude/agents/social-media-manager.md

2. customer-care

Gestisce la comunicazione con i clienti: risposte a recensioni (positive e negative), email a clienti difficili, reclami, solleciti, FAQ e richieste di recensione. Lo usi quando serve curare la relazione e la reputazione, con il tono giusto per chi leggerà dopo.

→ .claude/agents/customer-care.md

3. copywriter-vendite

Scrive testi commerciali: offerte e preventivi scritti, email di vendita orientate ai benefici, follow-up post-preventivo, script con gestione delle obiezioni e schede prodotto che convertono. Lo usi per tutto ciò che deve portare a una vendita, mettendo il valore prima del prezzo.

→ .claude/agents/copywriter-vendite.md

Come si usano con Claude Code

Gli agenti girano dentro Claude Code, lo strumento da terminale di Anthropic. Se non l'hai mai usato, parti dalla nostra guida Setup di Claude Code nelle prime ore: in mezz'ora sei operativo. Per capire come Claude Code legge le istruzioni di un progetto, è utile anche CLAUDE.md: il README per l'AI.

Una volta installato Claude Code, usare gli agenti è semplice:

1. Scarica la cartella .claude/agents/ dal repository e copiala nella cartella del tuo progetto (o nella tua configurazione personale di Claude Code).
2. Apri Claude Code in quella cartella: rileva automaticamente gli agenti disponibili.
3. Chiedi quello che ti serve — per esempio "preparami tre caption Instagram per la promo di sabato": Claude Code instrada la richiesta all'agente giusto, che ti farà al massimo due o tre domande mirate e poi consegnerà il testo.

Non sei uno sviluppatore? Va benissimo. Gli agenti non richiedono di scrivere codice: parli con loro in italiano, in linguaggio naturale. Claude Code è solo il "contenitore" che li fa funzionare. Se preferisci restare sui prompt copia-incolla, le prime tre lezioni di questa sezione ti bastano per lavorare bene.

Quando conviene passare agli agenti

• Quando un compito torna spesso. Se pubblichi sui social ogni settimana o rispondi a recensioni di continuo, un agente ti fa risparmiare il tempo di ricostruire il prompt ogni volta.
• Quando vuoi coerenza. L'agente mantiene lo stesso modo di lavorare, quindi i tuoi contenuti restano allineati nel tono.
• Quando vuoi delegare la raccolta del contesto. È l'agente a chiederti cosa serve, così non rischi di dimenticare un dato importante.

Se invece ti serve qualcosa una volta sola, un prompt della libreria è più rapido. Prompt e agenti non si escludono: sono due livelli dello stesso strumento.

Ricapitolando il percorso

In questa sezione hai visto cos'è prompt-pmi-italia e il problema che risolve, come si scrive un buon prompt, i 10 prompt indispensabili e ora gli agenti. Da qui puoi muoverti in due direzioni: restare sui prompt e padroneggiarli, oppure entrare nel mondo di Claude Code con i nostri tutorial dedicati.

---

Trovi i 3 agenti, con tutte le istruzioni, su github.com/StChannelIT/prompt-pmi-italia. Se il progetto ti è utile, lascia una ⭐ e — se ti manca un agente per il tuo settore — proponilo: anche solo come idea.