aplimoramento de agent

DOCUMENTACAO/templates/regra-negocio.md.template

@@ -0,0 +1,63 @@
+---
+type: template
+name: regra-negocio
+description: Template canônico para especificação de regras de negócio em linguagem natural
+updatedAt: "2026-09-02"
+---
+
+<!--
+DESTINO CANÔNICO NO PROJETO:
+- Wiki de Desenvolvimento (Pilar 4): <base_projeto>/../wiki/dev/<modulo-id>/{nome-servico}.regras-negocio.md
+  ou <base_projeto>/../wiki/dev/<modulo-id>/regras-negocio/{nome-regra}.md
+
+REFERÊNCIA NO CÓDIGO TYPESCRIPT (primeira linha útil):
+// Regras de negócio: ver <base_projeto>/../wiki/dev/<modulo-id>/{nome-servico}.regras-negocio.md
+-->
+
+# Regras de Negócio — [Nome do Serviço / Funcionalidade]
+
+- **Módulo:** `<modulo-id>`
+- **Arquivo TypeScript:** `caminho/relativo/ao/_arquivo.ts`
+- **Última Atualização:** `<AAAA-MM-DD>`
+
+---
+
+## Contexto Operacional
+<Por que esta regra existe? Qual decisão ou cálculo ela formaliza e qual problema operacional evita?>
+
+---
+
+## Critérios de Entrada / Acionamento
+<Quais condições e dados ativam a avaliação desta regra?>
+- [ ] Critério 1: [...]
+- [ ] Critério 2: [...]
+
+---
+
+## Regras de Processamento (Ordem Determinística)
+As regras devem ser avaliadas na ordem numérica estrita abaixo:
+
+1. **Regra 1 — [Nome]:** <Descrição da validação ou transformação.>
+2. **Regra 2 — [Nome]:** <Descrição da validação ou transformação.>
+3. **Regra 3 — [Nome]:** <Descrição da validação ou transformação.>
+
+---
+
+## Casos de Revisão Manual (Exceções)
+<Quando o sistema não deve decidir automaticamente e deve solicitar intervenção de um operador humano?>
+- **Cenário A:** [...]
+- **Cenário B:** [...]
+
+---
+
+## Estratégia de Persistência / Saída
+<Qual é o resultado final gerado? Campos persistidos no banco, status atualizados, eventos disparados.>
+- **Status Resultante:** [...]
+- **Campos Atualizados:** [...]
+
+---
+
+## Dependências Externas e Filas
+<Quais filas BullMQ, endpoints externos, rotas ou tabelas de banco são afetadas por esta regra?>
+- **Filas:** [...]
+- **Tabelas / Schemas:** [...]