デザインクラフト (Design craft)
フロントエンドのデザインと構築のための作業手法です。SKILL.md にはすべてのタスクに必要な情報が含まれています。
references/ 内のファイルには、詳細な情報、数値、コードが含まれています。末尾の表にあるトリガーが該当する場合は、該当ファイルを読んでください。
適用範囲: 新しいページ、フロー、コンポーネントの作成はステップ1〜8を実行します。小さな変更(1つの状態、1つのアニメーション、1つの文字列など)は、影響を受けるステップのみを実行し、その後ステップ8で変更箇所を検証します。
ニーズの優先順位 (Order of needs)
機能的 → 信頼性 → 使いやすさ → 喜び. 壊れていたり、遅かったり、わかりにくいものに喜びを追加してはいけません。また、最上層がない状態でリリースしてはいけません。「後で」と先延ばしにされた個性は、ほとんどリリースされません。
1. フレーム (コードの前)
- ジョブストーリー: [状況] のとき、[動機] したいので、[成果] できる。 状況や成果が不明な場合は質問するか、その前提を仮説としてサマリーに記載してください。
- ブリーフが求めている野心を選び、そこに注力します:
| ブリーフ | 投資する箇所 | 最初の証明 |
|---|---|---|
| ブランドサイト、「プレミアム」、「アワードレベル」、「アニメーション満載」 | 被写体に根ざした1つの特徴的なインタラクション(ステップ2) | 実際のコンテンツでインタラクションが動作すること:開始、中間、中断、解放 |
| ローンチ、エディトリアル、マーケティングページ | オファーが明確で、その最良の証拠が探索可能であること | スマートフォンで見た最初の画面。待たずにメインアクションに到達できること |
| アプリ、ツール、ダッシュボード | 最も難しい判断、ミスのコスト、繰り返し使用の速度 | 変化するデータを用いた現実的なタスク、および1つの障害からの回復 |
| コンポーネントまたはデザインシステム | 2つの異なるコンシューマーで通用する振る舞いの契約 | 長いコンテンツを持つ2つのコンテキストでの同じコンポーネント |
- 事実と仮定を分離します。訪問者の到着時の感情状態を特定します。トーンを決める要素です。
- 既存のものを確認します:トークン、コンポーネント、パターン、規約。発明する前に再利用します。
2. 被写体の中に特徴を見つける
表現力豊かな作品の場合、訪問者がロゴが隠れていても認識できる被写体の特性と、訪問者がそれを操作できる動詞を探します。ビールは注がれ、泡立ち、色を示します。布地はドレープします。書体には軸があります。時計にはムーブメントがあります。その特性を中心にインタラクションをデザインします。
- 置換テスト: 無関係なブランドと差し替えます。そのエフェクトがそのまま機能する場合、まだ被写体についてのものになっていません。磨きをかける前に被写体に戻ります。
- 4つのビート: 何が入力を誘うか → 接触時に何が応答するか → 持続的な入力で何が明らかになるか → 解放時に何が残るか。1つの永続的なオブジェクトがこれらすべてを担うべきです。
- エフェクトを増やしても「基本的だと感じる」ことは解決しません。代わりに中心的なアイデアやメカニズムを変更します。
- すべてのジェスチャーには、同じ情報に到達できるプレーンな同等物(スライダー、ボタン、ラジオグループ)が必要です。
3. 安価に探索し、最も難しい部分を最初に証明する
- 構造的に異なる少なくとも3つのアプローチを、それぞれ数行で説明します。1つを選び、その理由を述べます。
- モーションの前に、実際のコンテンツで静止フレームを作成します:読み順、タイポグラフィ、イメージ、プライマリアクション。アニメーションの中間のフレームも、意図的に見えるようにします。
- 最もリスクの高い主張(ジェスチャー、スクロールシーン、難しいワークフロー)を最初に構築し、ページの残りの部分を構築する前に、実際のブラウザで確認します。
4. システムを優先する
- トークンはコンポーネントよりも先に。コンポーネントはプリミティブ(
--amber-400)をエイリアスするセマンティックトークン(--color-action)を使用します。コンポーネントスタイル内部に16進数、px、マジックナンバーは使用しません。 - スペーシングは4ベースのスケール(4, 8, 12, 16, 24, 32, 48, 64)を使用します。ボディは16px/1rem、行間1.5。見出しは1.1〜1.25。1つのモジュラータイプ比率。最大2つの書体(+ モノスペース)。変化する数値には表組み数字を使用します。
- 1〜3のブランドカラー、ニュートラルカラー、ステータスカラー。すべてのテキストペアはWCAG AA(本文4.5:1、大規模/UIは3:1)に合格します。色は唯一の信号にしてはいけません。
- モーショントークン(継続時間、イージング)は、色やスペーシングと並んで配置します。
- Propsは意味で名前付けします(
variant="destructive")、見た目ではありません。繰り返されるオーバーライドは、不足しているバリアントを示します。
5. ハッピーパスだけでなく、すべての状態
インタラクティブコンポーネント:デフォルト、ホバー、フォーカス可視、アクティブ、無効、ローディング、エラー、選択済み。 画面:空、ローディング、部分的、エラー、成功、オフライン。非同期処理:
- 最新のリクエストが優先されます。遅い古い応答が新しい応答を上書きしてはいけません。
- 障害後もユーザーの入力を保持し、ローディング中は以前の結果を(暗くして)表示し続けます。
- 空のアカウント、結果なし、フェッチ失敗は異なる状態であり、それぞれ異なる次のアクションが必要です。
キーボード操作可能、セマンティックHTMLを優先し、ARIAはHTMLで表現できない場合にのみ使用し、すべてのフィールドにラベルを付け、すべてのモーダルに可視の脱出手段を提供し、モーダルが閉じたときはフォーカスを適切な場所に戻します。
6. 感情、コピー、誠実さ
- 明確さは賢さに勝ります。 ジョークに余計な一文が必要なら、それを削除します。短縮形、平易な言葉を使用します。
- 声(Voice)は一定で、トーンは変化します:成功時は温かく、エラー時は平易で穏やかに、機密性の高い入力時は優しく。
- エラー: 何が起こったか、なぜか、次に何をすべきか、何が保持されたか。決してユーザーを責めないでください。ここにユーモアは不要です。
- 空の状態 は招待状です:ここに何が表示されるか、そして1つの明確な最初のアクション。
- ピークエンドの法則: 真の達成の終わりに1つの大きな喜びを配置します。フラストレーションの谷に決して配置しません。
- 重要なページでは、訪問者の懸念を挙げ、それぞれの答えを行動喚起の前に提示します。
- イメージ:デフォルトで多様なキャストを使用します。「誰を除外しているか?」と問いかけます。
- 誠実さ: AI生成の画像やデモデータは、実際のものと誤認される可能性がある場合はラベルを付けます。コピーは画像が示すものと一致しなければなりません(5.0%と印字された缶は、ページでも5.0%と表示されます)。
- 規制対象カテゴリ(アルコール、金融、健康、子供向け):必要なゲートまたは開示を追加し、画像をカテゴリの広告規範に照らして確認します(例:アルコールの性的な画像は禁止)。
7. モーション
すべてのアニメーションには役割があります:コンテキスト、注意、フィードバック、または個性。役割がなければ、アニメーションは不要です。
| トークン | 値 | 用途 |
|---|---|---|
--dur-1 | 100ms | プレス、フォーカス、トグル(知覚的閾値) |
--dur-2 | 200ms | ほとんどのUIトランジション、ホバー、小規模な出現 |
--dur-3 | 300ms | パネル、ドロワー、モーダル |
--dur-4 | 400-500ms | 全画面またはヒーロー演出のみ |
--ease-out | cubic-bezier(0,0,.2,1) | 出現 / 注意を引く |
--ease-in | cubic-bezier(.4,0,1,1) | 退出 / 注意をそらす(退出は〜20-30%短く) |
--ease-in-out | cubic-bezier(.4,0,.2,1) | 画面上の位置間の移動 |
| spring | 臨界減衰、再ターゲット可能 | ジェスチャー。ターゲットが変わっても速度を維持 |
- 演出のためにメインアクションをブロックしないでください。 プリローダーやイントロは、メインアクションを約1秒以上遅らせてはならず、再訪問者はスキップできるようにします。
- 空間的一貫性: ものは来た道から去ります。共有要素はその場で変形します。
- スタガー は30〜60msで、減衰する遅延(
base*√i)を設定します。シーケンス全体は〜300ms以内に収めます。 - スクロールシーン: 進行度はセクションの計測された移動距離にマッピングされるため、同じスクロール位置は常に同じフレームを生成し、上にスクロールするときれいに逆再生され、途中への直接リンクも機能します。
- ジェスチャー: 進行度の所有者は1つ。グリップはポインターに追従。解放時の速度はスプリングに渡す。途中での中断でもUIは操作可能。
transformとopacityのみをアニメーション化します。prefers-reduced-motionが設定されている場合、移動、パララックス、ズーム、自動再生を削除し、短いフェードは維持し、ユーザー駆動のジェスチャーは引き続き機能させます。- 実際のビルドで壊れたエンジニアリングの落とし穴(1プロパティ1所有者、一時停止したスクロールタイムライン、タイムライン内のスナップラベル、非負のフレーム時間、スワップ可能なアセットのプリロード):
references/motion-engineering.mdを参照。
8. 実ブラウザで検証し、引き継ぐ
scripts/walk.py(Playwright + ローカルChrome)をデスクトップ、電話、縮小モーションで実行します:実際のポインタードラッグ、すべてのセクションのスクロール、コンソールエラー、横方向のオーバーフロー。非表示または最小化されたプレビューペインはアニメーションフレームをスロットルするため、そこからモーションを判断しないでください。詳細:references/verification.md。
その後、好みではなくジョブストーリーに照らして批評します:
- ジョブストーリーを満たしていますか?プライマリアクションが最も目立つものであり、どこからでも到達可能ですか?
- すべての状態が存在しますか(ステップ5)?キーボード、スクリーンリーダーのラベル、コントラスト?
- トークンのみを使用していますか?既存のコンポーネントを再利用していますか?
- コピーはステップ6に従っていますか(誠実さラベルを含む)?
- すべてのアニメーションに役割があり、正しいイージング方向、中断パス、縮小モーションパスがありますか?
- 特徴は置換テストに合格しますか?終わりに配置された1つのピークがありますか?
- 何を削減しますか?1つの要素またはエフェクトを削除して、改善されるかどうかを確認します。
根拠(rationale) とともに引き継ぎます:問題、アプローチ、却下された代替案とその理由、何をどのようにテストしたか(エミュレーション vs 実機)、既知の制限。テンプレート:
references/process-and-teams.md 付録B。
リファレンス
| 読むファイル | いつ |
|---|---|
references/motion-engineering.md | GSAP/ScrollTrigger/Lenis、キャンバス、ジェスチャー、スクロールシーンの作業時 |
references/verification.md | ビジュアルまたはインタラクティブな作業を完了と呼ぶ前に |
references/imagery.md | 画像の生成、準備、製品の切り抜き、アートディレクション |
references/animation.md | 演出、7つのモーション原理、スタガーの計算、モーショントークン |
references/emotion.md | デザインペルソナ、オンボーディング、喜び、信頼と恐怖、障害時コピー |
references/design-systems.md | トークン、コンポーネントAPI、ガバナンス、バージョニング、ドキュメント |
references/product-design.md | リサーチ、ストーリーファースト、スケッチ、フィードバック、プロトタイピング、テスト |
references/design-thinking.md | 共感/定義/発想/プロトタイプ/テストを必要とする曖昧な問題 |
references/design-engineering.md | プロトタイプの忠実度の選択、デザイン↔コードの連携 |
references/process-and-teams.md | 批評セッション、根拠と引き継ぎのテンプレート、DesignOps |