127 lines
4.6 KiB
Text
127 lines
4.6 KiB
Text
---
|
|
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`
|