omd:feel — インターフェースのフィーリングを数値化 は何をしますか?
業界が感覚(かんかく)で決めていたインターフェースの細部 — 「このくらいの速度」「このくらいの影」「このくらいの余白」 — を出典グレード付きでチェック可能な数値に置き換え、適用・監査するスキル。Jakub Krehel の "great interfaces are a collection of small things that compound" の命題を継承しつつ、どの数値に合わせるべきか/いつ間違っているかまで数値で答える。
核となる洞察: 品質とは、数十の小さな制約をそれぞれの許容範囲内に収めた積分である。600msのチェックボックスのチック、1pxのフォーカスリング、本文2.85:1のコントラスト、@media (hover:hover) ゲートなしのホバーリフト — ひとつひとつが「フィーリング」において測定可能な減点となる。このスキルはその減点を防ぐ。
全ルール(17軸・113個)は reference.md に、各数値の出典・tier・方法論は provenance.md にある。以下のチートシートは常に読み込まれる核であり、深い監査やエッジケースは reference を参照すること。
いつ使うか
- APPLY — UIを新規作成・修正する際に、定量的フィーリングルールを注入する (「フィーリングよくして」「インタラクション磨いて」「細部適用」)
- AUDIT — 既存のHTML/JSX/TSX/CSSをルール表と照合し、フィーリングスコア + BLOCK/WARN/FYI レポートを生成する (「フィーリングチェック」「この画面を監査して」)
UI作業でなければトリガーしない。コピー・情報構造のみの作業は対象外。
0. 出典グレード → 強制力 (このスキルの心臓)
すべてのルールは tier を持ち、tierが強制力を決める。これこそが「感覚を正直に数値化する」方法 — 仕様の数値はゲート、好みの数値は提案。
| バッジ | Tier | APPLY | AUDIT severity |
|---|---|---|---|
| 🟢 SPEC | spec-authoritative (W3C/WCAG・HIG・normative) | 強制 | BLOCK |
| 🟢 DS | ds-token (コミットされたデザインシステムトークン) | 強制 (ブランドが上書きしない場合) | BLOCK |
| 🟡 CONV | industry-convention (独立した実務者≥2の収束) | デフォルト値として適用 | WARN |
| ⚪ OP | single-opinion (信頼できる単独意見) | 提案のみ | FYI |
| ⚪ FOLK | folklore-unverified (根拠追跡不能) | 提案 + tier明示 | FYI |
分布: SPEC 61 · DS 24 · CONV 19 · OP 7 · FOLK 2 → 85/113 が spec・token 根拠(強制可能)。
DESIGN.md が常に優先される。 ブランドの
DESIGN.mdトークンがルールと競合する場合、ブランドトークンが権威を持つ。これらのルールはブランドが沈黙している場合のデフォルトであり、オーバーライドではない。プロジェクトルートに DESIGN.md があれば、omd:applyでまずトークンを読み、空の軸だけを feel ルールで埋める。
1. チートシート — 常に適用する核となる数値
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 (再ターゲット可能)、ワンショット演出のみ
@keyframes。🟢
Spacing · Radius · Rhythm
- 8px base, 4px half-step (4·8·12·16·24·32·40·48·64)。🟢
- 内側 padding ≤ 兄弟間の外部 gap。🟡
- 同心円半径: outer = inner + padding。🟢
- UIタイプスケール ~1.25(major third)。🟡
Shadow & Depth
- レイヤードシャドウ 3–5層、光源は上方1つ。低高度=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 · フォーカスリング 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 天井。🟢
- 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、開くときにダイアログへフォーカス、Tab trap、Escで閉じる、閉じる際にトリガーへフォーカス復元、背景 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-visible)。🟢
Form Validation
- 一次検証は blur時、一度エラーになったフィールドは on-change(ライブ) に切り替え(修正即エラー解除)。非同期検証 debounce 300–500ms。🟡
2. APPLY ワークフロー
- コンテキスト検出 — プロジェクトルート/対象フォルダに
DESIGN.mdがあるか? あればomd:apply手順でトークン(色・radius・spacing・motion・type)を先に読み込む。ブランドトークン = 権威。 - 空の軸を埋める — DESIGN.md が沈黙している軸のみ、チートシートのデフォルト値で埋める。深い軸(スクロール物理・glass・z階段・CLS)は
reference.mdの該当セクションを参照。 - tierを尊重 — 🟢はそのまま適用、🟡はデフォルト値(ブランド/リクエストが上書きすれば譲る)、⚪/FOLKは 「これは好みのヒューリスティックです」と明示して提案のみ。
- 出力に根拠を残す — 非自明な数値(例: exit 0.8×、focus offset 2px)は、なぜなのか + tier をコードコメントや説明に1行で残す。数値を発明しないこと — チートシート/referenceに無ければ reference を読むか、わからないと言う。
- prefers-reduced-motion は常に 付随 — モーションを入れたら reduce 分岐も一緒に入れる (A11yはオプションではない)。
3. AUDIT ワークフロー
omd:designer-review と同様の advisory (読み取り専用) パターン + feel 軸。呼び出し毎に DESIGN.md を再読み込み (キャッシュ禁止)。
- 入力:
artifact_path(HTML/JSX/TSX/CSS) + (あれば)design_md_path+ viewport。 - machine_check スキャン —
reference.mdの各ルール🔍 machine_checkを artifact に適用。例:transition: all/ >400ms duration / off-grid duration → 検出- タップターゲット <44px、フォーカスアウトライン削除、テキストコントラスト <4.5:1
- aspect-ratio なしの
<img>、aria-modalなしの modal、overscroll-behaviorなしのオーバーレイ
- severity = tier マッピング — SPEC/DS 違反 = BLOCK、CONV = WARN、OP/FOLK = FYI。(severity inflation/deflation 禁止)
- feel-score — 適用可能な軸のうち in-band 比率:
🟢 in-band / 🟢 applicableをコア数値とし、WARN/FYI は補足。"feel-score 18/22 SPEC in-band, BLOCK 2, WARN 5"。 - 出力:
<work_dir>/.reviews/feel-audit-round-<N>.md— issue毎に line ref + tier + machine_check 根拠 + fix(アクション可能)。line ref なしの issue・"looks good" rubber-stamp 禁止。
### [BLOCK] タップターゲット最小値未満 — アイコンボタン
- **場所:** `components/Toolbar.tsx:31`
- **ルール:** §8 Targets — 44pt/48dp/24px 最小 (🟢 SPEC, WCAG 2.5.8)
- **根拠:** `<button className="w-6 h-6">` → 24px、hit-slop なし
- **修正:** パディングで 44×44 のヒット領域を確保 (`p-2.5` + 視覚 24px アイコン維持)
4. ガードレール
- ❌ folklore を spec のように提示禁止。 ⚪/FOLK は常に tier を明示する。 (corpus Appendix B の降格リスト — Hick-Hyman 0.155s/bit, Fitts ms/bit, rubberband 0.7, pressed 0.95 下限, exit 0.8×, stagger 80/100ms, optical 2px など — は数値ゲートとして強制せず、方向のみ借用。)
- ❌ 数値の発明禁止。 チートシート/reference に無ければ reference を読むか、「わからない」と言う。
- ❌ DESIGN.md を無視して汎用ベストプラクティスで上書き禁止。 ブランドトークンが優先。
- ❌ モーションを入れて
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— ブランド一貫性(タイポ/色予算/radius スケール)を監査。omd:feel AUDIT はその フィーリング軸のペア(モーションタイミング・ターゲット・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 がその分下がるべき。