Memory Bank — Arquitetura de Memória Persistente para Agentes d…

🧠 Memory Bank — Protocolo de Memória Persistente e Contexto para Agentes

Você é um agente equipado com o Memory Bank, um sistema de memória externa estruturada. Modelos de linguagem são redefinidos entre sessões e perdem contexto durante fluxos de trabalho longos. O Memory Bank resolve isso externalizando a continuidade do projeto em um diretório estruturado de arquivos Markdown simples dentro do repositório.

---

📁 Arquitetura do Memory Bank

O Memory Bank reside em um diretório memory-bank/ na raiz do projeto:

project-root/
└── memory-bank/
    ├── projectbrief.md     # Missão central, escopo, metas, não negociáveis
    ├── productContext.md   # Por que isso existe, problemas do usuário resolvidos, jornadas do usuário
    ├── activeContext.md    # FOCO ATUAL, decisões ativas, mudanças recentes, próximos passos imediatos
    ├── systemPatterns.md   # Arquitetura, estrutura de componentes, padrões de design, fluxos de dados
    ├── techContext.md      # Stack tecnológico, dependências, restrições de execução, configuração de ambiente
    └── progress.md         # O que funciona, o que está construído, bugs conhecidos, roteiro

---

⚡ Protocolo de Carregamento Progressivo

Para manter o uso de tokens enxuto e evitar diluição de contexto:

1. Ao Iniciar Sessão / Retomar Trabalho:
   • Verifique se memory-bank/ existe.
   • Se existir, leia memory-bank/activeContext.md primeiro. Isso restaura imediatamente a consciência situacional.
   • Leia memory-bank/systemPatterns.md ou techContext.md SOMENTE ao modificar arquitetura relevante ou configurações de build.
2. Em Decisões Importantes / Fim da Sessão:
   • Atualize memory-bank/activeContext.md com o que mudou e o que permanece.
   • Atualize memory-bank/progress.md com marcos recém-concluídos ou bugs descobertos.

---

🛠️ Comandos e Ações de Memória

1. /memory init (Inicializar Memory Bank)

Se memory-bank/ não existir:

• Escaneie a estrutura do repositório (package.json, README.md, arquivos fonte, git log).
• Gere todos os 6 arquivos principais preenchidos com detalhes verificados do código atual.

2. /memory update (Sincronizar Estado Atual)

• Resuma as mudanças de código, pivôs arquitetônicos e tarefas ativas da sessão atual em activeContext.md.
• Mova itens concluídos em progress.md de "Em Andamento" para "Concluído".

3. /memory record <decisão> (Registrar Decisão Técnica)

• Anexe a decisão, a justificativa e as alternativas consideradas a systemPatterns.md.

---

📋 Modelos de Arquivo

activeContext.md

# Contexto Ativo

## Foco Atual
- [Breve resumo do objetivo em andamento]

## Mudanças Recentes
- [Arquivo ou componente modificado] — [Justificativa]

## Decisões e Considerações Ativas
- [Trade-off ou padrão acordado]

## Próximos Passos
1. [Tarefa imediata 1]
2. [Tarefa imediata 2]

progress.md

# Progresso do Projeto

## O Que Funciona
- [Funcionalidade A] — verificada funcional
- [Funcionalidade B] — verificada com testes unitários

## O Que Falta Construir
- [ ] Marco 1
- [ ] Marco 2

## Problemas Conhecidos / Bloqueadores
- [Descrição do problema e correção potencial]