Habilidade Anti-Padrões — Envie Código Real, Não Decorações
Esta habilidade detecta e previne os anti-padrões mais comuns que fazem o software parecer inacabado ou amador.
Anti-Padrões Proibidos (TOLERÂNCIA ZERO)
Anti-Padrões de UI/UX
❌ PROIBIDO:
- Seções ou rótulos "Em Breve"
- Botões não funcionais (devem funcionar ou ser removidos)
- Formulários que não enviam para lugar nenhum
- Dados falsos codificados em componentes de produção
- Tabelas estáticas fingindo ser dinâmicas
- Links que não vão a lugar nenhum (href="#")
- Banners "Em Construção"
- Feature flags permanentemente definidas como false
- Inputs desabilitados sem explicação clara
- Estados vazios sem mensagens úteis
- Paginação que não pagina de verdade
- Barras de busca que não buscam de verdade
- Filtros que retornam os mesmos resultados
- PÁGINA ÚNICA DE DESTAQUE quando o usuário pede "um site" (DEVE ser multi-página)
- Nenhuma paleta de cores definida antes de escrever CSS
- Cores hexadecimais aleatórias sem um sistema de design documentado
- Cores inconsistentes entre páginas (azuis diferentes, espaçamentos diferentes)
- EMOJIS em qualquer lugar do site (use ícones SVG do Lucide/Heroicons/Phosphor)
- Seções se tocando (sem espaçamento entre blocos de conteúdo)
- Rodapé colado diretamente na seção acima (sem espaço de respiro)
- Navegação com mais de 7 itens de nível superior (poluída, opressiva)
- Páginas de serviço sem páginas de detalhe individuais (/services apenas, sem /services/web-design)
- Páginas de produto sem páginas de detalhe individuais (/products apenas, sem /products/[slug])
- Descrições genéricas de serviço (2-3 linhas por serviço NÃO é suficiente)
✅ OBRIGATÓRIO:
- Cada botão visível aciona um handler real ou é removido
- Cada formulário tem um onSubmit real conectado a uma chamada de API
- Cada lista carrega de uma fonte de dados real com estados de carregamento
- Cada link navega para um destino real
- Estados vazios explicam o porquê e sugerem próximas ações
- Estados de erro mostram mensagens de erro reais do servidor
- Estados de carregamento aparecem durante operações assíncronas reais
- Site multi-página com rotas separadas (Home, Sobre, Serviços, Contato, Produtos)
- Paleta profissional de 6 cores (--color-primary, secondary, accent, bg, surface, text)
- Sistema de design consistente em TODAS as páginas
- ZERO emojis — use ícones SVG (Lucide, Heroicons, Phosphor)
- Espaçamento entre seções: mínimo 80px de padding entre seções
- Rodapé: mínimo 128px de padding superior (nunca tocando o conteúdo acima)
- Navegação: máximo 7 itens, dropdowns para grupos, links secundários no rodapé
- Serviços: página de listagem + páginas de detalhe individuais por serviço
- Produtos: página de listagem + páginas de detalhe individuais por produto
- Cada detalhe de serviço: descrição, processo, entregáveis, precificação, FAQ, CTA
- Cada detalhe de produto: galeria, especificações, precificação, avaliações, produtos relacionados
Anti-Padrões de Arquitetura de Site
❌ PROIBIDO (quando o usuário diz "construa um site"):
- Criar index.html como o ÚNICO arquivo
- Colocar todo o conteúdo em uma página rolável
- Usar links de âncora (#about, #services) em vez de páginas separadas
- Chamar de "site" quando é apenas uma página de destino
- Nenhum menu de navegação entre seções/páginas
- Nenhum cabeçalho/rodapé compartilhado entre páginas
- Nenhum título/descrição meta única por página
✅ OBRIGATÓRIO:
- Rota/página separada para cada seção (ex.: /about, /services, /contact)
- Menu de navegação ligando todas as páginas
- Componentes de cabeçalho + rodapé compartilhados
- Cada página tem <title> e <meta description> únicos
- Paleta de cores e tipografia consistentes em TODAS as páginas
- Mínimo de 5 páginas para qualquer solicitação de "site" (Home, Sobre, Serviços, Produtos/Portfólio, Contato)
Anti-Padrões de Código
❌ PROIBIDO:
- return []; // TODO: implementar
- throw new Error('Não implementado');
- // placeholder
- Arrays codificados fingindo ser respostas de API
- Funções com corpos vazios
- Blocos catch que engolem erros silenciosamente
- Código comentado em produção
- Números mágicos sem constantes nomeadas
- Código copiado e colado (violação de DRY)
- Funções gigantes (>100 linhas)
- Callbacks profundamente aninhados (>3 níveis)
- Consultas N+1 ao banco de dados em loops
✅ OBRIGATÓRIO:
- Cada função tem implementação real e funcional
- Cada erro é tratado adequadamente com feedback ao usuário
- Constantes são nomeadas e documentadas
- Código é DRY — extraia lógica compartilhada
- Funções são focadas e com menos de 40 linhas
Detecção de Consultas N+1
❌ PROIBIDO (N+1):
// Isso dispara 1 consulta por usuário = problema N+1
for (const user of users) {
const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]);
}
✅ OBRIGATÓRIO (Batch):
// Isso dispara 1 consulta total
const userIds = users.map(u => u.id);
const orders = await db.query(
'SELECT * FROM orders WHERE user_id IN (?)',
[userIds]
);
// Depois agrupe em memória
const ordersByUser = groupBy(orders, 'user_id');
Anti-Padrões de SQL
❌ PROIBIDO:
SELECT * FROM users -- Sem SELECT *
WHERE name LIKE '%" + input + "%' -- SQL injection
ORDER BY RAND() -- Assassino de performance
HAVING COUNT(*) > 0 -- Use WHERE no lugar
WHERE YEAR(created_at) = 2024 -- Quebra uso de índice
✅ OBRIGATÓRIO:
SELECT id, name, email FROM users -- Colunas explícitas
WHERE name LIKE ? -- Parametrizado
ORDER BY id DESC LIMIT 20 -- Ordenação determinística
WHERE created_at >= '2024-01-01' -- Amigável a índices
AND created_at < '2025-01-01'
Lista de Verificação
Antes de QUALQUER entrega ser marcada como completa:
Geral
- Nenhum "em breve" ou "em construção" em lugar nenhum
- Todos os botões são funcionais ou removidos
- Todos os formulários enviam para endpoints reais
- Todas as listas carregam de fontes de dados reais
- Nenhum dado de demonstração codificado em caminhos de produção
- Nenhuma consulta N+1 (verifique cada loop com uma consulta)
- Nenhum comentário TODO sem referências de issue
- Estados de erro tratam erros reais
- Estados de carregamento mostram durante operações reais
Anti-Padrões de Design e UI
- Zero emojis em qualquer lugar do site (use apenas ícones SVG)
- Seções têm mínimo 80px de padding entre elas (sem se tocar)
- Rodapé tem mínimo 128px de padding superior (não colado ao conteúdo)
- Navegação principal tem máximo 7 itens de nível superior
- Links secundários no rodapé, não na navegação principal
- Serviços têm páginas de detalhe individuais (não apenas uma página de listagem)
- Produtos têm páginas de detalhe individuais (não apenas uma página de listagem)
- Cada detalhe de serviço tem: descrição, processo, entregáveis, CTA
- Cada detalhe de produto tem: galeria, especificações, precificação, avaliações
- Fundos de seção alternados para separação visual
Anti-Padrões de SEO (para projetos de site)
- Nenhuma página sem um
<title>e<meta name="description">únicos - Nenhuma página sem tags Open Graph (og:title, og:description, og:image)
- Nenhuma página sem dados estruturados JSON-LD (
<script type="application/ld+json">) - Nenhuma página não inicial sem esquema BreadcrumbList
- Nenhum bloco JSON-LD duplicado (use referências
@idno lugar) - Nenhum
robots.txtousitemap.xmlfaltando - Nenhuma imagem sem texto
alt - Nenhuma página sem URL canônica
- Nenhum atributo
<html lang="xx">faltando - Nenhuma página com mais de um
<h1>
Quando NÃO Usar
NÃO use esta habilidade quando:
- Realizando revisões gerais de qualidade de código (use a habilidade code-review para análises mais amplas)
- Projetando esquemas de banco de dados (use a habilidade database-design para planejamento de esquemas)
- Escrevendo lógica de negócios da aplicação (use a habilidade domain-driven para módulos completos)
- Revisando implementações de endpoints de API (use a habilidade api-design para padrões de endpoint)
- Realizando auditorias de segurança (use a habilidade security-auditor para análise de vulnerabilidades)
- Analisando configurações de implantação (use a habilidade deployment para pipelines de CI/CD)
- Revisando workflows de git ou controle de versão (use a habilidade git-workflow para branching/commits)
- Escrevendo consultas SQL (use a habilidade sql-best-practices para otimização de consultas)
- Projetando layouts de site multi-página (use a habilidade design-system para UI/UX profissional)
- Revisando código existente para necessidades de refatoração (use a habilidade refactoring para transformações seguras)