Codex Subagents

Source: https://github.com/VoltAgent/awesome-codex-subagents at 16f880a2a048
License: MIT
Read the English original

This edition is an AI-assisted translation.

A coleção excepcional de mais de 175 subagentes Codex em 13 categorias.

Excelentes Codex Subagents

Este repositório é a coleção definitiva de Codex Subagents, assistentes de IA especializados projetados para tarefas específicas de desenvolvimento. Escrito especificamente para o Codex e alinhado com a documentação oficial.

Instalação

Use os diretórios de agentes personalizados do Codex exatamente como documentado:

• ~/.codex/agents/ para agentes globais (disponíveis em todos os projetos)
• .codex/agents/ para agentes específicos do projeto (maior precedência naquele repositório)

1. Clone este repositório.
2. Copie os arquivos de agente .toml desejados para um dos diretórios acima.
3. Reinicie ou atualize sua sessão do Codex se necessário.
4. Delege explicitamente nos prompts (o Codex não gera subagentes personalizados automaticamente).

Exemplos:

mkdir -p ~/.codex/agents
cp categories/01-core-development/backend-developer.toml ~/.codex/agents/

mkdir -p .codex/agents
cp categories/04-quality-security/reviewer.toml .codex/agents/

Se você usa configuração de agentes no Codex, mantenha-a em .codex/config.toml sob [agents] conforme descrito na documentação oficial.

Patrocinadores

	Crawlbase é a infraestrutura de dados web na qual confiam mais de 70.000 desenvolvedores. Sua API de Crawling, servidor MCP e integrações dão aos agentes de IA acesso ao vivo a qualquer página web — com renderização JavaScript, rotação de proxies e proteção anti-bot.
	SerpApi é uma API de busca web para suas apps de IA. Disponível em Markdown e JSON para qualquer integração.

👉 Você pode expor seu produto aqui e alcançar desenvolvedores que usam agentes de codificação de IA como Claude Code, Codex, Gemini e mais.

Locais de armazenamento de subagentes

Type	Path	Availability	Precedence
Project Subagents	.codex/agents/	Current project only	Higher
Global Subagents	~/.codex/agents/	All projects	Lower

Observação: Quando ocorrem conflitos de nomes, os subagentes específicos do projeto substituem os globais.

Estrutura dos subagentes

Cada subagente usa um formato .toml nativo do Codex:

name = "subagent-name"
description = "When this agent should be invoked"
model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
sandbox_mode = "read-only"

[instructions]
text = """
You are a [role description and expertise areas]...

[Agent-specific checklists, patterns, and guidelines]...
"""

Roteamento inteligente de modelos

Cada subagente inclui um campo model que o encaminha automaticamente para o modelo certo — equilibrando qualidade e custo:

Model	When It’s Used	Examples
gpt-5.6-sol	Raciocínio profundo — revisões de arquitetura, auditorias de segurança, lógica financeira	security-auditor, architect-reviewer, fintech-engineer
gpt-5.6-terra	Implementação, diagnóstico, avaliação e análise profissional multi-etapas	docker-expert, test-automator, scientific-literature-researcher
gpt-5.6-luna	Busca limitada, extração, roteamento, redação e síntese leve	search-specialist, docs-researcher, agent-installer

Filosofia do modo sandbox

O campo sandbox_mode de cada subagente controla o acesso ao sistema de arquivos:

• Agentes somente leitura (revisores, auditores): sandbox_mode = "read-only" — analisam sem modificar
• Agentes de escrita no workspace (desenvolvedores, engenheiros): sandbox_mode = "workspace-write" — criam e modificam arquivos

Categorias

01. Core Development

Subagentes de desenvolvimento essenciais para tarefas de codificação do dia a dia.

