mapping-visualization-scaffolds

マッピングと可視化のひな形

目次

• ワークフロー
• 一般的なパターン
• ガードレール
• クイックリファレンス

ワークフロー

このチェックリストをコピーして、進捗を記録してください。

Mapping Visualization Progress:
- [ ] Step 1: Clarify mapping purpose
- [ ] Step 2: Identify nodes and relationships
- [ ] Step 3: Choose visualization approach
- [ ] Step 4: Create the map
- [ ] Step 5: Validate and refine

ステップ 1：マッピングの目的を明確にする

ユーザーに目標を尋ねます。どのシステムや概念をマッピングする必要がありますか？対象者は誰ですか？どのような意思決定に役立てますか？必要な詳細度はどの程度ですか？一般的なユースケースについては、一般的なパターンを参照してください。

ステップ 2：ノードと関係性を特定する

すべての主要な要素（ノード）と、それらのつながり（関係性）を列挙します。階層レベル、依存関係の種類、グループ化の基準を特定します。単純なケース（ノードが 20 個未満）では、resources/template.mdを使用してください。複雑なシステム（ノードが 50 個以上）や共同作業のセッションについては、高度な戦略を説明したresources/methodology.mdを参照してください。

ステップ 3：可視化のアプローチを選択する

複雑さに基づいて形式を選択します。ノードが 10 個未満ならシンプルなリスト、階層にはツリー図、複雑な関係性にはネットワークグラフ、システムにはレイヤー図を使用します。大規模システムや複数のマップから成る階層については、マッピング戦略とツールの選択に関するresources/methodology.mdを参照してください。指針については、一般的なパターンを参照してください。

ステップ 4：マップを作成する

Markdown、ASCII 図、または構造化テキストを使って可視化を作成します。まず大まかな構造から始め、次に詳細を追加します。必要に応じて凡例を付けます。ひな形としてresources/template.mdを使用してください。

ステップ 5：検証して改善する

resources/evaluators/rubric_mapping_visualization_scaffolds.jsonを使って、完全性、明瞭さ、正確性を確認します。重要なノードと関係性がすべて含まれていることを確かめます。最低基準：平均スコアが 3.5 以上。

一般的なパターン

アーキテクチャ図：

• システムコンポーネントをノードとして表す
• サービス呼び出し／データフローを関係性として表す
• レイヤーをグループ化する（フロントエンド、バックエンド、データ）
• 用途：技術文書、システム設計レビュー

概念マップ：

• 概念／アイデアをノードとして表す
• 「〜である」「〜を持つ」「〜につながる」を関係性として表す
• テーマごとにグループ化する
• 用途：学習、知識の整理、研究成果の統合

依存関係グラフ：

• タスク／機能／モジュールをノードとして表す
• 「〜に依存する」「〜をブロックする」「〜を必要とする」を関係性として表す
• フェーズ／スプリントごとにグループ化する
• 用途：プロジェクト計画、リスク評価、並行作業の特定

階層と分類体系：

• カテゴリー／クラスをノードとして表す
• 親子関係を表す
• レベルごとにグループ化する（L1、L2、L3）
• 用途：情報アーキテクチャ、組織図、スキルツリー

フロー図：

• ステップ／状態をノードとして表す
• 遷移／判断を関係性として表す
• スイムレーンごとにグループ化する（役割、システム）
• 用途：プロセス文書、ユーザージャーニー、判断ツリー

ガードレール

スコープ管理：

• 特定の目的に関係するつながりに焦点を当てる
• すべてをマッピングするのではなく、意思決定に関係するものをマッピングする
• 適切な詳細度で止める（通常は深さ 3〜4 層）
• ノードが 50 個を超えるシステムでは、焦点を絞った複数のマップを作成する

完全性より明瞭さを優先：

• 網羅性より理解しやすさを優先する
• 一貫した表記法と命名を使う
• 関係性の種類が 3 つを超える場合は凡例を追加する
• 関連するノードをグループ化して、視覚的な複雑さを抑える

検証：

• 分野の専門家に正確性を確認してもらう
• 初めて見る人がマップを理解できるか試す
• 重要な関係性が抜けていないか確認する
• 方向性が明確であることを確かめる（A → B と A ← B）

よくある落とし穴：

• ❌ つながりが多すぎる「スパゲッティ」図を作成する
• ❌ 抽象度のレベルを混在させる（戦略と実装の詳細）
• ❌ ノード／関係性の表現に一貫性がない
• ❌ マップの目的と範囲を明記し忘れる

クイックリファレンス

リソース：

• resources/template.md - マップ作成用の構造化されたひな形
• resources/evaluators/rubric_mapping_visualization_scaffolds.json - 品質基準

出力：

• ファイル：現在のディレクトリにある mapping-visualization-scaffolds.md
• 内容：ノード、関係性、グループ分け、凡例（必要な場合）
• 形式：ASCII 図または構造化されたリストを含む Markdown

成功基準：

• 重要なノードがすべて特定されている
• 関係性が方向も含めて明確に示されている
• 適切なグループ分けやレイヤー分けが適用されている
• 説明がなくても対象読者が理解できる
• 品質評価基準に照らして検証されている（スコア ≥ 3.5）