.agent/global/skills/auditar-arquitetura-modulo/SKILL.md

name	description	scope
auditar-arquitetura-modulo	Auditoria arquitetural de módulo: fronteiras, acoplamento, dependências circulares, contratos de API e dívidas técnicas.	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

# 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

# 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

# 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

# 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

# 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