O que Memória faz?
Um sistema de gerenciamento de conhecimento baseado em sistema de arquivos, onde o código-fonte É a memória. Armazene decisões, padrões e contexto em arquivos Markdown estruturados.
Quando Usar
- Registrar decisões arquitetônicas
- Documentar padrões descobertos durante o desenvolvimento
- Salvar contexto sobre por que algo foi construído de determinada forma
- Rastrear problemas conhecidos e soluções alternativas
- Armazenar documentação de API ou notas de integração
Quando NÃO Usar
- Notas de depuração temporárias (use comentários)
- Rastreamento de tarefas (use issues do git ou quadro de projeto)
Princípios Centrais
- O código-fonte é a fonte única da verdade
- Armazene conhecimento perto de onde ele é usado
- Use Markdown estruturado para consistência
- Mantenha arquivos focados (um tópico por arquivo)
Locais de Armazenamento
| Tipo | Localização | Exemplo |
|---|---|---|
| Documentação técnica | docs/technical/ | Decisões arquitetônicas, padrões |
| Documentação de funcionalidades | docs/features/ | Especificações de funcionalidades, requisitos |
| Documentação de API | docs/api/ | Contratos de API, notas de integração |
Operações de Memória
Lembrar (Escrita)
Armazene novo conhecimento:
# [Título do Tópico]
## Contexto
[Por que isso existe, qual problema resolve]
## Decisão
[O que foi decidido e por quê]
## Detalhes
[Detalhes técnicos, exemplos de código]
## Referências
- [Arquivos ou URLs relacionados]
---
*Criado em: [data]*
*Última atualização: [data]*
Recuperar (Leitura)
Recupere conhecimento:
- Verifique a estrutura do diretório
docs/ - Leia os arquivos relevantes
- Pesquise por palavras-chave nos documentos
Atualizar
Modifique conhecimento existente:
- Leia o arquivo existente
- Atualize a seção relevante
- Adicione ao histórico de evolução se for significativo
Skills Relacionados
| Skill | Quando Encadear |
|---|---|
| feature-dev | Armazenar decisões arquitetônicas durante o desenvolvimento |
| planning | Documentar o plano para referência futura |