otimização do agent para docuemntação

This commit is contained in:
Luiz Silva 2026-09-01 16:55:01 -03:00
parent 1a25edc274
commit 890eddc464
60 changed files with 1807 additions and 1435 deletions

View file

@ -44,8 +44,9 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
5. Implementar processadores de fila (`filas/`)
6. Criar CRONs e workers agendados (`cron/`)
7. Manter schemas Zod no pacote `*-comuns` como contrato compartilhado
8. Documentar lógica de negócio complexa em arquivos `.regras-negocio.md`
9. Escrever JSDoc em funções compartilhadas
8. Documentar regras de negócio detalhadas na Wiki de Desenvolvimento (`../../wiki/dev/<modulo>/`)
9. Escrever JSDoc e comentários claros e coerentes quanto à aplicação prática de rotas, serviços e queries (ver `rules/jsdoc-padrao.md`)
10. Manter e expor a rota `/llm.md` no backend com a especificação dinâmica de schemas e rotas para IA
## Restrições
@ -54,8 +55,9 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
- NUNCA criar componentes Vue ou lógica de interface
- NUNCA usar `any` ou `as any` — usar `unknown` com narrowing
- NUNCA expor erros técnicos internos diretamente ao usuário
- Toda lógica com 3+ critérios de decisão deve ter `.regras-negocio.md`
- Toda lógica com 3+ critérios de decisão deve ter regras documentadas em `../../wiki/dev/<modulo>/`
- Schemas Zod compartilhados ficam em `*-comuns`, nunca duplicados no back
- Endpoints públicos de documentação de IA devem responder na rota `/llm.md`
## Colaborações
@ -78,19 +80,16 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
- [ ] Tipagem completa sem `any`?
- [ ] Validação Zod em toda entrada externa?
- [ ] Mensagens de erro traduzidas para o domínio do usuário?
- [ ] Lógica complexa documentada em `.regras-negocio.md`?
- [ ] Funções compartilhadas têm JSDoc?
- [ ] Lógica complexa documentada na Wiki de Desenvolvimento (`../../wiki/dev/<modulo>/`)?
- [ ] Funções, rotas e serviços possuem comentários claros quanto à aplicação prática?
- [ ] Rota `/llm.md` expõe os novos schemas e contratos atualizados?
- [ ] Fronteiras de pacote respeitadas?
- [ ] Build passa sem erros (`tsc --noEmit` + `biome check`)?
## Memória Persistente
O ecossistema adota uma arquitetura de memória em duas camadas:
- **Memórias do Projeto ()**: Armazena decisões de negócio, contexto do produto, especificações funcionais e ADRs na raiz do projeto pai (versionado pelo repositório pai).
- **Evoluções da IA ()**: Armazena registros de sessões , otimizações dos agentes e melhorias da arquitetura multiagente (versionado pelo submódulo ).
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 memórias de projeto em (na raiz do pai).
- Gravar evoluções da IA em (no submódulo).
- Toda memória deve ser um arquivo Markdown em com frontmatter (, , , , ).
- 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`).