🌐 Idioma

Coleção de Subagentes Claude Code

Uma coleção abrangente de subagentes de IA especializados para o Claude Code, projetados para aprimorar fluxos de trabalho de desenvolvimento com expertise específica de domínio.

Visão Geral

Este repositório contém 76 subagentes especializados que expandem as capacidades do Claude Code. Cada subagente é especialista em um domínio específico, sendo automaticamente acionado com base no contexto ou chamado explicitamente quando necessário. Todos os agentes são configurados com modelos Claude específicos conforme a complexidade da tarefa para desempenho ideal e custo-benefício.

Subagentes Disponíveis

Desenvolvimento & Arquitetura

backend-architect - Projetar APIs RESTful, limites de microsserviços e esquemas de banco de dados
frontend-developer - Construir componentes React, implementar layouts responsivos e gerenciar estado do lado do cliente
ui-ux-designer - Criar designs de interface, wireframes e sistemas de design
ui-visual-validator - Verificar se modificações na UI atingiram seus objetivos através de análise rigorosa de screenshots
mobile-developer - Desenvolver aplicativos React Native ou Flutter com integrações nativas
graphql-architect - Projetar esquemas GraphQL, resolvers e federação
architect-reviewer - Revisar alterações de código quanto à consistência e padrões arquiteturais

Especialistas em Linguagem

python-pro - Escrever código Python idiomático com recursos avançados e otimizações
ruby-pro - Escrever código Ruby idiomático com metaprogramação, padrões Rails, desenvolvimento de gemas e frameworks de teste
golang-pro - Escrever código Go idiomático com goroutines, canais e interfaces
rust-pro - Escrever Rust idiomático com padrões de posse, lifetimes e implementações de traits
c-pro - Escrever código C eficiente com gerenciamento de memória adequado e chamadas de sistema
cpp-pro - Escrever código C++ idiomático com recursos modernos, RAII, ponteiros inteligentes e algoritmos STL
javascript-pro - Dominar JavaScript moderno com ES6+, padrões assíncronos e APIs Node.js
typescript-pro - Dominar TypeScript com tipos avançados, genéricos e segurança de tipos rigorosa
php-pro - Escrever código PHP idiomático com recursos modernos e otimizações de desempenho
java-pro - Dominar Java moderno com streams, concorrência e otimização JVM
elixir-pro - Escrever código Elixir idiomático com padrões OTP, programação funcional e frameworks Phoenix
csharp-pro - Escrever código C# moderno com recursos avançados e otimização .NET
scala-pro - Dominar desenvolvimento Scala de nível empresarial com programação funcional, sistemas distribuídos e processamento de big data
flutter-expert - Dominar desenvolvimento Flutter com Dart, widgets e integrações de plataforma
unity-developer - Construir jogos Unity com scripts otimizados e ajuste de desempenho
minecraft-bukkit-pro - Dominar desenvolvimento de plugins para servidores Minecraft com APIs Bukkit, Spigot e Paper
ios-developer - Desenvolver aplicações nativas para iOS com Swift/SwiftUI
sql-pro - Escrever consultas SQL complexas, otimizar planos de execução e projetar esquemas normalizados

Infraestrutura & Operações

devops-troubleshooter - Depurar problemas em produção, analisar logs e corrigir falhas de implantação
deployment-engineer - Configurar pipelines CI/CD, containers Docker e implantações em nuvem
cloud-architect - Projetar infraestrutura AWS/Azure/GCP e otimizar custos de nuvem
hybrid-cloud-architect - Projetar infraestrutura de nuvem híbrida em AWS/Azure/GCP e ambientes locais OpenStack
kubernetes-architect - Projetar infraestrutura cloud-native com Kubernetes no núcleo e princípios GitOps em AWS/Azure/GCP e ambientes híbridos.
database-optimizer - Otimizar consultas SQL, projetar índices eficientes e gerenciar migrações de banco de dados
database-admin - Gerenciar operações de banco de dados, backups, replicação e monitoramento
terraform-specialist - Escrever módulos avançados de Terraform, gerenciar arquivos de estado e implementar melhores práticas de IaC
incident-responder - Gerencia incidentes de produção com urgência e precisão
network-engineer - Depura conectividade de rede, configura balanceadores de carga e analisa padrões de tráfego
dx-optimizer - Especialista em Experiência do Desenvolvedor que aprimora ferramentas, configuração e fluxos de trabalho

