🍎

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

に公開
2026/02/26

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 フェーズで進む:

  1. Discovery — ブランドの背景、ターゲット、競合を整理する
  2. Concept — 名前、タグライン、パーソナリティ、ストーリーを練る
  3. Visual Identity — カラーパレット、タイポグラフィ、ロゴの方向性を決める
  4. 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

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

Discussion