refatoração dos agents

agents/arquiteto/skills/auditar-arquitetura-modulo/SKILL

@@ -0,0 +1,89 @@
+---
+name: auditar-arquitetura-modulo
+description: >
+  Auditoria arquitetural de módulo: fronteiras, acoplamento, dependências
+  circulares, contratos de API e dívidas técnicas.
+scope: local
+---
+
+# Skill: Auditar Arquitetura de Módulo
+
+## Objetivo
+
+Avaliar a saúde arquitetural de um módulo antes de propor mudanças estruturais.
+
+## Etapas
+
+### 1. Verificar Fronteiras de Pacote
+
+```sh
+# Detectar imports que cruzam fronteiras
+rg "from.*-back" --include='*.ts' --include='*.vue' <modulo>-front/src/ -n
+rg "from.*-front" --include='*.ts' <modulo>-back/src/ -n
+
+# Verificar imports entre módulos diferentes
+rg "from.*<outro-modulo>" --include='*.ts' <modulo>/ -n
+```
+
+### 2. Verificar Acoplamento
+
+```sh
+# Contar imports por arquivo (alto = muito acoplado)
+fd "*.ts" <modulo>-back/src/ --exec sh -c 'echo "$(grep -c "^import" "$1") $1"' _ {} | sort -rn | head -10
+
+# Detectar dependências circulares
+rg "from.*\.\/" --include='*.ts' <modulo>/src/ -l | head -20
+```
+
+### 3. Verificar Contratos de API
+
+```sh
+# Listar rotas e seus schemas de validação
+rg "router\.(get|post|put|patch|delete)" --include='*.ts' <modulo>-back/src/rotas/ -n
+
+# Verificar se schemas Zod estão no *-comuns (não duplicados no back)
+rg "z\.object" --include='*.ts' <modulo>-back/src/ -l
+```
+
+### 4. Avaliar Dívida Técnica
+
+```sh
+# Buscar marcadores de dívida
+rg "TODO|FIXME|HACK|WORKAROUND|DEBT|TEMP" --include='*.ts' --include='*.vue' <modulo>/ -n
+
+# Verificar limite de linhas
+fd "*.ts" <modulo>/src/ --exec sh -c 'lines=$(wc -l < "$1"); [ "$lines" -gt 250 ] && echo "$lines $1"' _ {}
+
+# Verificar uso de any
+rg "as any|: any" --include='*.ts' <modulo>/ -c
+```
+
+### 5. Relatório
+
+```markdown
+# Auditoria Arquitetural — [módulo]
+
+## Resumo
+- **Violações de fronteira:** N
+- **Arquivos com acoplamento alto (>10 imports):** N
+- **Dívidas técnicas (TODO/FIXME):** N
+- **Arquivos acima de 250 linhas:** N
+
+## Achados
+### 🔴 Crítico
+| Tipo | Arquivo | Problema | Ação |
+|------|---------|----------|------|
+
+### 🟡 Moderado
+| Tipo | Arquivo | Problema | Ação |
+|------|---------|----------|------|
+
+## Plano de Ação
+1. ...
+```
+
+## Referências
+
+- Rule: `global/rules/diagnostico-antes-correcao`
+- Rule: `global/rules/fronteiras-monorepo`
+- Skill: `global/skills/mapear-codigo-fonte/SKILL`