🏆 Stack recomendada
A combinação que cobre 90% dos casos: Hermes (proativo via msg, cron, gateway) + Claude Code (cockpit de coding sentado no PC) + GitHub (fonte de verdade pra contexto, skills, configs). Os três apontam ao mesmo repositório.
🏗️ Por que essa stack ganha
📁 Estrutura típica do repo central
repo/
├── README.md # overview compartilhado
├── CLAUDE.md # contexto do Claude Code
├── AGENTS.md # contexto multi-agente
├── .hermes.md # contexto do Hermes
├── .cursorrules # regras do Cursor (opcional)
├── skills/ # SKILL.md por procedimento
│ ├── deploy.md
│ ├── audit.md
│ └── ...
├── soul.md # personalidade do agente
└── memory.md # MEMORY.md (auto-gerenciada)🔗 Apontar Claude Code e Hermes ao mesmo repo
CLAUDE.md fica na raiz do repo, lido pelo Claude Code. .hermes.md (ou MEMORY.md/USER.md) fica no mesmo repo, lido pelo Hermes. Cada um respeita seu próprio formato sem conflito.
📜 Convenção de arquivos
⚠️Anti-pattern: arquivo único pra todos
Tentar fazer um único arquivo pra todos os agentes vira bagunça. Cada agente tem convenção própria; respeitar isso simplifica manutenção. Conteúdo comum vai no README.md; específico no arquivo do agente.
🔁 n8n + Hermes
n8n executa workflow visual determinístico (sincroniza CRM, dispara webhook). Hermes adiciona inteligência adaptativa onde precisa de raciocínio (resumir email, classificar ticket, ajustar tom).
🔄 Padrão de integração
💡Economia de custo
n8n faz a parte determinística sem LLM (grátis depois de criado). Hermes é chamado só onde retorna valor (raciocínio adaptativo). Combo barato e poderoso — você não paga LLM em cada nó do workflow.
🐍 LangChain dentro do Hermes
Hermes tem plugin system. Você cria plugin Python que importa LangChain e expõe como ferramenta. Hermes chama a ferramenta quando precisa de RAG complexo, parsing de documento ou retriever especializado.
🧠 Padrão de uso
langchain-retriever: wrapper Python que conecta a Pinecone/Weaviate/Chroma e expõe como tool do Hermes.rag-search: procedimento Markdown que orienta o agente a usar o plugin pra retrieval.🌐 Vantagem da combinação
Você ganha o ecossistema LangChain (500+ integrações, vector stores, document loaders) sem ter que construir o agente do zero. Hermes vira a casca operacional, LangChain o miolo de retrieval.
🤖 Codex CLI ou Aider como subagente
Skills bundled codex e aider permitem ao Hermes invocar Codex CLI ou Aider como subprocess pra tarefas de coding pesadas. Hermes coordena, especialistas executam.
⚙️ Fluxo prático
aider, monta prompt apropriado.subprocess com argumentos certos. Aider executa refactor com modelo otimizado.diffs/2026-05-10.diff."💡Por que delegar?
Aider tem integração git superior (commits automáticos, diff view). Codex tem modelo otimizado pra coding. Em vez de Hermes fazer coding mediano, ele delega pra ferramenta especializada. Você ganha o melhor de cada.
⚠️ Anti-pattern: forçar substituição
Tentar substituir Claude Code por Hermes em coding pesado é frustrante (modelo via Codex Plus não é Sonnet 4.5). Tentar substituir Hermes por Claude Code em automação proativa também (sem cron, sem gateway).
✗ Anti-patterns comuns
- ✗Hermes pra refactor pesado de monorepo
- ✗Claude Code pra cron de marketing
- ✗n8n pra "responda no tom da empresa"
- ✗LangChain pra agente pessoal MVP
- ✗CrewAI pra Telegram bot operacional
✓ Patterns que funcionam
- ✓Hermes orquestra; Aider/Codex commitam
- ✓Claude Code raciocina; Git é fonte de verdade
- ✓n8n integra; Hermes raciocina
- ✓LangChain dentro de plugin Hermes
- ✓CrewAI batch; Hermes operacional
📜Regra de ouro
Cada agente faz aquilo que ele faz melhor. Hermes orquestra. Claude Code raciocina código. n8n integra serviços. LangChain busca em vector store. Aider commita diffs limpos. Aceitar a divisão = stack mais produtiva. Forçar fora do nicho = trabalho extra, qualidade baixa, frustração diária.
🎯Resumo do módulo
Próxima trilha:
Trilha 6 - Escala (rosa)