Escrito originalmente em francês. Traduzido por IA — o sentido foi preservado, não a prosa.
Definição curta
Registro escrito fora do assistente, ao longo das trocas de trabalho, do que foi feito, decidido, encontrado e deixado pendente — destinado a ser recarregado no início de uma sessão posterior.
Definição detalhada
A palavra "memória" costuma designar o que uma ferramenta retém por conta própria: o modelo guarda certos elementos que julga úteis, sem garantia sobre o que vai restituir. Usada assim, ela descreve uma propriedade da ferramenta.
Nos artigos deste blog, a memória de sessão é o contrário: um artefato externo ao assistente, mantido em arquivos Markdown depositados no repositório do projeto. Ela não é aquilo de que o assistente se lembra, ela é aquilo que você vai devolver a ele.
Três traços a delimitam. Ela é diária na sua forma baixa — um arquivo por dia, em seções fixas — e condensada na sua forma alta, um long_memory.md mantido sob um teto. Ela é escrita automaticamente, ao fim de cada turno de conversa, sem gesto de designação. E ela é recarregada sob demanda: a captura é contínua, a restituição é um ato.
Uso no domínio
Usado para designar o que permite retomar um trabalho interrompido, e para distinguir o que você mantém por conta própria daquilo que um assistente retém por conta dele.
Sinônimos e variantes
"memória de agente" quando a ênfase está no destinatário e não no momento de produção; "log de sessão" quando se fala apenas do andar diário.
Não confundir com
- memória nativa de um assistente — o que uma ferramenta retém por conta própria, guardado na instalação dela e preso à máquina. Ela não é versionada, não é relida em um editor, não viaja com o projeto.
- arquivo de regras de um projeto — enunciado das convenções e dos proibidos que devem valer sempre. Ele é escrito a frio e não data nada; a memória de sessão data tudo e não prescreve nada.
- Contexto — espaço de trabalho durável que reúne fontes, notas, decisões e rascunhos em torno de um objetivo. A memória de sessão é um dos conteúdos dele, aquele que registra o andamento em vez do material.
- Memória ativa — memória de organização que conserva, ao lado dos fatos, o que eles ensinaram, em uma forma portátil e governada. A memória de sessão registra um andamento; a memória ativa conserva o que se retém dele.
- Persistência — gesto pelo qual uma pessoa designa um fragmento que precisa sobreviver à troca. A memória de sessão obtém um resultado parecido sem esse gesto: a seleção é feita por um modelo, segundo um critério escrito de antemão.
Exemplos
Retomar na segunda de manhã um bug deixado pendente na sexta: a memória de sessão dá o estado do problema, o que foi tentado, o que foi decidido e o que faltava fazer, sem que você precise explicar tudo de novo.
Ambiguidades / debates
A palavra circula em três sentidos que nada distingue na fala — o que o modelo retém, o que a ferramenta guarda na máquina, o que o projeto registra no repositório dele. É a razão de ser desta entrada.