otimização do agent para docuemntação
This commit is contained in:
parent
1a25edc274
commit
890eddc464
60 changed files with 1807 additions and 1435 deletions
|
|
@ -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`).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue