# Memory Ops

> Consulta e persistência obrigatória da memória principal no PostgreSQL (Memory_openclaw + pgvector). Use quando for responder, delegar tarefas, consolidar contexto do usuário, registrar handoffs (ex.: Alfred, Prompt Improver), ou manter histórico operacional com auditoria.

- Skill: `dvcrn/memory-ops` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add dvcrn/memory-ops`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/memory-ops/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/memory-ops

---


# Memory Ops

## Protocolo obrigatório (sempre)
1. Consultar memória principal antes de responder ou delegar.
2. Responder/delegar com contexto recuperado.
3. Salvar contexto do prompt do usuário.
4. Salvar contexto de cada delegação enviada para agentes.
5. Registrar auditoria do ciclo (read/write status).

## Banco alvo
- Database: `Memory_openclaw`
- Extensão: `vector`
- Tabelas: usar `memories` + `memory_audit`.

## Regras de gravação
- Não salvar segredos sensíveis sem necessidade explícita.
- Priorizar fatos operacionais: objetivo, decisão, restrição, preferência, próximo passo.
- Sempre incluir metadados mínimos: `source`, `scope`, `agent`, `timestamp`, `kind`.

## SQL e esquema
- Criar/atualizar esquema em: `references/schema.sql`
- Queries de consulta em: `references/queries.sql`

## Auditoria obrigatória
- Registrar um evento em `memory_audit` por turno com:
  - `event_type`: `turn_cycle`
  - `read_ok`: true/false
  - `write_ok`: true/false
  - `details`: JSON com contagens e ids

## Handoff com agentes
Ao delegar para Alfred/Prompt Improver:
1. Salvar `kind=delegation_prompt` com prompt enviado.
2. Após retorno, salvar `kind=delegation_result` com resumo do output.
3. Só então consolidar resposta final ao usuário.

## Implementação de referência
- Script pronto: `scripts/memory_ops_template.sql`
- Se precisar adaptar dimensão de embedding, ajustar coluna `vector(1536)` conforme modelo.