> ## 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. # Arquitetura > Como agentes, skills, rotinas e integrações se encaixam no EvoNexus ## Visão Geral O EvoNexus é um framework baseado em arquivos e amigável ao git. Tudo é markdown, YAML e scripts Python. Não exige banco de dados para o core (SQLite é usado apenas pelo dashboard). O EvoNexus organiza 38 agentes em **duas camadas ortogonais**: uma Business Layer (17 agentes para ops/finanças/comunidade/retenção de aprendizado/etc.) e uma Engineering Layer (21 agentes para desenvolvimento de software — 19 derivados do [oh-my-claudecode](https://github.com/yeachan-heo/oh-my-claudecode), MIT, por Yeachan Heo, mais 2 nativos: Helm e Mirror). As duas camadas compartilham a mesma infraestrutura de skills, memória e integrações, mas não atrapalham uma à outra: tarefas de negócio vão para agentes de negócio, tarefas de engenharia vão para agentes de engenharia. Handoffs entre camadas são comuns (ex.: Nova escreve um PRD → Apex revisa → Bolt implementa → Mirror captura lições). A engineering layer segue um workflow canônico de 6 fases (Discovery → Planning → Solutioning → Build → Verify → Retro) documentado em [`.claude/rules/dev-phases.md`](https://github.com/evolution-foundation/evo-nexus/blob/main/.claude/rules/dev-phases.md). ``` ┌──────────────────────────────────────────────────────────────────────┐ │ Usuário (humano) │ │ │ │ │ Claude Code CLI │ │ │ │ │ ┌────────────────────────────────────────────────────────────┐ │ │ │ BUSINESS LAYER (17) — operações / finanças / comunidade │ │ │ │ Clawdia Flux Atlas Pulse Pixel Sage Nex Mentor Lumen │ │ │ │ Kai Oracle Mako Aria Zara Lex Nova Dex │ │ │ └──────────────────────────┬─────────────────────────────────┘ │ │ │ │ │ ┌──────────────────────────┴─────────────────────────────────┐ │ │ │ ENGINEERING LAYER (19) — desenvolvimento de software │ │ │ │ apex echo compass raven bolt hawk lens zen vault grid │ │ │ │ probe oath trail scout flow scroll quill canvas prism │ │ │ │ (derivados do oh-my-claudecode por Yeachan Heo, MIT) │ │ │ └──────────────────────────┬─────────────────────────────────┘ │ │ │ │ │ ┌──────────────────────────┴─────────────────────────────────┐ │ │ │ Skills (175+) │ │ │ │ Negócio: fin- / social- / int- / hr- / legal- / pm- /... │ │ │ │ Engenharia: dev-* (25 skills, 3 tiers) │ │ │ └──────────────────────────┬─────────────────────────────────┘ │ │ │ │ │ ┌──────────────────────────┴─────────────────────────────────┐ │ │ │ Integrações (APIs + MCPs) │ │ │ │ Gmail / Calendar / Discord / Stripe / GitHub / Linear /… │ │ │ └────────────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────────────┘ ┌───────────────────────┐ │ Scheduler (cron) │ ─── routines.yaml │ ADW Runner │ ─── 4 core + ~23 exemplos custom │ Logs JSONL │ ─── métricas + custos └───────────────────────┘ ┌───────────────────────┐ │ Dashboard (web) │ │ Flask + React │ │ SQLite (só auth) │ └───────────────────────┘ ``` ## Componentes ### Agentes (`.claude/agents/`) Cada agente é um arquivo markdown com um system prompt que define seu domínio, responsabilidades e regras de comportamento. Agentes são invocados via slash commands (`/clawdia-assistant`, `/flux-finance`, `/apex-architect`, `/bolt-executor`, etc.) ou automaticamente pelo Claude com base na solicitação do usuário. ### Skills (`.claude/skills/`) Skills são instruções específicas de domínio que ensinam o Claude a executar tarefas. Organizadas por prefixo: | Prefixo | Domínio | Quantidade | | - | - | - | | `social-` | Redes sociais | 17 | | `int-` | Integrações | 13 | | `fin-` | Finanças | 11 | | `prod-` | Produtividade | 9 | | `mkt-` | Marketing | 8 | | `gog-` | Google | 6 | | `obs-` | Obsidian | 5 | | `discord-` | Discord | 5 | | `pulse-` | Comunidade | 4 | | `sage-` | Estratégia | 3 | > **Nota:** as skills `evo-` (\~45) são mantidas no projeto separado [EVO-METHOD](https://github.com/evolution-foundation/EVO-METHOD). Elas são gitignored neste repositório, mas funcionam normalmente se instaladas localmente. O repo entrega 175+ skills não-evo. ### Rotinas (`ADWs/routines/`) Workflows automatizados que rodam em uma agenda. Cada rotina é um script Python que invoca o Claude Code CLI com um agente e uma skill específicos. As rotinas são divididas em duas camadas: * **Core** (`ADWs/routines/`) — 4 rotinas que vêm com o repo (good\_morning, end\_of\_day, memory\_sync, weekly\_review). * **Examples** (`ADWs/routines/examples/`) — \~23 rotinas de exemplo versionadas (comunidade, finanças, social, licenciamento, etc.). * **Custom** (`ADWs/routines/custom/`) — rotinas criadas pelo usuário (gitignored). Copie dos exemplos ou crie as suas. **Runner** (`ADWs/runner.py`) — A engine de execução que: * Invoca o Claude Code CLI com `--output-format json` * Captura uso de tokens e custo * Registra logs em arquivos JSONL * Envia notificações pelo Telegram * Acompanha métricas por rotina **Scheduler** (`scheduler.py`) — Lê `config/routines.yaml` e executa as rotinas nos horários configurados usando a biblioteca `schedule`. ### Memória Memória persistente em duas camadas seguindo o **padrão LLM Wiki** (ingest → query → lint): 1. **CLAUDE.md** — Hot cache carregado a cada início de sessão. Contém o contexto-chave sobre o usuário, empresa, projetos ativos e preferências. 2. **memory/** — Diretório de memória global com arquivos tipados (pessoas, projetos, glossário, tendências). Os agentes leem conforme necessário. * `index.md` — Catálogo centralizado de todos os arquivos de memória por categoria (atualizado automaticamente pelo memory-sync) * `log.md` — Registro cronológico append-only de todas as operações de memória (ingest, lint, atualizações) 3. **agent-memory/** — Memória por agente que persiste entre sessões. Três operações mantêm a base de conhecimento: * **Ingest** (diário, via memory-sync) — Extrai conhecimento novo dos logs diários, reuniões e mudanças no git. Propaga atualizações entre arquivos de memória relacionados (ex.: uma mudança de cargo de uma pessoa atualiza o arquivo dela em people/, o glossary.md e o CLAUDE.md). * **Query** (durante conversas) — Sínteses complexas podem ser arquivadas como novas entradas de memória, fazendo o conhecimento se acumular pelo uso. * **Lint** (semanal, via memory-lint) — Health check que detecta contradições, afirmações desatualizadas, arquivos órfãos, gaps de cobertura e referências cruzadas faltando. ### Dashboard (`dashboard/`) UI web construída com: * **Backend**: Flask + SQLAlchemy + Flask-Login + WebSocket * **Frontend**: React + TypeScript + Tailwind + Recharts + xterm.js * **Auth**: SQLite com roles (admin/operator/viewer), permissões customizáveis, audit log * **Terminal**: terminal real do Claude Code no navegador via WebSocket PTY ### Integrações Clientes de API em `.claude/skills/int-*/scripts/` que se conectam a serviços externos. Cada integração tem um SKILL.md descrevendo o uso e um script Python como cliente. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.