ima2 UI/UX: 意図発見、パターン、プロダクト語彙
セットアップ
npm install -g ima2-gen # グローバルにインストール(Node.js >= 20)
ima2 setup # 初回認証(GPT OAuth推奨)
ima2 serve # ローカルサーバー起動
ima2 ping # 確認
ima2 status # 設定とOAuthステータス確認
エージェント起動時: 最初に ima2 ping を実行。到達不可の場合: ima2 serve &。インストールされていない場合: npm install -g ima2-gen && ima2 setup。ima2 skill path を使用してスキルを特定し、../ima2-uiux/SKILL.md(このファイル)でデザインの方向性を、../ima2-front/SKILL.md で実装アセットを確認してください。
以下のような変化面でアクティブになります:
- ユーザーのデザイン方向性が曖昧な場合(「きれいに」「モダンに」「とにかく見た目を良くして」)
- オンボーディング、空状態、エラー状態、ローディング状態のUIを構築する場合
- ユーザーがプロダクトの美的感覚に言及した場合(「Notionっぽく」「Linearのように」)
- 新しいデザインシステムの開始やカラーパレットの生成を行う場合
- レイアウトパターンやナビゲーションアーキテクチャを選択する場合
- ファビコン、プロダクトロゴ、ブランドアイデンティティ要素を設定する場合
- ロゴのダークモードバリアント、OG画像、ソーシャルシェアリングメタを扱う場合
ユーザーが明確なデザイン方向性を表現できない場合は、スタイル固有の参照よりも先にこれを読んでください。
アンチスロップ検出と禁止パターンについては、ima2 skill front ref anti-slop、特に2026年のグラデーション予算とワンノートテーマ禁止を参照してください。
絵文字禁止(仮): 絵文字をUIのビジュアル要素として使用しないこと(厳守)。正規のルール、範囲、および例外: ima2-front §5 / ima2 skill front ref anti-slop § 絵文字スロップ。
役割分離: このスキルはデザイン判断を担当します: 意図発見、情報アーキテクチャ、UX状態の意味、タイポグラフィ/カラー/レイアウトの方向性、プロダクトの個性、ブランド語彙、アンチスロップパターン判断、デザインシステムの決定。ima2-front は実装を担当します: HTML/CSS/コンポーネント、レスポンシブメカニクス、アクセシビリティ配線、ランタイム動作、レンダリング検証。ここでデザインの方向性を選択した後、具体的な実装のために ima2-front をロードしてください。
外部/現在のデザインエビデンス: ライブプロダクト参照の主張、現在のデザインシステムドキュメント、ブラウザAPIの動作、変更された可能性のあるアクセシビリティガイダンス、またはブラウザレンダリングされたソースエビデンスについては、ウェブを検索し、そのクエリ書き換え、ソース取得、エビデンスステータスのルールに従ってください。ブラウザのfetch/open/text/get-dom/snapshotは、候補URLが存在した後にのみ使用してください。
C0/C1作業(小さなローカルパッチ): 小さなパッチの場合は、完全な参照チェーンをスキップしてください。
ルールクラス注記(UX-STYLE-01): このスキル内で好みを表現するものすべて — プロダクトペルソナ、デザインイズム、プリセットトークン、美的語彙 — は
STYLE_SAMPLEです: 引き出しのための例であり、普遍的な要件ではありません。客観的なUXの正しさ(状態カバレッジ、アクセシビリティ、可読性)はima2-front§1.5 が所有し、STRICT/DEFAULT のままです。
モジュール参照
推奨: スキルをエージェントのスキルディレクトリにインストールしてください。
ima2 skill install --dir <agent-skill-path> # エージェントが自身のパスを提供 ima2 skill install --tmp # 一時的なフォールバックエージェントは自身のスキルディレクトリを決定し、
--dirで渡します。 インストール後、SKILL.md とreferences/がディスク上に配置され、ネイティブに読み取れます。アドホックな読み取り(インストールなし):
ima2 skill uiux refs # すべての参照モジュールを行数とともに一覧表示 ima2 skill uiux ref design-isms # 1つのモジュールを表示(ベースネーム一致)
| ファイル | いつ読むか | カバーする内容 |
|---|---|---|
references/design-isms.md | ユーザーがスタイル/ムーブメントを指定した場合 | CSSシグネチャ付き16のデザインムーブメント、Liquid Glass + Liquid Editorial デフォルトキット(2025-2026)、AI Serif Editorial、Organic Capsule(2026-07-09確認済み)を含む |
references/design-award-sources.md | 実際のデザインリファレンスを探している場合 | 階層化されたソーシングガイド: アワードサイトとギャラリーサイト、それぞれに最適な用途、検索方法 |
references/compositional-patterns.md | ヒーロー、ナビゲーション、モーション、またはコンテンツ構造を構成する場合 | アワードリサーチからの標準的な構成パターン(レスポンシブおよびアクセシビリティゲート付き) |
references/design-trends.md | 日付付きの普及度、新しいテクニック、またはプロモーションステータスを確認する場合 | 2026-07-14 軸頻度スナップショット、テクニックシグナル、シグネチャ台帳、再クロールプロトコル |
references/design-read-example.md | デザインリードのフォーマットを学ぶまたは復習する場合 | 記入済みデザインリード + ダイヤル設定例 |
references/product-personalities.md | ユーザーがプロダクトに言及した場合 | 正確なトークン付き10のプロダクトDNAプロファイル、2026年AIプロダクトパステル、OpenAIのウォームサン有機、Anthropicのセリフブック風を含む |
references/layout-macrostructures.md | ページ/コンポーネントのレイアウトを選択する場合 | コンポーネントレイアウト + ページレベルの構成 |
references/ux-states.md | ステートフルなUIを構築する場合 | オンボーディング、空、エラー、ローディング、プログレッシブディスクロージャー |
references/color-system.md | 色/パレットを生成する場合 | OKLCHベースのパレット生成、色相予算、着色されたニュートラル、ダークモード、アクセシビリティ |
references/design-system-bootstrap.md | 新規プロジェクト / デザインシステム | トークンアーキテクチャ、コンポーネント階層、DESIGN.mdフォーマット(google-labs-code/design.md) |
references/responsive-nav.md | レスポンシブまたはナビゲーション作業 | ブレークポイント、コンテナクエリ、密度別ナビパターン |
references/ux-preflight.md | 納品前 | UX状態確認チェックリスト |
references/typography-line-breaks.md | テキストが多いUIでは常に | 見出し改行品質、短い説明カテゴリ(ヒーローサブタイトル、カード説明 — pretty ではなく balance を使用)、オーファン防止、ch 単位、韓国語オーファン基準、-webkit-line-clamp との競合 |
references/favicon-logo.md | ファビコン、プロダクトロゴ、またはブランドアイデンティティ作業 | ファビコンファイルセット、SVGダークモード、ナビ/フッターのロゴ、ダークモードバリアント、OG画像、ブランドトークン、よくある間違い |
references/logo-trust-sections.md | インテグレーション/パートナー/クライアントロゴ | マーキーとグリッドの判断、アンチパターン、グレースケール処理、配置 |
references/visual-hierarchy.md | あらゆるレイアウト / 構成決定 | 6つのレバー: サイズスケール、ウェイトコントラスト、カラー強調、スペーシング、ポジション、密度 |
references/form-patterns.md | フォーム、ウィザード、認証、ファイルアップロード | バリデーションタイミング、マルチステップ、パスワードUX、ファイルアップロード、検索/フィルター |
references/mobile-native-ux.md | ネイティブモバイルアプリのUX決定 | iOS HIG vs Material 3、ジェスチャー、ディープリンク、韓国プライバシー、アプリストアUX |
references/intent-discovery-ladder.md | UX-INTENT-01 オプションの深化(ステップ1-6) | ムード/明度/密度/シェイプ/ビューポート/参照ラダー、曖昧なリクエストの曖昧性解消 |
references/korean-design-vocabulary.md | 韓国語のデザインブリーフまたは韓国語ファーストUI | 韓国語記述子 → CSSトークン変換、クイックマッチテーブル、フォント選択ガイドライン |
怠惰なユーザーへのゲート(UX-LAZY-01、デフォルト — ポニーテール規律をUXに適用)
認知的に節約するユーザーのために設計する: ユーザーは読まず、スキャンする。サティスファイスする。彼らは、明白な次のアクションが1つあることと引き換えに、選択肢を手放すだろう。ユーザー向けの決定ポイント — オプション、設定、ステップ、確認、入力フィールド、モード — を出荷する前に、その存在をポニーテール方式で順に正当化せよ:
- 何もしない: 正しいデフォルトでこの決定を完全に削除できるか?
- 削除: そのステップ/フィールドは、その完了率のコストに見合う価値があるか(ヒックの法則)?
- 吸収: ユーザーの代わりにシステムが複雑性を引き受けることができるか(テスラーの法則)?
- 格下げ: 一部のユーザーにはまだ必要 → プログレッシブディスクロージャー、決してトップレベルの分岐にしてはならない。
すべての画面には1つのプライマリアクションがある。サーフェス条件付き: コンシューマー/ワンショットフローは決定を最小化する。反復作業ツール(高密度プロファイル)は反復動作を最小化する — エキスパートコントロールをウィザードにまとめることは逆の失敗である。厳格な例外: 破壊的/不可逆なアクション、同意/プライバシー/法的、支払い確認、およびアクセシビリティアフォーダンスは、魔法のデフォルトに決してまとめてはならない。
UX状態契約(UX-STATE-01)
オンボーディング、空、ローディング、エラー、またはプログレッシブディスクロージャー作業では、スタイリングの前に本文が状態の意味を答えなければならない。詳細なパターンは references/ux-states.md にあります。
- オンボーディングは、プロダクト全体ではなく、最初の意味のあるアクションを教える。
- 空は、状態が存在する理由を説明し、次のアクションを指名する。
- ローディングは、既知の構造にはスケルトンを、短い未知の待機にはスピナー/プログレスバーを選択し、偽の完了を避ける。
- エラーは、リトライ、リカバリー、またはエスカレーションを公開し、ユーザーを行き止まりにさせない。
- プログレッシブディスクロージャーは、何が隠されているのか、なぜ隠されているのか、どこで利用可能になるのかを明示する。
IA 選択(UX-IA-01)
ワークシェイプ別のデフォルトナビゲーションアーキテクチャ。レスポンシブの詳細については references/responsive-nav.md を参照。
| ワークシェイプ | デフォルトIA |
|---|---|
| 高密度デスクトップ反復作業 | サイドバー + コマンドパレット |
| 中程度セクション別作業 | タブまたはセグメント化ナビゲーション |
| モバイルプライマリコンシューマーフロー | ボトムナビ、シート、またはサムゾーンアクション |
| ウィザード/認証/セットアップ | ステッパーまたはスタック線形フロー |
1. ユーザー意図発見プロトコル
ユーザーのデザインリクエストが曖昧な場合(「きれいにして」「モダンに」「とにかく見た目を良くして」)、汎用的な出力を生成しないでください。コンパクトな曖昧性解消フロー(UX-INTENT-01)を実行してください:
- 利用可能なシグナルを使用して、§2からデザインリードを作成する。
- 1つの決定がまだ方向性を妨げている場合は、2値/3値の選択肢を持つ最も明確な1つの分岐を質問する。
- 回答に基づいて進める。ユーザーが回答せず、タスクを続行できる場合は、最もドメイン的に正しいデフォルトを選択し、その仮定を明記する。表現力豊かなサーフェス(ランディング/コンシューマー/クリエイティブ/AIプロダクト)では、そのデフォルトは以下の無ブリーフデフォルト方向(UX-DEFAULT-ISM-01)です。静かなサーフェスは静かなドメイン的に正しいデフォルトを維持する。
ユーザーが明示的なデザイン仕様を提供した場合、またはこれが5行以下のパッチである場合は、このセクションをスキップしてください。
無ブリーフデフォルト方向(UX-DEFAULT-ISM-01、デフォルト — キットコンテンツ STYLE_SAMPLE)
これはUX-INTENT-01のステップ3のフォールバックであり、決してバイパスではありません。デザインリードの後、かつ1つのブロック分岐が解決されるか未回答になった後にのみ発動し、適用される方向性は常に成果物内で明示的な仮定として記載されます。名前付きの、具体的で、ドメインゲートされた方向性が、汎用的なLLMデフォルトを置き換えます。新しいラベルの下で、汎用的なグラスモーフィズム/中央寄せカード/ベージュデフォルトの趣味を再導入してはなりません。
表現力豊かなサーフェス向けデフォルトキット: Liquid Editorial(2026年複合、2026-07-07にTier-2トレンドリサーチから決定 — 完全なシグネチャについては references/design-isms.md §1.14 を参照):
- 構造: タイポ主導のエディトリアル構成(特大の著者見出しスケール、デフォルトグロテスク、セリフ表示はUX-TYPE-01あたりのエディトリアル理由がある場合のみ)、フラットグラデーションウォッシュよりも触覚的/写真的テクスチャ、非対称のコンテンツ重視レイアウト。
- マテリアルアクセント: Liquid Glassまたは半不透明のピルクロームは、フローティング機能レイヤー(ナビ/ツールバー/チップクラスター)にのみ使用。ピルチップコンテンツユニット。コンテンツレイヤーはソリッドを維持(
ima2-frontFE-LIQUID-LAYER-01)。ピルクローム内の子要素は、静止時にカプセル境界線/アウトラインを持たない — 塗りつぶし/ティントのみで強調(ima2-frontFE-PILL-NEST-01)。トップバーのスクロール状態はima2-front/references/top-bar.mdFE-TOPBAR-STATE-01 に従う。 - モーション: フィードバックベースライン + 1つのシグネチャモーメント(ポインタ近接チップまたはスクロール駆動リビール)+ ランディングバケットサーフェスでは1つ以上のサポートスクロールリビール(フロア2、シーリング約4 —
ima2-front/references/motion.mdFE-MOTION-BUCKET-01)。その他の場所ではフィードバックのみ、モーションドメインゲートに従う。 - カラー: OKLCH派生の単一アクセント + 着色されたニュートラル(色相予算、
references/color-system.md)。
ドメインゲート(厳守): ダッシュボード、管理、運用、金融、政府、B2B反復作業ツールは、デフォルトでこのキットを受け取ってはならない — 「派手」がドメインの正しさを決してオーバーライドしてはならない(§ IA選択 + ima2-front プロダクト密度プロファイル)。
オプションの深化: 以下のラダーは、最初の分岐が失敗した場合、またはユーザーが明示的にガイド付き探索を希望する場合にのみ使用してください。
- 自由形式の質問ではなく、2値/3値の選択肢を使用する。
- 既知のプロダクトを参照する — ユーザーは、言葉で表現するよりも、自分が何を望んでいるかを認識する方が速い。
- ダイアグラムスキルが利用可能な場合は、「참고로 스타일 비교를 다이어그램으로 보여드릴 수도 있어요。」(参考までに、スタイル比較をダイアグラムで表示することもできます。)と提案する。
- ユーザーが特定のプロダクトを指定した場合は、残りのステップをスキップし、
references/product-personalities.mdを介して直接マッピングする。
完全な6ステップガイドラダー(ムード → 明度 → 密度 → シェイプ → ビューポート → 参照)と曖昧なリクエストの曖昧性解消テーブルについては、references/intent-discovery-ladder.md を参照してください。上記のコンパクトフローでより深いガイド付き探索が必要な場合にのみロードしてください。
2. デザインリード(新しいページ、コンポーネント、またはレイアウトには必須。5行以下のパッチではオプション — dev §0.1 パッチファストパスを参照。)
フロントエンドコードを生成する前に、デザインリードを作成してください。プロジェクトに DESIGN.md ファイルがある場合は、最初にそれを読んでください。そのトークンと散文は、以下のすべてをオーバーライドします。
ネイティブツールサポート(構造/60): デザインリードを書く前に、view_image を使用してビジュアルリファレンス(既存の画面、競合キャプチャ、デザインエクスポート)をコンテキストに読み込みます。ima2 を使用して必要なビットマップアセット(アイコン、イラスト、モック画像)を生成します(ダウンしている場合は ima2 status をプローブし、ima2 serve を試みます。ima2 が真に利用不可の場合にのみ、ima2 がプライマリツールです)。プレースホルダーボックスを残さないでください。そして、ビジュアル検証(ブラウザスクリーンショット -> view_image)ごとに、構築された結果を視覚的に確認します。
出力フォーマット(ミニ DESIGN.md)
記入済みの例: references/design-read-example.md。
---
name: <プロジェクト名>
colors:
primary: "<hex>"
accent: "<hex>"
background: "<hex>"
typography:
heading: { fontFamily: <フォント>, fontSize: <サイズ> }
body: { fontFamily: <フォント>, fontSize: <サイズ> }
---
これを次のように読む: <ページ種類> for <対象者>、<雰囲気> 言語で。 <1-2文: 具体的な参照、形容詞ではない。「1970年代の講義資料」>「モダンでクリーン」>
Do's: <ブリーフからのコンテキスト固有のポジティブ> Don'ts: <ブリーフからのコンテキスト固有のネガティブ>
ミニマルデザインリード(パッチファストパス — 5行以下の変更、dev §0.1)
---
name: <プロジェクト名>
---
<1文: 変更の背後にあるデザイン上の判断。どのレバーを動かしたか、そしてなぜ。>
3. デザインリードダイヤル
各デザインリードには、正確なCSSトークン設定が含まれている必要があります。これらのダイヤルは、ゴールポストを固定するためのものです。
3.1 タイポグラフィ(UX-TYPE-01、デフォルト — スタイルサンプル)
| ダイヤル | 値 | CSSトークン |
|---|---|---|
| ベースフォント | グロテスク(例: Inter, Roboto) | font-family: 'Inter', sans-serif |
| 見出しフォント | サンセリフ(グロテスク)、+/- セリフ表示 | --heading-font: 'Inter' |
| ベースサイズ | 16px | font-size: 16px |
| 見出しスケール | モジュラースケール 1.25(メジャー3rd) | --scale-ratio: 1.25 |
| 行間隔 | 1.5(本文)/ 1.2(見出し) | line-height: 1.5 |
| 最大線幅 | 60-75ch(最適な読みやすさ) | max-width: 65ch |
空白スペース禁止(厳守): 太字の見出し、細いウェイトとの混合、および低コントラストのテキストは許可されています。単なる空白は禁止されています — すべての空白スペースの使用には、正当なタイポグラフィ上の理由が必要です。「クリーン」「モダン」「ミニマル」と正体不明の空白の間には常に一線を引いてください。詳細なルールについては、references/typography-line-breaks.md を参照してください。
3.2 カラー(UX-COLOR-01、デフォルト)
| ダイヤル | 値 |
|---|---|
| プライマリ | ブランドブルー(#2563eb) |
| アクセント | ブランドブルー(補色) |
| 背景 | 白(#ffffff)または非常に明るいグレー(#f8f9fa) |
| テキスト | ダークグレー(#1a1a2e) |
| 二次テキスト | ミディアムグレー、アクセシビリティに十分なコントラスト |
新しいプロジェクトにはOKLCHベースのパレット生成を使用する。詳細なガイドについては references/color-system.md を参照。
3.3 スペーシング(UX-SPACE-01、デフォルト)
| ダイヤル | 単位 |
|---|---|
| ベースユニット | 4px |
| セクション間隔 | 3-6ユニット(12-24px) |
| コンテンツパディング | 4-8ユニット(16-32px) |
3.4 レイアウト(UX-LAYOUT-01、デフォルト)
| ダイヤル | 値 |
|---|---|
| 最大コンテンツ幅 | 1200px |
| グリッド列 | 12(レスポンシブ) |
| ガター | 24px |
3.5 ボーダーと角(UX-BORDER-01、デフォルト)
| ダイヤル | 値 |
|---|---|
| ボーダー幅 | 1px |
| ボーダーカラー | #e2e8f0 |
| 角丸 | 8px(カード)、0px(ボタン) |
3.6 ドロップシャドウ(UX-SHADOW-01、デフォルト)
| レベル | 値 |
|---|---|
| 低 | 0 1px 3px rgba(0,0,0,0.1) |
| 中 | 0 4px 6px rgba(0,0,0,0.1) |
| 高 | 0 10px 25px rgba(0,0,0,0.15) |
4. アンチスロップパターン
以下のパターンは、美的陳腐化(スロップ)と見なされ、避けるべきです:
- 過剰なグラデーション: 背景全体のグラデーションは避ける。マイクロインタラクション用に予約する。
- 汎用的なグラスモーフィズム: 明確な機能的理由なしに使用しないでください。
- 過剰なシャドウ: 複数のソースからの大きなぼかしシャドウ。「ネオモーフィズム」全般。
- 装飾的なオーバーレイ: じゅらく、ノイズ、グレイン、テクスチャは、コンテンツの強化に役立つ場合にのみ使用する。
- テーマのあるブランディング過剰: すべての状態を1つのスタイルで描きすぎない。
- すべてに対するぼかし: 背景のぼかしは、モーダル/シート/ナビゲーションのために予約する。
- 装飾用アイコン: 装飾のみを目的としたアイコン。情報を伝えるか、アクションを促す必要があります。
- 「プレミアム」のダークモード: 通常の高コントラストダークモードはOKですが、過剰にスタイル化された「プレミアム」ダークテーマは避ける。
- アニメーションの過剰使用: 目的のない動き。すべてのアニメーションは意味をサポートする必要があります。
- 「未来的な」要素: サイバーパンク、グラデーションテキスト、過剰なグロー効果。
スロップ検出の詳細については、ima2 skill front ref anti-slop を参照してください。
5. プロダクトペルソナ
ユーザーが特定のプロダクトを参照する場合、references/product-personalities.md を使用して、そのスタイルを正確なトークンにマッピングします。既知のペルソナ:
- Notion: クリーン、ミニマル、プログレッシブディスクロージャー、グレーと白のカラーパレット、サンセリフタイポグラフィ
- Linear: ダークテーマ、高コントラスト、アクセントカラー(グリーン)、クリーンなタイポグラフィ、マイクロインタラクション
- Superhuman: ゴールドアクセント、ダークテーマ、高密度情報表示、キーボードファースト
- Arc: カラーフル、遊び心、曲線的な要素、グラデーション
6. ブランドアイデンティティ
ファビコン、ロゴ、OG画像については、references/favicon-logo.md を参照してください。
ブランドアイデンティティを構築する際の主要な考慮事項:
- ファビコンはすべてのプラットフォームで一貫している必要がある
- ロゴはナビゲーションとフッターで機能する必要がある
- ダークモードバリアントが必要
- OG画像は正しいサイズとアスペクト比である必要がある
7. 納品前チェックリスト
コードを「完了」とマークする前に、references/ux-preflight.md を使用して以下を確認してください:
- すべてのUX状態がカバーされている(オンボーディング、空、エラー、ローディング)
- アクセシビリティチェック(色のコントラスト、キーボードナビゲーション、スクリーンリーダー)
- レスポンシブチェック(モバイル、タブレット、デスクトップ)
- タイポグラフィチェック(改行、オーファン、行間隔)
- アンチスロップチェック(不必要な装飾はありませんか?)
- ローディング状態がすべてのデータフェッチで考慮されている
- エラー状態がすべてのフェイルケースで考慮されている
- プログレッシブディスクロージャーがすべての複雑なインタラクションで使用されている