📝 MEMORY.md — a camada legível
A primeira camada de memória do Hermes é um arquivo de texto simples chamado MEMORY.md. É markdown puro: você abre num editor qualquer, lê e edita. Ele vive no seu laptop — não num servidor de terceiros. Pense nele como o caderninho onde o agente anota o que importa sobre você.
📒 Por que markdown e não um banco "mágico"
Texto puro tem três vantagens que um sistema fechado não dá:
- •Transparente: você vê exatamente o que ele "sabe" sobre você.
- •Editável: corrige um fato errado abrindo o arquivo.
- •Portável: é só um arquivo; faz backup, copia, versiona.
Como o MEMORY.md se parece (ilustrativo)
# MEMORY.md ## Pessoa - Nome: Nei - Aniversário: 14 de março - Fuso: America/Sao_Paulo (BRT) ## Preferências - Gosta de respostas diretas, sem enrolação - Trabalha com automação (n8n, Make) ## Projetos ativos - Curso "Hermes 21C" — entregar trilha 2
🔍 Busca full-text — recall de tudo
A segunda camada é uma busca full-text em SQLite sobre TODA mensagem de TODA sessão. Enquanto o MEMORY.md guarda o "resumo curado", essa camada guarda o histórico bruto e deixa você pescar qualquer frase por palavra ou por data.
💬 Exemplo real de recall
Você pode pedir literalmente:
"Me dá um exemplo de pergunta que fiz em 19 de maio."
O agente busca no histórico indexado e devolve a mensagem exata — algo impossível só com o MEMORY.md curado.
💡 Dica prática
As duas camadas se completam: o MEMORY.md é o que ele sempre tem em mente; a busca full-text é o que ele vai pescar quando precisar de um detalhe antigo.
⏳ Compõe silenciosamente
A memória não fica boa no primeiro dia. Ela compõe em segundo plano conforme você usa, e leva cerca de 2 semanas de uso real para o agente ficar "mágico" — conhecer seus padrões, seu vocabulário, suas prioridades.
Dia 1–3 — quase um chatbot
Pouco contexto acumulado
Ainda não te conhece. As respostas são genéricas; você precisa repetir contexto.
Semana 1 — começa a lembrar
Padrões emergindo
Já evita perguntar coisas que você falou; sugere com base no que sabe.
~2 semanas — "mágico"
Memória composta
Antecipa necessidades, conecta projetos e conversa como quem te acompanha há tempos.
💡 Dica prática
Não desista nos primeiros dias. A sensação de "não vale a pena" é normal antes da memória compor. Use de verdade por 2 semanas antes de julgar.
🔗 Supercharge — turbinar a memória
Você pode conectar fontes externas para o Hermes "saber" muito mais: Obsidian (suas notas), Pinecone (memória vetorial), a memória do Claude Code e até apps do seu computador.
✓ Boas fontes para conectar
- ✓Obsidian — seu segundo cérebro de notas
- ✓Pinecone — recall semântico de volume grande
- ✓Memória do Claude Code — projetos e decisões
✗ Cuidados ao turbinar
- ✗Não despejar tudo de uma vez (vira ruído)
- ✗Não conectar dados sensíveis sem necessidade
- ✗Não esquecer: mais contexto = mais tokens por turno
📊 O efeito de turbinar
- Mais fontes → respostas mais específicas e personalizadas
- Recall semântico → encontra por significado, não só por palavra exata
- Memória unificada → conecta o que você fala em canais diferentes
🌙 Ele "sonha" à noite
Em períodos ociosos, o Hermes processa o que aprendeu e volta proativamente com sugestões. É a diferença entre uma memória passiva (que só responde quando perguntada) e uma memória ativa (que conecta pontos por conta própria).
🌙 O que "sonhar" significa na prática
Não é misticismo — é processamento ocioso que revisita o histórico e gera insights:
- •"Notei que você adiou X três vezes — quer que eu agende?"
- •"Aquele projeto que você mencionou tem um prazo amanhã."
- •"Você falou em treino; quer um lembrete recorrente?"
💡 Dica prática
Quanto mais rica a memória, melhores os "sonhos". Esse comportamento proativo se conecta ao heartbeat/cron da Trilha 3 — o agente que vem até você.
🌐 O "everything system"
A filosofia central: sem informação do que você faz, não há como dar conselho preciso. A memória é o que transforma um modelo genérico em um assistente que entende o seu contexto — o "everything system".
✗ Sem memória
- ✗Conselhos genéricos, "de manual"
- ✗Você repete contexto toda vez
- ✗Cada sessão começa do zero
✓ Com memória
- ✓Conselhos calibrados ao seu caso
- ✓Continua de onde parou
- ✓Conecta projetos e decisões ao longo do tempo
🌐 Por que isso fecha a trilha de capacidades
Soul (2.2) dá personalidade, integrações (2.3) dão alcance, ações (2.4) dão braços — mas é a memória que dá continuidade. Sem ela, todas as outras capacidades reiniciam a cada conversa.
📌 Resumo do Módulo
Próximo Módulo:
2.2 — Soul.md: a bíblia do personagem