---
type: rule
name: usar-memoria-persistente
description: Todo agente deve consultar e registrar conhecimento persistente na Memória Azteca sempre que relevante
scope: global
trigger: always_on
priority: media
updatedAt: "2026-06-22"
---

# Regra: Usar Memória Persistente

## Contexto

O ecossistema Azteca possui uma memória centralizada em `https://memoria-ia.idz.one` acessível por todos os agentes via API REST. Informações descobertas durante o trabalho se perdem entre sessões se não forem registradas.

## Quando consultar a memória

O agente **deve** buscar na memória antes de:

- Tomar decisões arquiteturais (verificar se já existe ADR sobre o tema)
- Resolver um bug (verificar se já existe solução documentada)
- Implementar um padrão novo (verificar se já existe padrão definido)
- Trabalhar em módulo que não conhece (buscar contexto do módulo)

```bash
curl -s -X POST "https://memoria-ia.idz.one/api/busca" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: banana" \
  -d '{"termo": "PALAVRA_CHAVE"}' | jq .
```

## Quando registrar na memória

O agente **deve** salvar na memória quando:

- Toma uma decisão arquitetural significativa
- Descobre e resolve um bug não trivial
- Define ou altera um padrão técnico
- Descobre uma regra de negócio nova
- Encontra um workaround para problema de infraestrutura
- Qualquer conhecimento que beneficiaria sessões futuras

## Como registrar

Usar a skill `global/skills/memoria-persistente/SKILL` para o protocolo completo.

**Mínimo obrigatório:**

```bash
curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: banana" \
  -d '{
    "titulo": "Descrição clara e pesquisável",
    "conteudo": "Detalhes completos com contexto",
    "categoria": "CATEGORIA",
    "criado_por": "@HANDLE_DO_AGENTE"
  }'
```

## Regra de ouro

> Se a informação seria útil para outro agente ou para a mesma tarefa daqui 1 semana — **salve na memória**.

## Impacto

Sem esta regra, cada sessão começa do zero. Com ela, o ecossistema acumula conhecimento e fica mais inteligente a cada interação.

## Referências

- Skill: `global/skills/memoria-persistente/SKILL`
- API: `https://memoria-ia.idz.one`
