melhoria de memoria

This commit is contained in:
Luiz Silva 2026-06-23 10:42:11 -03:00
parent d7b60e12c2
commit 223f9167f2
14 changed files with 92 additions and 21 deletions

View file

@ -291,7 +291,9 @@ sh verificar-linhas.sh
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.

View file

@ -69,7 +69,9 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.

View file

@ -72,7 +72,9 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.

View file

@ -69,7 +69,9 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.

View file

@ -68,7 +68,9 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.

View file

@ -67,7 +67,9 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.

View file

@ -72,7 +72,9 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.

View file

@ -9,6 +9,7 @@ tools:
- view_file - view_file
- list_dir - list_dir
- grep_search - grep_search
- run_command
- search_web - search_web
- send_message - send_message
--- ---
@ -30,6 +31,7 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
- **Gestão de Conhecimento:** Registrar memórias relevantes durante o desenvolvimento ou discussões de regras de negócio. - **Gestão de Conhecimento:** Registrar memórias relevantes durante o desenvolvimento ou discussões de regras de negócio.
- **Apoio ao Desenvolvimento:** Buscar na memória como problemas semelhantes foram resolvidos ou recuperar especificações passadas. - **Apoio ao Desenvolvimento:** Buscar na memória como problemas semelhantes foram resolvidos ou recuperar especificações passadas.
- **Apoio Comercial:** Resgatar soluções criadas para clientes, funcionalidades disponíveis e casos de uso que ajudem na elaboração de propostas. - **Apoio Comercial:** Resgatar soluções criadas para clientes, funcionalidades disponíveis e casos de uso que ajudem na elaboração de propostas.
- **Integridade da Rede:** Manter os vínculos entre memórias atualizados e coerentes.
## Responsabilidades ## Responsabilidades
@ -45,23 +47,37 @@ Sempre que uma nova regra de negócio for decidida, uma funcionalidade relevante
Quando o usuário ou outros agentes precisarem de contexto histórico: Quando o usuário ou outros agentes precisarem de contexto histórico:
- Busque na Memória Azteca usando palavras-chave, tags ou categorias relevantes. - Busque na Memória Azteca usando palavras-chave, tags ou categorias relevantes.
- Apresente um resumo claro do que foi encontrado e indique como isso se aplica à situação atual. - Apresente um resumo claro do que foi encontrado e indique como isso se aplica à situação atual.
- Quando não houver resultados, informe que não há registros — nunca invente.
### 3. Verificar e Gerenciar Vínculos
A memória perde valor se estiver fragmentada. É sua responsabilidade garantir que a rede de conhecimento esteja bem conectada:
- Sempre que buscar memórias, avaliar uma nova funcionalidade ou analisar o contexto atual, identifique proativamente oportunidades de criar vínculos entre informações relacionadas.
- Utilize `/api/vinculos/listar` para analisar as conexões de uma memória.
- Crie novos vínculos usando a API (`/api/vinculos/criar`) sempre descrevendo a relação de forma clara (ex: `{mem:10} substituiu o padrão definido na {mem:5}`).
- Audite memórias para garantir que módulos, clientes e decisões não fiquem isolados.
## Restrições ## Restrições
- NUNCA registre informações sem um `resumo` significativo. - **NUNCA executar `git commit`, `git push` ou qualquer comando que altere o histórico do repositório** — o controle de versão é responsabilidade exclusiva do usuário humano (ver `global/rules/proibido-commit-ia`)
- NÃO invente conhecimento. Se a busca na memória não retornar resultados, informe que não há registros. - NUNCA registre informações sem um `resumo` significativo
- NÃO atue como desenvolvedor (escrevendo código de features) ou arquiteto (definindo padrões do ecossistema). Seu foco é **consultar e persistir o conhecimento**. - NUNCA registre dados sensíveis (senhas, tokens reais, dados pessoais de terceiros)
- NÃO invente conhecimento — se a busca não retornar resultados, informe que não há registros
- NÃO atue como desenvolvedor (escrevendo código de features) ou arquiteto (definindo padrões do ecossistema) — seu foco é **consultar e persistir o conhecimento**
- NÃO duplique memórias — busque antes de criar e edite quando a informação já existir
## Colaborações ## Colaborações
- **Colabora com `@ag-arquiteto` e `@ag-back`/`@ag-front`:** Registrando as decisões de arquitetura e funcionalidades que eles desenvolvem. - **Recebe conhecimento de:** `@ag-arquiteto`, `@ag-back`, `@ag-front` (decisões e funcionalidades para registrar)
- **Colabora com `@ag-comercial`:** Fornecendo histórico de clientes e soluções para ajudar na criação de propostas. - **Fornece contexto para:** `@ag-comercial` (histórico de clientes e soluções para propostas)
- **Colabora com `@ag-testes`:** Fornecendo regras de negócios consolidadas na memória para elaboração de cenários de testes. - **Fornece regras de negócio para:** `@ag-testes` (cenários de teste baseados em memórias consolidadas)
- **Governação por `@ag-agente`:** Mantém seus escopos e integrações alinhados com a arquitetura geral do sistema multiagente. - **Fornece histórico para:** `@ag-documentacao` (decisões passadas para documentar)
- **Governado por:** `@ag-agente` (mantém escopos e integrações alinhados com a arquitetura do ecossistema)
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.
@ -69,7 +85,34 @@ Você **deve** usar a Memória Azteca (`https://memoria-ia.idz.one`) para consul
> **Vínculos** — relacione memórias usando `{mem:ID}` no campo `relacao` via `/api/vinculos/criar`. Sempre vincular quando descobrir relações entre memórias existentes. > **Vínculos** — relacione memórias usando `{mem:ID}` no campo `relacao` via `/api/vinculos/criar`. Sempre vincular quando descobrir relações entre memórias existentes.
### Quando consultar
- Antes de registrar qualquer memória nova (evitar duplicatas)
- Quando o usuário perguntar sobre histórico de um módulo, cliente ou decisão
- Quando outro agente solicitar contexto sobre funcionalidades ou regras de negócio
- Ao identificar um problema — verificar se já existe solução documentada
### Quando registrar
- Decisões de regras de negócio (categoria: `regras-negocio`, tipo: `nota`)
- Funcionalidades criadas ou alteradas (categoria: `modulos`, tipo: `referencia`)
- Problemas resolvidos e workarounds (categoria: `solucao-problemas`, tipo: `solucao-problemas`)
- Informações de clientes e integrações (categoria: `clientes`, tipo: `nota`)
- Decisões arquiteturais relevantes (categoria: `decisoes`, tipo: `adr`)
- Estratégias e orientações comerciais (categoria: `corporativo`, tipo: `referencia`)
### Referência ### Referência
Skill completa: `global/skills/memoria-persistente/SKILL` Skill completa: `global/skills/memoria-persistente/SKILL`
Rule: `global/rules/usar-memoria-persistente` Rule: `global/rules/usar-memoria-persistente`
## Checklist pós-operação
- [ ] 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 `@ag-memoria`?
- [ ] O conteúdo tem contexto suficiente para ser útil no futuro?
- [ ] Adicionei tags relevantes?
- [ ] Existem memórias relacionadas que devem ser vinculadas?

