Usando Arquivos Markdown como um Sistema de Memória para Agentes de IA de Programação

Método Principal: Conversando em Arquivos em Vez da Janela de Chat

O desenvolvedor usa o Claude Code, mas evita a interface de chat padrão. Em vez disso, ele instrui o agente a criar um arquivo {topic}_LOG.md onde todas as discussões importantes são conduzidas e persistidas. Na janela de chat, ele apenas escreve /response para dizer ao Claude para olhar o arquivo de discussão atual e responder lá, reservando o chat para perguntas triviais à parte que não precisam de persistência.

Estrutura e Anotação de Arquivos

As respostas são normalmente adicionadas no final do arquivo LOG como em um chat normal, mas comentários também podem ser inseridos inline para responder a pontos específicos. Isso é particularmente útil para esclarecimentos paralelos durante o planejamento do projeto. Para manter a clareza na releitura, todos os comentários humanos são marcados com C: para distingui-los das contribuições do Claude.

Arquitetura do Sistema de Memória Dupla

Além do arquivo LOG, o Claude é instruído a criar e manter um arquivo {topic}_SUMMARY.md. Este resumo contém referências ao LOG original com números de linha, já que o LOG frequentemente se torna muito grande para caber na memória. O resumo atua como memória declarativa de alto nível, enquanto o LOG serve como memória procedural detalhada.

Inicialização do Agente e Gerenciamento de Memória

Quando um novo agente é iniciado ou após a compactação, o processo é:

• O usuário fornece contexto: "Sua tarefa é continuar a conversa {topic}. Vamos focar em X."
• O agente lê {topic}_SUMMARY.md para entender o que é importante
• O resumo indica onde X foi discutido (ex.: linhas 100-200 e 500-800 do LOG)
• O agente carrega essas linhas específicas do LOG mais as últimas cem linhas para contexto recente
• O agente pode decidir autonomamente quando consultar detalhes mencionados no resumo

Manutenção e Controle de Qualidade

Subagentes simples escaneiam os resumos periodicamente para garantir a sincronização adequada com seus logs correspondentes. Resumos de tópicos diferentes contêm referências cruzadas quando apropriado, dando a qualquer agente trabalhador a infraestrutura para consultar detalhes adicionais. Os agentes também sinalizam quaisquer comentários C: que nunca foram abordados, evitando perguntas perdidas.

Benefícios de Fallback e Documentação

Para máxima confiabilidade independentemente do custo de tokens, um novo agente pode ser instruído a reler todo o arquivo LOG, o que requer menos memória do que a discussão original, pois exclui outras operações como ler arquivos Python ou navegar na web. Como bônus, os arquivos LOG servem como documentação completa para outras pessoas trabalhando no mesmo projeto.