Qualidade & Segurança

code-reviewer - Revisão de código especializada com foco profundo em segurança de configuração e confiabilidade em produção
security-auditor - Revisa código para vulnerabilidades e garante conformidade OWASP
test-automator - Cria suítes de teste abrangentes com testes unitários, de integração e e2e
performance-engineer - Profila aplicações, otimiza gargalos e implementa estratégias de cache
debugger - Especialista em depuração de erros, falhas de teste e comportamentos inesperados
error-detective - Busca padrões de erro, rastreamentos de pilha e anomalias em logs e bases de código
search-specialist - Especialista em pesquisa web usando técnicas avançadas e síntese

Dados & IA

data-scientist - Especialista em análise de dados para consultas SQL, operações BigQuery e insights de dados
data-engineer - Constrói pipelines ETL, data warehouses e arquiteturas de streaming
ai-engineer - Constrói aplicações LLM, sistemas RAG e pipelines de prompts
ml-engineer - Implementa pipelines de ML, serving de modelos e engenharia de features
mlops-engineer - Constrói pipelines de ML, rastreamento de experimentos e registros de modelos
prompt-engineer - Otimiza prompts para LLMs e sistemas de IA

Domínios Especializados

api-documenter - Cria especificações OpenAPI/Swagger e escreve documentação para desenvolvedores
payment-integration - Integra Stripe, PayPal e processadores de pagamento
quant-analyst - Constrói modelos financeiros, faz backtest de estratégias de trading e analisa dados de mercado
risk-manager - Monitora risco de portfólio, múltiplos R e limites de posição
legacy-modernizer - Refatora bases de código legado e implementa modernização gradual
context-manager - Gerencia contexto entre múltiplos agentes e tarefas de longa duração

Documentação

docs-architect - Cria documentação técnica abrangente a partir de bases de código existentes
mermaid-expert - Cria diagramas Mermaid para fluxogramas, sequências, ERDs e arquiteturas
reference-builder - Cria referências técnicas exaustivas e documentação de APIs
tutorial-engineer - Cria tutoriais passo a passo e conteúdo educacional a partir do código

Negócios & Marketing

business-analyst - Analisa métricas, cria relatórios e acompanha KPIs
content-marketer - Escreve posts para blog, conteúdo para redes sociais e newsletters por e-mail
hp-pro - Parceiro para contratação, onboarding/offboarding, férias e licenças, desempenho, políticas de conformidade e relações com colaboradores.
sales-automator - Redige e-mails frios, follow-ups e modelos de propostas
customer-support - Gerencia tickets de suporte, respostas a FAQs e e-mails de clientes
legal-advisor - Redige políticas de privacidade, termos de serviço, avisos legais e comunicados legais

SEO & Otimização de Conteúdo

seo-content-auditor - Analisa o conteúdo fornecido quanto à qualidade, sinais E-E-A-T e melhores práticas de SEO
seo-meta-optimizer - Cria títulos meta, descrições e sugestões de URL otimizados
seo-keyword-strategist - Analisa o uso de palavras-chave, calcula densidade, sugere variações semânticas
seo-structure-architect - Otimiza a estrutura do conteúdo, hierarquia de cabeçalhos e marcação de schema
seo-snippet-hunter - Formata conteúdo para snippets em destaque e recursos SERP
seo-content-refresher - Identifica elementos desatualizados e sugere atualizações de conteúdo
seo-cannibalization-detector - Analisa várias páginas para sobreposição de palavras-chave e conflitos
seo-authority-builder - Analisa conteúdo para sinais E-E-A-T e indicadores de confiança
seo-content-writer - Escreve conteúdo otimizado para SEO com base em palavras-chave e briefings
seo-content-planner - Cria esboços de conteúdo, clusters de tópicos e calendários

