ui-variations

UI Variations

現在のアプリを分析し、そのアプリに合った5つの異なるスタイル方向を動的に生成。 各 ui-designer が mcp__pencil__batch_design で直接構築するため、5画面が同時に出来上がる。 固定プリセットは使わず、毎回アプリのドメイン・コードベース・ペルソナ・トンマナから導出する。

アーキテクチャ

リーダー（あなた）
├── V1チーム: v1-designer + v1-reviewer + v1-copywriter
├── V2チーム: v2-designer + v2-reviewer + v2-copywriter
├── V3チーム: v3-designer + v3-reviewer + v3-copywriter
├── V4チーム: v4-designer + v4-reviewer + v4-copywriter
└── V5チーム: v5-designer + v5-reviewer + v5-copywriter

各 designer が直接 Pencil に書き込む（MCP ツールはサブエージェントでも使用可能）
リーダーは見守り + 最終比較レポート

ワークフロー

1. ヒアリング（画面要件、プラットフォーム、ターゲット）
2. アプリ分析 → スタイル方向の動的生成（プリセット不使用）
3. Pencil キャンバス準備（5フレーム配置）← リーダーが実施
4. 5チーム並列起動（各3エージェント = 計15エージェント）
5. デザイン構築 + チーム内レビュー ← designer が直接 Pencil 操作
6. スクリーンショット取得 + 比較レポート生成
7. クリーンアップ

Step 1: ヒアリング

以下を確認（不明ならユーザーに質問）:

• 画面: どの画面を作るか（ログイン、ホーム、設定等）
• 機能要件: 画面に必要な要素（ボタン、入力欄、リスト等）
• プラットフォーム: iOS / Web / 両方
• ターゲット: 年齢層、技術レベル
• 既存コード: あればソースコードを読んで機能を把握
• 制約: 必須の色、ブランド要件、既存デザインシステム
• 除外スタイル: 使いたくないスタイル方向

Step 2: アプリ分析 → スタイル方向の動的生成

プリセットは使わない。 現在のアプリケーションを分析し、そのアプリに合ったスタイル方向を毎回ゼロから生成する。

2-1. アプリコンテキストの収集

以下のソースから情報を集める（存在するもの全て）:

コードベースから:

• 既存の画面コンポーネント（色、フォント、レイアウトパターン）
• デザイントークン / テーマ定義（colors.ts, theme.ts 等）
• package.json / app.json からアプリのカテゴリ・説明
• 既存UIの雰囲気（Glob + Read で主要画面を読み取る）

ドキュメントから:

• docs/personas/ - ペルソナ（あれば行動パターン・利用シーンを抽出）
• .claude/app-tone-manner/ or docs/tone-manner/ - トンマナ
• docs/product-context.md - プロダクト定義
• docs/competitive-analysis/ - 競合分析
• CLAUDE.md - プロジェクトの概要

ユーザーから:

• Step 1 のヒアリング結果（画面要件、ターゲット、制約）
• 「こういう方向は避けたい」等の除外指示

2-2. デザインリサーチ（WebSearch）

収集したアプリ情報を元に、以下を WebSearch で調査する:

• 同カテゴリの優れたアプリのUI事例（例: タスク管理アプリなら Todoist, Things, TickTick 等）
• ターゲットユーザー層に人気のデザイントレンド
• そのドメインで「定番」とされるUIパターン

2-3. 5つのスタイル方向を生成

収集した情報を統合し、このアプリ固有の5つの方向性を設計する。

生成ルール:

1. 5つが情報設計・ビジュアルの両面で明確に異なること
2. 全てがこのアプリのドメイン・ターゲットに適合すること（汎用プリセットの流用禁止）
3. 既存コードのデザイントークンがあれば、少なくとも1つはそれをベースにする
4. ペルソナがあれば、ペルソナの行動パターンから情報優先順位を変える
5. トンマナがあれば、その制約内でバリエーションを出す
6. 競合アプリの調査結果から差別化ポイントを反映する

各スタイルについて以下を定義:

• コンセプト名（そのアプリに即した具体的な名前。「Minimal」等の汎用名禁止）
• 設計思想（なぜこの方向か、どんなユーザー体験を狙うか）
• 情報設計: 最大CTA、情報の優先順位、ナビ構造、セクション配置
• カラーパレット: 背景、プライマリ、テキスト、アクセント（アプリの文脈に合った配色）
• フォントファミリーとウェイト
• レイアウト方針: 余白、角丸、ボーダー、密度
• トーン: コピーの方向性（アプリのブランドに合ったもの）
• 差別化ポイント: 他の4バリエーションとどう違うか

Step 3: Pencil キャンバス準備（リーダーが実施）

1. get_editor_state で現在のファイルを確認
2. get_guidelines でデザインガイドライン取得（topic: "design-system"）
3. find_empty_space_on_canvas で空き領域を特定
4. 5つのルートフレームを横並びに配置:

