「兄弟リポジトリ参照」でモノレポ化せずにAIコーディングエージェントの文脈を拡張する — Kenn Ejimaの実践テクニック

AIコーディングエージェントの大きな制約の一つが「今開いているリポジトリしか見えない」ことだ。フロントエンドとバックエンド、共通ライブラリと本体アプリ——別リポジトリに分かれたコードの関連性をエージェントが理解できず、的外れな提案をされた経験がある開発者は多いだろう。

この問題に対するシンプルかつ強力な解決策を、Gista創設者の Kenn Ejima（@kenn） がXで共有し、480いいね・676ブックマークと大きな反響を呼んでいる。

テクニックの核心

Kennが紹介したのは、たった2つの要素で構成されるシンプルな手法だ。

1. 兄弟リポジトリを相対パスで参照するSKILLを作る

../other-repo

Claude CodeのCLAUDE.mdやCursorの.cursorrules等に、兄弟ディレクトリのパスを参照先として記述する。これだけでエージェントに「もう一つのリポジトリがそこにある」と認識させられる。

2. ripgrepでファイル一覧を取得させる

rg --files ../other-repo

rg --filesは指定ディレクトリ内のファイルパスを高速にリストアップするコマンドだ。.gitignore等を尊重するため、余計なファイルが混ざらない。エージェントにこのコマンドの実行を許可することで、兄弟リポジトリの構造を把握させ、必要なファイルを読み込ませることができる。

Kennはこう要約している。

こちら側のリポジトリのナレッジを使って、あちら側のリポジトリの作業を行う。これでモノレポにできない事情があっても、まるでモノレポであるかのように扱える

なぜこのテクニックが効くのか

ポイントは 「エージェントのコンテキストウィンドウを、設定ファイル1行で物理的なリポジトリ境界を超えて拡張する」 ことにある。

手法	メリット	デメリット
モノレポ化	全コードが1箇所	移行コスト大、CI/CD再構築、チーム合意が必要
git submodules	commit SHA追跡可能	管理が複雑、更新忘れのリスク
兄弟リポジトリ参照	設定1行、即座に導入可能	ローカル環境前提、パス固定

個人開発者や小規模チームにとって、モノレポ化は「やりたいけど今じゃない」ケースが多い。このテクニックなら、リポジトリ構造を一切変えずに、AIエージェントだけに「横断的な視界」を与えられる。

広がる「Virtual Monorepo」パターン

実はこの手法は、2026年に入って急速に注目を集めている「Virtual Monorepo」パターンの一つだ。

• Spine Pattern: 複数リポジトリにまたがるCLAUDE.mdを配置し、エージェントにクロスリポジトリのタスクファイルを渡す手法（Titus Soporan）
• refs/サブモジュール方式: 参照用フォルダにgit submoduleとして他リポジトリを導入し、コンテキストとして読み取らせる方式（Reddit r/ClaudeAI）
• Virtual Monorepo Pattern: 35リポジトリにまたがるフルシステムコンテキストをClaude Codeに与える手法（Owen Zanzal, Medium）

Kennのアプローチは、これらの中でも最もミニマルで導入障壁が低い。

実践ガイド：今すぐ試す3ステップ

Step 1: ディレクトリ構成を確認

兄弟リポジトリが同じ親ディレクトリにcloneされていることを確認する。

~/Dev/
  ├── my-frontend/    ← 作業中のリポ
  └── my-backend/     ← 参照したいリポ

Step 2: SKILLファイル（設定ファイル）に参照を追加

Claude Codeなら CLAUDE.md、Cursorなら .cursorrules に以下を記述する。

## 兄弟リポジトリ参照

バックエンドのAPIスキーマとデータモデルは ../my-backend を参照してください。
ファイル一覧の取得には `rg --files ../my-backend` を使ってください。

Step 3: エージェントに作業を依頼

あとは通常通りエージェントに依頼するだけだ。エージェントは必要に応じて兄弟リポジトリのファイルを読み、こちらのリポジトリでの作業に活かしてくれる。

注意点

• ローカル環境前提: CI/CDやリモート環境では兄弟リポジトリが存在しないため、ローカル開発でのAI活用に限定される
• パスの固定: チームで共有する場合、ディレクトリ構成の統一が必要
• 大規模リポジトリ: rg --files の出力が膨大な場合、--globでフィルタリングを併用するとよい

Kenn Ejimaについて

Kenn Ejimaは、Gistaの創設者であり、AIコーディングツールの実践的な活用法を発信し続けている開発者だ。元Quora Japan責任者。フォロワー約3.9万人のXアカウントで、AIを活用した開発ワークフローの知見を頻繁にシェアしている。

---

ソース: Kenn Ejima (@kenn) on X（2026年4月1日）

---