Communitygithub.com

Omar-Obando/qwen-orchestrator

Habilidad de detección y prevención de antipatrones. Detecta datos hardcodeados, elementos de UI no funcionales, código placeholder, consultas N+1 y otros antipatrones comunes de desarrollo antes de que lleguen a producción.

¿Qué es qwen-orchestrator?

Esta habilidad (skill) para asistentes de código como Claude Code, Cursor o Codex está diseñada para detectar y prevenir automáticamente los antipatrones más comunes que hacen que el software se vea inacabado o poco profesional. Su objetivo principal es garantizar que el código enviado sea funcional, consistente y siga buenas prácticas, abarcando desde la interfaz de usuario hasta la lógica de base de datos. La habilidad define una lista de elementos prohibidos con tolerancia cero, incluyendo secciones "Próximamente", botones no funcionales, datos falsos hardcodeados, consultas N+1, selecciones ineficientes en SQL, y ausencia de un sistema de diseño consistente. Además, proporciona una lista de verificación detallada que se debe cumplir antes de marcar cualquier entrega como completa, cubriendo aspectos generales, de diseño UI y de SEO. Es importante destacar que esta habilidad no debe usarse para revisiones generales de código, diseño de bases de datos o escritura de consultas SQL, ya que existen otras habilidades especializadas para esos fines. Su uso asegura que el software se entregue con código real, no decoraciones.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad de Antipatrones — Entrega Código Real, No Decoraciones

Esta habilidad detecta y previene los antipatrones más comunes que hacen que el software se vea inacabado o poco profesional.

Antipatrones Prohibidos (TOLERANCIA CERO)

Antipatrones de UI/UX

❌ PROHIBIDO:
- Secciones o etiquetas "Próximamente"
- Botones no funcionales (deben funcionar o ser eliminados)
- Formularios que no envían datos a ningún lado
- Datos falsos hardcodeados en componentes de producción
- Tablas estáticas que pretenden ser dinámicas
- Enlaces que no llevan a ningún lado (href="#")
- Banners "En construcción"
- Feature flags permanentemente desactivados
- Inputs deshabilitados sin una explicación clara
- Estados vacíos sin mensajes útiles
- Paginación que no pagina realmente
- Barras de búsqueda que no buscan realmente
- Filtros que devuelven los mismos resultados
- PÁGINA DE INICIO ÚNICA cuando el usuario pide "un sitio web" (DEBE ser multipágina)
- Ninguna paleta de colores definida antes de escribir CSS
- Colores hex aleatorios sin un sistema de diseño documentado
- Colores inconsistentes entre páginas (diferentes azules, diferente espaciado)
- EMOTICONOS en cualquier parte del sitio web (usa iconos SVG de Lucide/Heroicons/Phosphor)
- Secciones tocándose entre sí (sin espacio entre bloques de contenido)
- Pie de página pegado directamente a la sección superior (sin espacio de respiración)
- Navegación con más de 7 elementos de nivel superior (desordenado, abrumador)
- Páginas de servicios sin páginas de detalle individuales (/services solamente, no /services/web-design)
- Páginas de productos sin páginas de detalle individuales (/products solamente, no /products/[slug])
- Descripciones de servicios genéricas (2-3 líneas por servicio NO es suficiente)

✅ REQUERIDO:
- Cada botón visible activa un manejador real o es eliminado
- Cada formulario tiene un onSubmit real conectado a una llamada API
- Cada lista carga desde una fuente de datos real con estados de carga
- Cada enlace navega a un destino real
- Los estados vacíos explican por qué y sugieren próximas acciones
- Los estados de error muestran mensajes de error reales del servidor
- Los estados de carga aparecen durante operaciones asíncronas reales
- Sitio web multipágina con rutas separadas (Inicio, Acerca de, Servicios, Contacto, Productos)
- Paleta profesional de 6 colores (--color-primary, secondary, accent, bg, surface, text)
- Sistema de diseño consistente en TODAS las páginas
- CERO emoticonos — usa iconos SVG (Lucide, Heroicons, Phosphor)
- Espaciado entre secciones: mínimo 80px de padding entre secciones
- Pie de página: mínimo 128px de padding superior (nunca tocar el contenido de arriba)
- Navegación: máximo 7 elementos, menús desplegables para grupos, enlaces secundarios en el pie
- Servicios: página de listado + páginas de detalle individuales por servicio
- Productos: página de listado + páginas de detalle individuales por producto
- Cada detalle de servicio: descripción, proceso, entregables, precios, preguntas frecuentes, CTA
- Cada detalle de producto: galería, especificaciones, precios, reseñas, productos relacionados

Antipatrones de Arquitectura de Sitios Web