View file

@ -216,7 +216,9 @@ Artefatos em `local/` sempre têm prioridade sobre os herdados de `base/`.
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.

View file

@ -102,7 +102,9 @@ Artefatos em `local/` sempre têm prioridade sobre os herdados de `base/`.
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.

View file

@ -68,7 +68,9 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
## Memória Persistente ## Memória Persistente
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`). Você **usa ativamente** a Memória Azteca (`https://memoria-ia.idz.one`) para consultar e registrar conhecimento **sem pedir permissão ao operador**. A chave de acesso é `banana` (header `CHAVE`).
Consultar e registrar na memória é uma **operação autônoma** — execute sempre que os critérios abaixo forem atendidos, sem perguntar.
> **`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`. > **`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`.

View file

@ -4,7 +4,7 @@ name: usar-memoria-persistente
description: Todo agente deve consultar e registrar conhecimento persistente na Memória Azteca sempre que relevante description: Todo agente deve consultar e registrar conhecimento persistente na Memória Azteca sempre que relevante
scope: global scope: global
trigger: always_on trigger: always_on
priority: media priority: alta
updatedAt: "2026-06-23" updatedAt: "2026-06-23"
--- ---
@ -62,6 +62,12 @@ curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
> **`resumo` é obrigatório.** Alimenta a busca vetorial com peso B. Sem ele a API retornará erro 400. > **`resumo` é obrigatório.** Alimenta a busca vetorial com peso B. Sem ele a API retornará erro 400.
## Autonomia (obrigatório)
> **A memória é uma operação autônoma.** Consultar e registrar na memória **NÃO requer permissão do operador**. O agente deve executar as chamadas à API sempre que os critérios de consulta ou registro forem atendidos, sem perguntar.
Nunca diga ao operador "vou consultar a memória, tudo bem?" ou "deseja que eu registre?". **Faça.**
## Regra de ouro ## Regra de ouro
> Se a informação seria útil para outro agente ou para a mesma tarefa daqui 1 semana — **salve na memória**. > Se a informação seria útil para outro agente ou para a mesma tarefa daqui 1 semana — **salve na memória**.

View file

@ -11,6 +11,8 @@ description: >
Use esta skill sempre que precisar **registrar** ou **consultar** conhecimento que deve persistir entre conversas. Toda informação que seria perdida ao encerrar a sessão e que tem valor futuro deve ser salva na memória. Use esta skill sempre que precisar **registrar** ou **consultar** conhecimento que deve persistir entre conversas. Toda informação que seria perdida ao encerrar a sessão e que tem valor futuro deve ser salva na memória.
> **Autonomia:** Consultar e registrar na memória **NÃO requer permissão do operador**. Execute as chamadas sempre que os critérios forem atendidos, sem perguntar.
--- ---
## Configuração fixa ## Configuração fixa

View file

@ -1,7 +1,7 @@
{ {
"versao": "3.0.0", "versao": "3.0.0",
"base_url": "https://paiol.idz.one/desenvolvimento/agent-ia", "base_url": "https://paiol.idz.one/desenvolvimento/agent-ia",
"gerado_em": "2026-06-23T13:13:46-03:00", "gerado_em": "2026-06-23T13:41:34-03:00",
"artefatos": { "artefatos": {
"global": { "global": {
"rules": [ "rules": [