Memória

Além de uma conversa, o agente mantém uma memória pequena e legível sobre você e o seu trabalho. Diferente do histórico de uma sessão, a memória persiste entre sessões.

O Imaginne tem duas memórias, com escopos diferentes:

	Memória de projeto	Memória da conta
Onde	Desktop, TUI, VS Code	Chat no navegador
Escopo	Um projeto (workspace)	Você, em todas as conversas do chat web
Formato	Quatro arquivos Markdown no seu disco	Cartões curtos, guardados no servidor
Quem edita	Você e o agente	Você (o agente sugere; você aprova)

O resto desta página descreve a memória de projeto. Para a memória da conta, veja Memória da conta.

Quatro notas, por projeto

A memória são quatro arquivos Markdown em .imaginne/memory/, lidos no início de cada sessão.

A memória vive em <projeto>/.imaginne/memory/ como quatro arquivos Markdown:

Nota	Para quê
Perfil do usuário	Quem é você, seu papel, suas preferências de trabalho.
Memória do projeto	Objetivos, contexto e estado atual do projeto.
Glossário	Termos e siglas do seu domínio.
Decisões	O que foi combinado e por quê — um registro de decisões.

São por workspace (por projeto), não globais. São arquivos comuns: você pode lê-los e editá-los.

Como o agente usa a memória

• No início da sessão, as quatro notas entram no contexto do modelo, em ordem estável (perfil → projeto → glossário → decisões).
• Durante a conversa, o agente pode atualizar a memória quando percebe uma preferência, uma correção ou uma decisão. As mudanças são gravadas no disco na hora.

As mudanças valem na próxima sessão

O prompt do sistema é montado a partir de um retrato tirado no início da sessão. Por isso, uma atualização de memória feita no meio da conversa só passa a influenciar o agente na sessão seguinte. Isso mantém o comportamento estável e previsível dentro da mesma conversa.

Proteções

A memória é tratada com cuidado porque alimenta o prompt do sistema:

• Escritas atômicas e trava de arquivo evitam corrupção quando há edições concorrentes.
• Detecção de alteração externa: se um arquivo foi modificado por fora, o Imaginne faz backup e sinaliza, em vez de sobrescrever cegamente.
• Verificação contra injeção: toda escrita passa por uma checagem que bloqueia tentativas de injeção de prompt e caracteres invisíveis/bidirecionais antes que cheguem ao prompt do sistema.

Editar a memória

• Desktop — abra Project Memory na navegação lateral. As notas abrem em modo leitura; edite e salve.
• Terminal (TUI) — use /memory (/memory <user|project|glossary|decisions|review|list>) para ver ou revisar.
• Chat no navegador — o item Memória na barra lateral gerencia a memória da conta (cartões, sugestões e limites). Veja Memória da conta.

Nas superfícies locais, você também pode editar os arquivos .md diretamente — eles são seus.

Memória ≠ sessão

	Sessão	Memória
Escopo	Uma conversa	O projeto, entre conversas
Conteúdo	Mensagens e ações	Perfil, projeto, glossário, decisões
Limpar contexto afeta?	Sim (esquece o histórico)	Não

Veja também

💬Sessões

O que acontece dentro de uma conversa.

Abrir →🧠Memória da conta

O que o Imaginne lembra de você no chat no navegador.

Abrir →🔒Segurança & privacidade

Como o conteúdo é tratado antes de ir ao modelo.

Abrir →