O que ai-memory-system faz?
Sistema de memória auto-evolutiva para Claude Code e Codex — duas camadas (pessoal + por projeto), reflete em doutrina, colhe fluxos de trabalho repetidos em habilidades, bloqueia ferramentas quebradas.
Visão Geral
O sistema mantém uma memória persistente que permite ao assistente de IA lembrar de preferências, decisões e workflows passados, tanto no nível do usuário individual quanto no contexto de um projeto específico. Ele é auto-evolutivo, ou seja, melhora automaticamente com o uso contínuo.
Camadas de Memória
- Memória Pessoal: Armazena informações gerais sobre o usuário, como preferências de estilo, comandos frequentes e configurações pessoais. É compartilhada entre todos os projetos.
- Memória por Projeto: Mantém contexto específico de um projeto, como decisões arquiteturais, bibliotecas usadas e problemas resolvidos. Não vaza para outros projetos.
Funcionalidades Principais
- Reflexão em Doutrina: As interações do usuário são periodicamente resumidas e consolidadas em uma 'doutrina' — um documento interno que guia a tomada de decisão da IA.
- Colheita de Workflows: Fluxos de trabalho ou comandos repetidos mais de 3 vezes são automaticamente transformados em 'skills' reutilizáveis.
- Bloqueio de Ferramentas Quebradas: Se uma ferramenta ou comando falha repetidamente (ex: 5 erros consecutivos), ela é marcada como bloqueada até nova configuração.
Como Usar
No claude.md ou AGENTS.md do seu projeto, adicione:
## Memória
- Ativar sistema de memória para este projeto
- Usar memória pessoal para preferências do usuário
Comandos
@memory status— Ver o estado atual da memória@memory harvest— Forçar colheita de workflows em skills@memory reflect— Forçar atualização da doutrina
Configuração
O sistema é auto-configurável. Nenhuma variável de ambiente é necessária. Ele detecta automaticamente o ambiente (Claude Code ou Codex) e ajusta o funcionamento.
Suporte
Funciona com:
- Claude Code
- Codex (GitHub Copilot)
Para feedback ou issues, acesse: https://github.com/Jason5330/ai-memory-system