Camada Humana e Governança
Uma dimensão frequentemente negligenciada nas discussões técnicas sobre memória de agentes: o humano também é um consumidor de memória.
Um agente pode armazenar e recuperar contexto com perfeição técnica, mas se o humano responsável pelo projeto não consegue ler, auditar e entender o que o agente "sabe" e "decidiu", o sistema é uma caixa preta. Em contextos profissionais, isso é um problema de governança, não apenas técnico.
Arquivo de identidade lido pelo Claude Code, Cursor e outros agentes de codificação no início de cada sessão. Define quem o agente é, o que pode fazer e como deve se comportar neste projeto específico.
Equivalente ao CLAUDE.md para sistemas multi-agente. Define escopos, responsabilidades e regras de colaboração entre agentes distintos. Evita conflitos, duplicação de trabalho e comportamentos não autorizados.
Texto injetado no início de cada chamada ao modelo, definindo persona, tom, restrições e contexto operacional. É a camada de identidade mais imediata — lida a cada inferência, não apenas no início da sessão.
Arquivo de configuração do Model Context Protocol (Anthropic, 2024) que define quais ferramentas, servidores e recursos o agente pode acessar. É a documentação de capacidades do agente — o que ele pode fazer, não apenas quem ele é.
Documento que registra decisões relevantes tomadas pelo agente ou pelo time, com contexto, alternativas consideradas e raciocínio. É a camada de governança mais importante: permite revisão, contestação e aprendizado.
Documento gerado pelo agente ao final de cada sessão de trabalho, descrevendo o que foi feito, o que mudou, o que ficou pendente e o que o próximo agente (ou humano) precisa saber.
Documento de análise de causa raiz de incidentes, falhas de produto ou decisões que não funcionaram como esperado. Transforma erros em aprendizado institucional — e alimenta a memória episódica do sistema.
Documento que descreve como executar operações recorrentes: deploys, migrações, respostas a incidentes, onboarding. É a memória procedural do time — o que fazer, na ordem certa, com os comandos exatos.
"Onde o agente escreve para o humano ler?"
Não o log de sessão, não o grafo interno, não o vetor store — mas a documentação estruturada, os registros de decisão, os PRDs, os resumos de sprint. Essa camada existe em separado das camadas de memória técnica, e sua ausência é o motivo pelo qual a maioria dos projetos de agente não escala além do desenvolvedor que o construiu.