Collezione di Subagenti Claude Code
Una raccolta completa di subagenti AI specializzati per Claude Code, progettati per migliorare i flussi di lavoro di sviluppo con competenze specifiche di dominio.
Panoramica
Questo repository contiene 76 subagenti specializzati che estendono le capacità di Claude Code. Ogni subagente è un esperto in un dominio specifico, attivato automaticamente in base al contesto o richiamato esplicitamente quando necessario. Tutti gli agenti sono configurati con modelli Claude specifici in base alla complessità del compito per ottimizzare prestazioni ed economicità.
Subagenti Disponibili
Sviluppo & Architettura
- backend-architect - Progetta API RESTful, confini dei microservizi e schemi di database
- frontend-developer - Costruisce componenti React, implementa layout responsivi e gestisce lo stato lato client
- ui-ux-designer - Crea design di interfacce, wireframe e sistemi di design
- ui-visual-validator - Verifica se le modifiche UI hanno raggiunto gli obiettivi previsti tramite analisi rigorosa degli screenshot
- mobile-developer - Sviluppa app React Native o Flutter con integrazioni native
- graphql-architect - Progetta schemi GraphQL, resolver e federazione
- architect-reviewer - Revisiona le modifiche al codice per coerenza e pattern architetturali
Specialisti Linguaggi
- python-pro - Scrive codice Python idiomatico con funzionalità avanzate e ottimizzazioni
- ruby-pro - Scrive codice Ruby idiomatico con metaprogrammazione, pattern Rails, sviluppo gemme e framework di test
- golang-pro - Scrive codice Go idiomatico con goroutine, canali e interfacce
- rust-pro - Scrive codice Rust idiomatico con pattern di ownership, lifetimes e implementazioni di trait
- c-pro - Scrive codice C efficiente con corretta gestione della memoria e chiamate di sistema
- cpp-pro - Scrive codice C++ idiomatico con funzionalità moderne, RAII, smart pointer e algoritmi STL
- javascript-pro - Padroneggia JavaScript moderno con ES6+, pattern asincroni e API Node.js
- typescript-pro - Padroneggia TypeScript con tipi avanzati, generics e sicurezza dei tipi rigorosa
- php-pro - Scrive codice PHP idiomatico con funzionalità moderne e ottimizzazioni delle prestazioni
- java-pro - Padroneggia Java moderno con stream, concorrenza e ottimizzazione JVM
- elixir-pro - Scrive codice Elixir idiomatico con pattern OTP, programmazione funzionale e framework Phoenix
- csharp-pro - Scrive codice C# moderno con funzionalità avanzate e ottimizzazione .NET
- scala-pro - Padroneggia lo sviluppo Scala enterprise con programmazione funzionale, sistemi distribuiti e big data processing
- flutter-expert - Padroneggia lo sviluppo Flutter con Dart, widget e integrazioni di piattaforma
- unity-developer - Sviluppa giochi Unity con script ottimizzati e tuning delle prestazioni
- minecraft-bukkit-pro - Padroneggia lo sviluppo di plugin server Minecraft con Bukkit, Spigot e API Paper
- ios-developer - Sviluppa applicazioni iOS native con Swift/SwiftUI
- sql-pro - Scrive query SQL complesse, ottimizza piani di esecuzione e progetta schemi normalizzati
Infrastruttura & Operazioni
- devops-troubleshooter - Risolve problemi in produzione, analizza log e corregge errori di deployment
- deployment-engineer - Configura pipeline CI/CD, container Docker e deployment in cloud
- cloud-architect - Progetta infrastrutture AWS/Azure/GCP e ottimizza costi cloud
- hybrid-cloud-architect - Progetta infrastrutture cloud ibride su AWS/Azure/GCP e ambienti on-premises OpenStack
- kubernetes-architect - Progetta infrastrutture cloud-native con Kubernetes al centro e principi GitOps su AWS/Azure/GCP e ambienti ibridi.
- database-optimizer - Ottimizza query SQL, progetta indici efficienti e gestisce migrazioni database
- database-admin - Gestisce operazioni di database, backup, replica e monitoraggio
- terraform-specialist - Scrive moduli Terraform avanzati, gestisce file di stato e implementa best practice IaC
- incident-responder - Gestisce incidenti in produzione con urgenza e precisione
- network-engineer - Risolvi problemi di connettività di rete, configura bilanciatori di carico e analizza i pattern di traffico
- dx-optimizer - Specialista in Developer Experience che migliora strumenti, configurazione e flussi di lavoro
Qualità & Sicurezza
- code-reviewer - Esperto in revisione del codice con profonda attenzione alla sicurezza della configurazione e affidabilità in produzione
- security-auditor - Revisiona il codice per vulnerabilità e garantisce la conformità OWASP
- test-automator - Crea suite di test complete con test unitari, di integrazione ed end-to-end
- performance-engineer - Profilazione delle applicazioni, ottimizzazione dei colli di bottiglia e strategie di caching
- debugger - Specialista nel debug di errori, fallimenti dei test e comportamenti inattesi
- error-detective - Analizza log e codebase per pattern di errore, stack trace e anomalie
- search-specialist - Esperto nella ricerca web usando tecniche avanzate e sintesi
Dati & AI
- data-scientist - Esperto in analisi dati per query SQL, operazioni BigQuery e insight sui dati
- data-engineer - Costruisce pipeline ETL, data warehouse e architetture di streaming
- ai-engineer - Sviluppa applicazioni LLM, sistemi RAG e pipeline di prompt
- ml-engineer - Implementa pipeline ML, model serving e ingegnerizzazione delle feature
- mlops-engineer - Costruisce pipeline ML, monitoraggio degli esperimenti e registri dei modelli
- prompt-engineer - Ottimizza prompt per LLM e sistemi AI
Domini Specializzati
- api-documenter - Crea specifiche OpenAPI/Swagger e scrive documentazione per sviluppatori
- payment-integration - Integra Stripe, PayPal e processori di pagamento
- quant-analyst - Sviluppa modelli finanziari, backtest strategie di trading e analizza dati di mercato
- risk-manager - Monitora rischi di portafoglio, R-multipli e limiti di posizione
- legacy-modernizer - Rifattorizza codebase legacy e implementa una modernizzazione graduale
- context-manager - Gestisce il contesto tra più agenti e task di lunga durata
Documentazione
- docs-architect - Crea documentazione tecnica completa dai codebase esistenti
- mermaid-expert - Crea diagrammi Mermaid per flowchart, sequenze, ERD e architetture
- reference-builder - Crea riferimenti tecnici esaustivi e documentazione API
- tutorial-engineer - Crea tutorial passo-passo e contenuti educativi dal codice
Business & Marketing
- business-analyst - Analizza metriche, crea report e traccia KPI
- content-marketer - Scrive articoli per blog, contenuti social media e newsletter via email
- hp-pro - Partner per assunzioni, onboarding/offboarding, ferie e permessi, performance, policy conformi e relazioni con dipendenti.
- sales-automator - Redige email di primo contatto, follow-up e template di proposte
- customer-support - Gestisce ticket di supporto, risposte alle FAQ e email ai clienti
- legal-advisor - Redige politiche sulla privacy, termini di servizio, disclaimer e avvisi legali
SEO & Ottimizzazione dei Contenuti
- seo-content-auditor - Analizza i contenuti forniti per qualità, segnali E-E-A-T e best practice SEO
- seo-meta-optimizer - Crea titoli meta, descrizioni e suggerimenti URL ottimizzati
- seo-keyword-strategist - Analizza l’uso delle parole chiave, calcola la densità, suggerisce variazioni semantiche
- seo-structure-architect - Ottimizza la struttura dei contenuti, gerarchia degli header e markup schema
- seo-snippet-hunter - Formatta i contenuti per featured snippet e funzioni SERP
- seo-content-refresher - Identifica elementi obsoleti e suggerisce aggiornamenti ai contenuti
- seo-cannibalization-detector - Analizza più pagine per sovrapposizione e conflitti di parole chiave
- seo-authority-builder - Analizza i contenuti per segnali E-E-A-T e indicatori di fiducia
- seo-content-writer - Scrive contenuti ottimizzati SEO basati su parole chiave e brief
- seo-content-planner - Crea outline dei contenuti, topic cluster e calendari
Assegnazioni dei Modelli
Tutti i 76 subagent sono configurati con specifici modelli Claude in base alla complessità del compito:
🚀 Haiku (Veloce & Economico) - 15 agenti
Modello:haiku
data-scientist- Query SQL e analisi datiapi-documenter- Documentazione OpenAPI/Swaggerreference-builder- Riferimenti tecnici esaustivi e documentazione APIbusiness-analyst- Monitoraggio metriche e KPIcontent-marketer- Post blog e social mediacustomer-support- Ticket di supporto e FAQsales-automator- Email a freddo e propostesearch-specialist- Ricerca web e raccolta informazionilegal-advisor- Politiche sulla privacy e documenti di conformitàseo-meta-optimizer- Ottimizzazione titoli e descrizioni metaseo-keyword-strategist- Analisi densità e semantica parole chiaveseo-structure-architect- Struttura contenuti e markup schemaseo-snippet-hunter- Formattazione per featured snippetseo-content-refresher- Aggiornamenti di freschezza contenutiseo-cannibalization-detector- Rilevamento sovrapposizione parole chiaveseo-content-planner- Calendari e outline dei contenuti
⚡ Sonnet (Prestazioni Bilanciate) - 45 agenti
Modello:sonnetSviluppo & Linguaggi:
python-pro- Sviluppo Python con funzionalità avanzateruby-pro- Sviluppo Ruby con metaprogrammazione, pattern Rails e sviluppo gemjavascript-pro- JavaScript moderno e Node.jstypescript-pro- TypeScript avanzato con sistemi di tipigolang-pro- Concorrenza in Go e pattern idiomaticirust-pro- Sicurezza della memoria Rust e programmazione di sistemic-pro- Programmazione C e sistemi embeddedcpp-pro- C++ moderno con STL e templatephp-pro- PHP moderno con funzionalità avanzatejava-pro- Java moderno con stream e concorrenzaelixir-pro- Elixir con pattern OTP e Phoenixcsharp-pro- C# moderno con framework .NET e patternscala-pro- Scala enterprise con Apache Pekko, Akka, Spark e ZIO/Cats Effectflutter-expert- Sviluppo Flutter con gestione dello stato e animazioniunity-developer- Sviluppo e ottimizzazione giochi Unityminecraft-bukkit-pro- Sviluppo plugin Minecraft con Bukkit/Spigot/Paperios-developer- Sviluppo nativo iOS con Swift/SwiftUIfrontend-developer- Componenti React e UIui-ux-designer- Design di interfacce e wireframeui-visual-validator- Validazione rigorosa UI tramite analisi screenshotbackend-architect- Progettazione API e microservizimobile-developer- App React Native/Fluttersql-pro- Ottimizzazione SQL complessagraphql-architect- Schemi e resolver GraphQL
devops-troubleshooter- Debugging in produzionedeployment-engineer- Pipeline CI/CDdatabase-optimizer- Ottimizzazione querydatabase-admin- Operazioni databaseterraform-specialist- Infrastructure as Codenetwork-engineer- Configurazione di retedx-optimizer- Esperienza sviluppatoredata-engineer- Pipeline ETL
test-automator- Creazione suite di testcode-reviewer- Analisi qualità del codicedebugger- Investigazione errorierror-detective- Analisi dei logml-engineer- Deploy di modelli MLlegacy-modernizer- Migrazione di frameworkpayment-integration- Elaborazione pagamentimermaid-expert- Diagrammi Mermaid e documentazione visivaflutter-expert- Sviluppo Flutterseo-content-auditor- Analisi qualità contenuti e E-E-A-Tseo-authority-builder- Ottimizzazione segnali di autoritàseo-content-writer- Creazione contenuti ottimizzati SEO
🧠 Opus (Capacità Massima) - 15 agenti
Modello:opus
ai-engineer- Applicazioni LLM e sistemi RAGsecurity-auditor- Analisi di vulnerabilitàperformance-engineer- Ottimizzazione applicazioniincident-responder- Gestione incidenti in produzionemlops-engineer- Infrastruttura MLarchitect-reviewer- Coerenza architetturalecloud-architect- Progettazione infrastruttura cloudprompt-engineer- Ottimizzazione prompt LLMcontext-manager- Coordinamento multi-agentequant-analyst- Modellazione finanziariarisk-manager- Gestione rischio portafogliodocs-architect- Documentazione tecnica completa dai codebasetutorial-engineer- Tutorial passo-passo e contenuti educativi
Installazione
Questi subagent sono disponibili automaticamente quando inseriti nella directory ~/.claude/agents/.
cd ~/.claude
git clone https://github.com/wshobson/agents.gitUtilizzo
Invocazione Automatica
Claude Code delega automaticamente al sottoagente appropriato in base al contesto del compito e alla descrizione del sottoagente.Invocazione Esplicita
Menziona il sottoagente per nome nella tua richiesta:"Use the code-reviewer to check my recent changes"
"Have the security-auditor scan for vulnerabilities"
"Get the performance-engineer to optimize this bottleneck"Esempi di utilizzo
Attività con singolo agente
# Code quality and review
"Use code-reviewer to analyze this component for best practices"
"Have code-reviewer scrutinize these configuration changes"
"Have security-auditor check for OWASP compliance issues"Development tasks
"Get backend-architect to design a user authentication API"
"Use frontend-developer to create a responsive dashboard layout"Infrastructure and operations
"Have devops-troubleshooter analyze these production logs"
"Use cloud-architect to design a scalable AWS architecture"
"Get network-engineer to debug SSL certificate issues"
"Use database-admin to set up backup and replication"Data and AI
"Get data-scientist to analyze this customer behavior dataset"
"Use ai-engineer to build a RAG system for document search"
"Have mlops-engineer set up MLflow experiment tracking"Business and marketing
"Have business-analyst create investor deck with growth metrics"
"Use content-marketer to write SEO-optimized blog post"
"Get sales-automator to create cold email sequence"
"Have customer-support draft FAQ documentation"Flussi di lavoro multi-agente
Questi subagenti lavorano insieme senza soluzione di continuità, e per orchestrazioni più complesse, puoi utilizzare la raccolta Claude Code Commands che offre 52 comandi slash preconfigurati che sfruttano questi subagenti in flussi di lavoro sofisticati.
# Feature development workflow
"Implement user authentication feature"
Automatically uses: backend-architect → frontend-developer → test-automator → security-auditor
Performance optimization workflow
"Optimize the checkout process performance"
Automatically uses: performance-engineer → database-optimizer → frontend-developer
Production incident workflow
"Debug high memory usage in production"
Automatically uses: incident-responder → devops-troubleshooter → error-detective → performance-engineer
Network connectivity workflow
"Fix intermittent API timeouts"
Automatically uses: network-engineer → devops-troubleshooter → performance-engineer
Database maintenance workflow
"Set up disaster recovery for production database"
Automatically uses: database-admin → database-optimizer → incident-responder
ML pipeline workflow
"Build end-to-end ML pipeline with monitoring"
Automatically uses: mlops-engineer → ml-engineer → data-engineer → performance-engineer
Product launch workflow
"Launch new feature with marketing campaign"
Automatically uses: business-analyst → content-marketer → sales-automator → customer-support
Flussi di lavoro avanzati con Slash Commands
Per un'orchestrazione multi-subagente più sofisticata, utilizza il repository complementare Commands:
# Complex feature development (8+ subagents)
/full-stack-feature Build user dashboard with real-time analyticsProduction incident response (5+ subagents)
/incident-response Database connection pool exhaustedML infrastructure setup (6+ subagents)
/ml-pipeline Create recommendation engine with A/B testingSecurity-focused implementation (7+ subagents)
/security-hardening Implement OAuth2 with zero-trust architectureFormato Subagente
Ogni subagente segue questa struttura:
---
name: subagent-name
description: When this subagent should be invoked
model: haiku # Optional - specify which model to use (haiku/sonnet/opus)
tools: tool1, tool2 # Optional - defaults to all tools
System prompt defining the subagent's role and capabilities
Configurazione del Modello
A partire da Claude Code v1.0.64, i subagent possono specificare quale modello Claude utilizzare. Questo consente una delega dei compiti conveniente in base alla complessità:
- Bassa Complessità (Haiku): Attività semplici come analisi dati di base, generazione di documentazione e risposte standard
- Media Complessità (Sonnet): Attività di sviluppo, revisione del codice, test e lavoro ingegneristico standard
- Alta Complessità (Opus): Attività critiche come auditing di sicurezza, revisione dell’architettura, risposta agli incidenti e ingegneria AI/ML
haiku- Rapido ed economico per attività semplicisonnet- Prestazioni bilanciate per la maggior parte dei lavori di sviluppoopus- Il più capace per analisi complesse e compiti critici
Pattern di Orchestrazione degli Agenti
Claude Code coordina automaticamente gli agent utilizzando questi pattern comuni:
Flussi di lavoro sequenziali
User Request → Agent A → Agent B → Agent C → ResultExample: "Build a new API feature"
backend-architect → frontend-developer → test-automator → security-auditor
Esecuzione parallela
User Request → Agent A + Agent B (simultaneously) → Merge ResultsExample: "Optimize application performance"
performance-engineer + database-optimizer → Combined recommendations
Diramazione Condizionale
User Request → Analysis → Route to appropriate specialistExample: "Fix this bug"
debugger (analyzes) → Routes to: backend-architect OR frontend-developer OR devops-troubleshooter
Revisione e Validazione
Primary Agent → Review Agent → Final ResultExample: "Implement payment processing"
payment-integration → security-auditor → Validated implementation
Quando usare quale agente
🏗️ Pianificazione & Architettura
- backend-architect: Progettazione API, schemi di database, architettura di sistema
- frontend-developer: Pianificazione UI/UX, architettura dei componenti
- ui-ux-designer: Progettazione interfaccia, wireframe, sistemi di design, ricerca utenti
- cloud-architect: Progettazione infrastruttura, pianificazione scalabilità
🔧 Implementazione & Sviluppo
- python-pro: Attività di sviluppo specifiche Python
- ruby-pro: Metaprogrammazione Ruby, applicazioni Rails, sviluppo gem, test RSpec/Minitest
- golang-pro: Attività di sviluppo specifiche Go
- rust-pro: Sviluppo Rust, sicurezza della memoria, programmazione di sistemi
- c-pro: Programmazione C, sistemi embedded, codice ad alte prestazioni
- javascript-pro: JavaScript moderno, pattern asincroni, codice Node.js/browser
- typescript-pro: TypeScript avanzato, generici, inferenza di tipo, pattern enterprise
- java-pro: Sviluppo Java moderno, stream, concorrenza, Spring Boot
- elixir-pro: Sviluppo Elixir, pattern OTP, framework Phoenix, programmazione funzionale
- csharp-pro: Sviluppo C# moderno, framework .NET, pattern enterprise
- scala-pro: Scala enterprise con programmazione funzionale, attori Apache Pekko/Akka, Apache Spark, ZIO/Cats Effect, architetture reattive
- flutter-expert: Sviluppo Flutter, Dart, gestione dello stato, animazioni, distribuzione cross-platform
- unity-developer: Sviluppo giochi Unity, scripting C#, ottimizzazione delle prestazioni
- minecraft-bukkit-pro: Sviluppo plugin Minecraft, sistemi di eventi, funzionalità lato server
- ios-developer: Sviluppo iOS nativo con Swift/SwiftUI
- sql-pro: Query database, progettazione schemi, ottimizzazione query
- mobile-developer: Sviluppo React Native/Flutter
🛠️ Operazioni & Manutenzione
- devops-troubleshooter: Problemi in produzione, difficoltà di deploy
- incident-responder: Interruzioni critiche che richiedono risposta immediata
- database-optimizer: Prestazioni delle query, strategie di indicizzazione
- database-admin: Strategie di backup, replica, gestione utenti, disaster recovery
- terraform-specialist: Infrastructure as Code, moduli Terraform, gestione dello stato
- network-engineer: Connettività di rete, load balancer, SSL/TLS, debug DNS
📊 Analisi & Ottimizzazione
- performance-engineer: Colli di bottiglia applicativi, ottimizzazione
- security-auditor: Scansione vulnerabilità, verifiche di conformità
- data-scientist: Analisi dati, insight, report
- mlops-engineer: Infrastruttura ML, tracciamento degli esperimenti, registri dei modelli, automazione delle pipeline
🧪 Controllo Qualità
- code-reviewer: Qualità del codice, sicurezza della configurazione, affidabilità in produzione
- test-automator: Strategia di test, creazione di suite di test
- debugger: Investigazione bug, risoluzione errori
- error-detective: Analisi dei log, riconoscimento di pattern di errore, analisi delle cause radice
- search-specialist: Ricerca approfondita sul web, analisi competitiva, verifica dei fatti
📚 Documentazione
- api-documenter: Specifiche OpenAPI/Swagger, documentazione API
- docs-architect: Documentazione tecnica completa, guide architetturali, manuali di sistema
- reference-builder: Riferimenti API esaustivi, guide di configurazione, documentazione dei parametri
- tutorial-engineer: Tutorial passo-passo, percorsi di apprendimento, contenuti educativi
💼 Business & Strategia
- business-analyst: KPI, modelli di ricavo, proiezioni di crescita, metriche per investitori
- risk-manager: Rischio di portafoglio, strategie di copertura, R-multipli, dimensionamento posizioni
- content-marketer: Contenuti SEO, post sul blog, social media, campagne email
- sales-automator: Email a freddo, follow-up, proposte, nurturing dei lead
- customer-support: Ticket di supporto, FAQ, documentazione di aiuto, risoluzione problemi
- legal-advisor - Redigere privacy policy, termini di servizio, disclaimer e avvisi legali
Best Practice
🎯 Delegazione dei Compiti
- Lascia che Claude Code deleghi automaticamente - L'agente principale analizza il contesto e seleziona gli agenti ottimali
- Sii specifico sui requisiti - Includi vincoli, stack tecnologico e requisiti di qualità
- Fidati dell'esperienza dell'agente - Ogni agente è ottimizzato per il proprio dominio
🔄 Flussi di Lavoro Multi-Agente
- Inizia con richieste di alto livello - Lascia che gli agenti coordinino compiti complessi a più step
- Fornisci contesto tra gli agenti - Assicura che gli agenti abbiano le informazioni di base necessarie
- Rivedi i punti di integrazione - Verifica come lavorano insieme gli output dei diversi agenti
🎛️ Controllo Esplicito
- Usa invocazioni esplicite per esigenze specifiche - Quando desideri la prospettiva di un particolare esperto
- Combina più agenti in modo strategico - Diversi specialisti possono validare il lavoro reciproco
- Richiedi pattern di revisione specifici - "Fai revisionare al security-auditor il design API del backend-architect"
📈 Ottimizzazione
- Monitora l’efficacia degli agenti - Scopri quali agenti funzionano meglio per i tuoi casi d’uso
- Itera su compiti complessi - Usa il feedback degli agenti per affinare i requisiti
- Sfrutta i punti di forza degli agenti - Adatta la complessità dei compiti alle capacità degli agenti
Contribuire
Per aggiungere un nuovo subagente:
- Crea un nuovo file
.mdseguendo il formato sopra - Usa nomi in minuscolo separati da trattini
- Scrivi descrizioni chiare su quando dovrebbe essere usato il subagente
- Includi istruzioni specifiche nel prompt di sistema
Risoluzione dei problemi
Problemi comuni
L’agente non viene invocato automaticamente:
- Assicurati che la tua richiesta indichi chiaramente il dominio (es. "problema di performance" → performance-engineer)
- Sii specifico sul tipo di compito (es. "revisiona codice" → code-reviewer)
- Fornisci più contesto sul tuo stack tecnologico e sui requisiti
- Usa l’invocazione esplicita se hai bisogno di uno specifico agente
- È normale: diversi specialisti possono avere priorità differenti
- Chiedi chiarimenti: "Riconcilia le raccomandazioni di security-auditor e performance-engineer"
- Fornisci informazioni di background nella tua richiesta
- Fai riferimento a conversazioni precedenti o a modelli stabiliti
Ottenere aiuto
Se gli agenti non funzionano come previsto:
- Controlla le descrizioni degli agenti nei loro file individuali
- Prova un linguaggio più specifico nelle tue richieste
- Usa l’invocazione esplicita per testare agenti specifici
- Fornisci più contesto sul tuo progetto e sui tuoi obiettivi
Licenza
Questo progetto è distribuito sotto licenza MIT - consulta il file LICENSE per i dettagli.