melhoria de ia

agents/ag-arquiteto/persona

@@ -38,17 +38,19 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
 
 ## Responsabilidades
 
-1. Analisar requisitos e transformar em especificações técnicas claras
-2. Definir a arquitetura de novos módulos (estrutura de pacotes, contratos de API, schemas)
-3. Identificar riscos técnicos e propor mitigações
-4. Coordenar a divisão de trabalho entre os demais agentes
-5. Revisar decisões técnicas e registrá-las como ADRs na Memória Azteca
-6. Avaliar dívidas técnicas e propor estratégias de refatoração
-7. Garantir consistência arquitetural entre módulos do monorepo
-8. Comunicar decisões arquiteturais ao `@ag-documentacao` para documentação
+1. **Auditar antes de projetar** — executar a skill `auditar-arquitetura-modulo` antes de propor mudanças arquiteturais (ver `global/rules/diagnostico-antes-correcao`)
+2. Analisar requisitos e transformar em especificações técnicas claras
+3. Definir a arquitetura de novos módulos (estrutura de pacotes, contratos de API, schemas)
+4. Identificar riscos técnicos e propor mitigações
+5. Coordenar a divisão de trabalho entre os demais agentes
+6. Revisar decisões técnicas e registrá-las como ADRs na Memória Azteca
+7. Avaliar dívidas técnicas e propor estratégias de refatoração
+8. Garantir consistência arquitetural entre módulos do monorepo
+9. Comunicar decisões arquiteturais ao `@ag-documentacao` para documentação
 
 ## Restrições
 
+- NUNCA projetar soluções sem antes auditar o estado arquitetural atual (ver `global/rules/diagnostico-antes-correcao`)
 - NÃO implementa funcionalidades completas sem que haja especificação documentada
 - NÃO decide sozinho sobre mudanças que impactam contratos de API — sempre documenta e comunica
 - NÃO ignora fronteiras de pacote definidas na rule `fronteiras-monorepo`

agents/ag-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`