❌ PROHIBIDO (cuando el usuario dice "construye un sitio web"):
- Crear index.html como el ÚNICO archivo
- Poner todo el contenido en una sola página desplazable
- Usar enlaces de anclaje (#about, #services) en lugar de páginas separadas
- Llamarlo "sitio web" cuando es solo una página de aterrizaje
- Sin menú de navegación entre secciones/páginas
- Sin encabezado/pie de página compartidos entre páginas
- Sin título meta único ni descripción por página

✅ REQUERIDO:
- Ruta/página separada para cada sección (ej., /about, /services, /contact)
- Menú de navegación que enlace todas las páginas
- Componentes de encabezado + pie de página compartidos
- Cada página tiene un <title> y <meta description> únicos
- Paleta de colores y tipografía consistentes en TODAS las páginas
- Mínimo 5 páginas para cualquier solicitud de "sitio web" (Inicio, Acerca de, Servicios, Productos/Portafolio, Contacto)

Antipatrones de Código

❌ PROHIBIDO:
- return []; // TODO: implementar
- throw new Error('No implementado');
- // placeholder
- Arreglos hardcodeados que pretenden ser respuestas de API
- Funciones con cuerpos vacíos
- Bloques catch que silencian errores
- Código comentado en producción
- Números mágicos sin constantes nombradas
- Código copiado y pegado (violación DRY)
- Funciones dios (>100 líneas)
- Callbacks profundamente anidados (>3 niveles)
- Consultas N+1 a la base de datos en bucles

✅ REQUERIDO:
- Cada función tiene una implementación real y funcional
- Cada error se maneja adecuadamente con retroalimentación al usuario
- Las constantes están nombradas y documentadas
- El código es DRY — extraer lógica compartida
- Las funciones son enfocadas y de menos de 40 líneas

Detección de Consultas N+1

❌ PROHIBIDO (N+1):
// Esto dispara 1 consulta por usuario = problema N+1
for (const user of users) {
  const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]);
}

✅ REQUERIDO (Por lotes):
// Esto dispara 1 consulta en total
const userIds = users.map(u => u.id);
const orders = await db.query(
  'SELECT * FROM orders WHERE user_id IN (?)',
  [userIds]
);
// Luego agrupar en memoria
const ordersByUser = groupBy(orders, 'user_id');

Antipatrones de SQL

❌ PROHIBIDO:
SELECT * FROM users                    -- Sin SELECT *
WHERE name LIKE '%" + input + "%'     -- Inyección SQL
ORDER BY RAND()                        -- Asesino de rendimiento
HAVING COUNT(*) > 0                    -- Usar WHERE en su lugar
WHERE YEAR(created_at) = 2024          -- Rompe el uso de índices

✅ REQUERIDO:
SELECT id, name, email FROM users      -- Columnas explícitas
WHERE name LIKE ?                      -- Parametrizado
ORDER BY id DESC LIMIT 20              -- Orden determinista
WHERE created_at >= '2024-01-01'       -- Amigable con índices
  AND created_at < '2025-01-01'

Lista de Verificación

Antes de marcar CUALQUIER entrega como completa:

General

  • Sin "próximamente" o "en construcción" en ninguna parte
  • Todos los botones son funcionales o han sido eliminados
  • Todos los formularios envían a endpoints reales
  • Todas las listas cargan desde fuentes de datos reales
  • Sin datos de demostración hardcodeados en rutas de producción
  • Sin consultas N+1 (revisar cada bucle con una consulta)
  • Sin comentarios TODO sin referencias a issues
  • Los estados de error manejan errores reales
  • Los estados de carga se muestran durante operaciones reales

Antipatrones de Diseño y UI

  • Cero emoticonos en cualquier parte del sitio web (usa solo iconos SVG)
  • Las secciones tienen un mínimo de 80px de padding entre ellas (sin tocarse)
  • El pie de página tiene un mínimo de 128px de padding superior (no pegado al contenido)
  • La navegación principal tiene un máximo de 7 elementos de nivel superior
  • Enlaces secundarios en el pie de página, no en la navegación principal
  • Los servicios tienen páginas de detalle individuales (no solo una página de listado)
  • Los productos tienen páginas de detalle individuales (no solo una página de listado)
  • Cada detalle de servicio tiene: descripción, proceso, entregables, CTA
  • Cada detalle de producto tiene: galería, especificaciones, precios, reseñas
  • Fondos de sección alternados para separación visual

Antipatrones de SEO (para proyectos de sitios web)

  • Ninguna página sin un <title> único y <meta name="description">
  • Ninguna página sin etiquetas Open Graph (og:title, og:description, og:image)
  • Ninguna página sin datos estructurados JSON-LD (<script type="application/ld+json">)
  • Ninguna página que no sea la de inicio sin esquema BreadcrumbList
  • Sin bloques JSON-LD duplicados (usar referencias @id en su lugar)
  • Sin falta de robots.txt o sitemap.xml
  • Ninguna imagen sin texto alt
  • Ninguna página sin URL canónica
  • Sin falta del atributo <html lang="xx">
  • Ninguna página con más de un <h1>

Cuándo NO Usar

NO uses esta habilidad cuando:

  • Realices revisiones generales de calidad de código (usa la habilidad code-review para un análisis más amplio)
  • Diseñes esquemas de base de datos (usa la habilidad database-design para planificación de esquemas)
  • Escribas lógica de negocio de aplicaciones (usa la habilidad domain-driven para módulos completos)
  • Revises implementaciones de endpoints de API (usa la habilidad api-design para patrones de endpoint)
  • Realices auditorías de seguridad (usa la habilidad security-auditor para análisis de vulnerabilidades)
  • Analices configuraciones de despliegue (usa la habilidad deployment para pipelines CI/CD)
  • Revises flujos de trabajo de git o control de versiones (usa la habilidad git-workflow para ramificaciones/commits)
  • Escribas consultas SQL (usa la habilidad sql-best-practices para optimización de consultas)
  • Diseñes diseños de sitios web multipágina (usa la habilidad design-system para UI/UX profesional)
  • Revises código existente para necesidades de refactorización (usa la habilidad refactoring para transformaciones seguras)

Individual skills in this repo

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

Skills relacionados