• api-designer - Arquiteto de API REST e GraphQL
• backend-developer - Especialista no lado do servidor para APIs escaláveis
• code-mapper - Mapeamento de caminhos de código e análise de limites de propriedade
• design-bridge - Traduz especificações DESIGN.md em instruções de UI prontas para implementação
• electron-pro - Especialista em aplicações de desktop
• frontend-developer - Especialista em UI/UX para React, Vue e Angular
• fullstack-developer - Desenvolvimento de recursos de ponta a ponta
• graphql-architect - Especialista em esquema GraphQL e federação
• microservices-architect - Projetista de sistemas distribuídos
• mobile-developer - Especialista móvel multiplataforma
• ui-designer - Especialista em design visual e interação
• ui-fixer - Pequeno patch seguro para problemas de UI reproduzidos
• websocket-engineer - Especialista em comunicação em tempo real

02. Language Specialists

Especialistas específicos de linguagem com conhecimento profundo de frameworks.

• angular-architect - Especialista em padrões empresariais Angular 15+
• cpp-pro - Especialista em desempenho C++
• csharp-developer - Especialista no ecossistema .NET
• django-developer - Especialista em desenvolvimento web Django 4+
• dotnet-core-expert - Especialista multiplataforma .NET 8
• dotnet-framework-4.8-expert - Especialista em empresa legada .NET Framework
• elixir-expert - Especialista em sistemas tolerantes a falhas Elixir e OTP
• erlang-expert - Especialista em engenharia Erlang/OTP e rebar3
• expo-react-native-expert - Especialista em desenvolvimento móvel Expo e React Native
• fastapi-developer - Especialista em framework moderno de API Python assíncrona
• flutter-expert - Especialista móvel multiplataforma Flutter 3+
• golang-pro - Especialista em concorrência Go
• java-architect - Especialista em Java empresarial
• javascript-pro - Especialista em desenvolvimento JavaScript
• kotlin-specialist - Especialista em linguagem JVM moderna
• laravel-specialist - Especialista em framework PHP Laravel 10+
• symfony-specialist - Especialista em aplicações Symfony e Doctrine
• nextjs-developer - Especialista full-stack Next.js 14+
• node-specialist - Especialista em backend Node.js
• php-pro - Especialista em desenvolvimento web PHP
• powershell-5.1-expert - Especialista em automação Windows PowerShell 5.1 e .NET Framework completo
• powershell-7-expert - Especialista em automação multiplataforma PowerShell 7+ e .NET moderno
• python-pro - Mestre no ecossistema Python
• rails-expert - Especialista em desenvolvimento rápido Rails 8.1
• react-specialist - Especialista em padrões modernos React 18+
• rust-engineer - Especialista em programação de sistemas
• spring-boot-engineer - Especialista em microserviços Spring Boot 3+
• sql-pro - Especialista em consultas de banco de dados
• swift-expert - Especialista em iOS e macOS
• typescript-pro - Especialista em TypeScript
• vue-expert - Especialista em API Composition do Vue 3

03. Infrastructure

Especialistas em DevOps, nuvem e implantação.

• azure-infra-engineer - Especialista em infraestrutura Azure e automação Az PowerShell
• cloud-architect - Especialista em AWS/GCP/Azure
• database-administrator - Especialista em gerenciamento de banco de dados
• deployment-engineer - Especialista em automação de implantação
• devops-engineer - Especialista em CI/CD e automação
• devops-incident-responder - Gerenciamento de incidentes DevOps
• docker-expert - Especialista em containerização e otimização Docker
• incident-responder - Especialista em resposta a incidentes de sistemas
• kubernetes-specialist - Mestre em orquestração de contêineres
• network-engineer - Especialista em infraestrutura de rede
• platform-engineer - Especialista em arquitetura de plataforma
• security-engineer - Especialista em segurança de infraestrutura
• sre-engineer - Especialista em engenharia de confiabilidade de sites
• terraform-engineer - Especialista em infraestrutura como código
• terragrunt-expert - Especialista em orquestração Terragrunt e IaC DRY
• windows-infra-admin - Especialista em automação Active Directory, DNS, DHCP e GPO

04. Quality & Security — Especialistas em teste, segurança e qualidade de código (20 agentes)

04. Quality & Security

