omd-feel

name	omd:feel
description	디자인·프론트 업계가 '감'으로 쓰던 인터페이스 디테일을 수치화한 규칙으로 적용(APPLY)하거나 감사(AUDIT)한다. Jakub Krehel의 make-interfaces-feel-better 철학을 계승 + HIG/Material/WCAG/DS 토큰/실무자 리서치로 확장한 17축·113규칙(provenance 등급별). 모션 타이밍·이징·동심원 radius·tabular-nums·44px 타깃·focus ring·prefers-reduced-motion 등. 'feel 좋게 다듬어줘', '인터페이스 디테일 적용', 'feel 점검', '마이크로 인터랙션 손봐줘', 'make this feel better', 'polish the interactions', 「インターフェースの細部を詰めて」, 「介面細節打磨」 류에 트리거. 브랜드 토큰은 DESIGN.md(omd:apply)가 우선.
user-invocable	true

omd:feel — Interface Feel, Quantified

업계가 감(感)으로 쓰던 인터페이스 디테일 — "이 정도 속도", "이 정도 그림자", "이 정도 여백" — 을 출처 등급이 매겨진 체크 가능한 숫자로 바꿔 적용하고 감사하는 스킬. Jakub Krehel의 "great interfaces are a collection of small things that compound" 명제를 계승하되, 어떤 숫자를 맞춰야 하는지 / 언제 틀렸는지까지 수치로 답한다.

핵심 통찰: 품질은 수십 개 작은 제약을 각자의 band 안에 가둔 것의 적분이다. 600ms짜리 체크박스 틱, 1px focus ring, 본문 2.85:1 대비, @media (hover:hover) 게이트 없는 hover lift — 하나하나가 "feel"에서 측정 가능한 차감이다. 이 스킬은 그 차감을 막는다.

전체 규칙(17축·113개)은 reference.md에, 각 숫자의 출처·tier·방법론은 provenance.md에 있다. 아래 cheat-sheet는 항상 로드되는 핵심이고, 깊은 감사·엣지 축은 reference를 읽는다.

언제 쓰나

• APPLY — UI를 새로 만들거나 고칠 때 정량 feel 규칙을 주입. ("feel 좋게", "인터랙션 손봐줘", "디테일 적용")
• AUDIT — 기존 HTML/JSX/TSX/CSS를 규칙표 대비 점검해 feel-score + BLOCK/WARN/FYI 리포트. ("feel 점검", "이 화면 감사해줘")

UI 작업이 아니면 트리거하지 않는다. 카피·정보구조만 다루는 작업은 대상 아님.

0. 출처 등급 → 강제 강도 (이 스킬의 심장)

모든 규칙은 tier를 달고 있고, tier가 강제 강도를 정한다. 이게 "감을 정직하게 수치화"하는 방법 — spec 숫자는 게이트, 취향 숫자는 제안.

Badge	Tier	APPLY	AUDIT severity
🟢 SPEC	spec-authoritative (W3C/WCAG·HIG·normative)	강제	BLOCK
🟢 DS	ds-token (커밋된 디자인시스템 토큰)	강제 (브랜드가 덮지 않으면)	BLOCK
🟡 CONV	industry-convention (독립 실무자 ≥2 수렴)	기본값으로 적용	WARN
⚪ OP	single-opinion (신뢰할 만한 1인)	제안만	FYI
⚪ FOLK	folklore-unverified (근거 추적 불가)	제안 + tier 명시	FYI

분포: SPEC 61 · DS 24 · CONV 19 · OP 7 · FOLK 2 → 85/113이 spec·token 근거(강제 가능).

DESIGN.md가 항상 이긴다. 브랜드 DESIGN.md 토큰이 규칙과 충돌하면 브랜드 토큰이 권위. 이 규칙들은 브랜드가 침묵할 때의 기본값이지 override가 아니다. 프로젝트 루트에 DESIGN.md가 있으면 omd:apply로 먼저 토큰을 읽고, 빈 축만 feel 규칙으로 채운다.

1. Cheat-sheet — 항상 적용하는 핵심 숫자

tier 표기: 🟢=강제, 🟡=기본값, ⚪=제안. 충돌 시 DESIGN.md > 🟢 > 🟡 > ⚪.

Motion & Timing

• 일상 UI 전환 ~200ms (hover ≤150 · popover ~200 · overlay/modal ~300). 범위 150–300ms, >400ms = 굼떠 보임. 🟡
• duration은 50ms 그리드에 양자화 (220/333ms 금지). 🟢
• exit ≈ 0.8 × enter (열 때보다 닫을 때 빠르게). 🟢
• 한 개의 전역 duration 금지 — 이동 면적/거리에 비례. 🟢

Easing & Springs

