デザインラボスキル
このスキルは、インタビュー、バリエーション生成、フィードバック収集、リファイン、プレビュー、および最終決定を含む、完全なデザイン探索ワークフローを実装します。
重要: クリーンアップ動作
処理終了時は、以下の場合に関わらず、すべての一時ファイルを削除する必要があります。
- ユーザーが最終デザインを確認した場合 → クリーンアップ後、計画を生成
- ユーザーが中断/キャンセルした場合 → 即座にクリーンアップ、計画は生成しない
.claude-design/ または __design_lab ルートを残してはいけません。 ユーザーが「キャンセル」「中止」「停止」「やっぱりいい」などと言った場合、確認してから一時アーティファクトをすべて削除します。
フェーズ0: 事前検出
インタビューを開始する前に、以下を自動検出します。
パッケージマネージャー
プロジェクトルートのロックファイルを確認します。
pnpm-lock.yaml→pnpmを使用yarn.lock→yarnを使用package-lock.json→npmを使用bun.lockb→bunを使用
フレームワーク検出
設定ファイルを確認します。
next.config.js、next.config.mjs、またはnext.config.ts→ Next.jsapp/ディレクトリが存在するか確認 → App Routerpages/ディレクトリが存在するか確認 → Pages Router
vite.config.jsまたはvite.config.ts→ Viteremix.config.js→ Remixnuxt.config.jsまたはnuxt.config.ts→ Nuxtastro.config.mjs→ Astro
スタイリングシステム検出
package.json の依存関係と設定ファイルを確認します。
tailwind.config.jsまたはtailwind.config.ts→ Tailwind CSS@mui/materialが依存関係にある → Material UI@chakra-ui/reactが依存関係にある → Chakra UIantdが依存関係にある → Ant Designstyled-componentsが依存関係にある → styled-components@emotion/reactが依存関係にある → Emotion.cssまたは.module.cssファイル → CSS Modules
デザインメモリチェック
既存のデザインメモリファイルを探します。
docs/design-memory.mdDESIGN_MEMORY.md.claude-design/design-memory.md
見つかった場合は読み取り、デフォルト値の事前入力と重複する質問のスキップに使用します。
ビジュアルスタイルの推測(重要)
汎用的または定義済みのスタイルは使用しないでください。プロジェクトからビジュアル言語を抽出します。
Tailwind が検出された場合、tailwind.config.js または tailwind.config.ts を読み取ります。
// 以下を抽出して使用:
theme.colors // カラーパレット
theme.spacing // スペーシングスケール
theme.borderRadius // 角丸の値
theme.fontFamily // タイポグラフィ
theme.boxShadow // エレベーションシステム
CSS 変数が存在する場合、globals.css、variables.css、または :root 定義を読み取ります。
:root {
--color-* /* カラートークン */
--spacing-* /* スペーシングトークン */
--font-* /* タイポグラフィトークン */
--radius-* /* 角丸トークン */
}
UI ライブラリが検出された場合(MUI、Chakra、Ant)、テーマ設定を読み取ります。
- MUI:
theme.tsまたはcreateTheme()の呼び出し - Chakra:
theme/index.tsまたはextendTheme()の呼び出し - Ant:
ConfigProviderの theme プロパティ
常に既存のコンポーネントをスキャンしてパターンを理解します。
- 2~3個のボタンを見つける → それらのスタイリングパターンを記録
- 2~3個のカードを見つける → パディング、ボーダー、シャドウを記録
- 既存のフォームを見つける → 入力スタイル、ラベルの配置を記録
- 既存のタイポグラフィを見つける → 見出しサイズ、本文テキストを記録
推測したスタイルはデザインブリーフに保存し、すべてのバリアントで一貫して使用します。
フェーズ1: インタビュー
すべてのインタビューステップで AskUserQuestion ツールを使用します。デザインメモリが存在する場合は、それに基づいて質問を調整します。
ステップ1.1: スコープとターゲット
以下の質問をします(複数の質問を1つの AskUserQuestion にまとめることができます)。
質問1: スコープ
- ヘッダー: "スコープ"
- 質問: "単一のコンポーネントをデザインしますか、それともページ全体をデザインしますか?"
- 選択肢:
- "コンポーネント" - 再利用可能なUI要素(ボタン、カード、フォーム、モーダルなど)
- "ページ" - 完全なページまたは画面レイアウト
質問2: 新規またはリデザイン
- ヘッダー: "タイプ"
- 質問: "これは新しいデザインですか、それとも既存のもののリデザインですか?"
- 選択肢:
- "新規" - ゼロから作成する
- "リデザイン" - 既存のコンポーネント/ページを改善する
「リデザイン」が選択された場合、以下を質問します。 質問3: 既存のパス
- ヘッダー: "場所"
- 質問: "既存のUIのファイルパスまたはルートは何ですか?"
- 選択肢: (ユーザーが「その他」で入力できるようにする)
ターゲットが不明な場合、リポジトリのパターンに基づいて名前を提案し、確認を取ります。
ステップ1.2: 問題点とインスピレーション
質問1: 問題点
- ヘッダー: "問題"
- 質問: "現在のデザインの最大の問題点は何ですか(または、この新しいデザインで避けるべきことは何ですか)?"
- 選択肢:
- "情報が多すぎる/密集している" - 情報過多でスキャンしにくい
- "階層が不明確" - 主要なアクションが明確でない
- "モバイルでの操作性が悪い" - 小さな画面でうまく動作しない
- "古い見た目" - ブランドと一致していない、または時代遅れ
- multiSelect: true
質問2: ビジュアルインスピレーション
- ヘッダー: "ビジュアルスタイル"
- 質問: "どの製品やブランドをビジュアルインスピレーションの参考にすべきですか?"
- 選択肢:
- "Stripe" - クリーン、ミニマル、信頼性
- "Linear" - 情報量が多く、キーボードファースト、デベロッパー向け
- "Notion" - 柔軟性、コンテンツ重視、遊び心
- "Apple" - プレミアム、余裕がある、洗練
- multiSelect: true
質問3: 機能インスピレーション
- ヘッダー: "インタラクション"
- 質問: "どのようなインタラクションパターンを模倣すべきですか?"
- 選択肢:
- "インライン編集" - モーダルなしでその場で編集
- "プログレッシブディスクロージャー" - 必要に応じて詳細を表示
- "楽観的更新" - 即時フィードバック、バックグラウンドで同期
- "キーボードショートカット" - パワーユーザーの効率性
ステップ1.3: ブランドとスタイルの方向性
質問1: ブランドを表す形容詞
- ヘッダー: "ブランドトーン"
- 質問: "希望するブランドの雰囲気を表す3~5つの形容詞は何ですか?"
- 選択肢:
- "ミニマル" - クリーン、シンプル、すっきり
- "プレミアム" - 高級感、洗練、上品
- "遊び心" - 楽しい、親しみやすい、取っつきやすい
- "実用主義" - 機能的、効率的、無駄がない
- multiSelect: true
質問2: 密度
- ヘッダー: "密度"
- 質問: "どの情報密度を好みますか?"
- 選択肢:
- "コンパクト" - より多くの情報を表示、間隔を詰める
- "快適" - バランスの取れた間隔、スキャンしやすい
- "ゆったり" - 余白が多く、集中しやすい
質問3: ダークモード
- ヘッダー: "ダークモード"
- 質問: "ダークモードは必要ですか?"
- 選択肢:
- "必要" - ダークモードをサポートする必要がある
- "不要" - ライトモードのみ
- "あれば良い" - 簡単にできるならサポート、必須ではない
ステップ1.4: ペルソナとジョブ理論
質問1: 主要ユーザー
- ヘッダー: "ユーザー"
- 質問: "主なエンドユーザーは誰ですか?"
- 選択肢:
- "開発者" - 技術的、キーボード指向
- "デザイナー" - ビジュアル重視、細部にこだわる
- "ビジネスユーザー" - 効率重視、技術的でない
- "エンドコンシューマー" - 一般ユーザー、技術レベルは様々
質問2: コンテキスト
- ヘッダー: "コンテキスト"
- 質問: "主な使用コンテキストは何ですか?"
- 選択肢:
- "デスクトップ優先" - 主に大きな画面で使用
- "モバイル優先" - 主にスマートフォンで使用
- "両方同等" - すべてのデバイスで適切に動作する必要がある
質問3: 主要タスク
- ヘッダー: "主要タスク"
- 質問: "ユーザーが完了しなければならない上位3つのタスクは何ですか?"
- (ユーザーが「その他」で入力できるようにする - 自由記述)
ステップ1.5: 制約
質問1: 保持必須要素
- ヘッダー: "保持"
- 質問: "保持しなければならない要素はありますか?"
- 選択肢:
- "既存のコピー/ラベル" - 現在のテキストを維持
- "現在のフィールド/入力" - フォーム構造を維持
- "ナビゲーション構造" - 現在のナビゲーションを維持
- "なし" - すべて自由に変更
質問2: 技術的制約
- ヘッダー: "制約"
- 質問: "技術的な制約はありますか?"
- 選択肢:
- "新しい依存関係は追加しない" - 既存のライブラリのみ使用
- "既存のコンポーネントを使用" - 現在のデザインシステムを基に構築
- "アクセシブルである必要がある(WCAG)" - 厳格なアクセシビリティ要件
- "なし" - 特別な制約はなし
- multiSelect: true
フェーズ2: デザインブリーフの生成
インタビュー後、構造化されたデザインブリーフをJSONとして作成し、.claude-design/design-brief.json に保存します。
{
"scope": "component|page",
"isRedesign": true|false,
"targetPath": "src/components/Example.tsx",
"targetName": "Example",
"painPoints": ["情報が多い", "主要アクションが不明確"],
"inspiration": {
"visual": ["Stripe", "Linear"],
"functional": ["インライン検証"]
},
"brand": {
"adjectives": ["ミニマル", "信頼性"],
"density": "comfortable",
"darkMode": true
},
"persona": {
"primary": "開発者",
"context": "desktop-first",
"keyTasks": ["チェックアウト完了", "注文確認", "割引適用"]
},
"constraints": {
"mustKeep": ["既存のフィールド"],
"technical": ["新しい依存関係は追加しない", "WCAGアクセシブル"]
},
"framework": "nextjs-app",
"packageManager": "pnpm",
"stylingSystem": "tailwind"
}
続行する前に概要をユーザーに表示します。
フェーズ3: デザインラボの生成
ディレクトリ構造
すべてのファイルを .claude-design/ の下に作成します。
.claude-design/
├── lab/
│ ├── page.tsx # メインラボページ(フレームワーク固有)
│ ├── variants/
│ │ ├── VariantA.tsx
│ │ ├── VariantB.tsx
│ │ ├── VariantC.tsx
│ │ ├── VariantD.tsx
│ │ └── VariantE.tsx
│ ├── components/
│ │ └── LabShell.tsx # ラボレイアウトラッパー
│ ├── feedback/ # インタラクティブフィードバックシステム
│ │ ├── types.ts # TypeScriptインターフェース
│ │ ├── selector-utils.ts # 要素識別
│ │ ├── format-utils.ts # フィードバックフォーマット
│ │ ├── FeedbackOverlay.tsx # メインオーバーレイコンポーネント
│ │ └── index.ts # モジュールエクスポート
│ └── data/
│ └── fixtures.ts # 共有モックデータ
├── design-brief.json
└── run-log.md
フィードバックシステムのセットアップ(重要 - 絶対にスキップしないでください)
FeedbackOverlay はデザインラボの主要機能です。 これがないと、ユーザーはインタラクティブなフィードバックを提供できません。FeedbackOverlay なしでデザインラボを生成しないでください。
信頼性戦略: 異なるプロジェクト設定間でのインポートパスの問題を回避するため、FeedbackOverlay は ルートディレクトリに直接(例: app/design-lab/FeedbackOverlay.tsx)、.claude-design/ の下には作成しません。これにより、単純な相対インポート(./FeedbackOverlay)が常に機能することが保証されます。
ルートディレクトリに必要なファイル:
app/design-lab/ # または app/__design_lab/(アンダースコアが機能する場合)
├── page.tsx # バリアントを含むメインラボページ
└── FeedbackOverlay.tsx # 自己完結型オーバーレイコンポーネント(テンプレートからコピー)
テンプレートソース: design-and-refine/templates/feedback/FeedbackOverlay.tsx
このアプローチの理由:
.claude-design/のパスは、バンドラ設定によっては失敗する可能性がある- 同じディレクトリからの相対インポートは常に機能する
- ルートディレクトリはクリーンアップ時に削除される
ルート統合
Next.js App Router:
.claude-design/lab/ からインポートする app/__design_lab/page.tsx を作成します。
Next.js Pages Router:
.claude-design/lab/ からインポートする pages/__design_lab.tsx を作成します。
Vite React:
- React Router が存在する場合:
/__design_labへのルートを追加 - ルーターがない場合: クエリパラメータ
?design_lab=trueに基づいてApp.tsxに条件付きレンダリングを作成
その他のフレームワーク: 検出されたフレームワークに最も適した一時ルートを作成します。
バリアント生成ガイドライン
重要: UX、インタラクション、モーションのベストプラクティスについては DESIGN_PRINCIPLES.md を読んでください。ただし、定義済みのビジュアルスタイルは使用しないでください。 プロジェクトから推測します。
普遍的な原則を適用します(DESIGN_PRINCIPLES.md より):
- UX: ニールセンのヒューリスティック、認知的負荷の低減、プログレッシブディスクロージャー
- コンポーネントの動作: ボタンの状態、フォームの構造、カードの構造
- インタラクション: フィードバックパターン、状態処理、楽観的更新
- モーション: タイミング(150~300ms)、イージング(イーズアウトで出現、イーズインで終了)
- アクセシビリティ: フォーカス状態、ARIAパターン、タッチターゲット(44px以上)
プロジェクトからビジュアルスタイルを推測します:
- 色 → Tailwind設定、CSS変数、または既存のコンポーネントから
- タイポグラフィ → コードベース内の既存の見出し、本文から
- 間隔 → プロジェクトの間隔スケールまたは既存のパターンから
- 角丸 → 既存のカード、ボタン、入力から
- シャドウ → 既存の浮揚コンポーネントから
各バリアントは異なるデザイン軸を探求する必要があります。小さなバリエーションを作成しないでください。意味的に異なるものにしてください。 すべてのバリアントに プロジェクトの既存のビジュアル言語 を使用します。
バリアントA: 情報階層重視
- コンテンツの階層を再構築(何が最も重要か?)
- ゲシュタルトの近接性を適用 - 関連項目を近くにグループ化
- ビューごとに1つの主要アクション
- 既存のタイポグラフィスケールを使用して明確なレベルを作成
バリアントB: レイアウトモデルの探求
- 異なるレイアウトアプローチを試す(カード vs リスト vs テーブル vs 分割ペイン)
- DESIGN_PRINCIPLES からカード構造またはテーブル動作パターンを適用
- 各ブレークポイントでのレスポンシブ動作を検討
- プロジェクトの既存のグリッド/レイアウトシステムを使用
バリアントC: 密度のバリエーション
- ブリーフが「快適」の場合は、よりコンパクトなバージョンを試す
- ブリーフが「コンパクト」の場合は、よりゆったりしたバージョンを試す
- プロジェクトの既存の間隔トークンを使用 - 単に異なる方法で適用する
- トレードオフを示す:表示データの多さ vs スキャンのしやすさ
バリアントD: インタラクションモデル
- 異なるインタラクションパターン(モーダル vs インライン vs パネル vs ドロワー)
- フィードバックパターンを適用:即時 → 進行中 → 完了
- 必要なすべての状態を実装(ローディング、エラー、空、無効)
- 非破壊的なアクションには楽観的更新を検討
バリアントE: 表現の方向性
- インタビューでユーザーが説明したブランドの方向性を押し出す
- プロジェクトの既存のデザイントークンの異なる使用方法を探る
- シャドウ、ボーダー、背景色の使用量を増減
- 意味を追加する場所にモーションを適用(ホバー、フォーカス、トランジション)
ラボページの要件
デザインラボページには以下を含める必要があります。
-
ヘッダー を含む:
- デザインブリーフの概要(ターゲット、スコープ、主要要件)
- レビュー手順
-
バリアントグリッド を含む:
- 明確なラベル(A、B、C、D、E)
- 各バリアントの簡単な根拠(「なぜこれが存在するのか」)
- 実際にレンダリングされたバリアント
…
[翻訳のため省略]