Communitygithub.com

VRIL-LABS/memória-portátil-para-agentes

🧠 Um sistema de memória avançado e portátil para agentes, otimizado para uso em qualquer agente, permitindo que desenvolvedores melhorem a qualidade do seu código. Pode ser usado como sistema de memória suplementar ou independente.

O que é memória-portátil-para-agentes?

Este skill fornece um sistema de memória persistente e portátil para agentes de IA, utilizando arquivos Markdown locais como fonte da verdade e, a partir da versão 1.1.0, um banco de dados SQLite com FTS5 para indexação e busca. Ele armazena memórias no diretório `<project_root>/memories/` e gerencia a persistência através do script `scripts/memory`. Totalmente independente, pode ser usado como camada adicional mesmo que o host já possua outro mecanismo de memória. O fluxo de trabalho é composto por ingestão, recuperação, raciocínio, reflexão, execução e empacotamento, com regras rígidas como nunca escanear segredos, nunca exceder 200 linhas e nunca escrever fora de `memories/`. Suporta qualquer agente (Claude Code, Cursor, Codex) e é verificado com `scripts/memory selftest`.

Funciona com✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add VRIL-LABS/portable-agent-memory

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Sistema de Memória

A camada de persistência deste skill para memória local do projeto, em <project_root>/memories/, via scripts/memory <cmd> (com base em references/memory_tool, a fonte determinística da verdade para esta camada — nunca modifique sua saída nem a reimplemente). Ele não pressupõe que o host não tenha outro mecanismo de memória; se existir, trate-o como uma camada adicional baseada em arquivos. A saída padrão é JSON; faça read novamente para confirmar o estado no disco.

Desde a versão 1.1.0, init também cria um <project_root>/.memsys-db oculto (SQLite + FTS5, journal_mode=DELETE, um único arquivo, sem -wal/-shm) — o plano de índice e busca regenerável. O Markdown permanece como a fonte da verdade.

Comece aqui, em ordem:

  1. references/protocol.md — o fluxo de trabalho completo de ingestão → recuperação → raciocínio → reflexão → execução → empacotamento, além de comandos e invocações de início rápido.
  2. references/layout.md — estrutura de armazenamento e o que carregar para uma determinada consulta.
  3. references/when-to-save.md — classifique: skill vs. índice vs. tópico vs. rejeitar, e roteamento skills-vs-memória.
  4. references/constitution.md — regras rígidas (nunca pular varredura de segredos, nunca exceder 200 linhas, nunca escrever fora de memories/, nunca enumerar via bash, nunca usar WAL no ledger).
  5. references/memsys-db.md — o contrato do ledger .memsys-db: esquema, search/reindex/forget, e por que o banco de dados nunca supera o Markdown.
  6. references/examples.md — exemplos práticos: caminho feliz, rejeição de segredos, recuperação de sobrescrita.

Verifique a instalação com scripts/memory selftest antes do primeiro uso.

Habilidades Relacionadas