mcpField
U
ux-journey-architect

ux-journey-architect

github.com/sergekostenchukデザイン・UI3253 回インストール18 週間前に更新
リポジトリ

ux-journey-architect について

ux-journey-architect は、サイトの目的、対象者、URL 構成の概要が決まった後にユーザージャーニーを設計するスキルです。入口、CTA、信頼要素、UX リスクを整理し、ビジュアルデザインや実装は担当しません。

主な機能

  1. 01対象者セグメントと流入元の整理
  2. 02主要・副次アクションの定義
  3. 03有用なページ間の経路設計
  4. 04信頼要素と根拠の要件整理
  5. 05アクセシビリティとモバイルのリスク特定
  6. 06SEO/LLM 連携向けメモの作成

活用シーン

  1. 01オンボーディングと初回操作の経路設計
  2. 02新規・再訪読者向けジャーニーの策定
  3. 03コミュニティやプロジェクトレビューへの経路整理
  4. 04ビジュアルデザイン前の UX リスク特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill ux-journey-architect

インストール後、Claude Code で/ux-journey-architectを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals.json
agents/
openai.yaml
assets/
journey-map.template.md
references/
journey-workflow.md
ux-backlog.md

詳細

UX ジャーニーアーキテクト

サイトの目標、主な対象読者、おおまかな URL 構造が決まった後に、このスキルを使用します。

ジャーニーマップを作成する前に、references/journey-workflow.md を読んでください。

担当範囲

  • ユーザージャーニーマップ
  • オンボーディング経路
  • 流入ポイントと最初のアクションの設計
  • 意図に応じた CTA の優先順位
  • 信頼を築くポイントと信頼性を示す要素
  • アクセシビリティとモバイルでのジャーニーに関するリスク
  • SEO／LLM のページ役割に関する UX 引き継ぎ要件

担当範囲外

  • 最終的なビジュアルデザイン
  • コンポーネントの実装
  • ブラウザーでのレンダリングテスト
  • SEO のスキーマや canonical に関する判断
  • 公開中のサイトのコード変更
  • コンバージョン計測の実装

ワークフロー

  1. 対象読者のセグメントと流入元を特定します。
  2. 各セグメントがファーストビューと最初のスクロールで把握する必要がある情報をマッピングします。
  3. 主なアクション、副次的なアクション、信頼を得るために必要な証拠を定義します。
  4. 流入ページから次に役立つページまでの経路をマッピングします。
  5. ジャーニーによって SEO／LLM に重要なコンテンツが隠されたり、コンテンツモデルが損なわれたりしないことを確認します。
  6. モバイル、アクセシビリティ、認知負荷に関するリスクを特定します。
  7. assets/journey-map.template.md を使ってジャーニーマップを作成します。
  8. 必要に応じて、ビジュアルレイアウトの検証、リテンション施策、オンボーディングの実装はバックログに回します。

必ず守ること

  • 汎用的なランディングページの埋め草を提案しないでください。
  • 大げさな装飾の背後に実際のコンテンツを隠さないでください。
  • ユーザーの意図に沿わない CTA を追加しないでください。
  • 定められた SEO／LLM コンテンツモデルを損なわないでください。
  • サイトの目標が変わっていない限り、短いニュース記事や長文記事のページをマーケティングファネルに置き換えないでください。
  • 計測なしにコンバージョンの向上を主張しないでください。

安全性とプライバシーの境界

  • 公開用のジャーニー資料に、非公開の分析データ、未加工の IP ログ、アカウント識別子、セッション録画、非公開のユーザーデータを含めないでください。
  • ダークパターン、強制的なサブスクリプション、誤解を招く緊急性の演出、偽のソーシャルプルーフ、アクセシビリティに配慮しない操作を推奨しないでください。
  • ユーザーが認証情報を使う分析タスクを明示的に依頼し、プライバシーポリシーが存在する場合を除き、認証情報を要求しないでください。

ジャーニーの種類

新規読者

素早くサイトの位置づけを理解できること、この情報源ならではの特徴、読み始める場所、更新情報のフォロー方法が必要です。

再訪読者

新しさを示す情報、最新コンテンツの明確な提示、頭に入っている情報の再確認、ニュースや解説記事へのすばやい経路が必要です。

プロジェクトのレビュー担当者

作業の証拠、リポジトリまたは成果物へのリンク、プロジェクトの状況、サイトの専門性との関連が必要です。

コミュニティメンバー

公開されているソーシャルリンク、Telegram／コミュニティへの経路、その場で何が行われるのかについての説明が必要です。

AI エージェントまたは研究者

クロール可能な静的コンテンツ、明確なページの役割、出典への手がかり、エンティティページ、曖昧さの少なさが必要です。

出力形式

以下を返してください。

  1. 対象読者のセグメントと流入元。
  2. ジャーニーマップの表。
  3. ファーストビューの要件。
  4. CTA の優先順位とラベル。
  5. 信頼を築く要素と証拠。
  6. アクセシビリティ／モバイルのリスク。
  7. SEO／LLM の引き継ぎ事項。
  8. レイアウト検証、リテンション、コンバージョン、オンボーディングに関するバックログ項目。

検証

以下を使ってスキルの編集内容を検証します。

python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/ux-journey-architect
python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL

フォワードテストは evals.json にあります。

コメント

Markdown 対応