From 176946b7ef0838272f99c42b092056105ebfb57e Mon Sep 17 00:00:00 2001 From: Luiz Silva Date: Mon, 22 Jun 2026 23:18:20 -0300 Subject: [PATCH] ajustes de memoria --- agents/ag-agente/persona | 2 ++ agents/ag-arquiteto/persona | 2 ++ agents/ag-back/persona | 2 ++ agents/ag-comercial/persona | 2 ++ agents/ag-deploy/persona | 2 ++ agents/ag-documentacao/persona | 2 ++ agents/ag-front/persona | 2 ++ agents/ag-refatorar/persona | 2 ++ agents/ag-testes/persona | 2 ++ agents/ag-ux/persona | 2 ++ global/rules/usar-memoria-persistente | 5 ++++- global/skills/memoria-persistente/SKILL | 30 +++++++++++++++---------- 12 files changed, 42 insertions(+), 13 deletions(-) diff --git a/agents/ag-agente/persona b/agents/ag-agente/persona index 71514f3..5d3c0f5 100644 --- a/agents/ag-agente/persona +++ b/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) diff --git a/agents/ag-arquiteto/persona b/agents/ag-arquiteto/persona index 546cb0c..ee3e634 100644 --- a/agents/ag-arquiteto/persona +++ b/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) diff --git a/agents/ag-back/persona b/agents/ag-back/persona index 24f4bd1..3cd1ef7 100644 --- a/agents/ag-back/persona +++ b/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 diff --git a/agents/ag-comercial/persona b/agents/ag-comercial/persona index 543c85c..5e6a406 100644 --- a/agents/ag-comercial/persona +++ b/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) diff --git a/agents/ag-deploy/persona b/agents/ag-deploy/persona index 131a574..a86a9d9 100644 --- a/agents/ag-deploy/persona +++ b/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) diff --git a/agents/ag-documentacao/persona b/agents/ag-documentacao/persona index 895041f..5e868b4 100644 --- a/agents/ag-documentacao/persona +++ b/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) diff --git a/agents/ag-front/persona b/agents/ag-front/persona index 53da5c4..39c6982 100644 --- a/agents/ag-front/persona +++ b/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 diff --git a/agents/ag-refatorar/persona b/agents/ag-refatorar/persona index 3939b97..9049bd1 100644 --- a/agents/ag-refatorar/persona +++ b/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) diff --git a/agents/ag-testes/persona b/agents/ag-testes/persona index 9b12e80..6176f7f 100644 --- a/agents/ag-testes/persona +++ b/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) diff --git a/agents/ag-ux/persona b/agents/ag-ux/persona index 100e5db..e75c105 100644 --- a/agents/ag-ux/persona +++ b/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) diff --git a/global/rules/usar-memoria-persistente b/global/rules/usar-memoria-persistente index 001f5bf..763d86d 100644 --- a/global/rules/usar-memoria-persistente +++ b/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**. diff --git a/global/skills/memoria-persistente/SKILL b/global/skills/memoria-persistente/SKILL index c2d32ff..48f80f1 100644 --- a/global/skills/memoria-persistente/SKILL +++ b/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?