Communitygithub.com

Omar-Obando/qwen-orchestrator

Habilidade de detecção e prevenção de anti-padrões. Captura dados codificados, elementos de UI não funcionais, código de placeholder, consultas N+1 e outros anti-padrões comuns de desenvolvimento antes de serem enviados para produção.

O que é qwen-orchestrator?

Habilidade especializada em detectar e prevenir anti-padrões de desenvolvimento que fazem o software parecer inacabado ou amador. Ela abrange desde UI/UX (botões não funcionais, formulários sem envio, landing pages únicas quando se pede 'um site') até arquitetura de sites (falta de páginas separadas, navegação ausente), código (funções vazias, consultas N+1, SQL injection) e design visual (emojis no lugar de ícones SVG, espaçamento ausente entre seções). A habilidade impõe uma lista de verificação rigorosa antes de qualquer entrega ser considerada completa, garantindo que todos os botões funcionem, formulários enviem para endpoints reais, listas carreguem de fontes de dados autênticas e que sites tenham pelo menos 5 páginas com paleta de cores consistente e SEO adequado. Ela é útil para times que querem manter qualidade profissional, evitar retrabalho e garantir que o código entregue seja funcional, escalável e visualmente consistente. É compatível com agentes de IA como Claude Code, Cursor e Codex, e pode ser usada como um gate de qualidade antes de commits ou deploys.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Omar-Obando/qwen-orchestrator/tree/HEAD/skills/anti-pattern

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 @id no lugar)
  • Nenhum robots.txt ou sitemap.xml faltando
  • 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)

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas