LLM とブランドを壁打ちして、結論を YAML に残して、CSS も Tailwind も生成する

brandspecにたどり着くまで
きっかけ
新しいサービスを作るうえで、LLM にずっと相談していました。
名前どうしようかな。いい名前ないかな?するとターゲットを聞かれる。LPの相談をすると、タグラインを決めるぞと言われる。そういうブランドの根っこの部分を、Claude とか ChatGPT と壁打ちしながら決めていく。たぶん同じことをやっている人は多いと思います。
色を決める作業では、作りかけのサービスに Tailwind のテーマを当てるために、「緑で、森の感じ」とか「なんかかっこよく」とか注文を出して、カラーパレットを作ってもらう。それを切り替えて試す。切り替えのThemeProviderを作り、色々なオーダーで試す。すると悪くないのが複数出てくる。今度は決め手に困る。
そうこうして気づくのは、サービスがなんであるかと、色味や細部は密接に関連しているということです。
以前所属していた会社でブランドアイデンティティ立ち上げのワークショップに参加したことがあります。個人規模の現在はプロに頼める予算も当然ないですが、それと近いことがAIと擬似的にできるのではと思いました。
またこうしたブランドの決定事項はいわばSSoTであり、これを堅持することで再現性を持った出力が可能になるのでは、と思いました。
作ろうとした
壁打ちの結論(名前、ターゲット、パーソナリティ、ストーリー)と、そこから導かれたデザイントークン(カラー、タイポグラフィ)が、同じファイルに入っている。チームで語り継ぐべきブランドのコアは全てここにまとまります。
AIに読みやすい形式であれば、ファイルから CSS も Tailwind テーマも Figma トークンも一発で生成できるし、人間向けの資料に落とすことも簡単です。
後日素材の追加が必要な際や、ブランドとしての価値判断(ある媒体に出るか)にしても、ブランドの文脈は全てここにあるので、軸足をおいて判断することができます。
そういうものが欲しくて作り始めたのが brandspec という OSS の CLI です。MIT ライセンス。
brand.yaml — ブランドの決定事項とトークンが同居する 1 ファイル
brandspec の核は brand.yaml というファイル。ブランドのコアと、カラーやタイポグラフィのデザイントークンが同居している。
必須フィールドは meta.name だけ。最小構成はこう:
meta:
name: "My Brand"
これだけだと何も生成されないけど、ちゃんと valid な brandspec ファイルではある。
実際にはこういう感じに育っていく:
meta:
name: "Acme Corp"
version: "1.0.0"
description: "Modern productivity tools for teams"
core:
essence: "Making the impossible satisfyingly simple"
tagline: "Simplicity, delivered"
personality:
- innovative
- approachable
- confident
voice:
tone:
- friendly
- clear
principles:
- "Use active voice"
- "Keep sentences short"
tokens:
colors:
primary:
$value: "oklch(0.65 0.18 250)"
$type: color
$description: "Main brand color"
primary-foreground:
$value: "oklch(0.98 0.01 250)"
$type: color
background:
$value: "oklch(0.99 0.005 250)"
$type: color
foreground:
$value: "oklch(0.15 0.02 250)"
$type: color
muted:
$value: "oklch(0.95 0.01 250)"
$type: color
muted-foreground:
$value: "oklch(0.45 0.02 250)"
$type: color
destructive:
$value: "oklch(0.55 0.20 25)"
$type: color
destructive-foreground:
$value: "oklch(0.98 0.01 25)"
$type: color
typography:
heading:
$value: "Inter, system-ui, sans-serif"
$type: fontFamily
body:
$value: "Inter, system-ui, sans-serif"
$type: fontFamily
assets:
- file: assets/logo-primary.svg
id: logo-primary
role: logo
variant: primary
上半分 (core) が AI と壁打ちして決めたブランドの意思決定。下半分 (tokens) がそこから導かれたデザイントークン。これが 1 ファイルに入っているのがポイントだと思っている。
カラートークンは W3C Design Tokens Community Group (DTCG) 仕様に準拠。色は oklch 形式[1]で書く。
AI ワークショップ — 壁打ちしながら brand.yaml を作る
brandspec には AI ワークショップという機能がある。Claude Code 上で対話しながらブランドを策定していく仕組み。
4 フェーズで進む:
- Discovery — ブランドの背景、ターゲット、競合を整理する
- Concept — 名前、タグライン、パーソナリティ、ストーリーを練る
- Visual Identity — カラーパレット、タイポグラフィ、ロゴの方向性を決める
- Documentation — 決まったことを brand.yaml に落とし込む
「緑で、森の感じ」みたいな曖昧な注文から oklch のカラーパレットを提案してもらって、気に入らなければ調整して、を繰り返せる。決まったことは _workshop/decisions.yml に蓄積されていくので、途中で中断しても文脈が失われない。
ワークショップの LLM は固定されていない。Claude でも GPT でも、自分が使いたいモデルを持ち込める。brand.yaml と decisions.yml がコンテキストとして渡されるので、モデルを切り替えても文脈は引き継がれる。
最終的に brand.yaml が出来上がる。自分で YAML を手書きしてもいいし、ワークショップで AI と作ってもいい。
セットアップ
Node.js 18 以上。
npx brandspec init
brandspec/ ディレクトリができる:
brandspec/
├── brand.yaml # ブランド定義ファイル
├── assets/ # ロゴ、アイコンなど
└── _workshop/ # AI ワークショップ状態管理
├── position.yml
├── decisions.yml
├── memo.md
└── session.md
brandspec/ はフロントエンドプロジェクトなどのリポジトリ内に置いて、git 管理するのを推奨する。brand.yaml がリポジトリにあれば、Claude Code などの AI ツールがそのまま読み込んで、ブランドの文脈を踏まえた相談ができる。
lint
npx brandspec lint で brand.yaml を 15のルールで検証する。WCAG コントラストチェック(oklch 対応)込みで、100 点満点のスコアが出る。--json で CI にも組み込める。
生成
npx brandspec generate --format all
4 つのフォーマットが出てくる:
dist/
├── tokens.css # CSS カスタムプロパティ
├── theme.css # Tailwind v4 テーマ
├── figma-tokens.json # Figma トークン
└── style-dictionary/
├── tokens.json # DTCG 形式
└── config.json # Style Dictionary 設定
tokens.css — CSS カスタムプロパティ
:root {
--primary: oklch(0.65 0.18 250);
--primary-foreground: oklch(0.98 0.01 250);
--background: oklch(0.99 0.005 250);
--foreground: oklch(0.15 0.02 250);
/* ... */
--font-heading: Inter, system-ui, sans-serif;
--font-body: Inter, system-ui, sans-serif;
}
theme.css — Tailwind v4
同じトークンが Tailwind v4 の @theme 形式で出力される。--color-primary のように prefix が付くので、bg-primary や text-foreground がそのまま使える。shadcn/ui 互換。
figma-tokens.json
Figma の Tokens Studio 形式。Figma Variables にインポートできる。
Style Dictionary
W3C DTCG 形式の JSON と設定ファイル。npx style-dictionary build で CSS、SCSS、iOS Swift、Android XML に展開できる。
つまりどういうことか
AI と壁打ちしてブランドを作る。決まったことが brand.yaml に集約される。そこから:
- フロントエンド →
tokens.cssかtheme.cssをインポート - デザイナー →
figma-tokens.jsonを Figma に読み込む - マルチプラットフォーム → Style Dictionary で iOS / Android に展開
- CI →
brandspec lint --jsonでブランド品質を自動検証 - 次に AI に相談するとき → brand.yaml を読ませれば、ブランドの文脈を踏まえて答えてくれる
更新は brand.yaml を 1 箇所変えて npx brandspec generate を再実行するだけ。
おわりに
ブランドは硬質なものであるはずです。ですが放っておくと運用で散逸して、柔く希薄になってしまう。チャット履歴に埋もれたり、誰かの頭の中にだけあったり。
そういう残念な体験を超えて、今なら1ファイルに集約したものが、適応先にも、人間にも渡せると思います。
Claude Codeなどお使いであれば、ローカルからいますぐブランド管理ができます。ぜひ brandspec.dev お試しあれ。
おまけ
*SaaS 版 (brandspec.tools) もちゃっかり用意しました。
- brandspecディレクトリのホスティングができる
- GUI でワークショップを進められる
- ローカルのモデル契約がなくてもAIが利用できる
- brand.yaml を読み込んだ AI にブランドのトーンで文章を書かせられる
- 色やアセットをまとめてチーム共有・公開もできる
ベータ期間中はFreeプランにAIトークンがついてきます。
npx brandspec init
GitHub: brandspec/brandspec

-
oklch は知覚的に均一な色空間で、「明度を変えずに彩度だけ上げる」といった操作が直感的にできる。wide gamut(広色域)にも対応している。hex や hsl でも書けるが、ブランドカラーの微調整には oklch の方が扱いやすいと思っている。CSS Color Level 4 で仕様化済みで、主要ブラウザは対応している。 ↩︎
Discussion