Atribuição de Modelos

Todos os 76 subagentes estão configurados com modelos Claude específicos com base na complexidade da tarefa:

🚀 Haiku (Rápido & Econômico) - 15 agentes

Modelo: haiku

data-scientist - Consultas SQL e análise de dados
api-documenter - Documentação OpenAPI/Swagger
reference-builder - Referências técnicas exaustivas e documentação de API
business-analyst - Métricas e acompanhamento de KPIs
content-marketer - Posts de blog e mídias sociais
customer-support - Tickets de suporte e FAQs
sales-automator - E-mails frios e propostas
search-specialist - Pesquisa web e coleta de informações
legal-advisor - Políticas de privacidade e documentos de conformidade
seo-meta-optimizer - Otimização de título e descrição meta
seo-keyword-strategist - Análise de densidade e semântica de palavras-chave
seo-structure-architect - Estrutura de conteúdo e marcação de schema
seo-snippet-hunter - Formatação para snippets em destaque
seo-content-refresher - Atualizações de frescor de conteúdo
seo-cannibalization-detector - Detecção de sobreposição de palavras-chave
seo-content-planner - Calendários e esboços de conteúdo

⚡ Sonnet (Desempenho Equilibrado) - 45 agentes

Modelo: sonnet

Desenvolvimento & Linguagens:

python-pro - Desenvolvimento Python com recursos avançados
ruby-pro - Desenvolvimento Ruby com metaprogramação, padrões Rails e criação de gems
javascript-pro - JavaScript moderno e Node.js
typescript-pro - TypeScript avançado com sistemas de tipos
golang-pro - Concorrência em Go e padrões idiomáticos
rust-pro - Segurança de memória em Rust e programação de sistemas
c-pro - Programação em C e sistemas embarcados
cpp-pro - C++ moderno com STL e templates
php-pro - PHP moderno com recursos avançados
java-pro - Java moderno com streams e concorrência
elixir-pro - Elixir com padrões OTP e Phoenix
csharp-pro - C# moderno com frameworks .NET e padrões
scala-pro - Scala corporativo com Apache Pekko, Akka, Spark e ZIO/Cats Effect
flutter-expert - Desenvolvimento Flutter com gerenciamento de estado e animações
unity-developer - Desenvolvimento e otimização de jogos Unity
minecraft-bukkit-pro - Desenvolvimento de plugins Minecraft com Bukkit/Spigot/Paper
ios-developer - Desenvolvimento nativo iOS com Swift/SwiftUI
frontend-developer - Componentes React e UI
ui-ux-designer - Design de interfaces e wireframes
ui-visual-validator - Validação rigorosa de UI por análise de screenshots
backend-architect - Design de APIs e microsserviços
mobile-developer - Apps React Native/Flutter
sql-pro - Otimização complexa de SQL
graphql-architect - Schemas e resolvers GraphQL

Infraestrutura & Operações:

devops-troubleshooter - Depuração em produção
deployment-engineer - Pipelines CI/CD
database-optimizer - Otimização de consultas
database-admin - Operações de banco de dados
terraform-specialist - Infraestrutura como Código
network-engineer - Configuração de redes
dx-optimizer - Experiência do desenvolvedor
data-engineer - Pipelines ETL

Qualidade & Suporte:

