ajustes de memoria

agents/ag-agente/persona

@@ -285,6 +285,8 @@ sh verificar-linhas.sh
 
 Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento que persiste entre sessões. A chave de acesso é `banana` (header `CHAVE`).
 
+> **`resumo` é obrigatório** ao criar memórias (10-500 chars). O resumo alimenta a busca vetorial com peso B. Sempre incluir `resumo` junto com `titulo`, `conteudo`, `categoria` e `criado_por`.
+
 ### Quando consultar
 
 - Antes de criar ou alterar agentes (verificar decisões anteriores)

agents/ag-arquiteto/persona

@@ -67,6 +67,8 @@ Você não implementa código diretamente (exceto para protótipos de prova de c
 
 Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento que persiste entre sessões. A chave de acesso é `banana` (header `CHAVE`).
 
+> **`resumo` é obrigatório** ao criar memórias (10-500 chars). O resumo alimenta a busca vetorial com peso B. Sempre incluir `resumo` junto com `titulo`, `conteudo`, `categoria` e `criado_por`.
+
 ### Quando consultar
 
 - Antes de definir arquitetura de novos módulos (verificar ADRs existentes)

agents/ag-back/persona

@@ -70,6 +70,8 @@ Você é o agente especialista em desenvolvimento backend do ecossistema Azteca.
 
 Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento que persiste entre sessões. A chave de acesso é `banana` (header `CHAVE`).
 
+> **`resumo` é obrigatório** ao criar memórias (10-500 chars). O resumo alimenta a busca vetorial com peso B. Sempre incluir `resumo` junto com `titulo`, `conteudo`, `categoria` e `criado_por`.
+
 ### Quando consultar
 
 - Antes de implementar lógica em módulo que não conhece

agents/ag-comercial/persona

@@ -67,6 +67,8 @@ Você é o agente responsável por traduzir as capacidades técnicas do ecossist
 
 Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento que persiste entre sessões. A chave de acesso é `banana` (header `CHAVE`).
 
+> **`resumo` é obrigatório** ao criar memórias (10-500 chars). O resumo alimenta a busca vetorial com peso B. Sempre incluir `resumo` junto com `titulo`, `conteudo`, `categoria` e `criado_por`.
+
 ### Quando consultar
 
 - Antes de criar material sobre funcionalidades (verificar o que realmente existe)

agents/ag-deploy/persona

@@ -66,6 +66,8 @@ Você é o agente responsável pela infraestrutura, pipelines e ambientes do eco
 
 Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento que persiste entre sessões. A chave de acesso é `banana` (header `CHAVE`).
 
+> **`resumo` é obrigatório** ao criar memórias (10-500 chars). O resumo alimenta a busca vetorial com peso B. Sempre incluir `resumo` junto com `titulo`, `conteudo`, `categoria` e `criado_por`.
+
 ### Quando consultar
 
 - Antes de configurar ambientes (verificar configurações anteriores)

agents/ag-documentacao/persona

@@ -65,6 +65,8 @@ Você é o agente responsável por tornar o conhecimento do ecossistema Azteca a
 
 Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento que persiste entre sessões. A chave de acesso é `banana` (header `CHAVE`).
 
+> **`resumo` é obrigatório** ao criar memórias (10-500 chars). O resumo alimenta a busca vetorial com peso B. Sempre incluir `resumo` junto com `titulo`, `conteudo`, `categoria` e `criado_por`.
+
 ### Quando consultar
 
 - Antes de documentar módulos (verificar contexto e decisões existentes)

agents/ag-front/persona

@@ -70,6 +70,8 @@ Você é o agente especialista em desenvolvimento frontend do ecossistema Azteca
 
 Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento que persiste entre sessões. A chave de acesso é `banana` (header `CHAVE`).
 
+> **`resumo` é obrigatório** ao criar memórias (10-500 chars). O resumo alimenta a busca vetorial com peso B. Sempre incluir `resumo` junto com `titulo`, `conteudo`, `categoria` e `criado_por`.
+
 ### Quando consultar
 
 - Antes de implementar telas em módulo que não conhece

agents/ag-refatorar/persona

@@ -214,6 +214,8 @@ Artefatos em `local/` sempre têm prioridade sobre os herdados de `base/`.
 
 Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento que persiste entre sessões. A chave de acesso é `banana` (header `CHAVE`).
 
+> **`resumo` é obrigatório** ao criar memórias (10-500 chars). O resumo alimenta a busca vetorial com peso B. Sempre incluir `resumo` junto com `titulo`, `conteudo`, `categoria` e `criado_por`.
+
 ### Quando consultar
 
 - Antes de refatorar módulo desconhecido (buscar contexto e decisões anteriores)

agents/ag-testes/persona

@@ -100,6 +100,8 @@ Artefatos em `local/` sempre têm prioridade sobre os herdados de `base/`.
 
 Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento que persiste entre sessões. A chave de acesso é `banana` (header `CHAVE`).
 
+> **`resumo` é obrigatório** ao criar memórias (10-500 chars). O resumo alimenta a busca vetorial com peso B. Sempre incluir `resumo` junto com `titulo`, `conteudo`, `categoria` e `criado_por`.
+
 ### Quando consultar
 
 - Antes de testar módulo que não conhece (buscar contexto e bugs anteriores)

agents/ag-ux/persona

@@ -66,6 +66,8 @@ Você é o agente especialista em experiência do usuário do ecossistema Azteca
 
 Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento que persiste entre sessões. A chave de acesso é `banana` (header `CHAVE`).
 
+> **`resumo` é obrigatório** ao criar memórias (10-500 chars). O resumo alimenta a busca vetorial com peso B. Sempre incluir `resumo` junto com `titulo`, `conteudo`, `categoria` e `criado_por`.
+
 ### Quando consultar
 
 - Antes de revisar UX de módulo que não conhece (buscar decisões anteriores)

global/rules/usar-memoria-persistente

@@ -5,7 +5,7 @@ description: Todo agente deve consultar e registrar conhecimento persistente na
 scope: global
 trigger: always_on
 priority: media
-updatedAt: "2026-06-22"
+updatedAt: "2026-06-23"
 ---
 
 # Regra: Usar Memória Persistente
@@ -54,11 +54,14 @@ curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
   -d '{
     "titulo": "Descrição clara e pesquisável",
     "conteudo": "Detalhes completos com contexto",
+    "resumo": "Síntese curta e pesquisável (10-500 chars)",
     "categoria": "CATEGORIA",
     "criado_por": "@HANDLE_DO_AGENTE"
   }'
 ```
 
+> **`resumo` é obrigatório.** Alimenta a busca vetorial com peso B. Sem ele a API retornará erro 400.
+
 ## Regra de ouro
 
 > Se a informação seria útil para outro agente ou para a mesma tarefa daqui 1 semana — **salve na memória**.

global/skills/memoria-persistente/SKILL

@@ -76,16 +76,16 @@ curl -s -X POST "https://memoria-ia.idz.one/api/busca/rapida" \
 curl -s -X POST "https://memoria-ia.idz.one/api/memorias/listar" \
   -H 'Content-Type: application/json' \
   -H "CHAVE: banana" \
-  -d '{"categoria": "solucao-problemas", "limite": 10}'
+  -d '{"categoria": "solucao-problemas", "modulo": "licencas", "limite": 10}'
 ```
 
