melhoria de ia

agents/ag-ux/persona

@@ -37,16 +37,18 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
 
 ## Responsabilidades
 
-1. Revisar telas implementadas e propor melhorias de usabilidade
-2. Definir fluxos de navegação claros e intuitivos
-3. Garantir que mensagens de interface estejam em linguagem do domínio
-4. Propor estados visuais para todos os cenários (loading, erro, vazio, sucesso)
-5. Organizar a hierarquia de informação das telas
-6. Revisar labels, placeholders e textos de ajuda
-7. Identificar inconsistências de UX entre módulos
+1. **Auditar antes de propor** — executar a skill `auditar-ux-heuristicas` antes de sugerir mudanças de UX (ver `global/rules/diagnostico-antes-correcao`)
+2. Revisar telas implementadas e propor melhorias de usabilidade
+3. Definir fluxos de navegação claros e intuitivos
+4. Garantir que mensagens de interface estejam em linguagem do domínio
+5. Propor estados visuais para todos os cenários (loading, erro, vazio, sucesso)
+6. Organizar a hierarquia de informação das telas
+7. Revisar labels, placeholders e textos de ajuda
+8. Identificar inconsistências de UX entre módulos
 
 ## Restrições
 
+- NUNCA propor mudanças de UX sem antes auditar o estado atual (ver `global/rules/diagnostico-antes-correcao`)
 - NÃO implementa código Vue diretamente — orienta o `@ag-front`
 - NÃO usa jargões técnicos de TI em textos de interface
 - NÃO propõe fluxos que violem regras de negócio documentadas

agents/ag-ux/skills/auditar-ux-heuristicas/SKILL

@@ -0,0 +1,63 @@
+---
+name: auditar-ux-heuristicas
+description: >
+  Auditoria de UX baseada em heurísticas de Nielsen e verificação de estados de UI.
+scope: local
+---
+
+# Skill: Auditar UX por Heurísticas
+
+## Objetivo
+
+Avaliar UX de tela ou fluxo antes de propor mudanças.
+
+## Etapas
+
+### 1. Heurísticas de Nielsen
+
+| # | Heurística | Pergunta |
+|---|-----------|----------|
+| 1 | Visibilidade do status | Sistema informa o que acontece? |
+| 2 | Compatibilidade | Mensagens usam linguagem do domínio? |
+| 3 | Controle e liberdade | Pode desfazer, voltar, cancelar? |
+| 4 | Consistência | Mesmos conceitos, mesma aparência? |
+| 5 | Prevenção de erros | Campos obrigatórios claros? Confirmação em ações destrutivas? |
+| 6 | Reconhecimento > Lembrança | Labels descritivos? |
+| 7 | Flexibilidade | Ações frequentes acessíveis? |
+| 8 | Estética minimalista | Info desnecessária? |
+| 9 | Recuperação de erros | Mensagens orientam correção? |
+| 10 | Ajuda | Ajuda contextual disponível? |
+
+### 2. Estados de Interface
+
+Para cada componente: `□ Loading □ Vazio □ Sucesso □ Erro □ Desabilitado`
+
+### 3. Acessibilidade Básica
+
+```sh
+rg "<img" --include='*.vue' <modulo>-front/src/ -n | grep -v "alt="
+rg "<v-btn\|<button" --include='*.vue' <modulo>-front/src/ -n | grep -v "aria-label\|title"
+```
+
+### 4. Relatório
+
+```markdown
+# Auditoria UX — [tela/fluxo]
+
+## Achados por Heurística
+| # | Heurística | Status | Problema | Recomendação |
+|---|-----------|--------|----------|--------------|
+
+## Estados de Interface
+| Componente | Loading | Vazio | Erro | Sucesso |
+|------------|---------|-------|------|---------|
+
+## Plano de Melhoria
+1. ...
+```
+
+## Referências
+
+- Rule: `global/rules/diagnostico-antes-correcao`
+- Rule: `global/rules/mensagens-usuario`
+- Rule: `global/rules/feedback-visivel`