melhoria de colera de memorias
This commit is contained in:
parent
f3c9e7b60c
commit
b0bb8b00ac
3 changed files with 178 additions and 1 deletions
|
|
@ -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`
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue