melhoria de colera de memorias

This commit is contained in:
Luiz Silva 2026-07-07 08:49:20 -03:00
parent f3c9e7b60c
commit b0bb8b00ac
3 changed files with 178 additions and 1 deletions

View file

@ -197,11 +197,57 @@ Exemplos de skills de projeto:
## 5️⃣ Atualização da Memória (Obrigatória quando aplicável)
### 5A — Memória Local (arquivos)
Sempre que decisões críticas sobre a arquitetura da aplicação ou o contexto do domínio precisarem ser arquivadas temporária ou permanentemente de maneira descritiva (e não diretamente injetável em código ou regra de lint):
* Registre o novo documento no formato adequado mantendo a pasta limpa em `.agent/memoria/`.
* Exemplo: Manter diário de pendências (`diario-pendencias-modulo-x`) ou ADR (`adr-001-migracao-nuxt-4`).
* Atenção! Tudo que puder ser abstraído para formato técnico estrito deve virar **Skill** ou **Rule**. Use a Memória apenas como extensão de base factual.
* Atenção! Tudo que puder ser abstraído para formato técnico estrito deve virar **Skill** ou **Rule**. Use a Memória local apenas como extensão de base factual.
### 5B — Memória Corporativa (API Azteca — OBRIGATÓRIO)
**Todo conhecimento gerado durante a sessão DEVE ser registrado na Memória Corporativa** (`https://memoria-ia.idz.one`) seguindo a rule `global/rules/coleta-automatica-memorias`.
#### Gatilhos automáticos de registro:
| Evento na sessão | Categoria | Tipo | Registrar? |
|-------------------|-----------|------|:---:|
| Bug resolvido não trivial | `solucao-problemas` | `solucao-problemas` | 🔴 Obrigatório |
| Decisão arquitetural tomada | `decisoes` | `adr` | 🔴 Obrigatório |
| Regra de negócio descoberta/alterada | `regras-negocio` | `nota` | 🔴 Obrigatório |
| Novo módulo ou funcionalidade | `modulos` | `referencia` | 🔴 Obrigatório |
| Padrão técnico definido/alterado | `tecnologias` | `referencia` | 🔴 Obrigatório |
| Migração de banco executada | `tecnologias` | `referencia` | 🟡 Recomendado |
| Componente/padrão de UI definido | `tecnologias` | `referencia` | 🟡 Recomendado |
| Refatoração significativa | `decisoes` | `adr` | 🟡 Recomendado |
#### Protocolo:
1. **Buscar antes de criar** — evitar duplicatas (`POST /api/busca`)
2. **Criar com qualidade** — `titulo` pesquisável, `resumo` obrigatório, mínimo 3 `tags`, `criado_por` com @
3. **Vincular** — relacionar com memórias existentes via `/api/vinculos/criar`
4. **Contextualizar** — preencher `contexto` com nome do projeto/módulo
#### Exemplo de registro automático:
```bash
curl -s -X POST "https://memoria-ia.idz.one/api/memorias/criar" \
-H 'Content-Type: application/json' \
-H "CHAVE: banana" \
-d '{
"titulo": "MODULO — Descrição clara do que foi feito/decidido",
"conteudo": "### Contexto\n...\n### Decisão\n...\n### Impacto\n...",
"resumo": "Síntese curta e pesquisável (10-500 chars)",
"categoria": "CATEGORIA",
"tipo": "TIPO",
"tags": ["modulo", "tag2", "tag3"],
"contexto": "NOME-DO-PROJETO",
"criado_por": "@HANDLE_DO_AGENTE"
}'
```
> ⚠️ **Anti-padrão:** Encerrar sessão do workflow `aprimorar-IA` sem ter registrado na Memória Corporativa é considerado **trabalho incompleto**.
---
@ -251,6 +297,9 @@ Só é permitido encerrar se TODOS forem verdadeiros:
* [ ] Referências cruzadas estão válidas
* [ ] Estrutura está organizada por assunto
* [ ] Skills referenciam (não duplicam) rules
* [ ] **Conhecimento da sessão foi registrado na Memória Corporativa** (API Azteca)
* [ ] **Memórias criadas possuem `resumo`, `tags` (≥3) e `criado_por` com @**
* [ ] **Memórias relacionadas foram vinculadas** via `/api/vinculos/criar`
---