オリジナル特集オリジナル特集
AIに伝わるデザインルールとは?DESIGN.mdの始め方
DESIGN.mdとは何か――AIに「見た目の判断基準」を渡す
AIに画面の実装を頼むと、動くものはできても、色や余白、文字の大きさが既存のサービスとそろわないことがあります。指示のたびに「ブランドカラーを使う」「余白は広めに」と説明しても、表現が曖昧なら結果は安定しません。そこで役立つのが、プロジェクトのデザイン方針をまとめる「DESIGN.md」です。
DESIGN.mdは、色・書体・間隔などの具体的な値と、それをどう使うかという理由やルールを一つの文書にまとめる方法です。人間が読める説明に加えて、コード上のトークン名やコンポーネント名を記せば、AIが既存実装と結びつけて判断しやすくなります。単なるブランド紹介ではなく、実装時に参照できる「デザインの作業基準」として捉えるのがポイントです。
最初の一歩は、対象と目的を絞る
始めるときは、完璧なデザインシステムを一度に書こうとせず、まずプロジェクトのルートにDESIGN.mdを作成します。冒頭にはサービスの概要、主な利用者、対象となる画面の役割を書きましょう。「誰が、何をするための画面か」が明確だと、AIは装飾の方向だけでなく、情報の優先順位も考えやすくなります。
たとえば「幅広い利用者向けの予約サービス」だけでは抽象的です。「初めて訪れた人が、スマートフォンで空き状況を確認し、迷わず予約できる画面」のように、利用者と行動を具体化します。対象を一画面や主要な操作フローに限定すれば、必要なルールも見つけやすく、書いた内容をすぐ試せます。
色・文字・余白を、再利用できる形で書く
次に、色、タイポグラフィ、間隔など、画面全体に影響する基本ルールを整理します。色は「青系」ではなく、既存コードに対応するトークン名や値を記載し、用途も添えます。例として、主要操作用の色、背景色、本文色、エラー表示色を分け、「主ボタンに使う」「通常の本文には使わない」といった使い分けを明示します。
文字についても書体名だけで済ませず、見出し・本文・補足文のサイズ、太さ、行間など、階層を示すと実装に役立ちます。余白や角丸も、ばらばらの数値を並べるより、既存のCSS変数やコンポーネントの命名に合わせて記述するのが効果的です。既存のコードと同じ言葉で書くことで、AIが新しい値を勝手に増やす可能性を抑えられます。
よく使う部品からルール化し、小さく検証する
基本値を整理したら、ボタン、入力欄、カード、ナビゲーションなど、頻繁に使う部品からルールを加えます。ボタンなら、色や高さだけでなく、主操作と副操作の区別、無効状態、フォーカス時の見え方まで書くと、画面ごとのばらつきを減らせます。「統一感を保つ」のような抽象的な指示より、「既存の主ボタンを優先して再利用し、新しい色やサイズを追加する場合は理由を示す」のように、実行・確認できる文章が有効です。
完成後は、AIにDESIGN.mdを参照させ、小さな画面修正や部品の追加を一つ依頼してみます。結果を見て、解釈が割れた箇所や不足していた状態を追記します。最初から網羅的な文書を目指すのではなく、実装と確認を通じて育てることが、使われるルールにする近道です。DESIGN.mdはAIの判断を完全に固定するものではありませんが、チームが大切にする基準を共有し、手戻りを減らす土台になります。
