←
図の一覧
デザインシステム整備のロードマップ
Phase 0/前提確認と方針提案
先方に聞き、MCP化を提案
Phase 1/参照経路の構築
エンジニアと接続
Phase 2/整合性の修正
残る矛盾だけ直す
Phase 3/採用版の参照一覧
何を使うかを1箇所で
Phase 4/手本画面の整備
1画面分だけ
Phase 5/検証と拡張
整備前後を比較し広げる
やること
成果物
先方と決める
次へ進む条件
本番
Storybookの部品は本番と同じコードか
管理
本番部品の管理場所、Storybookの有無
提案
Storybookがあれば、MCPでClaudeが直接参照する構成を最初から提案
体制
リポジトリの設定変更が要るので、初期からエンジニアを巻き込む
手本
標準的な一覧画面を先方と選定(Createでも可)
版
旧版・新案・比較案の採用状態
更新
Storybookのバージョンアップ(ZIPは8.6系)
接続
MCPアドオン導入、リポジトリ設定、公開と認証
確認
部品・Props・使用例が取れるか。Claude Codeかclaude.aiか
代替
MCP化できなければClaude Codeでリポジトリを直接参照
エンジニアと共同。デザイナーだけでは完結しない
省略
説明の複製をコードに合わせる作業は、MCPで直接参照すれば不要になる可能性
矛盾
承認済みルールと実装の違いは残る → 修正か例外か
例外
理由・範囲・承認者・見直し時期を記録
未記録
記録の無い差異は確認事項へ
MCP化できれば、この列は縮む
一覧
部品・画面ごとに 状態・用途・参照先・置き換え先
Skill
一覧から採用版を選ぶ手順だけ。一覧は重複させない
PoC
参照範囲を明示して絞る
新案・比較案は採用決定まで標準にしない
Usage
用途・使わない場面・代替・組み合わせ・例(TextField・SelectFieldから)
共通
エラー表示・必須は共通フォームルールに
雛形
固定/変更可能/適用条件/対象外
状態
0件2種・読み込み中・失敗・長文と狭い画面。作成編集は二重操作・入力保持・未保存確認
比較
同じ要件で整備前後を生成し4指標で評価
反復
同条件で複数回。ずれが減り続けるか
応用
項目を変えた画面にも効くか
拡張
ずれをもとに範囲を広げる
合意
MCP化の方針と担当エンジニア
記録
確認結果
決定
手本にする画面
接続
Claudeから参照できるStorybook
一覧
取得できる情報
代替
MCP化できない場合の経路
整合
直した実装
記録
例外の記録
一覧
確認事項
一覧
AI向け参照一覧
Skill
採用版を選ぶ手順
PoC
参照範囲の指定
Usage
Usageと共通フォームルール
雛形
Page Template
仕様
状態・操作仕様
評価
前後比較の結果
ずれ
ずれと反映先
次
次の対象範囲
方針
問題なければMCP化で進める
体制
参加するエンジニア
正
本番コード基準。既存実装=正ではない
手本
一覧かCreateか
更新
バージョンアップの時期と担当
接続
接続元、公開方法と認証
区別
意図的な例外か、直す不整合か(記録の有無で)
状態
採用済み/検討中/旧版
置換
旧版の置き換え先
条件
流用してよい条件と対象外
指標
無い部品・Props/Token・Usage違反/状態の抜け/修正回数
方針と手本が決まる
MCP化の可否、担当エンジニア、手本1画面
Claudeが部品を直接取れる
部品・Props・使用例がMCPで取れる(または代替経路が動く)
記録の無い差異が無い
直した/例外記録/確認事項 のどれか
旧版が使われない
PoCの生成結果で確認
手本1画面分が揃う
Usage・雛形・状態・操作
ずれが減り続ける
減っていれば次の画面へ広げる
ずれ → 反映先
1
部品選択 →
Usage
(Phase 4)
4
状態・操作の抜け →
状態・操作仕様
(Phase 4)
2
配置・構成 →
Modules/Page Template
(Phase 4)
5
正しい情報を参照しない →
AI向け指示/Skill
(Phase 3)
3
色・文字・余白 →
Token/実装との整合
(Phase 2)
6
取得できない・古い →
参照経路/MCP
(Phase 1)
ずれを戻す