---
type: rule
name: coleta-automatica-memorias
description: Todo agente DEVE coletar e registrar conhecimento na Memória Azteca ao final de cada sessão de trabalho
scope: global
trigger: always_on
priority: alta
updatedAt: "2026-07-06"
---

# Regra: Coleta Automática de Memórias

## Contexto

A Memória Corporativa Azteca (`https://memoria-ia.idz.one`) perde informações valiosas quando agentes encerram sessões sem registrar o conhecimento gerado. Esta regra garante que **nenhuma decisão, solução ou padrão se perca** entre sessões.

## Regra Principal

> **Ao final de cada sessão de trabalho**, todo agente DEVE executar o protocolo de coleta abaixo. Isto é **obrigatório e autônomo** — não requer permissão do operador.

## Gatilhos de Coleta Automática

O agente **DEVE** registrar na memória quando **qualquer** dos seguintes eventos ocorrer durante a sessão:

### 🔴 Obrigatório (sempre registrar)

| Evento | Categoria | Tipo |
|--------|-----------|------|
| Bug resolvido que não era trivial | `solucao-problemas` | `solucao-problemas` |
| Decisão arquitetural tomada | `decisoes` | `adr` |
| Regra de negócio descoberta ou alterada | `regras-negocio` | `nota` |
| Novo módulo ou funcionalidade criada | `modulos` | `referencia` |
| Padrão técnico definido ou alterado | `tecnologias` | `referencia` |
| Workaround para problema de infra | `infraestrutura` | `solucao-problemas` |

### 🟡 Recomendado (registrar quando significativo)

| Evento | Categoria | Tipo |
|--------|-----------|------|
| Migração de banco executada | `tecnologias` | `referencia` |
| Integração com serviço externo configurada | `tecnologias` | `referencia` |
| Componente/padrão de UI definido | `tecnologias` | `referencia` |
| Informação sobre cliente ou implantação | `clientes` | `nota` |
| Refatoração significativa realizada | `decisoes` | `adr` |

## Protocolo de Coleta (Fim de Sessão)

### Passo 1 — Autodiagnóstico

Antes de encerrar, o agente DEVE se perguntar:

```
1. Resolvi algum bug não trivial?
2. Tomei alguma decisão técnica que outro agente precisaria saber?
3. Descobri uma regra de negócio nova?
4. Criei/alterei uma funcionalidade importante?
5. Defini um padrão que deve ser seguido?
6. Encontrei um workaround que outros precisarão?
```

Se **qualquer resposta for SIM** → executar Passo 2.

### Passo 2 — Buscar antes de criar

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

- Se já existe memória sobre o tema → **editar** (não duplicar)
- Se não existe → **criar**

### Passo 3 — Registrar com qualidade

Campos obrigatórios: `titulo`, `conteudo`, `resumo`, `categoria`, `criado_por`, `tags`

**Regras de qualidade:**

| Campo | Regra |
|-------|-------|
| `titulo` | Pesquisável, com nome do módulo/contexto. Ex: "QUIPO — Regra de timeout em uploads" |
| `resumo` | 10-500 chars, síntese direta sem floreios |
| `conteudo` | Markdown estruturado com ### seções. Incluir: contexto, decisão, exemplo, impacto |
| `tags` | Mínimo 3 tags relevantes. Incluir nome do módulo/projeto |
| `criado_por` | Handle do agente com @ (ex: `@ag-back`) |
| `contexto` | Nome do projeto/módulo (ex: `QUIPO-PORTAL3`) |

### Passo 4 — Vincular memórias relacionadas

Após criar, verificar se existem memórias que devem ser vinculadas:

```bash
curl -s -X POST "https://memoria-ia.idz.one/api/vinculos/criar" \
  -H 'Content-Type: application/json' \
  -H "CHAVE: banana" \
  -d '{
    "codigo_memoria_a": CODIGO_NOVA,
    "codigo_memoria_b": CODIGO_EXISTENTE,
    "relacao": "{mem:CODIGO_NOVA} complementa/expande/resolve {mem:CODIGO_EXISTENTE}",
    "criado_por": "@HANDLE"
  }'
```

## Regra de Ouro

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

## Anti-padrões (PROIBIDO)

- ❌ Encerrar sessão com conhecimento não registrado
- ❌ Registrar sem `resumo` ou sem `tags`
- ❌ Criar memória sem buscar duplicatas antes
- ❌ Usar `criado_por` sem o prefixo `@`
- ❌ Registrar código-fonte (já está no repositório)
- ❌ Registrar dados sensíveis (senhas, tokens, dados pessoais)

## Impacto

Sem esta regra, **a auditoria de 2026-07-06 revelou que 6+ conversas significativas (tradução i18n, autenticação, build timestamps) não geraram nenhuma memória**. Esta regra previne perdas futuras.

## Referências

- Skill: `global/skills/memoria-persistente/SKILL`
- Rule: `global/rules/usar-memoria-persistente`
- Workflow: `global/workflows/aprimorar-IA`
