73 lines
2.2 KiB
Text
73 lines
2.2 KiB
Text
---
|
|
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`
|