• accessibility-tester - Especialista em conformidade A11y
• ad-security-reviewer - Especialista em segurança Active Directory e auditoria GPO
• anti-ui-slop-reviewer - Revisor de gate de acabamento de UI específico do produto
• ai-writing-auditor - Auditor e reescritor de padrões de escrita de IA
• architect-reviewer - Especialista em revisão de arquitetura
• browser-debugger - Reprodução baseada em navegador e depuração do lado do cliente
• chaos-engineer - Especialista em testes de resiliência de sistemas
• code-reviewer - Guardião da qualidade do código
• compliance-auditor - Especialista em conformidade regulatória
• debugger - Especialista em depuração avançada
• error-detective - Especialista em análise e resolução de erros
• gdpr-ccpa-compliance - Especialista em privacidade GDPR e CCPA
• penetration-tester - Especialista em hacking ético
• performance-engineer - Especialista em otimização de desempenho
• powershell-security-hardening - Especialista em endurecimento e conformidade de segurança PowerShell
• qa-expert - Especialista em automação de testes
• reviewer - Revisão estilo PR para correção, segurança e regressões
• security-auditor - Especialista em vulnerabilidades de segurança
• test-automator - Especialista em frameworks de automação de testes
• ui-ux-tester - Especialista em testes funcionais exaustivos de UI/UX

05. Data & AI — Especialistas em engenharia de dados, ML e IA (14 agentes)

05. Data & AI

• ai-engineer - Especialista em design e implantação de sistemas de IA
• azure-databricks-platform-architect - Arquiteto de plataforma e lakehouse Azure Databricks
• data-analyst - Especialista em insights e visualização de dados
• data-engineer - Arquiteto de pipeline de dados
• data-scientist - Especialista em análise e insights
• database-optimizer - Especialista em desempenho de banco de dados
• llm-architect - Arquiteto de grandes modelos de linguagem
• machine-learning-engineer - Especialista em sistemas de aprendizado de máquina
• ml-engineer - Especialista em aprendizado de máquina
• mlops-engineer - Especialista em MLOps e implantação de modelos
• nlp-engineer - Especialista em processamento de linguagem natural
• postgres-pro - Especialista em banco de dados PostgreSQL
• prompt-engineer - Especialista em otimização de prompts
• reinforcement-learning-engineer - Especialista em aprendizado por reforço e sistemas de decisão

06. Developer Experience — Especialistas em ferramentas e produtividade de desenvolvedores (14 agentes)

06. Developer Experience

• build-engineer - Especialista em sistemas de build
• cli-developer - Criador de ferramentas de linha de comando
• dependency-manager - Especialista em pacotes e dependências
• documentation-engineer - Especialista em documentação técnica
• dx-optimizer - Especialista em otimização da experiência do desenvolvedor
• git-workflow-manager - Especialista em fluxo de trabalho e branches Git
• legacy-modernizer - Especialista em modernização de código legado
• mcp-developer - Especialista em Model Context Protocol
• powershell-module-architect - Especialista em arquitetura de módulos e perfis PowerShell
• powershell-ui-architect - Especialista PowerShell UI/UX para WinForms, WPF, frameworks Metro e TUIs
• readme-generator - Gerador de README pronto para mantenedores, sem alucinação
• refactoring-specialist - Especialista em refatoração de código
• slack-expert - Especialista em plataforma Slack e @slack/bolt
• tooling-engineer - Especialista em ferramentas de desenvolvedor

07. Specialized Domains — Especialistas em tecnologias de domínio específico (14 agentes)

07. Specialized Domains

• api-documenter - Especialista em documentação de API
• blockchain-developer - Especialista em Web3 e cripto
• embedded-systems - Especialista em sistemas embarcados e de tempo real
• fintech-engineer - Especialista em tecnologia financeira
• game-developer - Especialista em desenvolvimento de jogos
• healthcare-admin - Especialista em administração de saúde, ciclo de receita e conformidade
• hipaa-compliance - Especialista em conformidade HIPAA para fornecedores SaaS de saúde
• iot-engineer - Desenvolvedor de sistemas IoT
• m365-admin - Especialista em administração Microsoft 365, Exchange Online, Teams e SharePoint
• mobile-app-developer - Especialista em aplicações móveis
• payment-integration - Especialista em sistemas de pagamento
• quant-analyst - Especialista em análise quantitativa
• risk-manager - Especialista em avaliação e gestão de riscos
• seo-specialist - Especialista em otimização para mecanismos de busca

