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
@iden su lugar) - Sin falta de
robots.txtositemap.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)