MemoryCustodian

O MemoryCustodian guarda toda a memória do projeto como Markdown simples em docs/memory/. Isso quer dizer que ela é revisável, comparável, confirmável e reversível com segurança, igual ao seu código-fonte, que é exatamente o ponto quando a memória codifica decisões reais de engenharia. Nada fica preso em um banco de dados proprietário, e os colegas podem revisar as mudanças de memória nos mesmos pull requests que o código.

Em vez de enfiar todo o histórico em cada prompt, a ferramenta lê primeiro o manifest.md, depois o brief.md e, em seguida, só os arquivos que o manifesto indica para a sua tarefa. O roteamento usa entradas explícitas de tarefa e escopo, sem adivinhação semântica nem ranking por LLM. O roteamento de contexto do agente fica determinístico e previsível. Você recebe um pacote de contexto limitado que combina com o trabalho em questão.

A CLI traz um conjunto fixo de categorias de tarefa: general, planning, implementation, artifact, preferences, history e maintenance. Chamar read --task implementation puxa a memória relevante para escrever código, enquanto outras tarefas carregam uma fatia diferente conforme o escopo que você passa. Uma flag --strict-routing falha fechado diante de um escopo incompleto ou ambíguo, em vez de adivinhar.

A memória ativa é respaldada por evidência. As entradas recebem IDs estáveis como MC-DEC-... e MC-SUBJ-..., e cada escrita precisa de confirmação do usuário ou de uma fonte do projeto para valer como real. As observações não confirmadas do agente ficam como candidatas no inbox.md até que uma pessoa as avalize, o que mantém as regras fantasmas fora da sua memória de trabalho e longe do seu código.

O esquecimento é com prévia primeiro e com escopo: o memory-custodian forget imprime um Plan ID que você precisa confirmar antes de qualquer coisa ser apagada. Esse passo de prévia importa porque os arquivos de memória são compartilhados, então uma exclusão ruim pode afetar o agente de todos de uma vez. Comandos de manutenção como o compact mantêm os arquivos dentro do orçamento e arquivam as entradas mais antigas quando você pede. Há verificações separadas de roteamento, atualidade, privacidade, segurança e conflitos, incluindo a revisão ciente de merges do Git contra uma branch base.

A ferramenta inteira roda na biblioteca padrão do Python. Nenhuma dependência de terceiros em tempo de execução. Funciona offline e não precisa de pipeline RAG nem banco de dados vetorial, o que evita a latência dos embeddings e as recuperações alucinadas. A instalação é um único pip install editável ou um script wrapper incluído.