> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolutionfoundation.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Visão Geral dos Agentes > 38 agentes especializados em duas camadas — negócio e engenharia # Visão Geral dos Agentes Agentes são o núcleo do EvoNexus. Cada agente é uma persona de IA especializada com seu próprio domínio, system prompt, skills e memória persistente. O EvoNexus organiza os agentes em **duas camadas ortogonais**: * **Business Layer (17 agentes)** — operações, finanças, comunidade, marketing, RH, jurídico, produto, dados, vendas, retenção de aprendizado. Construída e mantida pelo EvoNexus. * **Engineering Layer (21 agentes)** — desenvolvimento de software, code review, testes, debugging, segurança, design, orquestração de ciclo, retrospectiva. 19 derivados do [oh-my-claudecode](https://github.com/yeachan-heo/oh-my-claudecode) (MIT, por Yeachan Heo) + 2 nativos (Helm, Mirror). Segue um workflow canônico de 6 fases. Veja [Engineering Layer](engineering-layer) para detalhes. As duas camadas são independentes — tarefas de negócio vão para agentes de negócio, tarefas de engenharia para agentes de engenharia — mas handoffs entre camadas são comuns (ex.: `@nova` escreve um PRD → `@apex-architect` faz o review de arquitetura → `@bolt-executor` implementa → `@mirror-retro` captura lições). **Total: 38 agentes** + agentes customizados que você criar. ## O que é um Agente? Um agente é um arquivo markdown em `.claude/agents/` que contém: * **Frontmatter** com metadados (name, description, model, color, memory scope) * **System prompt** que define a identidade, responsabilidades, tom e comportamento do agente Quando invocado, o Claude Code carrega o system prompt do agente e opera dentro dessa persona durante a tarefa. ## Como Invocar um Agente ### Slash commands Cada agente tem um comando correspondente em `.claude/commands/`: **Business Layer (17):** ``` /clawdia-assistant — Hub de ops: agenda, e-mails, tarefas, decisões /flux-finance — Finanças: Stripe, ERP, fluxo de caixa, relatórios /atlas-project — Projetos: Linear, GitHub, sprints, milestones /pulse-community — Comunidade: Discord, WhatsApp, sentimento, FAQ /pixel-social-media — Redes sociais: conteúdo, calendário, analytics /sage-strategy — Estratégia: OKRs, roadmap, análise competitiva /nex-sales — Vendas: pipeline, propostas, qualificação /mentor-courses — Cursos: trilhas de aprendizado, módulos /lumen-learning — Retenção de aprendizado: repetição espaçada, captura de fatos, quizzes /kai-personal-assistant — Pessoal: saúde, hábitos, rotina /oracle — Conhecimento do workspace: docs, how-to, configuração /mako-marketing — Marketing: campanhas, SEO, e-mail, marca /aria-hr — RH / Pessoas: recrutamento, onboarding, desempenho /zara-cs — Customer Success: triagem, escalação, KB /lex-legal — Jurídico / Compliance: contratos, NDA, LGPD /nova-product — Produto: specs, roadmaps, métricas, pesquisa /dex-data — Dados / BI: análise, SQL, dashboards ``` **Engineering Layer (19):** ``` /apex-architect — Architect: design, debugging, tradeoffs (READ-ONLY) /echo-analyst — Analyst: discovery, gap analysis (READ-ONLY) /compass-planner — Planner: planos de 3-6 passos guiados por entrevista /raven-critic — Critic: revisão adversarial multi-perspectiva (READ-ONLY) /bolt-executor — Executor: implementação no menor diff viável /hawk-debugger — Debugger: causa-raiz, erros de build /lens-reviewer — Code reviewer: 2 estágios, OWASP, SOLID (READ-ONLY) /zen-simplifier — Simplificador de código: refactor sem mudar comportamento /vault-security — Security: OWASP Top 10, secrets, deps (READ-ONLY) /grid-tester — Test engineer: TDD, pirâmide, diagnóstico de flakiness /probe-qa — QA tester: sessões interativas em tmux /oath-verifier — Verifier: completude baseada em evidência (READ-ONLY) /trail-tracer — Tracer: investigação causal com hipóteses /scout-explorer — Explorer: busca paralela no codebase (READ-ONLY) /flow-git — Git master: commits atômicos, rebase seguro /scroll-docs — Document specialist: docs externas de SDK/API (READ-ONLY) /quill-writer — Writer: docs técnicos com exemplos verificados /canvas-designer — Designer: UI/UX em qualidade de produção /prism-scientist — Scientist: análise estatística formal ``` Uso no Claude Code: ``` /clawdia-assistant ver meus e-mails /flux-finance qual é a saúde financeira da empresa? /apex-architect por que o bot runtime está travando no reconnect? /dev-autopilot construa uma API CRUD para inventário de livraria ``` ### Roteamento automático Você não precisa escolher o agente certo manualmente. Apenas descreva o que precisa e o Claude roteia ao agente correto com base no campo `description` do frontmatter de cada agente. Exemplos: | Você diz | Agente ativado | | - | - | | "bom dia" | Clawdia | | "fechamento mensal" | Flux | | "ver PRs do github" | Atlas | | "sentimento da comunidade" | Pulse | | "escrever um post no LinkedIn" | Pixel | | "devemos priorizar X ou Y?" | Sage | | "preparar uma proposta para o cliente Z" | Nex | | "criar um módulo de curso" | Mentor | | "como está minha saúde?" | Kai | A lógica de roteamento usa interações de exemplo no campo `description` de cada agente para casar com a intenção do usuário. ## Memória dos Agentes Todo agente tem memória persistente baseada em arquivos em: ``` .claude/agent-memory// ``` Memória organizada por tipo: | Tipo | Propósito | | - | - | | `user` | Quem é o usuário, papel, preferências | | `feedback` | Correções e abordagens confirmadas | | `project` | Trabalho em andamento, prazos, decisões | | `reference` | Ponteiros para sistemas externos | Cada arquivo de memória usa frontmatter (`name`, `description`, `type`) e um arquivo `MEMORY.md` indexa todas as entradas. Os agentes leem a memória no início de cada sessão e a atualizam conforme aprendem. ## Agentes Customizados Você pode criar seus próprios agentes com o prefixo `custom-`. Agentes customizados são gitignored (pessoais ao seu workspace) e aparecem no dashboard com um badge "custom" cinza. Para criar um agente custom, use a skill `create-agent` ou veja [Criando Agentes](creating-agents). ``` .claude/agents/custom-devops.md # Prompt do agente .claude/commands/custom-devops.md # Slash command .claude/agent-memory/custom-devops/ # Memória persistente ``` ## Business Layer — 17 Agentes Core | Agente | Comando | Domínio | Cor | | - | - | - | - | | [**Clawdia**](clawdia) | `/clawdia-assistant` | Ops: agenda, e-mails, tarefas, reuniões, decisões | cyan | | [**Flux**](flux) | `/flux-finance` | Finanças: Stripe, Omie, fluxo de caixa, fechamento mensal | orange | | [**Atlas**](atlas) | `/atlas-project` | Projetos: Linear, GitHub, sprints, licenciamento | green | | [**Pulse**](pulse) | `/pulse-community` | Comunidade: Discord, WhatsApp, sentimento, FAQ | blue | | [**Pixel**](pixel) | `/pixel-social-media` | Social: conteúdo, calendário, analytics multiplataforma | yellow | | [**Sage**](sage) | `/sage-strategy` | Estratégia: OKRs, roadmap, análise competitiva | orange | | [**Nex**](nex) | `/nex-sales` | Vendas: pipeline, propostas, qualificação | red | | [**Mentor**](mentor) | `/mentor-courses` | Cursos: trilhas, módulos, academy | purple | | **Lumen** | `/lumen-learning` | Retenção de aprendizado: repetição espaçada (SM-2), captura de fatos, quizzes | yellow | | [**Kai**](kai) | `/kai-personal-assistant` | Pessoal: saúde, hábitos, rotina (isolado) | blue | | [**Oracle**](oracle) | `/oracle` | Conhecimento do workspace: docs, how-to, configuração | amber | | [**Mako**](mako) | `/mako-marketing` | Marketing: campanhas, SEO, sequências de e-mail, marca | orange | | [**Aria**](aria) | `/aria-hr` | RH / Pessoas: recrutamento, onboarding, desempenho | pink | | [**Zara**](zara) | `/zara-cs` | Customer Success: triagem, escalação, health scores | cyan | | [**Lex**](lex) | `/lex-legal` | Jurídico / Compliance: contratos, NDA, LGPD, risco | purple | | [**Nova**](nova) | `/nova-product` | Produto: specs, roadmaps, métricas, pesquisa | blue | | [**Dex**](dex) | `/dex-data` | Dados / BI: análise, SQL, dashboards, visualizações | yellow | ## Engineering Layer — 19 Agentes Especialistas em desenvolvimento de software. Cada agente tem um papel específico no workflow de dev: design, planejamento, implementação, review, testes, debugging, verificação. ### Reasoning (opus) | Agente | Comando | Papel | | - | - | - | | **Apex** | `/apex-architect` | Architect — design arquitetural, debugging read-only, tradeoffs | | **Echo** | `/echo-analyst` | Analyst — discovery, gaps de requisitos, premissas escondidas | | **Compass** | `/compass-planner` | Planner — planejamento tático de 3-6 passos com entrevista | | **Raven** | `/raven-critic` | Critic — desafia planos antes da execução, multi-perspectiva | | **Lens** | `/lens-reviewer` | Code Reviewer — review em 2 estágios (spec + qualidade), OWASP, SOLID | | **Zen** | `/zen-simplifier` | Simplificador de código — deslop, refactoring, clareza | | **Vault** | `/vault-security` | Security Reviewer — OWASP Top 10, secrets, auditoria de dependências | ### Execution (sonnet) | Agente | Comando | Papel | | - | - | - | | **Bolt** | `/bolt-executor` | Executor — implementação precisa em múltiplos arquivos | | **Hawk** | `/hawk-debugger` | Debugger — causa-raiz, regressões, stack traces | | **Grid** | `/grid-tester` | Test Engineer — TDD, estratégia em pirâmide, cobertura | | **Probe** | `/probe-qa` | QA Tester — testes interativos, diagnóstico de flakiness | | **Oath** | `/oath-verifier` | Verifier — verificação de conclusão baseada em evidências | | **Trail** | `/trail-tracer` | Tracer — tracing causal, hipóteses competindo | | **Flow** | `/flow-git` | Git Master — commits atômicos, rebase, limpeza de histórico | | **Scroll** | `/scroll-docs` | Document Specialist — docs externas (SDKs, APIs) via web | | **Canvas** | `/canvas-designer` | Designer — UI/UX para produto (Evo CRM, dashboards) | | **Prism** | `/prism-scientist` | Scientist — análise estatística formal, teste de hipóteses | ### Speed (haiku) | Agente | Comando | Papel | | - | - | - | | **Scout** | `/scout-explorer` | Explorer — busca paralela no codebase (Glob/Grep) | | **Quill** | `/quill-writer` | Writer — docs técnicos rápidos, README, comentários | Veja a página dedicada [Engineering Layer](engineering-layer) para pipelines, atribuições e workflows detalhados. ### Detalhes dos Papéis dos Agentes **Clawdia** é o agente padrão e o hub operacional. Briefings da manhã, triagem de e-mail, gestão de tarefas, resumos de reunião e consolidação de fim de dia passam todos pela Clawdia. **Flux** atua como CFO virtual. Consulta o Stripe para MRR/churn e o Omie para contas a pagar/receber, gera relatórios financeiros e gerencia o fechamento mensal. **Atlas** acompanha trabalho de desenvolvimento no Linear e GitHub. Status de sprint, reviews de PR, acompanhamento de issues e telemetria de licenciamento open source são seu domínio. **Pulse** monitora a saúde da comunidade no Discord e WhatsApp. Gera relatórios de pulso diários/semanais/mensais, acompanha sentimento, identifica perguntas recorrentes e mantém o FAQ. **Pixel** gerencia redes sociais no YouTube, Instagram e LinkedIn. Criação de conteúdo, planejamento de calendário, analytics multiplataforma e acompanhamento de engajamento. **Sage** lida com estratégia de alto nível. Reviews de OKR, análise competitiva, digests de estratégia e frameworks de decisão. **Nex** gerencia o pipeline de vendas. Qualificação de leads, propostas e workflows comerciais. **Mentor** lida com a plataforma de cursos (Evo Academy). Trilhas de aprendizado, criação de módulos e conteúdo educacional. **Kai** é o assistente pessoal com domínio isolado. Acompanhamento de saúde, hábitos, compromissos pessoais e rotinas. Não lida com assuntos profissionais. **Oracle** é o agente do conhecimento do workspace. Responde perguntas sobre como o EvoNexus funciona — agentes, skills, rotinas, integrações, dashboard, configuração e arquitetura — lendo a documentação real antes de responder. Sem RAG ou banco vetorial. **Mako** lida com marketing. Planejamento de campanhas, criação de conteúdo, reviews de marca, auditorias de SEO, sequências de e-mail e relatórios de performance. **Aria** gerencia RH e Operações de Pessoas. Pipeline de recrutamento, performance reviews, checklists de onboarding, análise de comp e planejamento organizacional. **Zara** lida com customer success. Triagem de tickets, empacotamento de escalações, pesquisa de cliente, drafts de resposta e artigos de KB. **Lex** gerencia jurídico e compliance. Review de contratos, triagem de NDA, checagens de LGPD, análise de risco e briefs jurídicos. **Nova** lida com gestão de produto. Specs/PRDs, reviews de métricas, atualizações de roadmap, brainstorms e updates para stakeholders. **Dex** é o agente de dados e BI. Análise de dados, queries SQL, dashboards interativos, análise estatística e validação de dados. **Lumen** é o agente de retenção de conhecimento. Captura fatos atômicos a partir de conteúdo colado, executa sessões de revisão por repetição espaçada SM-2, gera quizzes de prática de recuperação e reporta métricas de retenção por deck. Use Lumen para fixar o que você lê — Mentor cria conteúdo de aprendizado, Lumen faz colar. ## Skills Pré-carregadas Cada agente tem um campo `skills` no frontmatter que pré-carrega skills específicas do domínio no contexto do agente na inicialização. Isso significa que o agente não precisa descobrir ou carregar skills durante a execução — elas estão imediatamente disponíveis. ```yaml theme={null} --- name: "flux-finance" skills: - fin-daily-pulse - fin-weekly-report - int-stripe - int-omie --- ``` ## Agent Teams (Experimental) Para tarefas de consolidação que cobrem múltiplos domínios (digest de estratégia, dashboard, weekly review), os Agent Teams podem rodar agentes específicos de domínio em paralelo. Cada teammate coleta dados do seu domínio simultaneamente, então o agente líder sintetiza os resultados. Agent Teams são opt-in e custam \~3-5x mais tokens. Execute manualmente: ```bash theme={null} make team-strategy # @sage lidera, @atlas + @flux + @pulse + @pixel como teammates make team-dashboard # @clawdia lidera, @atlas + @flux + @pulse + @dex como teammates make team-weekly # @clawdia lidera, @atlas + @flux + @pulse como teammates ``` Veja [Visão Geral de Rotinas](../routines/overview) para detalhes sobre Agent Teams. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.