🖼️

画面(UI)デザインデータ管理をしないプロダクト開発を考える - Claude Code・Storybook・Figmaの活用

に公開
2026/03/02

AIなどが飛躍的に発達し、一からプロダクト作る場合の機能・UI設計ってもう最初からPencilでAIといっしょに考えたりすると思うのですが、既存プロダクトでは今までの資産を活用しながらどうAI前提の開発運用にのっけるのか、を最近はいつも考えています。

要約

課題: 実装と乖離していく「UIデザインデータのメンテナンス」は、多くの現場で大きな負担となっている。

解決策: Claude Code、Storybook、Figmaを組み合わせ、デザインデータではなく「実コード」を正とする運用へシフトする。

展望: AIの力でコードからデザインをオンデマンドに生成することで、デザイナーは「管理」から解放され「設計と判断」に集中できる。

デザインデータを管理し続けるべきなのか?

デジタルプロダクトのデザインを続ける中で、誰もが直面する課題があります。それは「UIデザインデータのメンテナンス」です。
最新のアプリケーションの状態に合わせて、Figmaなどのデザインファイルを更新し続ける作業。いわゆる「デザインマスターデータ」の運用に、限界を感じている方は多いのではないでしょうか。

そもそもなぜマスターデータ(最新のUI一覧)が必要なのかというと

  • 現状把握: どんな画面やコンポーネントが存在するか知りたい。
  • 仕様理解: UIに紐づく機能や遷移ルールなどを把握したい。
  • 設計の起点: 新しく設計を行う際、今のUIをベースに検討を始めたい。

などの役割があるからです。

ただ日々の業務や仕様追加に追われ、マスターデータが現状(ソースコード)と乖離してしまう…というのはあるあるですよね。

ソースコードを唯一のUIソースとする

「デザインデータを捨てて、コードを唯一の正解(Single Source of Truth)にすればいい」という議論は昔からありました。
ソースコードそのものや開発環境を見ればいい、と。

しかしながら、様々なページ、状態を持つアプリケーションで必要な画面を好きなように確認できる環境を作るにはかなりコストがかかるという課題がありました。充分なテストデータを用意したり、常に一定の状態が保証されるような開発環境を用意するのは骨が折れます。


作品画面一つとっても、通常販売、抽選販売、販売休止などなど色々なパターンを持つ

加えてそもそもデザインデータなかったらUI設計作業も始めにくいですよね。
毎度現状のUIを復元してからスタートになるので。

こういったことから「デザインデータ管理をなくす」というのは現実的には難しいよね、というのが今までだったかなと思います。

…が、そこにAI(LLM)が現れました🤖✨

Claude Code・Figma・Storybook使ってデザインデータ管理をやめる

最近のAIの進化やツールの発展により、先述したデザインデータ管理をやめる場合の問題を乗り越えられるんじゃないかと思ったのです。

※以下、Webアプリケーション開発を例として書いています

Storybookで必要なUIデータを表示する

Storybookとは、(Reactなどで実装された)コンポーネント単位でUI表示、テスト、ドキュメントなどを作成できるUIカタログツールのようなものです。

https://zenn.dev/fullyou/articles/853b77a3ce9144

例えば先程でてきた作品ページのような一画面も、コンポーネントが組み合わさった大きなコンポーネントなので、もちろんStorybookで表示することができます。
これを使えば、今のソースコードでどのような画面が表示されるのかを確認することが出来ます。

ただこういった画面丸ごと表示させるには、たくさんデータをページにわたす必要がある場合が多いです(普通はAPIでまるっと取ってくるようなイメージ)。
例えば抽選販売時の作品画面をStorybookで表示するなら、仕様を確認しながら抽選販売用の画面を表示するためのダミーデータを作らないといけません。面倒。

しかし今はAIがあります。Claude Codeが仕様を確認してくれて、見たい状態の画面を表示するダミーデータを一瞬で作ってくれます。


複数パターンの画面もすぐできちゃう

そう、AIがある今では、現状のソースコードでどんなUIができあがるのかをすぐ形にして確認することが出来ます。
自動で最新の状態が反映されるマスターファイルのようなものですね。
必要になったタイミングでStorybookファイルを追加していけば、一覧性も高まっていきます。

しかしまだ「マスターデータなかったらUI設計の作業も始めにくい」という問題は残っています。

そこでFigmaの登場です。

Figmaデータに変換して編集する

最近FigmaからClaude Code to Figmaという機能が公開されました。
Claude Code & Figma MCPを通して、開発サーバーで立ち上げた画面をFigmaのデザインデータに変換することができ、また逆にUIデザインの情報を読み取ってClaudeにコードの修正をお願いすることが出来ます。

https://note.com/kgsi/n/n6105dc1174bf

つまり、先程Storybookで立ち上げた最新のUI(画面)を、Figmaのデザインデータに変換することができるのです。


専用のスクリプトが埋め込まれ、Figmaのデータに変換してくれる


Figmaデータに変換したもの。画像は持ってきてくれなかったので後で埋め込みました

そのままFigmaに落とした画面データを修正して実装を依頼する、コピーして数パターンを作ってそれぞれ比較しながら実装してもらう、などなどClaudeとFigmaの連携のお陰でデザインと実装の往復がかなりやりやすくなってきました。

またFigmaのデータは特徴の違うデザインツール「Pencil」にインポートできるので、Claudeといっしょにデザインを練ってみたり、仕様書としてコードと一緒にGit管理する、みたいな使い方も出来そうです。

まとめ

  • Storybookを活用することで、最新のUI情報をFigmaからではなく実コードから取得できる様にする
    • Storybookの実装はAI(Claude)を活用することで苦ではなくなった
    • 難点はStorybookのデータ数が多くなること?
  • Claude Code to Figmaを使うことで、設計したいUI(画面)の最新データを必要なときに取得し編集できる
    • ClaudeとFigmaの連携でコードへの反映も比較的ラクに
      • Code Connectとか使うともっと便利になるかな?(宿題です)
    • FigmaからPencilへ変換しての活用も可

デザインデータ管理大変って感じてる人多かったと思うので、このタイミングでもう一度あり方を考えてみませんか?

今回はStorybook使えるかもと思って試してみたのですが、開発とデザインの統合が進んでいるので、もっとスムーズな方法や機能が生まれてきそうです。

おまけ

デザインデータってUIだけじゃなく要件や仕様も含めたドキュメントなので、それ無くしちゃうのまずくないか?という問い

むしろそういったものはソースコードと合わせて管理すべきでは。実際のコードとまとめておくことで、テストの書きやすさや実装計画の立てやすさにも繋がりそうと考えています。

デザインもAIにまるっとやらせちゃえばいいのでは、という問い

これは場面や技術の状況にもよると思うのですが、現時点ではUIデザインやモデリングなどの設計作業はデザイナーが主体になった方がよいと考えています。

作業がAIに任せられるようになる中、判断することを人間は求められるようになるわけですが、その決定を下すための材料をためる、構築する時間がUIデザインやモデリングの作業の中に含まれていると思っています。

また結論を出すことの効率化を(AIを使って)求めるあまり、充分な検討をせぬまま設計をFIXさせてしまうことも増えているのではと感じています。
(まぁフィードバックループが素早く回せるのならいいのかもしれない)

なので将来的には全部お任せになる未来が来るかもしれませんが、今はまだ手綱を握るべきかなと。

https://note.com/fumink7/n/nc73ef01ca5bb

Discussion