mem0 — memória persistente (plugin)¶
O que é¶
Plugin de memória semântica persistente para o Claude Code (mem0 Platform, via MCP).
Lembra decisões, padrões e preferências entre sessões, com busca semântica, auto-capturada
por hooks. Ligado só neste projeto, pro time todo — o enable + o marketplace vêm
versionados no repo (.claude/settings.json, escopo project); cada dev só configura a
própria API key (sensível, fora do repo).
Como instala¶
O enable já vem pelo repo. Cada dev seta a própria key individual
(MEM0_API_KEY, em https://app.mem0.ai/dashboard/api-keys) no
.claude/settings.local.json (gitignored, por-dev). Nunca committar a key. Detalhe em
onboarding.
O que vem no plugin¶
1 MCP server (mem0), 7 hooks de auto-captura (SessionStart, UserPromptSubmit,
PreToolUse/PostToolUse, Stop, PreCompact), 16 skills (remember, mem0/recall,
forget, pin, peek, stats, health, etc). Custo: ~1k tokens always-on por sessão +
serviço pago (mem0 Platform).
As três camadas de memória¶
| Camada | O que é | Quando |
|---|---|---|
| File-memory | Fatos curados à mão, por-dev, fora do repo. | Fato durável específico do projeto. |
| mem0 | Memória semântica auto-capturada, cross-session. | Decisão/padrão/preferência recorrente. |
| Knowledge graph (codebase-grafo) | Estrutura do código. | "Como o código se conecta / blast radius". |
Não competem — cada uma guarda uma coisa.
Onde se aplica no harness¶
Passivo em toda sessão (recall no início, captura no fim). Uso deliberado que muda
comportamento: no comite-de-agentes — attention-gate (lembra o que o humano
desprioriza), pr-guardian (decisão por área, "módulo que já queimou"), deep-search
(causa-raiz/PRD de issue parecida), tech-debt-scout (dívida aceita como wontfix). No ciclo
de dev — co-create/to-project recuperam decisões já batidas; to-build recupera
convenção da área.
Modelo de conhecimento do projeto¶
Regra de divisão: "o que subiu e quando" → PostHog annotation (criada pelo
prod-guardian em todo PR mergeado), não mem0. O mem0 fica só com o entendimento,
por metadata.type:
metadata.type |
O que é |
|---|---|
business_decision |
Regra/decisão de negócio. |
arch_decision |
Decisão de arquitetura (porquê + alternativa descartada + área). |
company_knowledge |
Fatos sobre a empresa, produto, times, mercado. |
system_knowledge |
Como o sistema funciona — domínio, fluxos, topologia. |
decision/convention/anti_pattern/user_preference/task_learning |
(existentes) |
Regra de captura: sempre que, numa conversa, alguém revelar decisão de arquitetura/negócio ou fato sobre empresa/sistema, grava na hora com o tipo certo — buscando semelhante antes, pra atualizar em vez de duplicar.
Privacidade¶
⚠️ A memória é enviada a um serviço externo. Nunca guardar dado sensível de cliente (CPF,
bancário, Open Finance) — memória é pra decisão/padrão de engenharia. Na dúvida, /forget.
Relacionado¶
comite-de-agentes · codebase-grafo · onboarding · visao-geral