概要
コーディングエージェントが複数リポジトリの文脈を理解しやすくするため、実リポジトリを統合せずにローカルで擬似的なモノリポを構成する手法を解説した記事です。
詳細内容
Claude Code などのコーディングエージェントを活用する際、プロダクトが複数の Git リポジトリに分かれていると、リポジトリを跨いだ文脈の把握が困難になるという課題があります。本記事では、この問題を解決する「Virtual monorepo」パターンを紹介しています。この手法は、実際のリポジトリを物理的に統合（モノリポ化）することなく、ローカル環境で複数のリポジトリをサブディレクトリとしてクローンし、`AGENTS.md` や `CLAUDE.md` を使ってシステム全体の依存関係をエージェントに明示するものです。記事内では、GitHub CLI を用いたセットアップスクリプトの例や、エージェントに構造を伝えるためのドキュメントの書き方、`.gitignore` による管理方法が具体的に示されています。これにより、AI によるコード生成やリファクタリングの精度を、最小限の手間で向上させることが可能になります。