ajustes de memoria

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 |
-| `conteudo` | Corpo completo do conhecimento |
+| `titulo` | Nome claro e pesquisável da memória (min 3, max 300) |
+| `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` |
-| `tags` | Array de strings para facilitar busca |
+| `tipo` | Tipo da memória: `nota`, `adr`, `solucao-problemas`, `referencia`, `procedimento` (default: `nota`) |
+| `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
-4. **Tags relevantes** — facilitar buscas futuras por contexto
-5. **Conteúdo rico** — incluir contexto, decisão, motivo e exemplos quando possível
-6. **Atualizar, não duplicar** — se a memória já existe, usar editar em vez de criar nova
-7. **Pipe com jq** — para leitura limpa, adicionar `| jq .` ao final do curl
+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. **Identificar o autor** — sempre preencher `criado_por` com o handle do agente
+5. **Tags relevantes** — facilitar buscas futuras por contexto e filtragem por tags
+6. **Conteúdo rico** — incluir contexto, decisão, motivo e exemplos quando possível
+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?