作業の進め方
Design Token Audit は、製品が既存のトークン体系をどう使用しているかを調べます。ハードコードされた色や間隔などの視覚的な値を探し、適切なトークン階層を使っているかを確認し、重複・非推奨トークンを特定します。チームが移行に使える具体的な差異一覧を作ることが目的です。
ソースは適用範囲、一貫性、不足を区別します。値がトークンを経由していない場合、誤った意味上の役割を使う場合、現在の体系では満たせない正当な要件を示す場合があります。これらを分けることで、すべてのリテラル値を見た目の近いトークンへ機械的に置き換えるのを防ぎます。
想定される成果物
- トークン採用状況と確認範囲を説明する監査要約。
- ハードコード値と推奨置換トークンの分類一覧。
- 不足するトークンの提案と優先順位付き移行計画。
ブリーフからレビューまで
- 01視覚的な値を棚卸しする
関連デザインファイルと実装コードの両方を読みます。色、間隔、タイポグラフィなどの属性を抽出し、比較可能な分類に整理します。
- 02現在の体系に対応付ける
使用箇所を既存トークンとその階層に対応付けます。ハードコード値、一貫しない役割、重複定義、非推奨トークンへの参照を示します。
- 03不足と逸脱を分ける
不適切な置換を押し付けず、新しいトークンが必要な場合を特定します。頻度と影響で順位を付け、影響の大きい色と間隔の問題を優先します。
- 04移行を計画する
実行可能な置換一覧と提案を作成します。後続監査で同じ範囲の採用状況を比較できるよう、何を調べたかを明記します。