【元記事】(https://zenn.dev/uniquevision/articles/625e00137b75af)
3行まとめ
- C4モデルを使ってアーキテクチャ図をPlantUML/MermaidのコードでGit管理する手法を解説
- 4つの抽象度レベル（コンテキスト・コンテナ・コンポーネント・コード）で粒度を統一する
- バージョン管理とコードレビューが可能になり、AIツールとの相性も向上する
要約
背景・課題
- アーキテクチャ図はツールがバラバラ（PowerPoint、draw.ioなど）で粒度が曖昧、複雑になると1枚に詰め込めない問題がある
- チームや個人によって形式や詳細度が異なり、メンテナンスが困難になりがち
アプローチ
- C4モデルを採用し、4つの階層で段階的に抽象度を分ける
- PlantUMLやMermaidでテキストベースのコードとして記述し、Gitで管理可能にする
成果・ポイント
- 「どこまで詳細に書くか」の判断基準が明確になり、抽象度・粒度が統一される
- バージョン管理とコードレビューが可能になり、Claude Codeなどによる編集・生成との相性も向上する