mermaid-mind-map

Mermaid マインドマップ

ソース資料を分析し、分岐階層が2～4段階の Mermaid mindmap 図を作成します。

参照ファイル

ファイル	読み込むタイミング
references/mermaid-syntax.md	デフォルト：マインドマップのノード形状、インデント、アイコン、既知の制限事項
references/generation-guidelines.md	デフォルト：ノードテキストの制約、深さの制御、ソースタイプ別の手法
references/mermaid-reference.md	マインドマップ以外の Mermaid 図を作成する場合、またはより広範な構文が必要な場合

ワークフロー

進捗を管理するため、このチェックリストをコピーします。

Mind map progress:
- [ ] Step 1: Determine source type
- [ ] Step 2: Set scope (depth, budget, central concept)
- [ ] Step 3: Extract structure
- [ ] Step 4: Generate Mermaid mind map
- [ ] Step 5: Validate output
- [ ] Step 6: Present to user

ステップ 1：ソースタイプを特定する

該当するソースタイプを特定し、対応する調査を実施します。

• トピックの調査：ユーザーが概念を指定します。対象範囲や読者が曖昧な場合は、確認の質問を1つします。ファイルのスキャンは不要です。
• コードベースの概要：プロジェクト構造をスキャンします。主要な設定ファイル（package.json、pyproject.toml など）を読み込みます。モジュール、エントリポイント、依存関係を整理します。
• ファイル／ドキュメントの要約：対象ファイルを読み込みます。主要なテーマやセクション、アイデア間の関係を抽出します。
• 機能計画／デバッグ：要件や症状を収集します。構成要素、フェーズ、考えられる原因に分解します。

ステップ 2：範囲を設定する

references/generation-guidelines.md の表を使って、深さのレベル（概要、標準、詳細）を選択します。不明な場合にのみユーザーに確認します。デフォルトは標準（3段階、15～30ノード）です。

中心となる概念を設定します。ルートノードには、明確な名詞または短いフレーズ（1～3語）を指定します。ノード数の上限は40です。

ステップ 3：構造を抽出する

• ソース資料から主要な枝を3～7個特定します（5個が理想です）。
• 深さの設定に応じて、各枝の下にサブノードを2～5個特定します。
• 関連する概念は同じ枝の下にまとめます。
• 各ノードは単一のキーワードまたは短いフレーズとし、文にはしません。
• ノードテキストの語数制限やキーワード抽出の手法については、references/generation-guidelines.md を参照してください。

ステップ 4：Mermaid マインドマップを生成する

正確な構文については、references/mermaid-syntax.md を読み込みます。フェンス付きの mermaid コードブロック内に生成します。

ノードの形状は意図的に使い分けます（形状の詳細な戦略については、references/generation-guidelines.md を参照してください）。

• ルート：中心となる概念に ((circle))
• 主要な枝：カテゴリに [square]、プロセスに (rounded)
• リーフノード：一般的な項目にはデフォルト、不確実な項目には {cloud}

ステップ 5：検証する

出力を提示する前に、次の項目を確認します。いずれかに失敗した場合は修正して再確認します。

• ルートを含むノードの合計数が40以下である
• 最大の深さが、選択したレベルを超えていない
• ノードテキストが6語を超えていない
• ルートノードのテキストが1～3語である
• 各主要な枝に子ノードが2～7個ある
• 子ノードが1つだけの枝がない（見つかった場合は上位の枝に統合する）
• 通常のテキストノードに、エスケープされていない ()[]{} がない（Mermaid の解析エラーの原因になります）
• 枝の深さのバランスが取れている（互いの差が1段階以内である）

ステップ 6：出力を提示する

フェンス付きの mermaid コードブロックでマインドマップを出力します。

```mermaid
mindmap
  root((Central Concept))
    [Branch 1]
      Sub-topic A
      Sub-topic B
    [Branch 2]
      Sub-topic C
      (Process D)
```

描画できる場所を記載します：GitHub の Markdown、Mermaid Live Editor、Mermaid 拡張機能を使った VS Code。

ユーザーがファイルを求めた場合は、フェンス付きブロックを含む .md ファイルに書き込みます。

アンチパターン

• ノードラベルに文を使う（代わりに、親概念と子ノードの詳細に分ける）
• 深さが4段階を超える（Mermaid が読みにくくなります。複数のマップに分割します）
• ノードが40個を超える（複数の焦点を絞ったマップに分割します）
• 要求がないのにアイコンを追加する（Font Awesome が必要で、表示されない場合があります）
• 1つのコードブロックで mindmap と他の Mermaid 図の種類を混在させる

関連スキル

• 視覚的な概要を補うスライド資料には presentation-creator
• 視覚的なマッピングを超えた詳細なアーキテクチャ上の決定には define-architecture