08. Business & Product — Gestão de produto e análise de negócios (17 agentes)

08. Business & Product

• assumption-mapping - Especialista em risco e validação de hipóteses de produto
• backlog-grooming - Especialista em refino de backlog ágil
• business-analyst - Especialista em requisitos
• content-marketer - Especialista em marketing de conteúdo
• content-quality-editor - Especialista em qualidade e humanização de conteúdo de IA
• customer-success-manager - Especialista em sucesso do cliente
• growth-loops - Especialista em loops de crescimento e mecânicas PLG
• legal-advisor - Especialista em jurídico e conformidade
• license-engineer - Especialista em licenciamento de software e sistemas de conformidade
• product-manager - Especialista em estratégia de produto
• project-manager - Especialista em gerenciamento de projetos
• resume-refiner - Especialista em otimização de currículo, CV e perfil LinkedIn
• sales-engineer - Especialista em vendas técnicas
• scrum-master - Especialista em metodologia ágil
• technical-writer - Especialista em documentação técnica
• ux-researcher - Especialista em pesquisa de usuários
• wordpress-master - Especialista em desenvolvimento e otimização WordPress

09. Meta & Orchestration — Coordenação de agentes e metaprogramação (12 agentes)

09. Meta & Orchestration

• agent-installer - Navega e instala agentes deste repositório via GitHub
• agent-organizer - Coordenador multi-agente
• codebase-orchestrator - Governança de refatoração em todo o repositório com portões de aprovação
• context-manager - Especialista em otimização de contexto
• error-coordinator - Especialista em tratamento e recuperação de erros
• it-ops-orchestrator - Especialista em orquestração de fluxos de trabalho de operações de TI
• knowledge-synthesizer - Especialista em agregação de conhecimento
• multi-agent-coordinator - Orquestração avançada multi-agente
• performance-monitor - Otimização de desempenho de agentes
• pied-piper - Orquestra um time de subagentes de IA para fluxos de trabalho SDLC repetitivos
• task-distributor - Especialista em alocação de tarefas
• workflow-orchestrator - Automação de fluxos de trabalho complexos

10. Research & Analysis — Especialistas em pesquisa, busca e análise (12 agentes)

10. Research & Analysis

• ab-test-analysis - Interpretação de testes A/B e decisões ship/no-ship
• cohort-analysis - Análise de retenção, comportamento de coortes e métricas de ativação
• competitive-analyst - Especialista em inteligência competitiva
• data-researcher - Especialista em descoberta e análise de dados
• docs-researcher - Verificação de API e frameworks apoiada por documentação
• first-principles-thinking - Resolução de problemas questionando hipóteses, com pensamento de primeiros princípios
• market-researcher - Análise de mercado e insights de consumidores
• project-idea-validator - Testador de pressão brutal de ideias e estrategista go/no-go
• research-analyst - Especialista em pesquisa abrangente
• scientific-literature-researcher - Pesquisa baseada em evidências de estudos científicos publicados
• search-specialist - Especialista em recuperação avançada de informação
• trend-analyst - Especialista em tendências emergentes e previsão

11. AI Governance & Safety - Especialistas em governança, guardrails e IA confiável (4 agentes)

11. AI Governance & Safety

• ai-governance-auditor - Auditor de controles de governança de IA e prontidão de implantação
• model-risk-manager - Especialista em priorização e mitigação de modos de falha de modelos
• policy-guardrail-designer - Designer de guardrails para prompts, ferramentas e fluxos de trabalho
• responsible-ai-reviewer - Revisor de justiça, uso indevido, transparência e supervisão

12. Platform Engineering & IDP - Especialistas em plataforma de desenvolvedor interna e golden paths (4 agentes)

12. Platform Engineering & IDP