• enter/사용자 트리거 = ease-out cubic-bezier(0,0,0.2,1) · exit = ease-in/accelerate · 이미 보이는 morph = ease-in-out · 스피너/progress = linear. enter에 ease-in 금지. 🟡
• Apple = spring 기본 (response 0.55, damping 0.825, bounce 0), 기능적 UI는 bounce <0.4. 🟢
• interruptible: 인터랙티브 상태는 transition/spring(재타깃 가능), one-shot 연출만 @keyframes. 🟢

Spacing · Radius · Rhythm

• 8px base, 4px half-step (4·8·12·16·24·32·40·48·64). 🟢
• 내부 padding ≤ 형제 간 외부 gap. 🟡
• 동심원 radius: outer = inner + padding. 🟢
• UI 타입 스케일 ~1.25(major third). 🟡

Shadow & Depth

• 레이어드 그림자 3–5겹, 광원은 위 하나. 저고도=tight+sharp, 고고도=diffuse+spread (Tailwind md→lg 램프). 🟡/DS
• 다크모드는 그림자보다 밝은 표면으로 깊이를 낸다. 🟡

Typography

• 본문 line-height 1.5, measure ~66ch (45–75). 🟢
• display tracking −0.02~−0.03em, all-caps +0.05~0.1em, 본문 ~0. 🟡
• 변하는 숫자엔 tabular-nums; 제목 text-wrap: balance, 본문 pretty; 레이아웃에 antialiased. (seed/jakub) 🟡

Color & Contrast

• 텍스트 4.5:1(large 3:1) AA · 비텍스트/UI 경계 3:1 · focus ring 3:1 + 2px + ~2px offset. 🟢
• M3 state layer: hover 8% · focus 10% · pressed 10% · dragged 16%. 🟢
• disabled ~38% opacity. 🟡

States & Feedback

• 데이터 컴포넌트는 5 상태(empty/loading/error/content/skeleton) 전부 정의. 🟡
• pressed: scale 0.96–0.97, 150ms ease-out (바닥 0.95). DS/⚪
• 아이콘 상태 스왑: scale+opacity+blur 4px→0, spring ~0.3. 🟡

Targets & Pointer

• 탭 타깃 44pt(iOS/WCAG AAA) / 48dp(Material) / 24px(WCAG AA 최소), 인접 타깃 간 ≥8pt. 🟢
• cursor: 인터랙티브=pointer · 비활성=not-allowed · 드래그=grab→grabbing · 편집=text. 🟡

Scroll & Gesture

• 오버레이/중첩 스크롤러에 overscroll-behavior: contain (스크롤 체이닝·PTR 차단). 🟢
• 스와이프 해제 임계 ~30% 거리 또는 velocity flick. DS
• scroll-snap: 롱폼=proximity · 캐러셀=mandatory. 🟢

Response Time & Perceived Perf

• 100ms = 즉각 · 1s = 사고 흐름 한계 · 10s = 주의 한계(% progress 표시). Doherty 400ms ceiling. 🟢
• INP ≤200ms p75, 프레임 예산 16.6ms. 🟢
• 스피너는 예상 대기 >1s일 때만; 띄웠으면 최소 500ms 유지(깜빡임 금지). 레이아웃을 알면 skeleton. 🟡/DS

Layout Stability (CLS)

• CLS ≤0.1 p75. 미디어는 width/height 또는 aspect-ratio로 자리 예약. scrollbar-gutter: stable. font-display: optional(또는 swap)+metric override. 입력 500ms 창 밖에서 콘텐츠 위쪽 삽입 금지. 🟢

Modals · Overlays · Z-index

• role=dialog + aria-modal=true, 열 때 다이얼로그로 focus, Tab trap, Esc 닫기, 닫을 때 트리거로 focus 복원, 배경 inert. scrim #000 ~32%. 🟢
• light-dismiss: 임시/정보 다이얼로그는 ON, 데이터 입력·파괴적 액션은 OFF. 🟢
• z 사다리: dropdown 1000 / sticky 1100 / fixed 1200 / backdrop 1300 / modal 1400 / popover 1500 / toast 1600 / tooltip 1700. 오버레이는 portal. (gap-fill)

Performance · Glass · A11y

• 애니메이션은 transform/opacity(+filter)만, transition: all 금지; will-change는 transient(쉴 때 제거). 🟢
• glass: backdrop-filter: blur(16px) saturate(180%) + 반투명 fill ~0.6 + 1px hairline + 불투명 fallback, 텍스트 ≥4.5:1. 🟡/🟢
• prefers-reduced-motion: reduce → cross-fade/즉시 전환, 큰 이동·parallax 제거(작은 opacity는 유지). ≤3 flashes/s. focus outline은 대체 없이 제거 금지(:focus-visible). 🟢

Form Validation

• 1차 검증은 blur에서, 한 번 에러난 필드는 **on-change(라이브)**로 전환(고치는 즉시 에러 해제). async 검증 debounce 300–500ms. 🟡

2. APPLY 워크플로

