Agent Memory System

Um único comando mapeia cada repositório de um espaço de trabalho. O escâner lê manifestos, rotas, APIs, configurações, testes, indícios de armazenamento e documentação, e então grava Markdown junto a um índice de tópicos em JSON. A saída é texto simples, então qualquer agente com acesso a arquivos pode usá-la sem plugin.

A memória se desvia quando o código se move, e o AMS tenta evitar isso. Rodar agent-memory maintain --since main detecta mudanças estruturais no Git, atualiza a pasta de memória e valida o resultado. A ideia é impedir que contexto desatualizado apareça sem aviso numa revisão de código. Caso contrário, não vale a pena.

O comando worklog permite que um agente deixe um recado para o próximo. Você pode marcar o destinatário, passar uma mensagem curta, e a ferramenta grava um arquivo de handoff que o assistente seguinte lê na inicialização. O contexto do Claude e a memória de agente do Cursor persistem assim. Trocar de agente deixa de parecer começar de novo.

A análise estática integrada mapeia dependências e camadas de arquitetura. Os agentes consultam o grafo para descobrir quais arquivos quebram se uma API mudar, o que transforma um jogo de adivinhação numa consulta. O projeto anuncia consultas de grafo O(1) e zero importações faltantes. Útil em repositórios grandes.

Arquivos de memória devem explicar um sistema, não expor credenciais. O AMS registra os nomes das variáveis de ambiente, bloqueia padrões óbvios de segredo, evita diretórios gerados e de fornecedores, e rotula conteúdo inferido para que os agentes saibam o que foi adivinhado e o que foi confirmado. Revise a pasta antes de commitá-la.

Uma ferramenta de benchmark de código aberto compara fluxos de início a frio de agentes com execuções guiadas pelo AMS em compreensão de repositórios, depuração, recuperação e continuidade entre vários agentes. Os mantenedores admitem que os números atuais são medições próprias e ainda precisam de reprodução independente. Bom saber antes de citá-los.