memoria

global/rules/usar-memoria-persistente

@@ -0,0 +1,73 @@
+---
+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`