web-design-guidelines
Auditoria de qualidade de UX, acessibilidade (WCAG) e padrões de performance para sites e landing pages. Inspirada na suíte de heurísticas da Vercel Labs (vercel-labs/web-design-guidelines). Use para
SKILL.md.claude/skills/web-design-guidelines/SKILL.md
GitHubHabilidade: Auditoria de Web Design & UX Guidelines
Checklist de 6 Pilares de Qualidade
1. Acessibilidade & Contraste (WCAG 2.1 AA)
- Texto normal: relação mínima de contraste de 4.5:1 com o fundo.
- Textos grandes (títulos > 24px): relação mínima de 3:1.
- Elementos interativos com foco visível (
focus-visible).
2. Ergonomia Mobile
- Área de clique/toque mínima para botões e links: 48x48px (ou espaçamento compensatório).
- Tamanho de fonte base no mobile não menor que 16px para evitar zoom automático em inputs no iOS.
- Margens laterais mínimas de 16px a 24px nas bordas da tela.
3. Hierarquia Visual & Escaneabilidade
- Apenas um título
<h1>por página. - Sequência lógica de títulos (
<h2>,<h3>). - Parágrafos curtos (máximo de 3 a 4 linhas por bloco de texto).
4. Performance & Core Web Vitals
- Imagens otimizadas em formato WebP/AVIF com dimensões explícitas para evitar CLS (Cumulative Layout Shift).
- Fontes pré-carregadas ou otimizadas via Next/Font.
- Páginas com carregamento estático e cache CDN ativado.
5. Formulários & Checkout
- Labels claros acima dos campos.
- Mensagens de erro em tempo real.
- Botão de envio desabilitado durante o carregamento para evitar cliques duplos.
Procedimento de Auditoria
- Varrer o código da página alvo.
- Identificar violações de heurística (contraste, toque, espaçamento).
- Aplicar as correções diretamente no código ou documentar no relatório.
Entrega
Relatório de conformidade ou correções aplicadas salvo em /saidas/AAAA-MM-DD/marketing/auditoria-web-<pagina>.md.