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

@ -36,7 +36,7 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
3. **Wiki do Usuário**: Aplicação VitePress com acesso dos usuários em `<base_projeto>/../wiki/<modulo>/` (manuais e guias de operação).
4. **Wiki de Desenvolvimento**: Aplicação VitePress com acesso interno da equipe de desenvolvimento em `<base_projeto>/../wiki/dev/<modulo>/` (documentação técnica, arquitetura, modelos de banco, regras de negócio `{modulo}.regras-negocio.md`, filas e ADRs).
5. **Integração de IA**: Rota do backend `/llm.md` (e `/sigma/llm.md`) gerando especificações dinâmicas para LLMs.
6. **Memória das Ações da IA**: Registro de sessões, otimizações e decisões tomadas em `<base_projeto>/memorias-ia/`.
6. **Memória das Ações da IA**: Registro de sessões (`sessao-AAAA-MM-DD-slug.md`) e índice cumulativo (`historico-acoes.md` com `Data | Memória / Ação | Arquivo Memoria | Citações no Código-Fonte`) em `<base_projeto>/memorias-ia/`.
7. **Hub DDD (`DOCUMENTACAO/`)**: Templates e manifesto do Documentation-Driven Development.
## Responsabilidades
@ -48,7 +48,7 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
4. **Manter a Wiki do Usuário** — redigir e manter manuais na aplicação VitePress em `<base_projeto>/../wiki/<modulo>/` com linguagem do domínio para usuários.
5. **Manter a Wiki de Desenvolvimento** — estruturar documentação técnica, arquitetura e regras de negócio na aplicação VitePress de acesso interno em `<base_projeto>/../wiki/dev/<modulo>/`.
6. **Validar a Rota `/llm.md`** — certificar que a rota do backend expõe schemas Zod, enums e contratos atualizados.
7. **Registrar Memórias da IA** — consolidar registros de ações e melhorias em `<base_projeto>/memorias-ia/`.
7. **Registrar Memórias da IA** — consolidar sessões em arquivos dedicados `sessao-AAAA-MM-DD-slug.md` e atualizar o índice central `historico-acoes.md` em `<base_projeto>/memorias-ia/`.
8. **Sincronizar Git da Wiki** — ao criar ou modificar documentações em `<base_projeto>/../wiki/` (Pilares 3 e 4), executar obrigatoriamente `git commit` e `git push` no repositório da Wiki.
## Restrições
@ -75,7 +75,7 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
- [ ] Documentação de usuário está atualizada em `<base_projeto>/../wiki/<modulo>/`?
- [ ] Documentação técnica e ADRs estão atualizados em `<base_projeto>/../wiki/dev/<modulo>/`?
- [ ] Rota de backend `/llm.md` reflete fielmente os schemas Zod e enums canônicos?
- [ ] Ações estruturantes da IA estão registradas em `<base_projeto>/memorias-ia/`?
- [ ] Ações estruturantes da IA estão registradas em `<base_projeto>/memorias-ia/sessao-AAAA-MM-DD-slug.md` e indexadas em `historico-acoes.md`?
- [ ] Alterações na Wiki foram commitadas e enviadas via push em `<base_projeto>/../wiki`?
- [ ] Repositório da aplicação foi mantido intacto sem commits da IA?
@ -86,5 +86,7 @@ O arquivo `<base_projeto>/memorias-ia/modulo.yml` é de **existência obrigatór
- Toda memória das ações, registros de sessões e decisões tomadas pela IA deve ser armazenada em `<base_projeto>/memorias-ia/` na raiz do projeto pai.
### Regras de Operação
- Gravar registros de ações, sessões e decisões da IA em `<base_projeto>/memorias-ia/`.
- Toda memória deve ser um arquivo Markdown com frontmatter (`type`, `name`, `description`, `session_date`, `updatedAt`).
- Gravar registros de ações, sessões e decisões da IA em arquivos individuais `<base_projeto>/memorias-ia/sessao-AAAA-MM-DD-slug.md`.
- Manter o índice central `<base_projeto>/memorias-ia/historico-acoes.md` atualizado com a tabela:
`| Data | Memória / Ação | Arquivo Memoria | Citações no Código-Fonte |`.
- Toda memória de sessão deve ser um arquivo Markdown com frontmatter (`type`, `name`, `description`, `session_date`, `updatedAt`).