Generates user journey maps across 5 phases into Markdown docs and Pencil (.pen) visuals, with drop-off analysis, cross-insights, and dev roadmaps from product/user inputs.
npx claudepluginhub sean-sunagaku/claude-code-plugin --plugin user-story-visualizerThis skill uses the workspace's default tool permissions.
6つの専門エージェントがチームで議論し、ユーザージャーニーマップを作成・可視化する。
Generates user journey maps across 5 phases for multiple user types using 6 agent teams, with research, Markdown outputs, cross-analysis, dev roadmaps, and Pencil visualizations.
Generates customer journey maps from requirements, visualizing stages, touchpoints, emotions, and pain points as Mermaid diagrams.
Creates user journey maps with personas, phases, touchpoints, emotions, pain points, and opportunities for UX analysis and improvement.
Share bugs, ideas, or general feedback.
6つの専門エージェントがチームで議論し、ユーザージャーニーマップを作成・可視化する。 ペルソナファイルがあれば自動連携するが、手動入力のみでも動作する独立スキル。 Markdown ドキュメントに加え、Pencil (.pen) によるビジュアルマップも出力する。
.claude/user-story-visualizer/{YYYY-MM-DD}_{project}/
├── context.md <- プロダクト情報・ユーザータイプ一覧
├── log.md <- 議事録
├── research-data.md <- タッチポイント・行動パターン・離脱トリガー調査
├── journeys/
│ ├── journey-01.md <- ユーザータイプ1のジャーニーマップ（離脱トリガー含む）
│ ├── journey-02.md
│ └── ...
├── insights/
│ ├── cross-analysis.md <- 全ジャーニー横断分析
│ └── dev-roadmap.md <- 優先度付き開発ロードマップ
└── visuals/
└── journey-map.pen <- Pencil ビジュアルジャーニーマップ
以下を確認する（不明ならユーザーに質問）:
ペルソナファイルがある場合:
~/.claude/persona-creation/*/personas/persona-*.md を検索TeamCreate で user-story-visualizer チームを作成。以下6エージェントを 1つのメッセージで並列に Task ツールで起動する。
| name | 役割 | 主な手段 |
|---|---|---|
context-manager | コンテキストファイル・議事録の管理 | Write/Edit |
journey-architect | フレームワーク設計・品質管理・離脱トリガー分析 | 分析 |
ux-researcher | タッチポイント・行動パターン・離脱トリガー調査 | WebSearch, Write |
journey-writer | ジャーニーマップ執筆（離脱トリガーセクション含む） | Write/Edit |
insight-analyst | クロス分析・開発ロードマップ | Write/Edit |
journey-visualizer | Pencil ビジュアルジャーニーマップ生成 | Pencil MCP |
各エージェントは agents/ ディレクトリにサブエージェントとして定義済み。
TaskCreate で7つのタスクを作成:
addBlockedBy: ["1"]）addBlockedBy: ["1"]）addBlockedBy: ["2"]）- フレームワーク確定後すぐに開始。リサーチデータは届き次第取り込むaddBlockedBy: ["4"]）- 全ジャーニー完成後に開始addBlockedBy: ["4"]）- 全ジャーニー完成後に開始addBlockedBy: ["1","2","3","4","5","6"]）subagent_type: "context-manager" # agents/ で定義済み
team_name: "user-story-visualizer"
mode: "bypassPermissions"
run_in_background: true
プロンプトに含める情報（全エージェント共通）:
init.sh が出力する絶対パスをそのまま使う
/Users/babashunsuke/Desktop/miravy/.claude/user-story-visualizer/2026-02-21_miravy/.claude/... のような相対パスは動作しないjourney-01.md, journey-02.md, ... のゼロ埋め2桁。journey-1.md 形式は禁止）visuals/ ディレクトリの絶対パスと .pen ファイル名を指定する[journey-architect]
-> 全員に: 5フェーズ×8行のマッピングルール + 離脱トリガー分析フレームワーク
-> journey-writer: 「このフレームワークに従って執筆してください」
-> ux-researcher: 「各ユーザータイプのタッチポイントと離脱トリガーを調査してください」
[ux-researcher]
-> journey-writer に: リサーチデータ（ファイル + 要約メッセージ）
-> journey-architect に: タッチポイント・離脱トリガー調査結果
[context-manager]
-> 全員に: context.md, log.md 作成完了通知
[journey-writer]
-> 1体完成ごとに全員に共有
-> journey-architect: フレームワーク準拠チェック依頼
-> ux-researcher: リサーチデータ整合性チェック依頼
[journey-architect]
-> 1体完成ごとにレビュー → journey-writer にフィードバック
[ux-researcher]
-> タッチポイント整合性を確認 → journey-writer にフィードバック
[insight-analyst]
-> 全ジャーニー読み込み → クロス分析 → 開発ロードマップ
-> チームリーダーに完了報告
[journey-visualizer]
-> 全ジャーニーファイルを読み込み → Pencil でビジュアルマップ生成
-> チームリーダーに完了報告（.pen ファイルパスを添付）
[context-manager]
-> log.md を最終更新
全エージェントのタスクが completed になった後、最終レポート作成の前にファイル存在を検証する。
user-story-visualizer/{date}_{project}/
├── context.md <- context-manager
├── log.md <- context-manager
├── research-data.md <- ux-researcher
├── journeys/
│ ├── journey-01.md <- journey-writer（内容があること）
│ ├── journey-02.md
│ └── ...
├── insights/
│ ├── cross-analysis.md <- insight-analyst
│ └── dev-roadmap.md <- insight-analyst
└── visuals/
└── journey-map.pen <- journey-visualizer
検証手順:
journeys/*.md のファイル数を確認（ユーザータイプ数と一致するか）visuals/journey-map.pen の存在を確認全ファイルが揃ったら JOURNEY_REPORT.md をプロジェクトルートに出力する。
レポートに含める:
visuals/journey-map.pen）shutdown_request を送信TeamDelete でチーム削除bash scripts/init.sh <project-name>
# 例
bash scripts/init.sh miravy
# -> .claude/user-story-visualizer/2026-02-21_miravy/ を作成（カレントディレクトリ直下）
# visuals/ ディレクトリも含めて作成される