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. 1

    Abra a aba Brain na página Details de um projeto e clique em “Build memory”.

  2. 2

    Filtre a lista de decisões pelas desatualizadas e confira qualquer uma com “Verify with Claude”.

  3. 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

Todos os recursosVeja os 18 agentes de código suportados

Reúna seus agentes em uma só mesa.

Comece no plano gratuito. Baixe, adicione a pasta de um projeto e abra seu primeiro agente.