¿Qué hace omd:feel — Sensaciones de Interfaz Cuantificadas?
Un skill que convierte los detalles de interfaz que la industria manejaba por intuición — "esta velocidad", "esta sombra", "este margen" — en números verificables con niveles de procedencia para aplicarlos y auditarlos. Hereda la premisa de Jakub Krehel de que "las grandes interfaces son una colección de pequeños detalles que se acumulan", pero responde con cifras: qué números hay que cumplir / cuándo se incumplen.
Insight clave: la calidad es la integral de decenas de pequeñas restricciones confinadas dentro de su banda. Un checkbox que tarda 600ms, un focus ring de 1px, un contraste de texto de 2.85:1, un hover lift sin @media (hover:hover) — cada uno es una resta medible de la "sensación". Este skill evita esa resta.
Todas las reglas (17 ejes, 113 reglas) están en reference.md; el origen, nivel y metodología de cada número está en provenance.md. El cheat-sheet de abajo es el núcleo que se carga siempre; para auditorías profundas o ejes marginales, consulta la referencia.
Cuándo usarlo
- APPLY — Inyecta reglas cuantitativas de "sensación" al crear o modificar una UI. ("mejora la sensación", "pule la interacción", "aplica los detalles")
- AUDIT — Inspecciona HTML/JSX/TSX/CSS existente contra la tabla de reglas y genera un informe con feel-score + BLOCK/WARN/FYI. ("revisa la sensación", "audita esta pantalla")
No se activa si la tarea no es de UI. Trabajos que solo tratan copy o arquitectura de información no aplican.
0. Nivel de procedencia → Intensidad de aplicación (el corazón del skill)
Cada regla lleva un nivel (tier), y el tier determina la fuerza de aplicación. Así es como se cuantifica honestamente la intuición: los números de especificación son puertas obligatorias, los números de gusto son sugerencias.
| Badge | Tier | APPLY | severidad AUDIT |
|---|---|---|---|
| 🟢 SPEC | spec-authoritative (W3C/WCAG·HIG·normativo) | Forzoso | BLOCK |
| 🟢 DS | ds-token (tokens de sistema de diseño confirmados) | Forzoso (si la marca no lo sobreescribe) | BLOCK |
| 🟡 CONV | industry-convention (≥2 profesionales independientes convergen) | Se aplica por defecto | WARN |
| ⚪ OP | single-opinion (1 persona de confianza) | Solo sugerencia | FYI |
| ⚪ FOLK | folklore-unverified (sin rastro de evidencia) | Sugerencia + indicar tier | FYI |
Distribución: SPEC 61 · DS 24 · CONV 19 · OP 7 · FOLK 2 → 85/113 con evidencia especificativa o de token (forzables).
DESIGN.md siempre gana. Si los tokens de la marca en
DESIGN.mdchocan con una regla, los tokens de marca tienen autoridad. Estas reglas son valores por defecto cuando la marca calla, no una sobreescritura. Si existeDESIGN.mden la raíz del proyecto, primero se leen sus tokens conomd:applyy solo los ejes que queden vacíos se rellenan con reglas de feel.
1. Cheat-sheet — Núcleo de números que se aplican siempre
Indicación de tier: 🟢=forzoso, 🟡=por defecto, ⚪=sugerencia. En caso de conflicto: DESIGN.md > 🟢 > 🟡 > ⚪.
Movimiento y temporización
- Transiciones de UI cotidianas ~200ms (hover ≤150 · popover ~200 · overlay/modal ~300). Rango 150–300ms, >400ms se ve lento. 🟡
- La duración se cuantiza en cuadrícula de 50ms (prohibido 220/333ms). 🟢
- salida ≈ 0.8 × entrada (más rápido al cerrar que al abrir). 🟢
- Prohibido una duración global única — debe ser proporcional al área/distancia de movimiento. 🟢
Easing y muelles (springs)
- entrada/desencadenada por usuario = ease-out
cubic-bezier(0,0,0.2,1)· salida = ease-in/aceleración · morph ya visible = ease-in-out · spinner/progress = linear. Prohibido ease-in en entrada. 🟡 - Apple = spring por defecto
(response 0.55, damping 0.825, bounce 0), en UI funcional bounce <0.4. 🟢 - Interrumpible: los estados interactivos usan transition/spring (pueden re-target), solo las animaciones de una sola vez usan
@keyframes. 🟢
Espaciado · Radio · Ritmo
- Base 8px, medio paso 4px (4·8·12·16·24·32·40·48·64). 🟢
- padding interno ≤ gap externo entre hermanos. 🟡
- Radio concéntrico: outer = inner + padding. 🟢
- Escala tipográfica de UI ~1.25 (tercera mayor). 🟡
Sombra y profundidad
- Sombras en capas de 3 a 5, una única fuente de luz arriba. Baja elevación = apretada+definida, alta elevación = difusa+amplia (rampa Tailwind md→lg). 🟡/DS
- Modo oscuro: profundidad mediante superficies más claras en lugar de sombras. 🟡
Tipografía
- line-height 1.5 para cuerpo, medida ~66ch (45–75). 🟢
- tracking de display −0.02~−0.03em, todo mayúsculas +0.05~0.1em, cuerpo ~0. 🟡
- Números variables: tabular-nums; títulos text-wrap: balance, cuerpo pretty; usos de layout antialiased. (seed/jakub) 🟡
Color y contraste
- Texto 4.5:1 (grande 3:1) AA · no texto/límites UI 3:1 · focus ring 3:1 + 2px + offset ~2px. 🟢
- Capas de estado M3: hover 8% · focus 10% · pressed 10% · dragged 16%. 🟢
- deshabilitado ~38% de opacidad. 🟡
Estados y retroalimentación
- Los componentes de datos deben definir los 5 estados (vacío/carga/error/contenido/esqueleto). 🟡
- presionado: escala 0.96–0.97, 150ms ease-out (límite inferior 0.95). DS/⚪
- Cambio de estado de iconos: escala+opacidad+blur 4px→0, spring ~0.3. 🟡
Objetivos y puntero
- Objetivo táctil 44pt(iOS/WCAG AAA) / 48dp(Material) / 24px(WCAG AA mínimo), distancia entre objetivos adyacentes ≥8pt. 🟢
- cursor: interactivo=pointer · deshabilitado=not-allowed · arrastre=grab→grabbing · edición=text. 🟡
Scroll y gestos
- Superposiciones/scroll anidados:
overscroll-behavior: contain(evita encadenamiento de scroll y PTR). 🟢 - Umbral de liberación de swipe ~30% de distancia o velocidad flick. DS
- scroll-snap: formularios largos=proximity · carrusel=mandatory. 🟢
Tiempo de respuesta y percepción de rendimiento
- 100ms = instantáneo · 1s = límite del flujo mental · 10s = límite de atención (mostrar % de progreso). Techo de Doherty 400ms. 🟢
- INP ≤200ms p75, presupuesto de frame 16.6ms. 🟢
- Spinner solo si la espera prevista >1s; si se muestra, mantener al menos 500ms (evitar parpadeos). Si se conoce el layout, usar skeleton. 🟡/DS
Estabilidad del layout (CLS)
- CLS ≤0.1 p75. Los medios deben reservar espacio con width/height o aspect-ratio.
scrollbar-gutter: stable.font-display: optional(o swap) + metric override. Prohibido insertar contenido arriba fuera de la ventana de 500ms posterior a la entrada. 🟢
Modales · Superposiciones · Z-index
role=dialog+aria-modal=true, al abrir enfocar el diálogo, trampa de Tab, cierre con Esc, al cerrar restaurar el foco al elemento que lo abrió, fondo inert. scrim#000 ~32%. 🟢- light-dismiss: diálogos temporales/de información SÍ, entrada de datos/acciones destructivas NO. 🟢
- Escalera z: dropdown 1000 / sticky 1100 / fixed 1200 / backdrop 1300 / modal 1400 / popover 1500 / toast 1600 / tooltip 1700. Las superposiciones usan portal. (relleno de huecos)
Rendimiento · Cristal · Accesibilidad
- Animaciones solo con transform/opacity(+filter), prohibido
transition: all;will-changees transitorio (eliminar al reposo). 🟢 - Cristal:
backdrop-filter: blur(16px) saturate(180%)+ relleno semitransparente ~0.6 + 1px hairline + fallback opaco, texto ≥4.5:1. 🟡/🟢 prefers-reduced-motion: reduce→ cross-fade/transición inmediata, eliminar grandes movimientos/parallax (pequeña opacidad se mantiene). ≤3 destellos/s. Prohibido eliminar focus outline sin alternativa (:focus-visible). 🟢
Validación de formularios
- Validación primaria en blur, una vez que un campo tiene error, cambiar a on-change (en vivo) (el error se elimina al corregir). Debounce para validación asíncrona 300–500ms. 🟡
2. Flujo de trabajo APPLY
- Detección de contexto — ¿Existe
DESIGN.mden la raíz del proyecto o en la carpeta de destino? Si existe, leer primero los tokens (color·radio·espaciado·movimiento·tipografía) con el procedimientoomd:apply. Los tokens de marca = autoridad. - Rellenar ejes vacíos — Solo los ejes sobre los que DESIGN.md calla se llenan con los valores por defecto del cheat-sheet. Para ejes profundos (física de scroll·cristal·escalera z·CLS), consultar la sección correspondiente de
reference.md. - Respetar niveles — 🟢 se aplica tal cual, 🟡 es valor por defecto (cede si la marca o la solicitud lo sobreescriben), ⚪/FOLK se presentan como "esto es una heurística de gusto" y solo se sugieren.
- Dejar evidencia en la salida — Los números no obvios (p. ej., salida 0.8×, offset de focus 2px) se explican en una línea con el motivo + tier, ya sea en comentarios de código o en la descripción. No inventar números — si no está en el cheat-sheet/reference, leer la referencia o decir que no se sabe.
prefers-reduced-motionsiempre acompañante — si se añade movimiento, también se añade la rama reduce (la accesibilidad no es opcional).
3. Flujo de trabajo AUDIT
Patrón de asesoría (solo lectura) como omd:designer-review + eje feel. Cada llamada relee DESIGN.md (sin caché).
- Entrada:
artifact_path(HTML/JSX/TSX/CSS) + (si existe)design_md_path+ viewport. - Escaneo machine_check — Aplica cada regla
🔍 machine_checkdereference.mdal artifact. Ejemplos:transition: all/ duración >400ms / duración fuera de cuadrícula → detectar- Objetivo táctil <44px, focus outline eliminado, contraste de texto <4.5:1
<img>sin aspect-ratio, modal sinaria-modal, superposición sinoverscroll-behavior
- severidad = mapeo de tier — Incumplimiento de SPEC/DS = BLOCK, CONV = WARN, OP/FOLK = FYI. (Prohibido inflar/deflar la severidad.)
- feel-score — Proporción de ejes aplicables que están dentro de la banda:
🟢 in-band / 🟢 applicablecomo número principal; WARN/FYI son secundarios. "feel-score 18/22 SPEC in-band, BLOCK 2, WARN 5". - Salida:
<work_dir>/.reviews/feel-audit-round-<N>.md— cada incidencia con ref de línea + tier + evidencia de machine_check + corrección (actionable). Prohibido emitir incidencias sin ref de línea o hacer rubber-stamp "se ve bien".
### [BLOCK] Objetivo táctil por debajo del mínimo — botón de icono
- **Ubicación:** `components/Toolbar.tsx:31`
- **Regla:** §8 Objetivos — mínimo 44pt/48dp/24px (🟢 SPEC, WCAG 2.5.8)
- **Evidencia:** `<button className="w-6 h-6">` → 24px, sin hit-slop
- **Corrección:** Asegurar región de impacto 44×44 con padding (`p-2.5` + mantener icono visual de 24px)
4. Barreras de seguridad
- ❌ Prohibido presentar folklore como especificación. ⚪/FOLK siempre indican su tier. (La lista de degradados del corpus Appendix B — Hick-Hyman 0.155s/bit, Fitts ms/bit, rubberband 0.7, pressed suelo 0.95, exit 0.8×, stagger 80/100ms, optical 2px, etc. — no deben forzarse como puertas numéricas, solo tomar la dirección.)
- ❌ Prohibido inventar números. Si no está en el cheat-sheet/reference, leer la referencia o decir "no lo sé".
- ❌ Prohibido ignorar DESIGN.md y sobreescribir con mejores prácticas genéricas. Los tokens de marca van primero.
- ❌ Prohibido añadir movimiento sin incluir la rama
prefers-reduced-motion. - ❌ En AUDIT, prohibido inflar severidad (todo BLOCK), deflarla (BLOCK a FYI), o emitir incidencias sin ref de línea.
- ❌ Si es necesario cambiar un número, no editar
reference.mda mano — regenerar desde corpus → generador.
5. Relaciones con el ecosistema omd
omd:apply— Aplica tokens de marca de DESIGN.md. omd:feel actúa encima, rellenando la capa de sensación donde los tokens callan.omd:designer-review— Audita la coherencia de marca (tipografía/presupuesto de color/escala de radios). La auditoría de omd:feel es su contraparte del eje feel (temporización de movimiento·objetivos·CLS·accesibilidad).omd:taste— Panel de gusto del usuario (concepto aparte). Las decisiones de feel que se repiten y se consolidan como gusto fluyen a través deomd:remember.
Verificación manual: Si AUDIT detecta
transition: all 0.6s+<button class="w-5 h-5">+ un componente sin ramaprefers-reduced-motion, deben aparecer al menos 3 BLOCK (transition all=GPU SPEC, objetivo 20px=WCAG SPEC, falta de reduced-motion=accesibilidad SPEC) con sus respectivas referencias de línea, y el feel-score debe reducirse en consecuencia.