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, 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.
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:
Nota: as skills evo- (~45) são mantidas no projeto separado 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.
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.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):- 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.
- 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)
- agent-memory/ — Memória por agente que persiste entre sessões.
- 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.