89 lines
2.2 KiB
Markdown
89 lines
2.2 KiB
Markdown
---
|
|
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`
|