コーディングエージェントに画面を任せると、機能は付くのに見た目が毎回変わります。昨日作ったボタンは青い角張った形だったのに、今日生成したページには紫のグラデーションが入っている。「もう少しすっきり」と言い直しても、その「すっきり」の基準は人の頭の中にしかないので、やり取りが空回りします。awesome-design-mdは、その基準を言葉ではなくファイルで渡そうという取り組みです。有名サイトのデザイン言語を分析してDESIGN.md 1枚にまとめたコレクションで、AIエージェントのフレームワークを開発するVoltAgentがMITライセンスで公開しています。
ひと目でわかる概要
| 項目 | 内容 |
|---|---|
| 開発元 | VoltAgent |
| ライセンス・料金 | MIT、無料 |
| 規模 | DESIGN.md 73本、10分類(2026年9月時点のリポジトリのバッジ) |
| 形式 | Markdownファイル1つ。プラグインもアカウントも不要 |
| 使う場所 | Claude Code、Cursorのようなコーディングエージェントと、Google Stitch |
| 始め方 | リポジトリからファイルをコピー、またはnpx getdesign@latest add <名前> |
AGENTS.mdが「作り方」なら、DESIGN.mdは「見せ方」
DESIGN.mdはこのリポジトリが考え出した形式ではなく、Google Stitchが提案した概念です。エージェントが読むドキュメントを役割ごとに分けようという発想で、リポジトリはその違いを一言でまとめています。AGENTS.mdはコーディングエージェントが読み、プロジェクトをどう作るかを決めるドキュメント。DESIGN.mdはデザインエージェントが読み、プロジェクトがどう見えるべきかを決めるドキュメントです。すでにリポジトリのルートにAGENTS.mdを置いているなら、その隣が空いていたことになります。
大事なのは、形式がMarkdownだという点です。Figmaの書き出しも、デザイントークンのJSONも、専用のパーサーもありません。言語モデルがいちばん読みやすい形式でルールを書き、ルートに置いておくだけです。各ファイルはGoogle Stitchが公開したDESIGN.mdの仕様に沿いつつ、項目を足して9つの節で構成されています。雰囲気と密度を書く節、色と役割を対応させた節、書体の階層表、ボタンやカードの状態別スタイル、余白とグリッド、影の体系、やってはいけないことのリスト、レスポンシブの挙動、そして最後に、エージェントにそのまま貼り付けるプロンプトのガイドが入っています。
色を役割の名前で呼ぶ
このコレクションの性格を決めているのは、説明文ではなく値です。Claudeのサイトを分析したファイルの冒頭はこうなっています。
colors:
primary: "#cc785c"
ink: "#141413"
canvas: "#faf9f5"
surface-card: "#efe9de"
accent-teal: "#5db8a6"
typography:
display-xl:
fontFamily: "Copernicus, Tiempos Headline, serif"
fontSize: 64px
fontWeight: 400
lineHeight: 1.05
letterSpacing: -1.5px
色にprimary、canvas、inkのような役割の名前が付いているので、エージェントが本文の背景と強調ボタンを取り違えません。値の上には人が読む説明が1段落添えられています。Claudeのファイルでは、多くのAIブランドが冷たい青やスレートを使うのに対し、クリーム色の地に温かいコーラルを載せている点を、そのブランドの性格として挙げています。こうした文があるからこそ、モデルはhex値だけをコピーせず、意図までまねできます。
何が入っているか
集めている範囲は広く、AIプラットフォームではClaude、Cohere、Mistral AI、Ollama、xAI、開発ツールではCursor、Vercel、Raycast、Warp、Superhumanが入っています。ほかにもバックエンドとDevOps(MongoDB、ClickHouse、PostHog)、生産性SaaS(Linear、Notion、Cal.com)、デザインツール(Figma、Framer、Webflow)、フィンテック(Stripe、Coinbase、Wise)、コマース(Shopify、Airbnb、Nike)、メディア(Apple、Spotify、NVIDIA)、自動車(Tesla、BMW、Ferrari)と分類が続き、1996年のDellと2001年のNintendoのサイトを復元したレトロ枠まであります。
実質的な変化は、一覧の長さより、頼み方が具体的になることです。「高級感を出して」の代わりに「Appleのように余白を大きく」や「Vercelのようにモノクロで正確に」を選べばよく、その選択が実際のhex値や文字サイズに置き換わってエージェントに渡ります。
ひとつ、構成を先に知っておくと迷いません。リポジトリの各フォルダにはDESIGN.mdと短いREADME.mdしかありません。色見本やタイポグラフィのスケールを目で確かめるプレビュー、ダークモードの例、ダウンロードボタンは、同じチームが運営するgetdesign.mdのサイトに移っており、フォルダのREADMEがそのアドレスへ案内しています。トップのREADMEにはフォルダごとにpreview.htmlがあると書かれていますが実際にはないので、プレビューはウェブで見る必要があります。
始め方
design-mdフォルダから、作りたい画面の性格に近いサイトを選びます。見当がつかなければ、先にgetdesign.mdでプレビューを見ます。- 選んだファイルをプロジェクトのルートに
DESIGN.mdとしてコピーします。CLIならnpx getdesign@latest add claudeのように1行で済みます。 - エージェントにファイルを示して指示します。「ルートのDESIGN.mdを基準に料金ページを作って」くらいで十分です。
- 結果がずれたら、ファイルの値を直接直します。Markdownなので、色をひとつ変えるのにビルドもツールも要りません。
いちばん得をするのは、まだデザインシステムがないチームがエージェントでUIを作るときです。逆に、独自のトークンとコンポーネントライブラリがすでにあるなら他社ブランドのファイルを載せる理由はなく、自社のシステムをDESIGN.mdの形式で一度まとめておくほうがよいでしょう。その場合、このリポジトリはよく書かれた73本の見本として使えます。
注意点
- 公式のデザインシステムではない。 公開されているウェブサイトのCSSの値を観察してまとめた独立の分析で、リポジトリ自身も各ブランドとは無関係で承認も受けていないと明記しています。
- そのまま写すと問題になる。 色や書体、レイアウトを丸ごと移すと、商標やトレードドレスの領域に入ります。方向性をつかむ参考資料として使い、自社の色と書体に置き換えることが前提です。
- エージェントがいつもルールを守るとは限らない。 DESIGN.mdは強制される設定ではなく、読まれるドキュメントです。ファイルとずれた結果はやはり出てくるので、確認は人の仕事です。
- まだ初期段階。 ファイルの1行目には
version: alphaとあり、先に見たとおりREADMEと実際のフォルダ構成が食い違っている部分も残っています。
まとめ
awesome-design-mdは新しい技術というより、合意された形式ひとつと、よく整理された見本の束に近いものです。ただ、エージェントにUIを任せるとき毎回欠けているのが、まさにその形式です。言葉で説明していた基準をファイルで固定すれば、同じ指示から同じ結果が返ってくる確率が上がります。MITライセンスでファイルを1回コピーするだけなので、次にランディングページをエージェントに頼む機会があれば、1枚置いて違いを確かめてみる程度で十分です。
アイキャッチ画像:VoltAgentのロゴ、© VoltAgent。紹介目的で使用しています。