melhoria de ia

global/rules/diagnostico-antes-correcao

@@ -0,0 +1,121 @@
+---
+type: rule
+name: diagnostico-antes-correcao
+description: Todo agente DEVE realizar diagnóstico antes de implementar qualquer correção ou mudança
+scope: global
+trigger: always_on
+priority: alta
+updatedAt: "2026-07-09"
+---
+
+# Regra: Diagnóstico Obrigatório Antes de Correção
+
+## Contexto
+
+Corrigir sem diagnosticar é tratar sintomas sem entender a causa. Isso leva a correções superficiais que reintroduzem o problema ou criam efeitos colaterais. Todo agente deve primeiro **entender** o problema para depois **resolver**.
+
+## Regra
+
+Antes de implementar qualquer correção, mudança ou refatoração, o agente **DEVE** executar um diagnóstico mínimo que responda três perguntas:
+
+1. **O que está errado?** — Identificar o problema concreto (erro, smell, inconsistência)
+2. **Por que está errado?** — Entender a causa raiz, não apenas o sintoma
+3. **Qual o impacto?** — Avaliar quais arquivos, módulos ou funcionalidades são afetados
+
+## Protocolo Mínimo de Diagnóstico
+
+### Etapa 1 — Coleta de evidências
+
+Antes de editar qualquer arquivo, o agente deve:
+
+- Ler o código afetado integralmente (não apenas a linha do erro)
+- Verificar dependências e importações do arquivo
+- Consultar a Memória Azteca para soluções anteriores do mesmo problema
+- Verificar se há `.regras-negocio.md` relevante
+
+### Etapa 2 — Análise de causa raiz
+
+O agente deve diferenciar:
+
+| Tipo | Exemplo | Abordagem |
+|------|---------|-----------|
+| **Sintoma** | "Campo X não aparece na tela" | NÃO corrigir direto |
+| **Causa intermediária** | "O tipo não inclui o campo X" | Investigar mais |
+| **Causa raiz** | "A migração não adicionou a coluna X no banco" | ESTA é a correção |
+
+### Etapa 3 — Plano de correção
+
+Antes de implementar, declarar ao operador:
+
+```
+DIAGNÓSTICO:
+- Problema: [descrição objetiva]
+- Causa raiz: [identificação da causa]
+- Arquivos afetados: [lista]
+- Plano de correção: [passos]
+- Riscos: [efeitos colaterais possíveis]
+```
+
+## Diagnóstico por Domínio
+
+Cada agente aplica o protocolo mínimo acima com foco no seu domínio:
+
+| Agente | Diagnóstico Específico |
+|--------|----------------------|
+| `@ag-back` | Verificar rotas, queries, schemas Zod, filas, logs de erro |
+| `@ag-front` | Verificar componente, composable, props/emits, estados de UI, console do navegador |
+| `@ag-refatorar` | Executar skill `diagnosticar-code-smells` antes de qualquer refatoração |
+| `@ag-testes` | Mapear cobertura existente, identificar cenários ausentes |
+| `@ag-deploy` | Verificar logs, healthchecks, variáveis de ambiente, estado dos containers |
+| `@ag-arquiteto` | Verificar fronteiras de módulo, dependências, contratos de API |
+| `@ag-ux` | Verificar fluxo de uso completo, estados de interface, mensagens ao usuário |
+| `@ag-documentacao` | Verificar JSDoc existente, `.regras-negocio.md`, dessincronia código/docs |
+| `@ag-agente` | Executar `auditar-agentes.sh`, verificar contradições entre personas |
+
+## Exceções
+
+A etapa de diagnóstico pode ser **simplificada** (não eliminada) quando:
+
+- O erro é trivial e isolado (typo, import faltando, formatação)
+- O operador fornece diagnóstico completo junto com a solicitação
+- É uma continuação de correção já diagnosticada na mesma conversa
+
+Mesmo nesses casos, o agente deve confirmar a compreensão do problema antes de agir.
+
+## Exemplos
+
+### ✅ Correto
+
+```
+Operador: "O campo email não está salvando"
+Agente:
+  1. Leu o componente de formulário → campo existe, emite evento corretamente
+  2. Leu a rota da API → recebe o campo, mas o schema Zod não inclui 'email'
+  3. Verificou o schema no *-comuns → campo ausente
+  DIAGNÓSTICO: Schema Zod em _contatos.ts não inclui o campo 'email'.
+  Causa raiz: migração de contatos alterou estrutura sem atualizar schema.
+  PLANO: Adicionar campo ao schema → rodar build → verificar front.
+```
+
+### ❌ Incorreto
+
+```
+Operador: "O campo email não está salvando"
+Agente: "Vou adicionar o campo email no componente Vue."
+→ Não investigou a causa. Pode ser problema no schema, na API ou no banco.
+```
+
+## Impacto
+
+Sem esta regra:
+- Agentes corrigem sintomas ao invés de causas raiz
+- Correções criam novos bugs em cascata
+- O operador perde tempo revisando correções superficiais
+- A mesma classe de problema reaparece repetidamente
+
+## Referências
+
+- Skill: `global/skills/diagnosticar-antes-corrigir/SKILL`
+- Skill: `global/skills/diagnosticar-erros-build/SKILL`
+- Skill: `agents/ag-refatorar/skills/diagnosticar-code-smells/SKILL`
+- Rule: `global/rules/autonomia-agente`