publico/.agent
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

ajustes de memoria

Browse source
This commit is contained in:
Luiz Silva 2026-06-22 23:18:20 -03:00
parent ba38329b87
commit 176946b7ef
12 changed files with 42 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

2
agents/ag-agente/persona
View file

@ -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)

2
agents/ag-arquiteto/persona
View file

@ -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)

2
agents/ag-back/persona
View file

@ -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

2
agents/ag-comercial/persona
View file

@ -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)

2
agents/ag-deploy/persona
View file

@ -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)

2
agents/ag-documentacao/persona
View file

@ -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)

2
agents/ag-front/persona
View file

@ -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

2
agents/ag-refatorar/persona
View file

@ -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)

2
agents/ag-testes/persona
View file

@ -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)

2
agents/ag-ux/persona
View file

@ -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)

5
global/rules/usar-memoria-persistente
View file

@ -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**.

30
global/skills/memoria-persistente/SKILL
View file

@ -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?