リポジトリの肥大化は「技術的負債」の終着点だ：Gitの深淵を制御する戦術的ロードマップ
リポジトリが数GBに達し、`git clone` を実行してコーヒーを淹れに行ってもまだ終わらない……。そんな状況は、チームの生産性を殺す最大の敵だ。
「とりあえずリポジトリを分ける」という短絡的な判断は、依存関係の地獄を招く。今日は、Gitの神髄を理解し、「LFS」「サブモジュール」「sparse-checkout」という3つの武器を、状況に応じて正確に使い分けるための実戦的ロードマップを伝授する。
—
1. 肥大化の正体を見極めろ：分析のファーストステップ
まず、何がリポジトリを殺しているのかを可視化せよ。直感で判断してはいけない。以下のコマンドで「犯人」を特定する。
リポジトリ内の巨大なオブジェクトTOP10を特定
git rev-list –objects –all | git cat-file –batch-check=’%(objectsize) %(objectname) %(rest)’ | sort -n | tail -n 10
ここでバイナリ（画像、動画、MLモデル等）が上位を占めているならGit LFS、ソースコードそのものが膨大ならsparse-checkout、プロジェクトの境界が明確ならサブモジュールという判断を下す。
—
2. 武器の使い分け：アーキテクトの判断基準
| 手法 | 目的 | メリット | デメリット |
| :— | :— | :— | :— |
| Git LFS | バイナリ管理 | 巨大な履歴を別管理できる | サーバーコストと転送時のロック |
| サブモジュール | 依存関係の分離 | リポジトリ間の結合度を下げられる | 参照先のバージョン管理が複雑 |
| sparse-checkout | 部分的取得 | 巨大リポジトリの一部のみ作業可能 | Gitコマンドの理解度が必須 |
Git LFS：バイナリの聖域
LFSは「Git本来の思想」を維持しつつ、バイナリを切り離す。
現場の知見: LFSを導入する際は、`.gitattributes` に必ず `filter=lfs` を定義する。特にマージコンフリクトが起きやすいバイナリは `lockable` オプションを付けろ。
.gitattributes
.psd filter=lfs diff=lfs merge=lfs -text
.assets filter=lfs diff=lfs merge=lfs -text lockable
サブモジュール：疎結合の極み
サブモジュールは「他のリポジトリを参照する」という強力な契約だ。
現場の知見: サブモジュールを使うなら、`–recursive` を自動化する設定をチーム全員の `.gitconfig` に強制させろ。
全員に設定を徹底させる（チーム開発の必須ルール）
git config –global submodule.recurse true
sparse-checkout：巨大モノレポへの特効薬
モノレポ化が進みすぎた現代の救世主。全ファイルをダウンロードせず、必要なディレクトリだけをツリーに展開する。
設定例：特定のディレクトリのみチェックアウト
git sparse-checkout init –cone
git sparse-checkout set “apps/web-frontend” “libs/shared-components”
—
3. 生産性を加速させる「神・設定」とハック
チーム開発の「設定共有化」ルール
個人の設定に依存させるな。`.gitconfig` をインクルードする仕組みを使え。
.gitconfig
[include]
path = .gitconfig.shared # チーム共通の設定をリポジトリ内に配置
必須の神プラグイン & ツール
1. [delta](https://github.com/dandavison/delta): `git diff` を人間が読めるレベルに引き上げる。これ無しでのコードレビューは時間の無駄だ。
2. [Git-extras](https://github.com/tj/git-extras): `git effort` を使え。どのファイルが最も頻繁に変更されているか一目でわかる。リファクタリング対象の発見に直結する。
隠れたキーボードショートカット（VS Code）
VS Codeの「Git Graph」を入れ、ショートカットを覚えるだけでコミット履歴の可視化と修正が爆速になる。
- `Ctrl + Shift + G`: Gitパネルへ瞬時にフォーカス
- `Ctrl + Enter`: コミットメッセージ入力中の即時コミット
—
4. プロの提言：リポジトリ肥大化への最終回答
結局のところ、ツールは「運用のルール」がなければただのガラクタだ。
1. CI/CDの最適化: `git clone –depth 1` は基本中の基本。LFSを使う場合は `GIT_LFS_SKIP_SMUDGE=1` をCI環境で設定し、必要なときだけバイナリをプルせよ。
2. プルーニングの自動化: 週に一度は `git gc –prune=now` を実行するフックをチームに推奨せよ。
リポジトリは「資産」である。だが、管理を怠ればそれは「ゴミ捨て場」になる。
「必要なものを、必要なときに、必要な分だけ」。この原則を徹底できれば、あなたのリポジトリは世界で最も洗練されたコードベースへと進化するはずだ。
さあ、今すぐ `git rev-list` を叩き、あなたのリポジトリの真実と向き合ってほしい。健闘を祈る。