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

feat(identidade): padronizar modulo-acesso e modulo-wiki no framework e validar-setup

Browse source
This commit is contained in:
Luiz Silva 2026-10-06 12:21:32 -03:00
parent d43631be13
commit 19df29ea45
18 changed files with 193 additions and 104 deletions
Download patch file Download diff file Expand all files Collapse all files

23
skills/documentar-dominio-modulo/SKILL.md
View file

@ -11,9 +11,9 @@ description: >
Use esta skill ao iniciar um novo módulo SaaS ou ao perceber que o agente não conhece o vocabulário e as regras do domínio que o módulo aborda.
Cada módulo opera em uma disciplina diferente da ciência/gestão ambiental (licenciamento, efluentes, bombeamento, resíduos, projetos, etc.). O repositório `<base_projeto>/../wiki` é uma **aplicação VitePress**, onde a base factual do domínio é estruturada em dois níveis de acesso:
1. **Wiki do Usuário (`<base_projeto>/../wiki/<modulo-id>/`):** Aplicação VitePress com **acesso dos usuários e clientes** (linguagem funcional, conceitos, glossário, fluxos e manuais operacionais).
2. **Wiki de Desenvolvimento (`<base_projeto>/../wiki/dev/<modulo-id>/`):** Aplicação VitePress com **acesso interno exclusivo da equipe de desenvolvimento e arquitetura** (arquitetura técnica, diagramas, modelos de banco, regras de negócio e ADRs).
Cada módulo opera em uma disciplina diferente da ciência/gestão ambiental (licenciamento, efluentes, bombeamento, resíduos, projetos, etc.). O repositório `<modulo-wiki>` (configurado em `memorias-ia/modulo.yml`, com fallback padrão para `<base_projeto>/../wiki`) é uma **aplicação VitePress**, onde a base factual do domínio é estruturada em dois níveis de acesso:
1. **Wiki do Usuário (`<modulo-wiki>/<modulo-id>/`):** Aplicação VitePress com **acesso dos usuários e clientes** (linguagem funcional, conceitos, glossário, fluxos e manuais operacionais).
2. **Wiki de Desenvolvimento (`<modulo-wiki>/dev/<modulo-id>/`):** Aplicação VitePress com **acesso interno exclusivo da equipe de desenvolvimento e arquitetura** (arquitetura técnica, diagramas, modelos de banco, regras de negócio e ADRs).
---
@ -24,14 +24,16 @@ Consultar obrigatoriamente `<base_projeto>/memorias-ia/modulo.yml` na raiz do pr
- `modulo-caminho`: rota base na URL (ex: `/sigma/`)
- `modulo-descricao`: escopo funcional e propósito do módulo
- `modulo-tipo`: stack tecnológica e arquitetura
- `modulo-wiki`: caminho relativo ou absoluto para a Wiki (fallback: `../wiki/`)
Os destinos canônicos da documentação na aplicação VitePress (`<base_projeto>/../wiki`) são:
- **Wiki do Usuário:** `<base_projeto>/../wiki/<modulo-id>/`
- **Wiki de Desenvolvimento:** `<base_projeto>/../wiki/dev/<modulo-id>/`
Os destinos canônicos da documentação na aplicação VitePress (`<modulo-wiki>`) são:
- **Wiki do Usuário:** `<modulo-wiki>/<modulo-id>/`
- **Wiki de Desenvolvimento:** `<modulo-wiki>/dev/<modulo-id>/`
---
## PASSO 2 — Criar Documentação na Wiki do Usuário (`<base_projeto>/../wiki/<modulo-id>/`)
## PASSO 2 — Criar Documentação na Wiki do Usuário (`<modulo-wiki>/<modulo-id>/`)
Estruturar o guia do usuário e conceitos de negócio em linguagem clara e acessível:
@ -55,7 +57,7 @@ Breve descrição do propósito do módulo para o gestor e operador.
---
## PASSO 3 — Criar Documentação na Wiki de Desenvolvimento (`<base_projeto>/../wiki/dev/<modulo>/`)
## PASSO 3 — Criar Documentação na Wiki de Desenvolvimento (`<modulo-wiki>/dev/<modulo>/`)
Estruturar a especificação técnica, modelos de banco e arquitetura:
@ -86,8 +88,9 @@ Estruturar a especificação técnica, modelos de banco e arquitetura:
## Checklist Final
- [ ] Documentação de usuário criada/atualizada em `<base_projeto>/../wiki/<modulo>/`?
- [ ] Documentação técnica criada/atualizada em `<base_projeto>/../wiki/dev/<modulo>/`?
- [ ] Documentação de usuário criada/atualizada em `<modulo-wiki>/<modulo>/`?
- [ ] Documentação técnica criada/atualizada em `<modulo-wiki>/dev/<modulo>/`?
- [ ] Glossário com os termos centrais do domínio documentado?
- [ ] Regras e entidades técnicas alinhadas com os schemas Zod do `*-comuns`?
- [ ] Rota `/llm.md` no backend reflete o módulo?