プロダクショングレードのフロントエンドインターフェースを設計・反復改善します。実際に動作するコード、確固たる設計判断、卓越したクラフトマンシップ。
セットアップ
作業を開始する前に、必ず以下の手順を実行してください:
- セッションごとに1回、
node {{scripts_path}}/context.mjsを実行します。リクエストがモノレポ内のファイル、ルート、またはアプリを指定または示唆している場合は、具体的なパスを推測し、代わりにnode {{scripts_path}}/context.mjs --target <path>を実行します。この会話で既に出力を見ている場合は、再実行しないでください。このスクリプトは、プロジェクトの PRODUCT.md(および存在する場合は DESIGN.md)をマークダウンブロックとして出力するか、存在しないことを伝えます。出力に従ってください。NO_PRODUCT_MDが報告された場合は、他の作業を行う前にreference/init.mdに従って停止してください。 出力がUPDATE_AVAILABLEディレクティブで終了した場合は、それに従ってください(更新についてユーザーに一度確認し、その後続行します)。これにより現在のタスクがブロックされることはありません。 - ユーザーがサブコマンド (
craft,shape,audit,polish...) を呼び出した場合、次に必ずreference/<command>.mdを読まなければなりません。これは必須です。リファレンスはコマンドのフローを定義しており、これなしではユーザーが期待する手順をスキップすることになります。 - 既存のデザインシステム、規則、およびコード内のコンポーネントを把握します。少なくとも1つのプロジェクトファイル(CSS / トークン / テーマ / 代表的なコンポーネントまたはページ)を読んでください。ステップ2でサブコマンドリファレンスを読み込んだ場合でも必須です。 車輪の再発明はせず、既存のものを活用し、UX上のメリットがある場合にのみ新たに開発してください。
- 該当するレジスターリファレンスを読みます。これは必須であり、スキップすると汎用的な出力になります。 プロジェクトがマーケティング、ランディングページ、キャンペーン、長文コンテンツ、ポートフォリオ(デザイン = プロダクト)の場合は、
reference/brand.mdを読みます。アプリUI、管理画面、ダッシュボード、ツール(デザイン = プロダクトに奉仕)の場合は、reference/product.mdを読みます。以下の優先順位で選択します:(1) タスクの手がかり (「ランディングページ」対「ダッシュボード」); (2) フォーカスしているサーフェス(作業中のページ、ファイル、ルート); (3) PRODUCT.md のregisterフィールド。 - プロジェクトが完全に新しい場合(ステップ3で既存のCSSトークン/テーマ/コミットされたブランドカラーが見つからなかった場合)、
node {{scripts_path}}/palette.mjsを実行して、ブランドのシードカラーと構成ガイダンスを受け取ります。これがプライマリブランドカラーの基点となります。スクリプトの指示に従い、パレットの残り(bg, surface, ink, accent, muted)をこのカラーを中心に構成します。全体でOKLCHを使用します。ステップ3で既存のトークンにコミットされたブランドカラーが見つかった場合のみこのステップをスキップします。その場合、アイデンティティの維持が優先されます。
設計ガイダンス
プロトタイプや開始点ではなく、出荷可能なプロダクショングレードのコードを生成します。ユーザーが明示的に要求しない限り、手抜きはしないでください(不明な場合は確認してください)。完全な実装(美しく、レスポンシブで、高速で、正確で、バグがなく、ブランドに合致している)に到達するまで止まらないでください。細部への注意力を重視します。作成されたすべてのページ、セクション、コンポーネントは、利用可能なツール(ブラウザのスクリーンショット、コンピューター使用など)を使用して実戦的にテストされます。{{model}} は卓越した仕事が可能です。手加減しないでください。
一般ルール
カラー
- コントラストを確認してください。 本文テキストは背景に対して ≥4.5:1 を達成する必要があります。大きなテキスト(≥18px または太字 ≥14px)は ≥3:1 が必要です。プレースホルダーテキストも、ミュートされたグレーのデフォルトではなく、同じ 4.5:1 が必要です。最も一般的な失敗例:薄く色づいたほぼ白の背景に、ミュートされたグレーの本文テキスト。コントラストが「近い」場合は、本文のカラーをインク側に引き上げてください。「エレガントさ」のための薄いグレーは、AIがデザインしたものが読みにくくなる最大の原因です。
- 色付きの背景上のグレーのテキストは、くすんで見えます。背景色自体の暗い色合い、またはテキストカラーの透明度を使用してください。
タイポグラフィ
- 本文の行長は 65–75ch に制限してください。
- 類似しているが同一ではないフォント(幾何学的サンセリフ同士、ヒューマニストサンセリフ同士)をペアリングしないでください。コントラスト軸(セリフ+サンセリフ、幾何学的+ヒューマニスト)でペアリングするか、1つのファミリーを複数のウェイトで使用してください。
- ヒーロー/ディスプレイ見出しの上限:clamp() の最大値 ≤ 6rem(約96px)。これを超えると、ページは「叫んで」おり、「デザイン」されていません。
- ディスプレイ見出しの文字間隔下限:≥ -0.04em。これ以上詰めると文字が接触します。「デザイン」ではなく、窮屈に見えます。
- h1–h3 には
text-wrap: balanceを使用して行の長さを均等にし、長い散文にはtext-wrap: prettyを使用してオーファンを減らします。
レイアウト
- リズムのために間隔を変えてください。
- カードは怠惰な回答です。それらが本当に最良のアフォーダンスである場合にのみ使用してください。ネストされたカードは常に間違っています。
- 1DにはFlexbox、2DにはGridを使用してください。
flex-wrapでよりシンプルになるのに、Gridをデフォルトにしないでください。 - ブレークポイント不要のレスポンシブグリッドの場合:
repeat(auto-fit, minmax(280px, 1fr))。 - セマンティックなz-indexスケールを構築します(dropdown → sticky → modal-backdrop → modal → toast → tooltip)。999や9999のような任意の値は使用しないでください。
モーション
- モーションは意図的であるべきで、後付けであってはなりません。ビルドの一部として考慮してください。
- 本当に必要でない限り、CSSレイアウトプロパティをアニメーション化しないでください。
- 指数曲線(ease-out-quart / quint / expo)でイーズアウトしてください。バウンスやエラスティックは避けてください。
- より高度なモーションニーズにはライブラリ(例:motion, gsap, anime.js, lenis など)を使用してください。
- 動作軽減はオプションではありません。すべてのアニメーションには
@media (prefers-reduced-motion: reduce)の代替手段が必要です。通常はクロスフェードまたはインスタントトランジションです。 - 1つのリスト内のアイテムを連続してアニメーション(スタガー)させることは正当です。問題は、一様な反射(すべてのセクションに適用される同一のエントランスアニメーション)であり、モーションそのものではありません。各リビールは、それが明らかにするものに適合する必要があります。反射を抑制することは、モーションなしでページを出す理由にはなりません。
- リビールアニメーションは、すでに表示されているデフォルトを強化する必要があります。クラストリガーによるトランジションにコンテンツの可視性をゲートしないでください。トランジションは非表示タブやヘッドレスレンダラーで一時停止し、リビールが発火せず、セクションが空白で出荷されます。
- プレミアムモーションマテリアルは transform/opacity だけではありません。ブラー、backdrop-filter、clip-path、マスク、シャドウ/グローも、効果を実質的に向上させ、スムーズさを維持する場合には、パレットの一部です。
インタラクション
overflow: hiddenまたはoverflow: autoコンテナ内でposition: absoluteを使用してレンダリングされたドロップダウンはクリップされます。ネイティブの<dialog>/ popover API、position: fixed、またはポータルを使用してスタッキングコンテキストからエスケープしてください。
新規プロジェクトのみ(先行作業がない場合)
カラーとテーマ
- OKLCHを使用してください。
- クリーム/サンド/ベージュの本文背景は、2026年のAIデフォルトの飽和状態です。 温かみのあるニュートラル帯域(OKLCH L 0.84-0.97, C < 0.06, hue 40-100)全体が、何と呼ぼうとクリーム/サンド/紙/羊皮紙として読み取られます。
--paper、--cream、--sand、--bone、--flour、--linen、--parchment、--wheat、--biscuit、--ivoryのようなトークン名自体が特徴です。要件が「温かみのある、伝統的な、ファミリーコースタルイタリアン」や「マガジンのような温かみ」、「エディトリアルな抑制」であっても、それをほぼ白の温かみのある背景に変換しないでください。それはAIの動きです。選択肢:(a) 飽和したブランドカラーを本文として使用する(テラコッタ、オックスブラッド、深い黄土色、ほぼ黒)、(b) クロマ0の真のオフホワイト(またはデフォルトで温かみのある色相ではなく、ブランド自身の色相に向かうクロマ)、(c) ブランド独自のものであることが明らかな、より暗い中間調の色付きニュートラル。「温かみ」はブランドにおいては、アクセント+タイポグラフィ+イメージによって表現されるものであり、本文背景によって表現されるものではありません。 - 色付きニュートラル:ブランドの色相に向かって 0.005–0.015 のクロマを追加します。「ブランドがそう感じるから」という理由でデフォルトで温かみまたは冷たさに向かって色付けしないでください。それはプロジェクト横断的な単一文化の動きです。
- テーマを選ぶ際:ダーク vs ライトは決してデフォルトではありません。「ツールはダークの方がクールに見えるから」ダークにするのでも、「安全だから」ライトにするのでもありません。選択する前に、物理的なシーンを一文で書いてください。誰が、どこで、どのような環境光の下で、どのような気分でこれを使用するのか。その文が答えを強制しない場合、それは具体的ではありません。答えが出るまで詳細を追加してください。
- 色を選ぶ前にカラー戦略を選んでください。コミットメント軸による4つのステップ:
- 抑制 (Restrained):色付きニュートラル + 1つのアクセント ≤10%。プロダクトのデフォルト。ブランドのミニマリズム。
- 確約 (Committed):1つの飽和したカラーがサーフェスの30–60%を占める。アイデンティティ駆動のページのブランドデフォルト。
- フルパレット (Full palette):3–4つの名前付きロール、それぞれが意図的に使用される。ブランドキャンペーン、プロダクトデータ可視化。
- 浸透 (Drenched):サーフェス自体がカラー。ブランドヒーロー、キャンペーンページ。
絶対禁止
照合して拒否します。これらのいずれかを書きかけている場合は、異なる構造で要素を書き直してください。
- サイドストライプボーダー。 カード、リストアイテム、コールアウト、アラートに色付きアクセントとして 1px を超える
border-leftまたはborder-right。意図的なものは決してありません。全周ボーダー、背景の色合い、先頭の数字/アイコン、または何もなしで書き直してください。 - グラデーションテキスト。
background-clip: textとグラデーション背景の組み合わせ。装飾的で、意味がありません。単一の無地色を使用してください。強調はウェイトまたはサイズで行います。 - ガラスモーフィズムのデフォルト使用。 装飾的に使用されるブラーとガラスカード。稀で目的がある場合のみ、さもなければ使用しません。
- ヒーローメトリックテンプレート。 大きな数字、小さなラベル、補助統計、グラデーションアクセント。SaaSの決まり文句。
- 同一のカードグリッド。 アイコン+見出し+テキストで構成される同じサイズのカードを無限に繰り返す。
- すべてのセクションの上にある小さな大文字トラッキングされた小見出し(アイブロウ)。 2023年頃のキッカー(各見出しの上にある、広いトラッキングを持つ小さな大文字のテキスト、「ABOUT」「PROCESS」「PRICING」)は、現在、飽和したAIの足場となっています。これは、ブリーフに関係なく生成物の55-95%に現れ、まさに「特徴」の定義です。意図的なブランドシステムとしての1つの名前付きキッカーは「ボイス」ですが、すべてのセクションのアイブロウは「AI文法」です。異なるケイデンスを選択してください。
- デフォルトの足場としての番号付きセクションマーカー (01 / 02 / 03)。 各セクションの上に
01 · About / 02 · Process / 03 · Pricingを置くことは、アイブロウの決まり文句を一段階深くしたものです。「ランディングページはこうするものだから」と反射的に手を伸ばすものです。数字は、そのセクションが実際にシーケンスである場合(実際の3ステッププロセス、順序付けられたフロー、型付けされたタイムライン)、そしてその順序が読者が必要とする情報を伝える場合にのみ、その場所に値します。1ページに1つの意図的な番号付きシーケンスは「ボイス」ですが、サイト全体のすべてのセクションに番号付きアイブロウがあるのは「AI文法」です。 - コンテナからはみ出すテキスト。 長い見出しの単語と大きなクランプスケールと狭いグリッドの組み合わせは、タブレット/モバイルで見出しのオーバーフローを引き起こします。すべてのブレークポイントで見出しのコピーをテストしてください。オーバーフローする場合は、クランプの最大値を減らすか、コピーを書き直してください。ビューポートはデザインの一部です。
- 同じ要素に対する
border: 1px solid X+box-shadow: 0 Npx Mpx ...で M ≥ 16px。「ゴーストカード」パターン:ボタンやカードに1pxのボーダーと柔らかく幅広いドロップシャドウを組み合わせます。これらをペアリングしないでください。1つを選んでください(ブランドカラーの単一実線ボーダー、または最大8pxブラーの定義されたシャドウ)、装飾として両方を決して使用しないでください。 - カード/セクション/入力における
border-radius: 32px+。丸めすぎです。カードは最大12–16pxです。フルピルはタグ/ボタンには問題ありません。カードに24/28/32/40pxを選ぶのはCodexの特徴です。「異常に丸い」ことを望むブランドはありません。 - 手描き/スケッチ風のSVGイラストレーション。
loose-sketch、*-sketch、doodle、wavyのようなクラス名。feTurbulence/feDisplacementMapの「紙目」フィルター。具体的な被写体(カワウソ、テーブルとフォーク、アルバムカバー)を描写しようとする5〜30パスの粗いシーン。これらはすべて、風変わりではなく、アマチュアっぽく見えます。実際のアセットでシーンをレンダリングできない場合は、イラストレーションを提供しないでください。フォールバックとしてスケッチ風のSVGを試みないでください。 repeating-linear-gradient(...)のストライプ背景。body:beforeやセクション背景の斜めストライプは、純粋なCodexの装飾です。使用しないでください。
...
[長いため省略]