Diagram Minerは、プロジェクトのドキュメントやREADMEを解析してアーキテクチャ図やシーケンス図を自動生成する小さなツールです。繰り返し出てくる用語や設定キーを検出して（共有変数として扱い）、編集可能な図を出力します。小さなチームが図と文章を同期させやすくなります。
ドキュメントの図は作成が面倒で放置されがちです。結果としてレビュー時に古い画像や手書きスケッチが使われ、内容が実態とずれます。複数のMarkdownファイルに散らばった関連用語や設定を手作業で探すのは、少人数チームにとって時間の無駄です。
Diagram MinerはMarkdown、コードコメント、簡単な設定ファイルを解析し、エンティティと関係を抽出、繰り返しトークンを共有変数としてマッピングします。MermaidやSVGで編集可能な図を生成し、レイアウト提案や文言スニペットも表示。ユーザーは図を修正し、共有変数をロックして全図を一括更新、更新済み画像をリポジトリに戻せます。小規模チーム向けの低額月額または買い切りです。
Tomは小さな分析ツールを保守しており、READMEに入れるネットワーク図が欲しいと考えています。Diagram Minerをリポジトリにかけると、README、CONTRIBUTING.md、config.ymlを解析して“collector”“processor”“storage”といったエンティティを抽出し、下書き図を表示しました。‘db_host’が複数箇所に出てくるのを見て、それを共有変数に設定すると全ての図に反映されます。ラベルを直し、ボックスを移動してレイアウトを固定し、SVGを出力してコミット。PRには「自動更新されたアーキテクチャ図」と書き、同僚は「見やすくなったね」とコメント。スケッチに半日かける代わりに20分で終わりました。
パースペクティブ: Guiding people through small, meaningful life shifts
作成日時: 2025/11/5 16:26:37