Claude Codeは、
- ファイルを読み
- 文脈を理解し
- 実装を進める
エージェントとして動くため、
どの文脈を持っているかが、そのまま出力の品質に直結します。
この前提を踏まえて、自分がこれからAIにツール開発を任せていくことを考えたときに、ひとつの方向性が見えてきました。
それは、
関連するすべての機能を、同じ環境で管理したい
ということです。
フロントエンド、API、バッチ、共通ロジックといった要素を分散させるのではなく、
ひとつのリポジトリの中でまとめて扱うことで、
- 依存関係を明確にする
- 変更の影響範囲を把握しやすくする
といった、モノレポとしての基本的なメリットがあります。
さらに重要なのは、
モノレポとして構造を整理し、その上でコンテキストの指示を適切に管理できれば、
AIにとって理解しやすい状態を作れるのではないか
と考えた点です。
単にコードをまとめるのではなく、
AIがどの文脈で判断するかを、構造として制御する
という発想です。
今回は、モノレポの基本から整理しながら、
なぜバイブコーディングと相性が良いのかを整理していきます。
モノレポとは何か
モノレポとは、
複数のプロジェクトやコンポーネントを、1つのリポジトリで管理する構成
のことです。
例えば、
- フロントエンド（web）
- バックエンド（api）
- 共通ライブラリ（shared）
- インフラ設定（infra）
といった異なる役割のコードを、1つのリポジトリにまとめて管理します。
モノレポの一般的なメリット
モノレポはもともと、人間の開発効率を上げるための構造として使われてきました。
主なメリットは以下の通りです。
- 依存関係を明確にできる
- 変更の影響範囲を把握しやすい
- 共通コードを再利用しやすい
複数のプロジェクトが分散していると、依存関係が見えづらくなり、変更の影響範囲も追いにくくなります。
その点、モノレポではすべてが1箇所にまとまるため、全体の構造を把握しやすくなります。
AIコーディングにおけるモノレポのメリット
ここからが、今回の記事の本題です。
モノレポはもともと人間のための設計ですが、AIコーディングの観点で見ると、別の価値が見えてきます。
- 参照するコードの範囲を制御しやすい
- 文脈をディレクトリ単位で分離できる
- AIに「どこを見ればいいか」を明示しやすい
Claude Codeのようなツールでは、
- どのコードを読むか
- どの実装を参考にするか
- どのルールに従うか
といった「文脈」が非常に重要になります。
モノレポはディレクトリ構造によって文脈を分離できるため、
AIにとっても理解しやすい環境を作ることができます。
なぜバイブコーディングと相性が良いのか
バイブコーディングは、
- やりたいことを言語化する
- AIに仕様として渡す
- 実装させる
- 修正する
というループで進みます。
このとき重要なのは、
どの文脈で実装させるか
です。
モノレポでは、
/apps/web/packages/api/packages/shared
のように、ディレクトリ単位で役割が分かれています。
そのため、
- 「このディレクトリを見て」
- 「この実装を参考にして」
- 「このルールで書いて」
といった指示がしやすくなります。
つまり、モノレポの構造そのものが、
AIに対するコンテキストの指定手段になる
ということです。
モノレポの注意点
ここは重要なポイントです。
モノレポは便利な一方で、構造が整理されていないと逆効果になります。
例えば、
- 似ている実装が複数存在する
- パッケージごとにルールが違う
- テスト方法やコマンドが統一されていない
この状態でAIに任せると、
- 間違った実装を参照する
- ルールを混同する
- 想定外のコードを生成する
といった問題が起きます。
モノレポは「広い」構造なので、
整理されていないとAIにとっては難しい環境になります。
モノレポをAI向けに使うためのポイント
モノレポとバイブコーディングをうまく組み合わせるためには、いくつかのポイントがあります。
文脈を明示する
- どのディレクトリを見るか
- どの実装を参考にするか
を明確にすることで、ズレを防ぎます。
探索範囲を制限する
- 「全体を見て」ではなく
- 「packages/apiだけ見る」
のように範囲を絞ることで、精度が上がります。
ルールを固定する
- コードスタイル
- テスト方法
- 実行コマンド
などを統一し、AIが迷わないようにします。
まとめ
モノレポは、単なるコード管理の手法ではなく、
AIにとっての「文脈を整理するための構造」
として捉えることができます。
もともとは人間のための設計ですが、AIコーディングの文脈では、
- 文脈の分離
- 参照範囲の制御
- 指示の明確化
といった形で、より大きな価値を持つようになります。
バイブコーディングとの関係を一言でまとめると、
モノレポは、AIの思考を整理するための基盤になる
と考えています。