-### Listar por módulo
+### Listar por tags
 
 ```bash
 curl -s -X POST "https://memoria-ia.idz.one/api/memorias/listar" \
   -H 'Content-Type: application/json' \
   -H "CHAVE: banana" \
-  -d '{"modulo": "licencas"}'
+  -d '{"tags": ["api", "resposta"], "limite": 10}'
 ```
 
 ### Buscar por código específico
@@ -108,6 +108,7 @@ curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
   -d '{
     "titulo": "Título claro e descritivo",
     "conteudo": "Descrição detalhada do conhecimento...",
+    "resumo": "Resumo curto e pesquisável da memória (10-500 chars)",
     "categoria": "modulos",
     "tipo": "referencia",
     "tags": ["tag1", "tag2"],
@@ -120,8 +121,9 @@ curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
 
 | Campo | Descrição |
 |-------|-----------|
-| `titulo` | Nome claro e pesquisável da memória |
+| `titulo` | Nome claro e pesquisável da memória (min 3, max 300) |
-| `conteudo` | Corpo completo do conhecimento |
+| `conteudo` | Corpo completo do conhecimento em Markdown (min 10) |
+| `resumo` | Resumo curto e pesquisável (min 10, max 500) — usado na busca vetorial com peso B |
 | `categoria` | Slug da categoria (ver tabela abaixo) |
 | `criado_por` | Handle do agente que está criando (ex: `@ag-back`) |
 