test-automator - Criação de suítes de testes
code-reviewer - Análise de qualidade de código
debugger - Investigação de erros
error-detective - Análise de logs
ml-engineer - Implantação de modelos de ML
legacy-modernizer - Migração de frameworks
payment-integration - Processamento de pagamentos
mermaid-expert - Diagramas Mermaid e documentação visual
flutter-expert - Desenvolvimento Flutter
seo-content-auditor - Auditoria de qualidade de conteúdo e análise E-E-A-T
seo-authority-builder - Otimização de sinais de autoridade
seo-content-writer - Criação de conteúdo otimizado para SEO

🧠 Opus (Capacidade Máxima) - 15 agentes

Modelo: opus

ai-engineer - Aplicações LLM e sistemas RAG
security-auditor - Análise de vulnerabilidades
performance-engineer - Otimização de aplicações
incident-responder - Gerenciamento de incidentes em produção
mlops-engineer - Infraestrutura de ML
architect-reviewer - Consistência arquitetural
cloud-architect - Design de infraestrutura em nuvem
prompt-engineer - Otimização de prompts para LLM
context-manager - Coordenação multiagente
quant-analyst - Modelagem financeira
risk-manager - Gestão de risco de portfólio
docs-architect - Documentação técnica abrangente a partir de bases de código
tutorial-engineer - Tutoriais passo a passo e conteúdo educacional

Instalação

Esses subagentes ficam automaticamente disponíveis ao serem colocados no diretório ~/.claude/agents/.

cd ~/.claude
git clone https://github.com/wshobson/agents.git

Uso

Invocação Automática

O Claude Code irá delegar automaticamente para o subagente apropriado com base no contexto da tarefa e na descrição do subagente.

Invocação Explícita

Mencione o subagente pelo nome em sua solicitação:

"Use the code-reviewer to check my recent changes"
"Have the security-auditor scan for vulnerabilities"
"Get the performance-engineer to optimize this bottleneck"

Exemplos de Uso

Tarefas de Agente Único

# 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"

Fluxos de Trabalho Multiagente

Esses subagentes trabalham juntos de forma integrada e, para orquestrações mais complexas, você pode usar a coleção Claude Code Commands, que oferece 52 comandos de barra pré-construídos que aproveitam esses subagentes em fluxos de trabalho sofisticados.

# 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

Fluxos de Trabalho Avançados com Comandos Slash

Para uma orquestração multi-subagente mais sofisticada, use o repositório complementar Commands:

# Complex feature development (8+ subagents)
/full-stack-feature Build user dashboard with real-time analytics
Production incident response (5+ subagents) 
/incident-response Database connection pool exhausted
ML infrastructure setup (6+ subagents)
/ml-pipeline Create recommendation engine with A/B testing
Security-focused implementation (7+ subagents)
/security-hardening Implement OAuth2 with zero-trust architecture

Formato do Subagente

Cada subagente segue esta estrutura:

--- 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

Configuração do Modelo

A partir do Claude Code v1.0.64, subagentes podem especificar qual modelo Claude devem utilizar. Isso permite uma delegação de tarefas mais econômica baseada na complexidade:

Baixa Complexidade (Haiku): Tarefas simples como análise básica de dados, geração de documentação e respostas padrão
Média Complexidade (Sonnet): Tarefas de desenvolvimento, revisão de código, testes e trabalhos de engenharia padrão
Alta Complexidade (Opus): Tarefas críticas como auditoria de segurança, revisão de arquitetura, resposta a incidentes e engenharia de IA/ML

Modelos disponíveis (usando nomenclatura simplificada conforme Claude Code v1.0.64):

haiku - Rápido e econômico para tarefas simples
sonnet - Desempenho equilibrado para a maioria dos trabalhos de desenvolvimento
opus - Mais capaz para análises complexas e tarefas críticas

Se nenhum modelo for especificado, o subagente usará o modelo padrão do sistema.

Padrões de Orquestração de Agentes

O Claude Code coordena automaticamente agentes usando estes padrões comuns:

Fluxos de Trabalho Sequenciais