V1 (gap:100)  V2 (gap:100)  V3 (gap:100)  V4 (gap:100)  V5
393x852       393x852       393x852       393x852       393x852

各フレームの設定:

• width: 393, height: 852 (iPhone 15 Pro)
• clip: true
• layout: vertical
• name: "V{N}: {StyleName}"

重要: 各フレームのノードIDを記録する。designer に渡す情報として必須。

Step 4: チーム作成と15エージェント起動

TeamCreate で ui-variations チームを作成。

タスク作成

TaskCreate で以下を作成:

バリエーションごと（x5）:

• V{N} デザイン構築 - ui-designer 担当
• V{N} デザインレビュー - design-reviewer 担当（デザイン構築に blockedBy）
• V{N} コピー作成 - copy-writer 担当（デザイン構築に blockedBy）

全体:

• スクリーンショット取得 + 比較 - リーダー担当（全15タスクに blockedBy）

エージェント起動

1つのメッセージで15エージェントを並列起動する。

各バリエーションにつき3エージェント:

subagent_type: "general-purpose"
team_name: "ui-variations"
name: "v{N}-designer" (or v{N}-reviewer, v{N}-copywriter)
model: "opus"
mode: "bypassPermissions"
run_in_background: true

注意: subagent_type は "general-purpose" を使用する（MCP ツールへのアクセスが必要なため）。 プロンプトに各エージェントの役割定義（agents/*.md の内容）を含める。

プロンプトに含める情報

ui-designer へ:

• agents/ui-designer.md の全内容（役割・手順・Pencilルール）
• .pen ファイルパス（絶対パス）
• 割り当てフレームのノードID
• スタイル方向の詳細（カラーパレット、フォント、レイアウト方針）
• 画面の機能要件
• チーム内メンバー名: v{N}-reviewer, v{N}-copywriter
• 既存コードの要約（あれば）

design-reviewer へ:

• agents/design-reviewer.md の全内容
• .pen ファイルパス
• 割り当てフレームのノードID
• スタイル方向の概要
• チーム内メンバー名: v{N}-designer, v{N}-copywriter

copy-writer へ:

• agents/copy-writer.md の全内容
• .pen ファイルパス
• 割り当てフレームのノードID
• スタイル方向のトーン定義
• ターゲットユーザー情報
• 画面の機能要件
• チーム内メンバー名: v{N}-designer, v{N}-reviewer

Step 5: 進行管理

リーダーの役割:

• 基本は見守り。エージェントが自律的に作業
• designer が直接 Pencil に構築 → reviewer がスクショ確認 → copywriter がコピー提案
• 詰まったエージェントがいればアドバイス

並行編集の安全ルール

5つの designer が同じ .pen ファイルに同時書き込みする。競合を防ぐため:

• 各 designer は自分の割り当てフレーム内のみ操作する
• 他の V{N} フレームへの Insert/Update/Delete は禁止
• document への直接 Insert は禁止（リーダーのみ）
• reviewer/copywriter は読み取り専用（get_screenshot, batch_get のみ）、書き込みは designer が行う
• プロンプトに「あなたの担当フレームID: {nodeId}」を必ず明記する

チーム内フロー:

1. ui-designer が mcp__pencil__batch_design でデザイン構築
2. ui-designer が mcp__pencil__get_screenshot で確認
3. ui-designer が reviewer と copywriter に完成通知
4. design-reviewer が mcp__pencil__get_screenshot でレビュー → フィードバック
5. copy-writer が mcp__pencil__get_screenshot でデザイン確認 → コピー提案
6. ui-designer が修正 → 最終版をリーダーに報告

Step 6: 比較レポート生成

全チーム完了後:

1. 5つのフレームの get_screenshot を取得
2. references/comparison-template.md のテンプレートで比較レポート作成
3. 比較マトリクス（スコア表）を生成
4. ベストチョイスと組み合わせ提案を含める
5. UI_VARIATIONS_REPORT.md として出力

比較マトリクス

観点	V1	V2	V3	V4	V5
ビジュアル品質	/10	/10	/10	/10	/10
UX	/10	/10	/10	/10	/10
アクセシビリティ	/10	/10	/10	/10	/10
プラットフォーム準拠	/10	/10	/10	/10	/10
コピー品質	/10	/10	/10	/10	/10
総合	/50	/50	/50	/50	/50

Step 7: クリーンアップ

1. 全15エージェントに shutdown_request を送信
2. 全員シャットダウン後に TeamDelete

Pencil テクニカルノート

designer のプロンプトに必ず含める:

• テキストの色は fill プロパティ（textColor は無効）
• justifyContent は space_between（アンダースコア、ハイフンではない）
• batch_design は最大25操作/コール
• Insert は必ずバインディング名が必要: foo=I("parent", {...})
• Copy した子ノードの更新は descendants プロパティ経由
• 画像は G() 操作（AI生成 or stock）
• 画像は frame/rectangle に fill として適用（image ノード型は無い）
• filePath パラメータは毎回必ず指定する