AgentVera Brain: a memória de por que o projeto é feito assim
O motivo por trás de uma decisão costuma estar na descrição de um PR, numa mensagem de commit ou numa conversa esquecida com um agente. O Brain lê essas fontes, lista as decisões com seus motivos, sinaliza as que não batem mais com o código e, se você quiser, entrega aos agentes novos do projeto um pacote de contexto curto.
Fontes
Monte a memória com “Build memory” na aba Brain da página Details de um projeto, e atualize com “Refresh memory”.
- Documentos e ADRs versionados no Git: README, ARCHITECTURE, CONTRIBUTING, CLAUDE, AGENTS, CHANGELOG, docs/, adr/, decisions/ e similares, até 250 arquivos.
- Os 1.500 commits mais recentes que não são de merge e os arquivos que eles alteraram.
- Até 200 PRs e 200 issues, se o repositório estiver no GitHub e você tiver feito login.
- Até 120 conversas com agentes no projeto.
Decisões e seus status
As fontes que explicam um motivo (ADRs, descrições longas de PR, commits com “because”, “instead of”, “switched to”, conversas) são lidas pelo Claude Haiku. Cada decisão é salva com título, motivo, data, fontes e termos de código relacionados; as duplicadas são unificadas.
- Status: atual, desatualizada, substituída. Uma decisão fica desatualizada quando seus termos de código não aparecem mais no código ou seus arquivos sumiram.
- “Compare with code” refaz essa checagem com git grep; “Verify with Claude” faz uma execução somente leitura do Claude Sonnet julgar uma decisão com base nas evidências dos arquivos.
- O grafo de conhecimento mostra as decisões e os termos de código que elas compartilham.
Pergunte ao projeto, e o pacote de contexto
Faça uma pergunta como “Por que usamos JWT?” e as decisões e fontes mais relevantes são escolhidas; o Claude Sonnet responde em modo somente leitura e cita essas fontes. O pacote de contexto resume o que é o projeto, a stack, as decisões principais, as convenções e as mudanças recentes em no máximo 2.500 caracteres. Com “Give new agents the context pack” ativado, todo agente novo iniciado no projeto recebe esse resumo, mais uma lista de decisões que talvez não valham mais, no fim das instruções. Essa opção vem desativada por padrão.
Comece
- 1
Abra a aba Brain na página Details de um projeto e clique em “Build memory”.
- 2
Filtre a lista de decisões pelas desatualizadas e confira qualquer uma com “Verify with Claude”.
- 3
Revise o pacote na visão do pacote de contexto e ative a entrega dele aos agentes novos.
Perguntas
A memória se atualiza sozinha?
Não. Você atualiza com “Refresh memory”.
Onde os dados ficam guardados?
No seu computador, em um arquivo por projeto na pasta de dados do app. Para extrair decisões e responder perguntas, o texto das fontes vai para a Anthropic pelo seu login do Claude Code.
Funciona sem GitHub?
Sim. Documentos, commits e conversas continuam sendo lidos; PRs e issues só entram quando o repositório está no GitHub e você fez login.
Como os agentes usam o Brain?
Com o pacote de contexto ativado, ele é adicionado às instruções dos agentes novos. Os agentes também podem buscar na memória com a ferramenta brain_recall e, com “Agents write the memory” ativado, guardar correções, regras e decisões para os próximos agentes com brain_remember.
Recursos relacionados
Reúna seus agentes em uma só mesa.
Comece no plano gratuito. Baixe, adicione a pasta de um projeto e abra seu primeiro agente.
Artigos sobre o tema
Blog- 28 de outubro de 2026Engenharia de contexto para agentes de IA: guia práticoEngenharia de contexto para agentes de código com IA: o que enche o contexto, por que ele se degrada e técnicas que funcionam melhor que ajustar o prompt.
- 27 de outubro de 2026Documentação com IA: do README ao changelogEscreva documentação com IA que continua correta: READMEs, docs de API, docstrings, notas de arquitetura e changelogs do git log, sem APIs inventadas.
- 24 de outubro de 2026Memória compartilhada para agentes de código com IAMemória compartilhada para agentes de código: como um cérebro do projeto guarda decisões, notas de passagem e correções para cada nova sessão começar informada.