publico/.agent
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

aplimoramento de agent

Browse source
This commit is contained in:
Luiz Silva 2026-09-02 10:23:53 -03:00
parent b361f25955
commit f597436be3
83 changed files with 1312 additions and 574 deletions
Download patch file Download diff file Expand all files Collapse all files

20
global/rules/regras-negocio-md.md
View file

@ -1,21 +1,23 @@
---
type: rule
name: regras-negocio-md
description: O conteúdo de regras de negócio deve ficar em ../../wiki/dev/<modulo>/.
description: O conteúdo de regras de negócio deve ficar em <base_projeto>/../wiki/dev/<modulo>/.
scope: global
trigger: always_on
updatedAt: "2026-09-01"
---
# Regra: Conteúdo de Regras de Negócio em `../../wiki/dev/<modulo>/`
# Regra: Conteúdo de Regras de Negócio em `<base_projeto>/../wiki/dev/<modulo>/`
> **Escopo global** — aplica-se a todos os projetos do ecossistema Azteca.
## Contexto
Toda lógica de negócio não-trivial — regras de decisão, critérios de bloqueio, estratégias de processamento, priorizações e fluxos de dados — deve ter seu conteúdo documentado em linguagem natural na **Wiki de Desenvolvimento** em `../../wiki/dev/<modulo>/`.
Toda lógica de negócio não-trivial — regras de decisão, critérios de bloqueio, estratégias de processamento, priorizações e fluxos de dados — deve ter seu conteúdo documentado em linguagem natural na **Wiki de Desenvolvimento** em `<base_projeto>/../wiki/dev/<modulo>/`.
> 💡 **Aplicação VitePress (`../../wiki`)**: O diretório `../../wiki` é uma aplicação VitePress na qual `../../wiki/<modulo>/` é voltado ao acesso dos **usuários**, e `../../wiki/dev/<modulo>/` é reservado ao **acesso interno exclusivo da equipe de desenvolvimento**.
> 💡 **Aplicação VitePress (`<base_projeto>/../wiki`) e Resolução do Módulo**:
> - O diretório `<base_projeto>/../wiki` é uma aplicação VitePress na qual `<base_projeto>/../wiki/<modulo-id>/` é voltado ao acesso dos **usuários**, e `<base_projeto>/../wiki/dev/<modulo-id>/` é reservado ao **acesso interno exclusivo da equipe de desenvolvimento**.
> - O identificador `<modulo-id>` (ou `<modulo>`) **DEVE** ser obtido obrigatoriamente do campo `modulo-id` em `memorias-ia/modulo.yml` na raiz do projeto (ex: `e-licencie.sigma`).
Isso garante centralização, governança técnica e facilidade de consulta por desenvolvedores, arquitetos e agentes de IA.
@ -23,7 +25,7 @@ Isso garante centralização, governança técnica e facilidade de consulta por
## Regra
**Todo o conteúdo detalhado de regras de negócio DEVE ficar em `../../wiki/dev/<modulo>/`.**
**Todo o conteúdo detalhado de regras de negócio DEVE ficar em `<base_projeto>/../wiki/dev/<modulo>/`.**
Considera-se lógica não-trivial qualquer módulo que:
- Possui 3 ou mais critérios de decisão distintos
@ -35,7 +37,7 @@ Considera-se lógica não-trivial qualquer módulo que:
O módulo TypeScript deve conter, na primeira linha útil do arquivo, a referência:
```typescript
// Regras de negócio: ver ../../wiki/dev/<modulo>/{modulo}.regras-negocio.md
// Regras de negócio: ver <base_projeto>/../wiki/dev/<modulo>/{modulo}.regras-negocio.md
```
A documentação na **Wiki de Desenvolvimento** é a **fonte de verdade da lógica operacional**. Os comentários JSDoc no código explicam a aplicação prática da função e apontam para a wiki para o detalhamento dos critérios.
@ -44,7 +46,7 @@ A documentação na **Wiki de Desenvolvimento** é a **fonte de verdade da lógi
## Estrutura do Documento de Regras na Wiki de Desenvolvimento
**Localização:** `../../wiki/dev/<modulo>/` (ex.: `../../wiki/dev/e-licencie.sigma/regras-negocio/` ou `../../wiki/dev/e-licencie.sigma/{modulo}.regras-negocio.md`)
**Localização:** `<base_projeto>/../wiki/dev/<modulo>/` (ex.: `<base_projeto>/../wiki/dev/e-licencie.sigma/regras-negocio/` ou `<base_projeto>/../wiki/dev/e-licencie.sigma/{modulo}.regras-negocio.md`)
```markdown
# Regras de Negócio — [Nome do Módulo / Serviço]
@ -79,7 +81,7 @@ Tabelas, filas BullMQ, rotas e serviços externos tocados pelo módulo.
✅ **Correto** — referência no topo do módulo apontando para a Wiki de Desenvolvimento:
```typescript
// Regras de negócio: ver ../../wiki/dev/e-licencie.sigma/juntar_execucoes.regras-negocio.md
// Regras de negócio: ver <base_projeto>/../wiki/dev/e-licencie.sigma/juntar_execucoes.regras-negocio.md
import { ... } from "..."
@ -117,4 +119,4 @@ export const compilarJuntarExecucoes = async (...) => {
- Rule: `rules/jsdoc-padrao.md`
- Skill: `skills/documentar-regras-negocio/SKILL.md`
- Workflow: `global/workflows/documentar-regras-negocio.md`
- Wiki de Desenvolvimento: `../../wiki/dev/<modulo>/`
- Wiki de Desenvolvimento: `<base_projeto>/../wiki/dev/<modulo>/`