User Request → Agent A → Agent B → Agent C → Result

Example: "Build a new API feature" backend-architect → frontend-developer → test-automator → security-auditor

Parallel Execution

User Request → Agent A + Agent B (simultaneously) → Merge Results

Example: "Optimize application performance" performance-engineer + database-optimizer → Combined recommendations

Ramificação Condicional

User Request → Analysis → Route to appropriate specialist

Example: "Fix this bug" debugger (analyzes) → Routes to: backend-architect OR frontend-developer OR devops-troubleshooter

Revisão & Validação

Primary Agent → Review Agent → Final Result

Example: "Implement payment processing" payment-integration → security-auditor → Validated implementation

Quando Usar Qual Agente

🏗️ Planejamento & Arquitetura

backend-architect: Design de API, esquemas de banco de dados, arquitetura de sistemas
frontend-developer: Planejamento de UI/UX, arquitetura de componentes
ui-ux-designer: Design de interface, wireframes, sistemas de design, pesquisa de usuário
cloud-architect: Design de infraestrutura, planejamento de escalabilidade

🔧 Implementação & Desenvolvimento

python-pro: Tarefas específicas de desenvolvimento em Python
ruby-pro: Metaprogramação em Ruby, aplicações Rails, desenvolvimento de gems, testes RSpec/Minitest
golang-pro: Tarefas específicas de desenvolvimento em Go
rust-pro: Desenvolvimento em Rust, segurança de memória, programação de sistemas
c-pro: Programação em C, sistemas embarcados, código crítico de desempenho
javascript-pro: JavaScript moderno, padrões assíncronos, código Node.js/navegador
typescript-pro: TypeScript avançado, genéricos, inferência de tipos, padrões corporativos
java-pro: Desenvolvimento moderno em Java, streams, concorrência, Spring Boot
elixir-pro: Desenvolvimento em Elixir, padrões OTP, frameworks Phoenix, programação funcional
csharp-pro: Desenvolvimento moderno em C#, frameworks .NET, padrões corporativos
scala-pro: Scala empresarial com programação funcional, atores Apache Pekko/Akka, Apache Spark, ZIO/Cats Effect, arquiteturas reativas
flutter-expert: Desenvolvimento Flutter, Dart, gerenciamento de estado, animações, implantação multiplataforma
unity-developer: Desenvolvimento de jogos Unity, scripts em C#, otimização de desempenho
minecraft-bukkit-pro: Desenvolvimento de plugins Minecraft, sistemas de eventos, recursos no servidor
ios-developer: Desenvolvimento nativo iOS com Swift/SwiftUI
sql-pro: Consultas a banco de dados, design de esquemas, otimização de consultas
mobile-developer: Desenvolvimento em React Native/Flutter

🛠️ Operações & Manutenção

devops-troubleshooter: Problemas em produção, dificuldades de implantação
incident-responder: Interrupções críticas que exigem resposta imediata
database-optimizer: Desempenho de consultas, estratégias de indexação
database-admin: Estratégias de backup, replicação, gestão de usuários, recuperação de desastres
terraform-specialist: Infraestrutura como Código, módulos Terraform, gerenciamento de estado
network-engineer: Conectividade de rede, balanceadores de carga, SSL/TLS, depuração de DNS

📊 Análise & Otimização

performance-engineer: Gargalos de aplicação, otimização
security-auditor: Varredura de vulnerabilidades, verificações de conformidade
data-scientist: Análise de dados, insights, relatórios
mlops-engineer: Infraestrutura de ML, rastreamento de experimentos, registro de modelos, automação de pipelines

🧪 Garantia de Qualidade

code-reviewer: Qualidade do código, segurança de configuração, confiabilidade em produção
test-automator: Estratégia de testes, criação de suíte de testes
debugger: Investigação de bugs, resolução de erros
error-detective: Análise de logs, reconhecimento de padrões de erro, análise de causa raiz
search-specialist: Pesquisa profunda na web, análise competitiva, verificação de fatos

