● Comunidade
VoltAgent
⚡ Instantâneo
Awesome Claude Code Subagents
por VoltAgent · VoltAgent/awesome-claude-code-subagents
Mais de 100 subagentes especializados do Claude Code cobrindo frontend, backend, infra, segurança, performance, dados — chame o especialista, não o generalista.
awesome-claude-code-subagents da VoltAgent é uma biblioteca de configs opinadas de subagentes — cada um é um especialista de domínio com seu próprio system prompt, allowlist de ferramentas e checklist de revisão. Você delega a um 'revisor de segurança' ou 'auditor de performance' como subagente, obtém output focado e então o agente principal integra.
Por que usar
Principais recursos
- Mais de 100 subagentes nos principais domínios de desenvolvimento
- Cada um tem ferramentas com escopo + system prompt
- Projetado para ser chamado a partir de uma sessão pai do Claude Code
- Cobertura: revisão de segurança, performance, revisão de codegen, custo de infra, etc.
- Mantido, em crescimento, contribuições da comunidade
Demo ao vivo
Como fica na prática
pronto
Casos de uso
Usos do mundo real: Awesome Claude Code Subagents
Quando usar: Seu agente principal escreveu código de autenticação; você quer um segundo par de olhos de um subagente focado.
Fluxo
-
Inicializar
Use awesome-subagents. Inicialize o subagente 'security-reviewer' em src/auth.✓ Copiado
→ Subagente reporta descobertas
-
Triar
Agrupe as descobertas por severidade. Identifique quais o agente principal deve corrigir agora vs registrar como issues.✓ Copiado
→ Lista triada
Resultado: Feedback de segurança em cada PR sem pagar o salário de um revisor real.
Armadilhas
- Subagente encontra coisas com que o agente principal discorda — É sua decisão — geralmente o output focado em segurança está certo; padrão para cautela
Quando usar: Um endpoint está lento e você quer uma revisão de performance focada.
Fluxo
-
Definir escopo
Inicialize o subagente 'perf-auditor' no endpoint /orders. Inclua o schema do banco de dados.✓ Copiado
→ Descobertas: N+1, índices faltando, loops quentes
-
Aplicar
Aplique os 3 principais fixes; faça benchmark antes/depois.✓ Copiado
→ Queda de latência com números
Resultado: Ganhos reais de performance, não impressões.
Armadilhas
- Subagente sugere micro-otimizações — Peça uma classificação por impacto; ignore o ruído
Quando usar: Você tem uma tarefa específica e não sabe qual subagente usar.
Fluxo
-
Pesquisar
Liste subagentes que são bons para 'otimização de queries no Postgres'.✓ Copiado
→ 2-3 candidatos com escopo
-
Experimentar
Use o top candidato em /reports/slow_queries.sql.✓ Copiado
→ Análise direcionada
Resultado: Ferramenta certa para o trabalho; menos raciocínio genérico do agente.
Armadilhas
- Definições de subagentes se sobrepõem — Escolha o com escopo mais restrito
Combinações
Combine com outros MCPs para 10× de alavancagem
Inicializar subagentes e acompanhar o progresso ao vivo
Inicialize 3 revisores; acompanhe via HUD.✓ Copiado
Subagentes coordenam via mail para evitar trabalho duplicado
Subagentes publicam reivindicações na thread #review antes de começar.✓ Copiado
Custo e limites
O que custa rodar
- Cota de API
- N/A
- Tokens por chamada
- Cada execução de subagente é seu próprio contexto — os custos se acumulam; orce conscientemente
- Monetário
- Gratuito
- Dica
- Use subagentes apenas quando a tarefa for verdadeiramente especialista; não delegue demais
Segurança
Permissões, segredos, alcance
Escopos mínimos: Por subagente — alguns precisam de shell, outros não
Armazenamento de credenciais: Nenhum inerente
Saída de dados: Depende das ferramentas do subagente
Nunca conceda: Acesso amplo a ferramentas para subagentes que não precisam
- Leia a allowlist de cada subagente antes de conceder
Solução de problemas
Erros comuns e correções
Subagente executa indefinidamente
Defina timeouts; alguns são excessivamente ansiosos
Subagente ignorou o escopo
Seja mais explícito na tarefa de inicialização; defina escopo de caminho estrito
Alternativas
Awesome Claude Code Subagents vs. outros
| Alternativa | Quando usar | Troca |
|---|
| Agente único multi-ferramenta | As tarefas são de propósito geral | Output menos focado |
| wshobson/agents | Você quer um conjunto curado diferente | Sobreposição; escolha a filosofia que prefere |