Virtual monorepo のすゝめ——コーディングエージェントのために分散リポジトリを束ねる

概要

複数の Git リポジトリに分かれたプロダクトを、モノリポ化せずにコーディングエージェントに横断的なコンテキストを与える「Virtual monorepo」パターンを紹介するブログ記事。シンプルな仕組みで効果が高いとして注目されている。

Virtual monorepo は、既存のGitリポジトリを clone して1つのディレクトリに並べるだけの構成。各サブディレクトリは独自の .git を持ち続ける
セットアップスクリプト（setup.sh）でサブリポジトリを clone し、CLAUDE.md でリポジトリ間の関係・アーキテクチャを説明する
完全なモノリポ化の課題（Git履歴断絶・エージェント調査範囲の拡大による性能劣化）を回避しつつ、エージェントに複数リポジトリの文脈を与えられる
architecture/ フォルダにシステム全体のアーキテクチャ説明を置き、エージェントが参照できるようにする