📚 Documentação

api-documenter: Especificações OpenAPI/Swagger, documentação de API
docs-architect: Documentação técnica abrangente, guias de arquitetura, manuais de sistema
reference-builder: Referências exaustivas de API, guias de configuração, documentação de parâmetros
tutorial-engineer: Tutoriais passo a passo, trilhas de aprendizado, conteúdo educacional

💼 Negócios & Estratégia

business-analyst: KPIs, modelos de receita, projeções de crescimento, métricas para investidores
risk-manager: Risco de portfólio, estratégias de hedge, múltiplos R, dimensionamento de posições
content-marketer: Conteúdo SEO, posts em blog, redes sociais, campanhas de e-mail
sales-automator: E-mails frios, follow-ups, propostas, nutrição de leads
customer-support: Chamados de suporte, FAQs, documentação de ajuda, solução de problemas
legal-advisor - Redação de políticas de privacidade, termos de serviço, avisos legais e disclaimers

Melhores Práticas

🎯 Delegação de Tarefas

Deixe Claude Code delegar automaticamente - O agente principal analisa o contexto e seleciona agentes ideais
Seja específico sobre os requisitos - Inclua restrições, stack tecnológico e critérios de qualidade
Confie na especialização dos agentes - Cada agente é otimizado para seu domínio

🔄 Fluxos de Trabalho Multi-Agentes

Comece com solicitações de alto nível - Deixe os agentes coordenarem tarefas complexas de múltiplas etapas
Forneça contexto entre os agentes - Garanta que os agentes tenham as informações de fundo necessárias
Revise pontos de integração - Verifique como as saídas dos diferentes agentes funcionam juntas

🎛️ Controle Explícito

Use invocação explícita para necessidades específicas - Quando você quiser a perspectiva de um especialista em particular
Combine múltiplos agentes estrategicamente - Diferentes especialistas podem validar o trabalho uns dos outros
Solicite padrões de revisão específicos - "Peça para o security-auditor revisar o design da API do backend-architect"

📈 Otimização

Monitore a eficácia dos agentes - Descubra quais agentes funcionam melhor para seus casos de uso
Itere em tarefas complexas - Use o feedback dos agentes para refinar os requisitos
Aproveite os pontos fortes dos agentes - Combine a complexidade da tarefa com as capacidades do agente

Contribuindo

Para adicionar um novo subagente:

Crie um novo arquivo .md seguindo o formato acima
Use nomes em minúsculo separados por hífen
Escreva descrições claras de quando o subagente deve ser utilizado
Inclua instruções específicas no prompt do sistema

Solução de Problemas

Problemas Comuns

Agente não sendo invocado automaticamente:

Certifique-se de que sua solicitação indica claramente o domínio (ex: "problema de desempenho" → performance-engineer)
Seja específico sobre o tipo de tarefa (ex: "revisar código" → code-reviewer)

Seleção inesperada de agente:

Forneça mais contexto sobre sua stack tecnológica e requisitos
Use invocação explícita se precisar de um agente específico

Vários agentes produzindo conselhos conflitantes:

Isso é normal - diferentes especialistas podem ter prioridades diferentes
Peça esclarecimento: "Reconciliar as recomendações do security-auditor e do performance-engineer"

Agente parece não ter contexto:

Forneça informações de fundo em sua solicitação
Faça referência a conversas anteriores ou padrões estabelecidos

Obtendo Ajuda

Se os agentes não estiverem funcionando como esperado:

Verifique as descrições dos agentes em seus arquivos individuais
Tente usar linguagem mais específica em suas solicitações
Use invocação explícita para testar agentes específicos
Forneça mais contexto sobre seu projeto e objetivos

Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para mais detalhes.

Saiba Mais

--- Tranlated By Open Ai Tx | Last indexed: 2025-09-04 ---