• backstage-specialist - Especialista em catálogo, templates e portal Backstage
• golden-path-designer - Designer de fluxos de trabalho self-service opinativos
• idp-architect - Especialista em arquitetura de plataforma de desenvolvedor interna
• platform-product-manager - Especialista em roteiro, adoção e métricas de sucesso de plataforma

13. LLMOps, Evals & Observability - Especialistas em qualidade de IA em produção e visibilidade de runtime (4 agentes)

13. LLMOps, Evals & Observability

• ai-observability-engineer - Especialista em traces, métricas e logging nativos de IA
• eval-engineer - Especialista em avaliação de prompts, ferramentas e fluxos de trabalho
• hallucination-investigator - Investigador de causalidade de falta de facticidade e colapso de contexto
• prompt-regression-tester - Designer de suíte de regressão para mudanças de comportamento de IA

Entendendo os subagentes

Os subagentes são assistentes de IA especializados que aprimoram as capacidades do Codex ao fornecer expertise específica por tarefa. Eles atuam como ajudantes dedicados que o Codex pode invocar ao encontrar determinados tipos de trabalho.

O que torna os subagentes especiais?

Janelas de contexto independentes Cada subagente opera em seu próprio espaço de contexto isolado, evitando contaminação cruzada entre tarefas diferentes e mantendo a clareza no thread de conversa principal.

Inteligência específica de domínio Os subagentes vêm equipados com instruções cuidadosamente elaboradas para sua área de expertise, resultando em desempenho superior em tarefas especializadas.

Compartilhados entre projetos Após criar um subagente, você pode utilizá-lo em vários projetos e distribuí-lo entre membros da equipe para garantir práticas de desenvolvimento consistentes.

Delegação explícita O Codex não gera subagentes automaticamente. Use prompts de delegação explícita para especificar quais agentes iniciar, como dividir o trabalho e qual forma o resultado deve ter.

Vantagens principais

• Eficiência de memória: contextos isolados evitam que a conversa principal fique sobrecarregada com detalhes específicos da tarefa
• Precisão aprimorada: prompts e configurações especializados levam a melhores resultados em domínios específicos
• Consistência de fluxo de trabalho: o compartilhamento de subagentes em toda a equipe garante abordagens uniformes para tarefas comuns
• Codex nativo: usa arquivos de agente .toml alinhados com a documentação oficial de subagentes do Codex

Fluxos de trabalho de exemplo

Fluxo de revisão de PR:

Review this branch with parallel subagents. Have reviewer look for correctness, security, and missing tests. Have docs_researcher verify the framework APIs this patch depends on. Wait for both and summarize the findings with file references.

Fluxo de investigação de bug:

Investigate the broken settings flow. Have code_mapper trace the owning code paths, browser_debugger reproduce the bug in the browser, and frontend_developer propose the smallest fix after the failure is understood. Wait for the read-heavy agents first, then continue.

Fluxo de exploração e planejamento do repositório:

Use search_specialist to locate the code related to payment retries, knowledge_synthesizer to summarize the current design, and refactoring_specialist to propose a minimal refactor plan. Return a concrete action list.

Ferramentas do ecossistema AI Design + Build

Você entrega produtos com IA, mas todo lançamento morre em silêncio porque ninguém fala sobre ele. EveryFeed conecta seu assistente de IA a um espaço de trabalho social que redige, agenda e publica em mais de 35 canais — sem agência, sem contratação de marketing.

Contribuindo

Contribuições são bem-vindas! Veja CONTRIBUTING.md para as diretrizes.

• Envie novos subagentes via PR
• Melhore as definições existentes
• Relate problemas e bugs

Licença

MIT License - veja LICENSE

Este repositório é uma coleção organizada de definições de subagentes contribuídas tanto pelos mantenedores quanto pela comunidade. Todos os subagentes são fornecidos “no estado em que se encontram”, sem garantia. Não auditamos nem garantimos a segurança ou correção de qualquer subagente. Revise antes de usar; os mantenedores não aceitam responsabilidade por quaisquer problemas decorrentes de seu uso.

Se você encontrar um problema com um subagente listado ou quiser sua contribuição removida, abra uma issue neste repositório e a trataremos rapidamente.