AIエージェント向けに色・フォント・間隔などの設計トークンと説明文をYAML+マークダウンで記述する仕様とCLIツール
中辛 の解説
DESIGN.mdはビジュアルデザインをAIエージェント向けの構造化形式に翻訳します。YAMLフロントマターで色・フォント・間隔・コンポーネントトークンを機械可読に定義し、その下のマークダウン本文でデザイン理念や使用方法を人間向けに説明する2層構造です。CLIツールはlintで構造検証とWCAG対比度チェック、diffでバージョン間の変更追跡、exportでTailwind v3/v4設定やW3C DTCG形式への出力を実行します。セクション順序・トークン参照の完全性・未使用トークンの検出など11個のリント規則を自動実行し、JSON形式で結果を返します。TypeScript実装で、npm経由でインストール可能な完成ツールです。
こんなリポジトリです
こんなときに便利です
- デザイナーがDESIGN.md仕様で色・フォント・間隔を定義し、AIエージェント向けに機械可読な形式で提供する
- 複数バージョンのDESIGN.md間で設計トークンの追加・変更・削除を自動追跡して回帰を検出する
- DESIGN.mdトークンをTailwind v3/v4の設定やW3C DTCG形式に自動変換して、異なるツールチェーンで再利用する
主な機能
ほかとの違い
AIエージェント向けに設計の機械可読値（トークン）と人間向け説明（マークダウン）を同一ファイルで統一管理することで、エージェントが正確な値を読み取りながらも、デザイン背景の文脈を保持できます。
このリポジトリの作り方
はじめてですか？ むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。
準備するもの
- Node.js環境
すぐに始める
- npm経由でパッケージをインストールします
npm install @google/design.md
- 既存のDESIGN.mdファイルをlintコマンドで検証します
npx @google/design.md lint DESIGN.md
- 結果がJSON形式で出力されます（エラーや警告が構造化されます）
代替方法（Windows PowerShellの場合）: .md拡張子の関連付け競合を避けるため、designmdエイリアスを使用します
npx -p @google/design.md designmd lint DESIGN.md
- 2つのバージョンを比較してトークン変更を検出します
npx @google/design.md diff DESIGN.md DESIGN-v2.md
- トークンをTailwind設定に変換します
npx @google/design.md export --format json-tailwind DESIGN.md
ギット飯トライで味見
入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。
ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。
npx gitbap-try google-labs-code/design.md
Node.js さえあれば、インストールなしで動きます · ギット飯トライとは？ →
スター推移 · 7日
確認日時
使いやすさ · まねしやすいか
- ゆるいライセンス
- テストあり
- サンプル集
- 最近の更新
- AGENTS.md
- llms.txt
- テンプレート
更新の情報なし · 2026 年に作成
「AI エージェント」 こういうリポジトリを毎週受け取りませんか？
毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。
自分のリポジトリですか？ README にギット飯バッジを貼る
[](https://www.gitbap.com/r/google-labs-code/design.md)Claude からそのまま使う — ギット飯のつなぎ方
ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。
Claude の設定 → コネクタにこのアドレスを貼り付け。
https://www.gitbap.com/api/mcpプラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI が README をもとに要約しました · 原文を見る