コードからシステム構成図を自動生成するツール

バイブコーディングが当たり前になってきた今、自分で書いたコードであっても「全体像の把握」が追いつかなくなってきている。APIの接続先、モジュール間の依存関係、外部サービスとの連携……AIに書かせるほどコードは増え、最初に引いた設計図は数週間で現実と乖離する。

この問題を指して「ドキュメント腐敗」と呼ぶ。手動で図を更新する文化が崩れ、Confluenceに残っているアーキテクチャ図がもはや参照されない、という状況は、規模を問わず起きている。

特に個人やスモールチームで動く「使い倒し型」の場合、ドキュメント管理に人手を割く余裕はない。気づいたら誰も全体像を把握していない、という状態が静かに発生する。AIがシェルを自律操作、開発の自動化が変わるでも触れたように、自動化が進むほど「人間がどこを見ればいいか」の整理が重要になってくる。

LikeC4（ライクC4）はGitHub上で4,200以上のスターを集めているOSSで、「コードで書いたアーキテクチャ定義から、常に最新の構成図を自動生成する」という設計思想で作られている。

仕組みとしてはシンプルだ。プロジェクト内に.likec4という専用の定義ファイルを置き、そこにシステムの要素（サービス、データストア、外部APIなど）と関係性をテキストで記述する。するとCLIがそれを読み取り、インタラクティブなシステム構成図をリアルタイムで描画・更新してくれる。

重要なのは、図がコードと同じリポジトリに存在するという点だ。コードを変えれば図も変わる。プルリクエストのレビューで構成の変化が視覚的に確認できる。「図と実装がズレる」という問題を、ワークフローの構造ごと解消しようとしている。

UIはWebベースのビューワーが付属しており、ローカルで立ち上げてブラウザから確認できる。チームで使うなら、図をそのまま静的HTMLとしてエクスポートして共有することも可能だ。公式ドキュメントによると、Mermaid等の汎用図形ツールとの最大の違いは「図が常にコードの現在地と同期している」点にある。

LikeC4の定義ファイルは独自DSL（ドメイン固有言語）で書くが、構文はシンプルで、JSONやYAMLを書いたことがある人なら数分で読めるレベルだ。

コードなしでできることとして、まず既存プロジェクトの構成を手で定義ファイルに書き起こし、図として出力するという使い方がある。ドキュメント代わりに使うだけでも、散らばっていた情報を一箇所に集める効果がある。ビューワーで複数の「視点」（全体図・特定コンポーネントの詳細図など）を切り替えながら確認できるのも実用的なポイントだ。

コードが書けると有利なこととしては、CI/CDパイプラインに組み込むことが挙げられる。コードの変更がマージされるたびに図の更新を自動で走らせ、常に最新の構成図をどこかに発行し続ける運用が可能になる。また、AIにコードを書かせる際に.likec4ファイルも同時に更新させるようプロンプトで指示すれば、「AIが書いた設計の全体像」を人間が追いやすくなる。

AIコーディング中にWeb検索をローカルで完結させるのようにローカル環境を整えている人なら、LikeC4のCLIをそこに加えるだけでシームレスに組み込めるはずだ。