melhorias no agent

This commit is contained in:
Luiz Silva 2026-09-05 09:36:01 -03:00
parent d0e6567652
commit df68976703
17 changed files with 171 additions and 40 deletions

View file

@ -16,10 +16,22 @@ Atalho rápido para o **Agente de Documentação & Memória** cobrindo os 6 pila
- `3. Wiki Usuário` $\rightarrow$ `<base_projeto>/../wiki/<modulo>/` (VitePress com acesso dos usuários)
- `4. Wiki Dev` $\rightarrow$ `<base_projeto>/../wiki/dev/<modulo>/` (VitePress com acesso interno dev e regras `{modulo}.regras-negocio.md`)
- `5. Rota IA` $\rightarrow$ Rota do backend `/llm.md`
- `6. Memória IA` $\rightarrow$ `<base_projeto>/memorias-ia/`
- `6. Memória IA` $\rightarrow$ `<base_projeto>/memorias-ia/` (gera `sessao-AAAA-MM-DD-slug.md` e indexa no arquivo central `historico-acoes.md`)
---
## 🧠 Pilar 6: Memória da IA e Histórico de Ações (`memorias-ia/`)
Ao documentar a sessão (seja via `/doc` ou `/documentacao`):
1. **Arquivo da Sessão:** O agente gera o registro detalhado em `<base_projeto>/memorias-ia/sessao-AAAA-MM-DD-slug.md` descrevendo contexto, causa raiz, solução técnica, citações no código-fonte e validações.
2. **Índice de Ações (`historico-acoes.md`):** O agente registra/atualiza a linha correspondente na tabela de `<base_projeto>/memorias-ia/historico-acoes.md`:
```markdown
| Data | Memória / Ação | Arquivo Memoria | Citações no Código-Fonte |
| :--- | :--- | :--- | :--- |
| **AAAA-MM-DD** | [Descrição da Ação] | [`sessao-AAAA-MM-DD-slug.md`](./sessao-AAAA-MM-DD-slug.md) | `caminho/arquivo.ts`<br>`outro/arquivo.vue` |
```
## 🔄 Versionamento Git Obrigatório da Wiki (`<base_projeto>/../wiki`)
Sempre que a documentação na Wiki (Pilares 3 e 4) for alterada ou criada:

View file

@ -16,10 +16,22 @@ Atalho rápido para o **Agente de Documentação & Memória** cobrindo os 6 pila
- `3. Wiki Usuário` $\rightarrow$ `<base_projeto>/../wiki/<modulo>/` (VitePress com acesso dos usuários)
- `4. Wiki Dev` $\rightarrow$ `<base_projeto>/../wiki/dev/<modulo>/` (VitePress com acesso interno dev e regras `{modulo}.regras-negocio.md`)
- `5. Rota IA` $\rightarrow$ Rota do backend `/llm.md`
- `6. Memória IA` $\rightarrow$ `<base_projeto>/memorias-ia/`
- `6. Memória IA` $\rightarrow$ `<base_projeto>/memorias-ia/` (gera `sessao-AAAA-MM-DD-slug.md` e indexa no arquivo central `historico-acoes.md`)
---
## 🧠 Pilar 6: Memória da IA e Histórico de Ações (`memorias-ia/`)
Ao documentar a sessão (seja via `/doc` ou `/documentacao`):
1. **Arquivo da Sessão:** O agente gera o registro detalhado em `<base_projeto>/memorias-ia/sessao-AAAA-MM-DD-slug.md` descrevendo contexto, causa raiz, solução técnica, citações no código-fonte e validações.
2. **Índice de Ações (`historico-acoes.md`):** O agente registra/atualiza a linha correspondente na tabela de `<base_projeto>/memorias-ia/historico-acoes.md`:
```markdown
| Data | Memória / Ação | Arquivo Memoria | Citações no Código-Fonte |
| :--- | :--- | :--- | :--- |
| **AAAA-MM-DD** | [Descrição da Ação] | [`sessao-AAAA-MM-DD-slug.md`](./sessao-AAAA-MM-DD-slug.md) | `caminho/arquivo.ts`<br>`outro/arquivo.vue` |
```
## 🔄 Versionamento Git Obrigatório da Wiki (`<base_projeto>/../wiki`)
Sempre que a documentação na Wiki (Pilares 3 e 4) for alterada ou criada: