Communitygithub.com

omd:feel — Interface Feel, Quantificado

Transforma detalhes de interface que antes dependiam de 'intuição' em regras quantificáveis, aplicando (APPLY) ou auditando (AUDIT) com base em 17 eixos e 113 regras com níveis de procedência. Herda a filosofia de Jakub Krehel e a expande com HIG/Material/WCAG/DS tokens e pesquisa prática.

O que é omd:feel — Interface Feel, Quantificado?

O skill omd:feel fornece um framework quantificado para medir e aplicar a 'sensação' (feel) de interfaces de usuário, substituindo decisões subjetivas por regras numéricas com níveis de procedência. Ele oferece dois fluxos principais: APPLY, que injeta regras de feel quantificadas ao criar ou modificar UIs, e AUDIT, que verifica HTML/JSX/TSX/CSS existentes contra essas regras, gerando um relatório com pontuação de feel e severidade (BLOCK/WARN/FYI). As regras cobrem 17 eixos, incluindo motion & timing, easing, radius concêntrico, tabular-nums, alvo de 44px, anel de foco, prefers-reduced-motion, entre outros. Cada regra possui um tier (SPEC, DS, CONV, OP, FOLK) que define sua força de aplicação, e o DESIGN.md do projeto sempre tem prioridade sobre as regras padrão. O skill é acionado por comandos como 'feel 좋게', 'feel 점검', 'make this feel better', 'polish the interactions', ou similares em português como 'melhore o feel', 'aplique detalhes de interface', 'verifique o feel', 'ajuste microinterações'.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/nococn/omd-feel/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

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.

BadgeTierAPPLYseveridade AUDIT
🟢 SPECspec-authoritative (W3C/WCAG·HIG·normative)ObrigatórioBLOCK
🟢 DSds-token (token do design system commitado)Obrigatório (se a marca não sobrescrever)BLOCK
🟡 CONVindustry-convention (≥2 profissionais independentes convergentes)Aplicar como padrãoWARN
⚪ OPsingle-opinion (1 pessoa confiável)Apenas sugestãoFYI
⚪ FOLKfolklore-unverified (origem não rastreável)Sugestão + tier explícitoFYI

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.md da 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:apply lê 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: all proibido; 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

  1. Detectar contexto — Existe DESIGN.md na raiz do projeto/pasta alvo? Se sim, executar procedimento omd:apply para ler tokens (cor·radius·spacing·motion·type) primeiro. Token da marca = autoridade.
  2. 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.
  3. Respeitar tier — 🟢 aplicar diretamente, 🟡 valor padrão (cede se marca/solicitação sobrescrever), ⚪/FOLK declarar "isto é heurística de gosto" e apenas sugerir.
  4. 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.
  5. prefers-reduced-motion sempre — 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).

  1. Entrada: artifact_path(HTML/JSX/TSX/CSS) + (se houver) design_md_path + viewport.
  2. Escaneamento machine_check — Aplicar cada regra 🔍 machine_check de reference.md ao 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 sem aria-modal, overlay sem overscroll-behavior
  3. Mapear severidade = tier — violação SPEC/DS = BLOCK, CONV = WARN, OP/FOLK = FYI. (Proibido inflar/deflar severidade.)
  4. feel-score — Proporção de eixos aplicáveis dentro da banda: 🟢 in-band / 🟢 applicable como número principal, WARN/FYI como secundários. "feel-score 18/22 SPEC in-band, BLOCK 2, WARN 5".
  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.md manualmente; 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 para omd:remember.

Verificação manual: Se um componente com transition: all 0.6s + <button class="w-5 h-5"> + sem ramificação prefers-reduced-motion for 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.

Habilidades Relacionadas