Contexto importante vive em arquivos do repo — não só no chat.
Onde guardar
Default: docs/agent-memory/
| Arquivo | Conteúdo |
|---|---|
decisions.md |
Decisões e porquês (data + resumo) |
preferences.md |
Preferências do usuário/projeto (stack, tom, UI) |
context.md |
Resumo atual do produto e estado |
Se a pasta não existir, crie-a ao gravar a primeira memória.
Workflow
- No início de tarefas longas ou ambíguas: ler os arquivos de memória existentes.
- Usar o que estiver documentado; citar a fonte (“em preferences.md…”).
- Atualizar após decisões relevantes, preferências novas ou mudança de contexto do produto.
- Não inventar memória ausente — se não estiver no arquivo, pergunte ou registre como nova.
Formato de decisão
## YYYY-MM-DD — <título>
- **Decisão:** …
- **Por quê:** …
- **Consequências:** …
Regras
- Memória é do projeto, versionável com o git.
- Não gravar segredos (tokens, chaves, senhas).
- Entradas curtas e pesquisáveis; evite dumps de conversa inteira.