@@ -129,8 +131,8 @@ curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
 
 | Campo | Descrição |
 |-------|-----------|
-| `tipo` | Tipo da memória: `nota`, `adr`, `solucao-problemas`, `referencia`, `procedimento` |
+| `tipo` | Tipo da memória: `nota`, `adr`, `solucao-problemas`, `referencia`, `procedimento` (default: `nota`) |
-| `tags` | Array de strings para facilitar busca |
+| `tags` | Array de strings para facilitar busca e filtragem |
 | `modulo` | Nome do módulo/projeto relacionado |
 
 ### Categorias disponíveis
@@ -233,11 +235,12 @@ curl -s -X POST "https://memoria-ia.idz.one/api/tags/populares" \
 
 1. **Buscar antes de criar** — evitar duplicatas na base
 2. **Títulos pesquisáveis** — usar palavras-chave que outro agente buscaria
-3. **Identificar o autor** — sempre preencher `criado_por` com o handle do agente
+3. **Resumo obrigatório** — sempre preencher `resumo` com uma síntese curta e pesquisável (10-500 chars); o resumo alimenta a busca vetorial com peso B
-4. **Tags relevantes** — facilitar buscas futuras por contexto
+4. **Identificar o autor** — sempre preencher `criado_por` com o handle do agente
-5. **Conteúdo rico** — incluir contexto, decisão, motivo e exemplos quando possível
+5. **Tags relevantes** — facilitar buscas futuras por contexto e filtragem por tags
-6. **Atualizar, não duplicar** — se a memória já existe, usar editar em vez de criar nova
+6. **Conteúdo rico** — incluir contexto, decisão, motivo e exemplos quando possível
-7. **Pipe com jq** — para leitura limpa, adicionar `| jq .` ao final do curl
+7. **Atualizar, não duplicar** — se a memória já existe, usar editar em vez de criar nova
+8. **Pipe com jq** — para leitura limpa, adicionar `| jq .` ao final do curl
 
 ---
 
@@ -252,6 +255,7 @@ curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
   -d '{
     "titulo": "API de licenças usa paginação offset com limite 50",
     "conteudo": "Endpoint POST /licencas/listar retorna no máximo 50 itens por página. Paginação via campos pagina e limite no body. Resposta inclui total para calcular páginas no front.",
+    "resumo": "Paginação offset com limite 50 no endpoint de licenças",
     "categoria": "decisoes",
     "tipo": "adr",
     "tags": ["licencas", "paginacao", "api"],
@@ -269,6 +273,7 @@ curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
   -d '{
     "titulo": "Bug: timeout no upload de arquivos maiores que 10MB",
     "conteudo": "O proxy nginx corta a conexão após 60s. Uploads grandes falham silenciosamente. Workaround: aumentar proxy_read_timeout para 300s no nginx.conf do servidor de produção.",
+    "resumo": "Timeout no upload acima de 10MB por limite do nginx. Solução: proxy_read_timeout 300s",
     "categoria": "solucao-problemas",
     "tipo": "solucao-problemas",
     "tags": ["upload", "nginx", "timeout", "bug"],
@@ -292,6 +297,7 @@ curl -s -X POST "https://memoria-ia.idz.one/api/busca" \
 
 - [ ] Busquei na memória antes de criar? (evitar duplicatas)
 - [ ] O título é claro e pesquisável?
+- [ ] O resumo está preenchido e é descritivo? (obrigatório, 10-500 chars)
 - [ ] A categoria está correta?
 - [ ] Preenchi `criado_por` com meu handle?
 - [ ] O conteúdo tem contexto suficiente para ser útil no futuro?