Pular para o conteúdo
Pathrule

memória

As sessões acabam.
A memória fica.

Memória persistente para agentes de programação com IA: as decisões, as armadilhas e as convenções que sua equipe aprendeu, guardadas fora do agente e vinculadas aos caminhos que elas regem.

Codex, uma semana depoisexemplo
Adicione um status de reembolsado aos pedidos.

Sem

Pronto. Adicionei o valor ao enum e rodei a migração de schema.

O deploy falhou: a migração de dados tinha que rodar antes.1 correção

Com o Pathrule

1 memória para db/migrations

  • Primeiro a migração de dados, depois a de schema. É o inverso do resto do schema.

Escrevendo primeiro a migração de dados, como esta pasta exige.

Entregue de primeira.0 correções

O que se perde quando a sessão acaba.

Segunda, Claude Codecontexto, 92%

sessão encerrada

Terça, uma nova sessãocontexto, 0%

  • As decisões, e os motivos por trás delas
  • A armadilha que custou um dia
  • A abordagem que já falhou
  • O que o outro agente aprendeu

Os arquivos mostram a forma atual do código. Eles não dizem por quê, em que sentido mudá-lo nem que alguém já errou nisso.

A memória é onde tudo começa.

  1. Memóriao que foi registrado
  2. Conhecimentoo que significa
  3. Inteligênciaquando importa
  4. Contexto da tarefaesta tarefa

A memória guarda o passado. A inteligência decide o que importa agora: se isso se aplica a este caminho, se é uma regra ou uma preferência e se uma pessoa confirmou. Como ela decide

Feita para código, não para chat.

memória de chatvinculada a uma pessoa
  • Recuperada quando algo pergunta
  • Privada a uma única conta
  • Uma pilha só, sem tipos
  • Zera quando você troca de ferramenta
memória de projetovinculada a um caminho
  • apps/mobile3
  • services/billing7
  • db/migrations2
  • Entregue antes da primeira chamada de ferramenta
  • Compartilhada com a equipe
  • Tipada como memórias, regras e skills
  • Fora de todos os agentes

Um armazenamento de memória responde quando é perguntado, e um agente que nunca pensou em perguntar sobre a convenção nunca a recebe. A memória de projeto lê o caminho primeiro.

Fato, regra, procedimento.

Se depende da situação, é uma memória. Se é inegociável, uma regra. Se é uma sequência que alguém vive repetindo, uma skill.

Às vezes, um arquivo basta.

um agente
Mantenha o CLAUDE.md
vários agentes
Uma memória para todos
uma equipe
Compartilhada e revisável
precisa valer
Uma regra estrita

O que decide não é o tamanho do repositório, e sim se o conhecimento precisa chegar aonde um arquivo não chega. Onde cada abordagem falha

Perguntas frequentes.

O que é memória para agentes de IA?

O conhecimento que um agente de IA consegue usar em uma sessão diferente daquela em que o aprendeu. Para um agente de programação, o tipo útil é a memória do projeto: decisões, armadilhas e convenções que não estão escritas em nenhum lugar do código-fonte, guardadas fora do agente e entregues de volta quando o trabalho acontece perto do código que elas regem.

Por que agentes de programação com IA esquecem de uma sessão para outra?

Uma chamada de modelo não tem memória própria, mas os produtos podem persistir conhecimento fora da janela de contexto. As memórias locais do Codex, a memória automática do Claude Code e os arquivos de instruções versionados ajudam entre sessões. A questão que resta é o que é armazenado, quem pode usar e quando chega. Leitura longa: por que assistentes de programação com IA esquecem sua base de código entre sessões.

Uma API de memória é a mesma coisa que memória para um agente de programação?

Não, e a diferença está no momento da entrega. Uma API de memória responde quando é consultada, o que funciona quando você controla o ponto de chamada dentro do seu próprio produto. Um agente de programação não sabe o que está faltando, então uma restrição sobre a qual ele nunca pensou em perguntar nunca chega. A memória do projeto lê o caminho em que o agente vai trabalhar e entrega o conhecimento correspondente antes da primeira chamada de ferramenta.

Não dá para simplesmente colocar tudo no CLAUDE.md?

Para um repositório pequeno, um arquivo de instruções curto costuma bastar. O Claude Code aceita regras vinculadas a caminhos e carregamento condicional do AGENTS.md; o Codex aceita AGENTS.md aninhados e memórias locais. O Pathrule passa a ser útil quando o mesmo conhecimento do espaço de trabalho precisa chegar a agentes diferentes, com seleção específica para a tarefa e requisitos que podem ser aplicados de fato. Lado a lado: Pathrule vs arquivos de instruções.

Qual a diferença disso para uma busca vetorial no meu repositório?

Elas respondem a perguntas diferentes. Um índice do seu repositório pode dizer ao agente o que o código diz hoje, o que é útil quando a resposta existe mas ninguém lembra onde. Ele não tem nada a devolver sobre uma decisão tomada em uma revisão e não registrada em lugar nenhum, e é disso que é feita a maior parte da memória do projeto. As duas coexistem: recuperação sobre os arquivos, memória sobre o raciocínio. Em detalhe: RAG vetorial vs contexto vinculado a caminhos.

Memória de equipe significa que a equipe inteira vê tudo?

Quem decide é a participação. Memórias, regras e skills ficam em um grafo compartilhado, indexado por caminho, com o acesso ao espaço de trabalho controlado no servidor, e não no cliente. Veja funções e permissões.

Memória para agentes significa enviar meu código-fonte?

Não precisa significar. O Pathrule não envia automaticamente o código-fonte do seu repositório. No modo local não há conta, e o conhecimento fica na sua máquina. No modo Cloud, o Pathrule Cloud armazena as memórias, regras e skills que sua equipe escreve, o início de cada prompt é enviado para ranquear o que se aplica, e o pathrule snapshot, quando você ou seu agente o executam, envia a árvore de arquivos, os manifestos, pequenas amostras de documentação e metadados recentes do git. O detalhamento completo está na página de Segurança.

O que acontece com a minha memória quando eu troco de agente de programação?

Nada, e esse é o motivo de guardá-la fora do agente. As mesmas memórias chegam a Claude Code, Codex, Cursor, GitHub Copilot, Windsurf e qualquer outro cliente conectado via MCP, então trocar de agente não zera o que a equipe registrou. Leitura longa: a memória da equipe não deveria mudar quando as ferramentas de IA mudam.

Preciso de memória para agentes se trabalho sozinho?

Você continua esquecendo, e o agente também. Sozinho, o que a memória lhe dá não é compartilhamento, é a versão de você de quatro meses atrás: o motivo pelo qual você rejeitou uma abordagem, que de outro modo você vai rediscutir com um agente que não faz ideia de que aquilo já foi decidido. O ganho aumenta se você usa mais de um agente, já que nenhum deles consegue ler as notas do outro. O Pathrule é gratuito para uso individual. Qual abordagem serve explica quando ele é realmente exagero.

Anote uma vez.
Toda sessão começa dali.