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

# O que é o EvoNexus

> Camada multi-agente para operação e desenvolvimento — 38 agentes especializados orquestrados via Claude Code

> **Nota:** EvoNexus é um projeto **independente, open-source não-oficial**. **Não é afiliado, endossado ou patrocinado pela Anthropic**. "Claude" e "Claude Code" são marcas registradas da Anthropic, PBC. Este projeto integra-se ao Claude Code como ferramenta de terceiros e exige que os usuários forneçam sua própria instalação e credenciais.

## O Problema

Tocar uma empresa significa lidar com dezenas de ferramentas, dashboards e canais de comunicação todos os dias. E-mail, calendário, gestão de projetos, controle financeiro, moderação de comunidade, redes sociais — cada um exige atenção, e nenhum conversa com o outro.

A maioria dos "assistentes de IA" são chatbots. Você faz uma pergunta, recebe uma resposta, e volta a copiar dados manualmente entre ferramentas. Isso não escala.

## O que é o EvoNexus

EvoNexus é um workspace multi-agente compatível com [Claude Code](https://docs.anthropic.com/en/docs/claude-code) e outras ferramentas de LLM. Ele transforma uma única instalação do Claude Code em um time de **38 agentes especializados** organizados em duas camadas ortogonais — uma para operações de negócio, outra para engenharia de software.

A **Business Layer** tem 17 agentes que cuidam de domínios distintos (finanças, projetos, comunidade, redes sociais, estratégia, vendas, cursos, retenção de aprendizado, bem-estar pessoal, marketing, RH, customer success, jurídico, produto, dados, conhecimento) e produzem entregáveis operacionais reais: relatórios em HTML, caixas de entrada triadas, atas de reunião sincronizadas, snapshots financeiros, checagens de saúde da comunidade.

A **Engineering Layer** tem 21 agentes para desenvolvimento de software (arquitetura, planejamento, implementação, 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-conductor` para orquestração de ciclo e `mirror-retro` para retrospectivas blameless). A camada segue um workflow canônico de 6 fases (Discovery → Planning → Solutioning → Build → Verify → Retro) que leva um briefing até uma feature verificada, revisada, testada e com lições capturadas.

Um scheduler executa rotinas em cadência diária, semanal e mensal. Handoffs entre camadas são comuns — Nova escreve um PRD, Apex revisa a arquitetura, Bolt implementa, Lens revisa, Oath verifica.

**Isso não é um chatbot.** É uma camada operacional para o seu negócio **e** para o seu time de engenharia.

## Para quem é

* **Founders solo** que precisam tocar a operação sem montar um time de ops
* **CEOs de empresas pequenas** gerenciando múltiplos produtos e comunidades
* **Times pequenos** que querem relatórios e coordenação automatizados
* **Desenvolvedores** que já usam Claude Code e querem estendê-lo

## Como é diferente

| Chatbot | EvoNexus |
| - | - |
| Você pergunta, ele responde | Agentes executam rotinas na agenda |
| Esquece entre sessões | Memória persistente entre sessões |
| Uma única thread de conversa | 38 agentes com domínios isolados (17 de negócio + 21 de engenharia) |
| Helper genérico | Papéis especializados por camada: ops, finanças, code review, auditoria de segurança, debugging |
| Sem integrações | 18+ integrações (Google, GitHub, Stripe, Discord, etc.) |
| Saída em texto | Relatórios HTML, dashboards, artefatos estruturados |
| Manual toda vez | Workflows automatizados diários/semanais/mensais + pipelines sob demanda (`dev-autopilot`, `dev-ralplan`) |
| Persona única de LLM | Consenso multi-perspectiva (Planner + Architect + Critic) para decisões de alto risco |

## Conceitos-Chave

### Agentes

17 agentes especializados, cada um com um system prompt, slash command, memória persistente e skills específicas do domínio:

| Agente | Domínio | Comando |
| - | - | - |
| Clawdia | Operações — agenda, e-mails, tarefas, decisões | `/clawdia` |
| Flux | Finanças — Stripe, ERP, fluxo de caixa, relatórios | `/flux` |
| Atlas | Projetos — Linear, GitHub, sprints | `/atlas` |
| Pulse | Comunidade — Discord, WhatsApp, sentimento | `/pulse` |
| Pixel | Redes sociais — conteúdo, calendário, analytics | `/pixel` |
| Sage | Estratégia — OKRs, roadmap, priorização | `/sage` |
| Nex | Vendas — pipeline, propostas, qualificação | `/nex` |
| Mentor | Cursos — trilhas de aprendizado, módulos | `/mentor` |
| Kai | Pessoal — saúde, hábitos, rotina | `/kai` |
| Oracle | Conhecimento — docs do workspace, how-to, config | `/oracle` |
| Mako | Marketing — campanhas, SEO, marca, conteúdo | `/mako` |
| Aria | RH / Pessoas — recrutamento, onboarding, desempenho | `/aria` |
| Zara | Customer Success — triagem, escalação, saúde | `/zara` |
| Lex | Jurídico — contratos, compliance, NDA, risco | `/lex` |
| Nova | Produto — specs, roadmaps, métricas, pesquisa | `/nova` |
| Dex | Dados / BI — análise, SQL, dashboards | `/dex` |
| Lumen | Retenção de Aprendizado — repetição espaçada (SM-2), captura de fatos, quizzes | `/lumen-learning` |

### Skills

175+ capacidades reutilizáveis organizadas por prefixo (`fin-`, `social-`, `int-`, `prod-`, `hr-`, `legal-`, `ops-`, `cs-`, `data-`, `pm-`, `mkt-`, etc.). Skills são arquivos markdown que ensinam os agentes a executar tarefas específicas — sem plugins, sem código.

### Rotinas

Workflows automatizados (ADWs) que rodam na agenda via um scheduler em Python. Briefings da manhã, triagem de e-mail, snapshots financeiros, monitoramento de comunidade, consolidação de fim de dia. Cada rotina registra métricas de execução (tokens, custo, duração) em formato JSONL.

### Dashboard

Uma UI web (React + Flask) para gerenciar tudo: ver relatórios, iniciar/parar serviços, navegar pelos agentes e skills, gerenciar usuários e roles, e interagir com o Claude Code via terminal embutido.

<img src="https://mintcdn.com/evoai-683d737d/KKvOt8ip-TVpeDVn/evo-nexus/imgs/doc-overview.webp?fit=max&auto=format&n=KKvOt8ip-TVpeDVn&q=85&s=c467984a5457fe11899169fac6b7d2ad" alt="Dashboard Web" width="1920" height="962" data-path="evo-nexus/imgs/doc-overview.webp" />

### Base de Conhecimento

Busca semântica opcional via [MemPalace](https://github.com/milla-jovovich/mempalace). Indexe o código do seu projeto, documentação e conhecimento para busca em linguagem natural — tudo roda localmente com ChromaDB. Habilite com um clique no Dashboard.

### Memória

Persistência em duas camadas. `CLAUDE.md` guarda a memória de trabalho (quem você é, projetos ativos, pessoas-chave). O diretório `memory/` armazena contexto profundo (perfis de pessoas, glossário, histórico de projetos). Ambos sobrevivem entre sessões.

### Provedores de IA

EvoNexus roda sobre o CLI `claude` da Anthropic por padrão, mas pode trocar para qualquer um dos 6 backends alternativos (OpenRouter, OpenAI, Gemini, AWS Bedrock, Google Vertex AI, Codex Auth) via [OpenClaude](https://www.npmjs.com/package/@gitlawb/openclaude). O provedor ativo é armazenado em `config/providers.json` e pode ser alterado pela página Providers no dashboard — tanto o terminal-server quanto o ADW runner releem o config a cada nova sessão, então a troca tem efeito imediato. Sem vendor lock-in, sua escolha de modelo, suas chaves. Veja [dashboard/providers](dashboard/providers) para a referência completa.

## Open Source

EvoNexus é licenciado sob Apache 2.0, construído pela [Evolution Foundation](https://evolutionfoundation.com.br). O código-fonte está em [github.com/evolution-foundation/evo-nexus](https://github.com/evolution-foundation/evo-nexus). Este é um projeto comunitário não-oficial — não afiliado nem endossado pela Anthropic.

Foi desenhado para ser forkado e adaptado. Adicione seus próprios agentes, skills, rotinas e integrações. A arquitetura é markdown-first — sem sistemas de plugin complexos, apenas arquivos que o Claude Code lê.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.