Memory Ops

---
name: memory-ops
description: "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."
---


# 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.