O que omd:feel — Interface Feel, Quantificado faz?
A indústria usava detalhes de interface por intuição — "essa velocidade", "essa sombra", "esse espaçamento" — e este skill transforma isso em números verificáveis com níveis de procedência para aplicar e auditar. Herda a proposição de Jakub Krehel "great interfaces are a collection of small things that compound", mas responde numericamente quais números acertar / quando estão errados.
Insight central: qualidade é a integral de dezenas de pequenas restrições, cada uma mantida dentro de sua faixa. Um tick de checkbox de 600ms, um focus ring de 1px, contraste de 2,85:1 no texto do corpo, um hover lift sem gate @media (hover:hover) — cada um é uma subtração mensurável do "feel". Este skill impede essas subtrações.
As regras completas (17 eixos, 113 regras) estão em reference.md; a procedência, tier e metodologia de cada número estão em provenance.md. Abaixo está a cheat-sheet sempre carregada; para auditorias profundas ou eixos extremos, leia a referência.
Quando usar
- APPLY — Ao criar ou modificar uma UI, injetar regras quantificadas de feel. ("melhore o feel", "ajuste as interações", "aplique detalhes de interface")
- AUDIT — Verificar HTML/JSX/TSX/CSS existentes contra a tabela de regras, gerando relatório com feel-score + BLOCK/WARN/FYI. ("verifique o feel", "audite esta tela")
Não acionar se não for trabalho de UI. Trabalhos que tratam apenas de copy ou arquitetura de informação não são alvo.
0. Nível de procedência → Força de aplicação (coração do skill)
Toda regra carrega um tier, e o tier define a força de aplicação. É assim que "intuição se torna número honesto" — números de especificação são gates, números de gosto são sugestões.
| Badge | Tier | APPLY | severidade AUDIT |
|---|---|---|---|
| 🟢 SPEC | spec-authoritative (W3C/WCAG·HIG·normative) | Obrigatório | BLOCK |
| 🟢 DS | ds-token (token do design system commitado) | Obrigatório (se a marca não sobrescrever) | BLOCK |
| 🟡 CONV | industry-convention (≥2 profissionais independentes convergentes) | Aplicar como padrão | WARN |
| ⚪ OP | single-opinion (1 pessoa confiável) | Apenas sugestão | FYI |
| ⚪ FOLK | folklore-unverified (origem não rastreável) | Sugestão + tier explícito | FYI |
Distribuição: SPEC 61 · DS 24 · CONV 19 · OP 7 · FOLK 2 → 85/113 com base em spec/token (obrigatórios).
DESIGN.md sempre vence. Se um token do
DESIGN.mdda marca conflitar com uma regra, o token da marca tem autoridade. Estas regras são o padrão quando a marca está em silêncio, não uma substituição. Se houver DESIGN.md na raiz do projeto,omd:applylê os tokens primeiro e preenche apenas os eixos vazios com as regras de feel.
1. Cheat-sheet — Números principais sempre aplicados
Notação de tier: 🟢=obrigatório, 🟡=padrão, ⚪=sugestão. Em conflito: DESIGN.md > 🟢 > 🟡 > ⚪.
Motion & Timing
- Transições de UI cotidianas ~200ms (hover ≤150 · popover ~200 · overlay/modal ~300). Faixa 150–300ms, >400ms = parece lento. 🟡
- Duração quantizada em grade de 50ms (proibido 220/333ms). 🟢
- exit ≈ 0,8 × enter (fechar mais rápido que abrir). 🟢
- Proibida duração global única — proporcional à área/distância do movimento. 🟢
Easing & Springs
- enter/trigger do usuário = ease-out
cubic-bezier(0,0,0.2,1)· exit = ease-in/accelerate · morph já visível = ease-in-out · spinner/progress = linear. Proibido ease-in no enter. 🟡 - Apple = spring padrão
(response 0,55, damping 0,825, bounce 0), UI funcional com bounce <0,4. 🟢 - interruptível: estados interativos usam transition/spring (reatribuível), apenas animações one-shot usam
@keyframes. 🟢
Spacing · Radius · Rhythm
- Base 8px, meio passo 4px (4·8·12·16·24·32·40·48·64). 🟢
- Padding interno ≤ gap externo entre irmãos. 🟡
- Raio concêntrico: outer = inner + padding. 🟢
- Escala tipográfica de UI ~1,25 (major third). 🟡
Shadow & Depth
- Sombras em camadas: 3 a 5 camadas, fonte de luz única no topo. Baixa elevação = tight+sharp, alta elevação = diffuse+spread (rampa Tailwind md→lg). 🟡/DS
- Modo escuro: profundidade com superfícies mais claras, não sombras. 🟡
Typography
- Texto do corpo line-height 1,5, measure ~66ch (45–75). 🟢
- Display tracking −0,02~−0,03em, all-caps +0,05~0,1em, corpo ~0. 🟡
- Números variáveis: tabular-nums; título text-wrap: balance, corpo pretty; layout antialiased. (seed/jakub) 🟡
Color & Contrast
- Texto 4,5:1 (large 3:1) AA · não texto/limite de UI 3:1 · focus ring 3:1 + 2px + offset ~2px. 🟢
- Camada de estado M3: hover 8% · focus 10% · pressed 10% · dragged 16%. 🟢
- disabled ~38% opacity. 🟡
States & Feedback
- Componentes de dados definem 5 estados (empty/loading/error/content/skeleton). 🟡
- pressed: scale 0,96–0,97, 150ms ease-out (fundo 0,95). DS/⚪
- Troca de estado de ícone: scale+opacity+blur 4px→0, spring ~0,3. 🟡
Targets & Pointer
- Alvo de toque 44pt(iOS/WCAG AAA) / 48dp(Material) / 24px(WCAG AA mínimo), alvos adjacentes ≥8pt. 🟢
- cursor: interativo=pointer · inativo=not-allowed · arrastar=grab→grabbing · edição=text. 🟡
Scroll & Gesture
- Overlays/scrollers aninhados:
overscroll-behavior: contain(bloquear scroll chaining·PTR). 🟢 - Limiar de liberação de swipe ~30% de distância ou velocity flick. DS
- scroll-snap: formulário longo=proximity · carrossel=mandatory. 🟢
Response Time & Perceived Perf
- 100ms = imediato · 1s = limite do fluxo de pensamento · 10s = limite de atenção (mostrar % progress). Teto Doherty 400ms. 🟢
- INP ≤200ms p75, orçamento de frame 16,6ms. 🟢
- Spinner apenas se espera prevista >1s; se exibido, manter mínimo 500ms (proibido piscar). Se layout conhecido, usar skeleton. 🟡/DS
Layout Stability (CLS)
- CLS ≤0,1 p75. Mídia deve reservar espaço com width/height ou aspect-ratio.
scrollbar-gutter: stable.font-display: optional(ou swap)+metric override. Proibido inserir conteúdo acima fora da janela de 500ms pós-entrada. 🟢
Modals · Overlays · Z-index
role=dialog+aria-modal=true, ao abrir focar diálogo, Tab trap, Esc fecha, ao fechar restaurar foco para trigger, fundo inert. Scrim#000 ~32%. 🟢- light-dismiss: diálogos temporários/informativos ON, entrada de dados/ação destrutiva OFF. 🟢
- Escada z: dropdown 1000 / sticky 1100 / fixed 1200 / backdrop 1300 / modal 1400 / popover 1500 / toast 1600 / tooltip 1700. Overlays usam portal. (gap-fill)
Performance · Glass · A11y
- Animações apenas transform/opacity(+filter),
transition: allproibido;will-changeé transitório (remover ao parar). 🟢 - Glass:
backdrop-filter: blur(16px) saturate(180%)+ fill semitransparente ~0,6 + hairline 1px + fallback opaco, texto ≥4,5:1. 🟡/🟢 prefers-reduced-motion: reduce→ cross-fade/transição imediata, remover movimentos grandes·parallax (pequena opacidade mantida). ≤3 flashes/s. Proibido remover focus outline sem substituto(:focus-visible). 🟢
Form Validation
- Validação primária no blur, campos com erro passam para on-change (live) (erro removido assim que corrigido). Validação async com debounce 300–500ms. 🟡
2. Fluxo APPLY
- Detectar contexto — Existe
DESIGN.mdna raiz do projeto/pasta alvo? Se sim, executar procedimentoomd:applypara ler tokens (cor·radius·spacing·motion·type) primeiro. Token da marca = autoridade. - Preencher eixos vazios — Apenas eixos que DESIGN.md silencia são preenchidos com valores padrão da cheat-sheet. Eixos profundos (scroll physics·glass·z escada·CLS) consultar seção correspondente em
reference.md. - Respeitar tier — 🟢 aplicar diretamente, 🟡 valor padrão (cede se marca/solicitação sobrescrever), ⚪/FOLK declarar "isto é heurística de gosto" e apenas sugerir.
- Deixar rastro da justificativa — Números não óbvios (ex: exit 0,8×, focus offset 2px) explicar em uma linha o porquê + tier em comentário de código ou descrição. Não inventar números — se não está na cheat-sheet/reference, ler a referência ou dizer que não sabe.
prefers-reduced-motionsempre — se inserir movimento, inserir também a ramificação reduce (A11y não é opcional).
3. Fluxo AUDIT
Padrão advisory (somente leitura) como omd:designer-review + eixo feel. A cada chamada, reler DESIGN.md (proibido cache).
- Entrada:
artifact_path(HTML/JSX/TSX/CSS) + (se houver)design_md_path+ viewport. - Escaneamento machine_check — Aplicar cada regra
🔍 machine_checkdereference.mdao artefato. Ex:transition: all/ duração >400ms / duração fora da grade → detectar- Alvo de toque <44px, focus outline removido, contraste de texto <4,5:1
<img>sem aspect-ratio, modal semaria-modal, overlay semoverscroll-behavior
- Mapear severidade = tier — violação SPEC/DS = BLOCK, CONV = WARN, OP/FOLK = FYI. (Proibido inflar/deflar severidade.)
- feel-score — Proporção de eixos aplicáveis dentro da banda:
🟢 in-band / 🟢 applicablecomo número principal, WARN/FYI como secundários. "feel-score 18/22 SPEC in-band, BLOCK 2, WARN 5". - Saída:
<work_dir>/.reviews/feel-audit-round-<N>.md— cada issue com line ref + tier + justificativa machine_check + fix (actionable). Proibido issue sem line ref ou "looks good" rubber-stamp.
### [BLOCK] Alvo de toque abaixo do mínimo — botão de ícone
- **Localização:** `components/Toolbar.tsx:31`
- **Regra:** §8 Alvos — mínimo 44pt/48dp/24px (🟢 SPEC, WCAG 2.5.8)
- **Evidência:** `<button className="w-6 h-6">` → 24px, sem hit-slop
- **Correção:** Garantir região de toque 44×44 com padding (`p-2.5` + manter ícone visual de 24px)
4. Barreiras de proteção
- ❌ Proibido apresentar folklore como spec. ⚪/FOLK sempre declarar tier. (Lista de rebaixamento no corpus Appendix B — Hick-Hyman 0,155s/bit, Fitts ms/bit, rubberband 0,7, pressed fundo 0,95, exit 0,8×, stagger 80/100ms, optical 2px etc. — não forçar como gate numérico, apenas usar direção.)
- ❌ Proibido inventar números. Se não está na cheat-sheet/reference, ler a referência ou dizer "não sei".
- ❌ Proibido ignorar DESIGN.md e sobrescrever com best-practice genérico. Token da marca primeiro.
- ❌ Proibido inserir movimento sem ramificação
prefers-reduced-motion. - ❌ Proibido inflar severidade (tudo BLOCK), deflacionar (BLOCK para FYI), ou emitir issue sem line ref no AUDIT.
- ❌ Se precisar alterar números, não editar
reference.mdmanualmente; recriar via corpus → gerador.
5. Relações no ecossistema omd
omd:apply— Aplica tokens do DESIGN.md da marca. omd:feel, sobre ele, preenche a camada de sensação onde o token silencia.omd:designer-review— Audita consistência da marca (escala typo/color budget/radius). AUDIT do omd:feel é o par do eixo feel (timing de movimento·alvos·CLS·a11y).omd:taste— Painel de gosto do usuário (conceito separado). Decisões de feel repetidas que se cristalizam em gosto são passadas paraomd:remember.
Verificação manual: Se um componente com
transition: all 0.6s+<button class="w-5 h-5">+ sem ramificaçãoprefers-reduced-motionfor auditado — devem aparecer no mínimo 3 BLOCKs (transition all=GPU SPEC, alvo 20px=WCAG SPEC, falta reduced-motion=a11y SPEC) com line ref, e o feel-score deve ser reduzido proporcionalmente.