NeuronVault Kit

Memória persistente em Markdown para qualquer IA

Por EuSouOGiba · eusouogiba.com · youtube.com/eusouogiba

---

O que é

NeuronVault Kit é um sistema simples para dar memória persistente a agentes de IA. Ele usa uma pasta de arquivos .md, um índice chamado MEMORY.md e instruções para ensinar Cursor, Claude Code, Codex, ChatGPT, Gemini ou modelos locais a lerem só o contexto relevante antes de responder.

Ele foi desenhado para funcionar sem banco, sem servidor e sem dependência obrigatória. O usuário controla tudo no filesystem.

Problema que resolve

• Toda conversa nova com IA começa do zero.
• Preferências, decisões e contexto de projeto se perdem entre sessões.
• Trocar de modelo ou ferramenta normalmente descarta memória.
• Contexto gigante custa token, dinheiro e tempo.

Lógica central

MEMORY.md
  -> índice leve com uma linha por memória
  -> a IA lê primeiro para decidir relevância

neurons/*.md
  -> memórias duráveis com frontmatter YAML
  -> tipos: user, feedback, project, reference, skill

daily/YYYY-MM-DD.md
  -> decisões e eventos do dia

_transit/
  -> rascunhos temporários que a IA não deve tratar como memória final

Fluxo padrão:

1. A IA lê MEMORY.md.
2. Seleciona apenas os neurons relevantes.
3. Executa a tarefa usando esse contexto.
4. Quando aprende algo durável, cria ou atualiza um neuron.
5. Remove, consolida ou marca como obsoleto o que envelheceu.

Leia a explicação completa em docs/STRUCTURE_AND_LOGIC.md.

Instalação rápida

Windows

git clone https://github.com/lezards/neuron-vault-kit.git
cd neuron-vault-kit
install.bat

macOS

git clone https://github.com/lezards/neuron-vault-kit.git
cd neuron-vault-kit
chmod +x install.sh scripts/*.sh
./install.sh

Integrações

• Cursor: instala rules em .cursor/rules/.
• Claude Code: adiciona bloco # NeuronVault em ~/.claude/CLAUDE.md.
• ChatGPT/Gemini/outros: use integrations/generic/AI_SYSTEM_PROMPT.md.
• Qualquer agente local: siga docs/AI_ADAPTATION_GUIDE.md.

Exemplo de neuron

---
name: Não mockar banco em testes de integração
description: Testes que tocam schema/query devem usar banco real
type: feedback
---

Testes de integração devem usar banco real quando validam schema, query,
transação, lock ou migração.

**Why:** mocks podem divergir do comportamento real.
**How to apply:** usar container ou banco local descartável antes de declarar pronto.

Estrutura do repositório

core/                         template do vault instalado
docs/                         arquitetura, workflow e guias de adaptação
integrations/cursor/          rules .mdc
integrations/claude-code/     template CLAUDE.md
integrations/generic/         prompt universal para qualquer IA
skills/neuron-vault-installer/SKILL.md
scripts/                      instaladores auxiliares e validação
install.bat                   instalador Windows
install.sh                    instalador macOS/Linux

Segurança

Este repositório é o kit público. Não coloque seu vault real aqui.

Nunca versionar:

• tokens, cookies, senhas ou arquivos .env;
• chaves SSH ou privadas;
• e-mails, dados pessoais ou material sensível;
• notas _transit/ que ainda não foram revisadas.

Veja SECURITY.md.

Validação

python scripts/validate-package.py

No Windows:

python .\scripts\validate-package.py

Licença

MIT.