1. 컨텍스트 감지 — 프로젝트 루트/대상 폴더에 DESIGN.md가 있나? 있으면 omd:apply 절차로 토큰(색·radius·spacing·motion·type) 먼저 read. 브랜드 토큰 = 권위.
2. 빈 축 채우기 — DESIGN.md가 침묵하는 축만 cheat-sheet 기본값으로. 깊은 축(스크롤 물리·glass·z 사다리·CLS)은 reference.md의 해당 섹션 참조.
3. tier 존중 — 🟢는 그대로 적용, 🟡는 기본값(브랜드/요청이 덮으면 양보), ⚪/FOLK는 "이건 취향 휴리스틱이에요"라고 밝히고 제안만.
4. 출력에 근거 남기기 — 비자명한 숫자(예: exit 0.8×, focus offset 2px)는 한 줄로 왜인지 + tier를 코드 주석이나 설명에 남긴다. 숫자를 발명하지 말 것 — cheat-sheet/reference에 없으면 reference를 읽거나 모른다고 말한다.
5. prefers-reduced-motion은 항상 동반 — 모션을 넣으면 reduce 분기도 같이 넣는다 (A11y는 옵션이 아님).

3. AUDIT 워크플로

omd:designer-review와 같은 advisory(읽기 전용) 패턴 + feel 축. 매 호출 DESIGN.md 재read(캐싱 금지).

1. 입력: artifact_path(HTML/JSX/TSX/CSS) + (있으면) design_md_path + viewport.
2. machine_check 스캔 — reference.md의 각 규칙 🔍 machine_check를 artifact에 적용. 예:
   • transition: all / >400ms duration / off-grid duration → 검출
   • 탭 타깃 <44px, focus outline 제거, 텍스트 대비 <4.5:1
   • aspect-ratio 없는 <img>, aria-modal 없는 modal, overscroll-behavior 없는 오버레이
3. severity = tier 매핑 — SPEC/DS 위반 = BLOCK, CONV = WARN, OP/FOLK = FYI. (severity inflation/deflation 금지.)
4. feel-score — 적용 가능한 축 중 in-band 비율: 🟢 in-band / 🟢 applicable을 핵심 숫자로, WARN/FYI는 부차. "feel-score 18/22 SPEC in-band, BLOCK 2, WARN 5".
5. 출력: <work_dir>/.reviews/feel-audit-round-<N>.md — issue마다 line ref + tier + machine_check 근거 + fix(actionable). line ref 없는 issue·"looks good" rubber-stamp 금지.

### [BLOCK] Tap target below minimum — icon button
- **Location:** `components/Toolbar.tsx:31`
- **Rule:** §8 Targets — 44pt/48dp/24px min (🟢 SPEC, WCAG 2.5.8)
- **Evidence:** `<button className="w-6 h-6">` → 24px, hit-slop 없음
- **Fix:** 패딩으로 44×44 hit region 확보 (`p-2.5` + 시각 24px 아이콘 유지)

4. 가드레일

• ❌ folklore를 spec처럼 제시 금지. ⚪/FOLK는 항상 tier를 밝힌다. (corpus Appendix B의 demote 목록 — Hick-Hyman 0.155s/bit, Fitts ms/bit, rubberband 0.7, pressed 0.95 바닥, exit 0.8×, stagger 80/100ms, optical 2px 등 — 은 숫자 게이트로 강제하지 말 것, 방향만 차용.)
• ❌ 숫자 발명 금지. cheat-sheet/reference에 없으면 reference를 읽거나 "모름"이라고 말한다.
• ❌ DESIGN.md 무시하고 일반 best-practice로 덮기 금지. 브랜드 토큰이 먼저.
• ❌ 모션을 넣고 prefers-reduced-motion 분기 누락 금지.
• ❌ AUDIT에서 severity inflation(다 BLOCK)·deflation(BLOCK을 FYI로)·line ref 없는 issue 금지.
• ❌ 숫자 변경이 필요하면 reference.md를 손으로 고치지 말고 corpus → 제너레이터로 재생성.

5. omd 생태계 관계

• omd:apply — 브랜드 DESIGN.md 토큰 적용. omd:feel은 그 위에서 토큰이 침묵하는 느낌 층을 채운다.
• omd:designer-review — 브랜드 일관성(typo/color budget/radius scale) 감사. omd:feel AUDIT은 그 feel 축 짝꿍(모션 타이밍·타깃·CLS·a11y).
• omd:taste — 사용자 취향 대시보드(별개 개념). 반복되는 feel 결정이 취향으로 굳으면 omd:remember로 흘려보낸다.

수동 검증: transition: all 0.6s + <button class="w-5 h-5"> + prefers-reduced-motion 분기 없는 컴포넌트를 AUDIT하면 — BLOCK 최소 3건(transition all=GPU SPEC, 20px 타깃=WCAG SPEC, reduced-motion 누락=a11y SPEC)이 line ref와 함께 뜨고 feel-score가 그만큼 깎여야 한다.