Home Repoパターンとは〜複数リポジトリでAIエージェントを動かす共通の拠点〜
AI エージェント 開発手法
Matt PocockがAI Heroで公開したHome Repoパターンを解説します。共有スキルとAGENTS.mdを1つのリポジトリに集め、そこから他リポジトリを指すことで、マルチリポジトリ環境でもエージェントを一貫して動かせる考え方を整理します
:::message 本記事は 2026年11月16日(JST)時点 の情報です。解説の対象は、Matt PocockがAI Heroで公開した「The Home Repo Pattern」(公開 2026-11-12 19:30 JST / 10:30 UTC)です。コーディングエージェントの仕様は変わりうるため、正確な情報は末尾の一次情報で確認してください。公式がタイムゾーンを書いた時刻は、日本時間(JST = UTC+9)と UTC を併記します。 :::
概要
複数のGitリポジトリにまたがる仕事をコーディングエージェントに任せようとすると、すぐに行き詰まります。エージェントは起動したリポジトリを作業の起点にします。別のリポジトリにアクセスできるか、そこの指示ファイルを自動で読むかは、ツールや設定によって異なります。スキルや指示ファイルを各リポジトリへコピーすると、やがて内容がずれ、リポジトリをまたぐ計画も全体像がないまま進みがちです。
Matt Pocockが2026年11月12日(19:30 JST / 10:30 UTC)にAI Heroで公開した Home Repoパターン は、この問題への答えです。共有するスキル、セッション開始時に読む指示ファイル(この解説では主に AGENTS.md)、コーディング規約のような共通ドキュメントを、1つのリポジトリ(Home Repo)に置きます。エージェントはそのHome Repoで起動し、AGENTS.md に書かれた短い「ポインタ」を手がかりに、ほかのリポジトリを開いたり、なければクローンしたりします。
コードそのものは各リポジトリに残します。履歴、リモート、Issueトラッカーもそのままです。Home Repoはモノレポの代替というより、「モノレポにできないときに、エージェントの共通拠点をつくる」ためのパターンです。
背景:なぜ必要か
コーディングエージェントは、起動したディレクトリを起点に動きます。店頭アプリ、決済API、管理画面、ときおり触る社内ツール、とリポジトリが分かれている組織では、1つの機能が複数リポジトリにまたがることが普通です。たとえば店頭アプリで起動し、決済APIのリポジトリを参照しなければ、API側の制約を把握しづらくなります。
よくある対処は2つあります。1つは、同じスキルと設定を各リポジトリへコピーすることです。一時的には動きますが、リポジトリが増えるほど同期が大変になります。Pocockの用語集でも、コピー同士がずれていくこと自体が、このパターンを使う理由の一つだと書かれています。
もう1つは、ユーザーのホームディレクトリ(たとえば ~/.claude/skills)に置くことです。どのリポジトリからでも見えますが、記事はこれを「理想に至るまでのつなぎ」と位置づけています。Home Repoはプロジェクトなので、スキルをGitで版管理でき、チームで共有できる、というのが記事の対比です。
Home Repoは、その両方を避ける第3の置き場です。記事が挙げる利点は、
- 指示ファイルとツール一式を一か所にまとめられる
- エージェントをいつも同じ場所から起動できる
- 複数リポジトリへの横断的な変更を1つのセッションで進められる
の3点です。理想として記事が書いているのは、「みんな同じスキルを使い、それをプロジェクトの中で管理する」ことです。

パターンの中身
何をHome Repoに置き、何を各リポジトリに残すか
記事と、同じ著者の用語集が示す切り分けは次のとおりです。
| Home Repoに置くもの | 各リポジトリに残すもの |
|---|---|
| 複数リポジトリで使うスキル | そのリポジトリのコード |
ほかのリポジトリへのポインタを含む AGENTS.md |
そのリポジトリ固有の AGENTS.md、ビルドやテストのコマンド |
| コーディング規約、用語集、システム全体に効く判断といった共有ドキュメント | そのリポジトリだけのドキュメント |
| 必要なら、エージェントを外部サービスにつなぐCLIなどのツール一式 | (履歴、リモート、Issueトラッカーも各リポジトリのまま) |
記事は、最初に共有する価値があるドキュメントとしてコーディング規約を挙げ、Markdownの小さなwikiやツール類を置いてもよい、とも書かれています。
スキルについては、元記事は「SKILL.md を持つフォルダ」として扱っています。Agent Skillsの公開仕様でも、スキルは少なくとも SKILL.md を含むディレクトリです。Home Repoへ移すときは、このフォルダ単位を崩しません。公開スキルリポジトリやマーケットプレイスから入れたものは、移さず、入れた場所に置いたままにします。
ナビゲーションポインタ
Home Repoの中心は、AGENTS.md の「Other Repos」に並べるポインタです。1リポジトリにつき1行で、名前、それが何か、ローカルのパス、なければクローンする先を書きます。必要なときだけ、短いヒントを添えます。記事の例を、形だけ借りると次のようなものです。
## Other Repos
Storefront (Next.js app): ~/repos/acme/storefront. Clone from git@github.com:acme/storefront.git if missing.
Payments API: ~/repos/acme/payments-api. Read its AGENTS.md before changing it.
すでにそのパスへクローンしてあれば、エージェントはそこを使います。なければ、その場所へクローンします。Home Repoの中へクローンして .gitignore する構成もある、と記事は書いています。git submodule について記事は、リポジトリが5〜10個ならsubmodule風の構成でもよいとしつつ、同じ役割は素のポインタでも果たせるとしています。
セッションはHome Repoから始める
作業の起点は、個別のリポジトリではなくHome Repoです。リポジトリをまたぐ機能の洗い出し(記事の言葉では grilling)も、ここで行います。複数のエージェントが同じリポジトリを同時に触る場合は、各リポジトリを1回だけクローンし、機能ごとにそのクローンの中へ git worktree を切る、と書かれています。Issueは各リポジトリのトラッカーをまとめて把握でき、起票先は「収まりのよいリポジトリ」でよい、とされています。チームで使うなら、共有するのはこのHome Repoであり、各自のエージェントもそこで起動します。
AGENTS.md と CLAUDE.md
このパターンの解説は AGENTS.md を標準の名前にしています。ただし本質はファイル名ではなく、「使っているハーネスがセッション開始時に読むファイルへ、ポインタを書く」ことです。AGENTS.md はエージェント向けの説明を置く公開の置き場で、公式サイト(agents.md)によれば必須の項目やスキーマはありません。Cursorの公式ドキュメントも、プロジェクトルート(およびサブディレクトリ)の AGENTS.md を、.cursor/rules の簡潔な代替として読むと説明しています。
Home Repoの記事は「Claude Codeは CLAUDE.md を読む」と書いており、ハーネスが別のファイルを読む場合は、そのファイルを AGENTS.md への1行のポインタにする、としています。Claude Codeの公式ドキュメントも、プロジェクト指示として CLAUDE.md(または ./.claude/CLAUDE.md)を読む、と説明しています。Claude Code v2.1.277 以降では、対応するセッションの既定設定で、作業ディレクトリやその上位にプロジェクトの CLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.md のいずれもなければ AGENTS.md を直接読みます。組み込みプラグインを無効にしたセッションでは、この直接読み込みは使えません。Pocockが2026年1月に公開したAGENTS.md解説の「Claude Codeは AGENTS.md を使わない」は、当時の説明であり、2026年11月時点の公式ドキュメントとは一部ずれています。実際に何を読むかは、自分の環境で確認するのが安全です。
規模と、モノレポとの関係
記事が目安として書いている規模感は、次のとおりです。
- おおよそ20リポジトリまで なら、1リポジトリ1ポインタで足りる
- おおよそ400リポジトリ になると、フラットなポインタだけではエージェントの判断が追いつかない。事業領域ごとのファイルに分け、
AGENTS.mdからはそのファイルを指す(progressive disclosure) - 数千リポジトリ 規模では、スキルの利用者が多くなりすぎるため、スキルのマーケットプレイスの方が向く
ただし、記事のセットアッププロンプトは、約20リポジトリを超えた時点でポインタを領域ごとのファイルにまとめるよう指示しています。FAQの「約400」はフラットな一覧の限界の目安です。プロンプトで構成をつくる場合は、20を超えたあたりから分割案が出ると考えておくとよいでしょう。

モノレポにできるなら、記事はモノレポを推します。Home Repoが代替になるのは、公開リポジトリと非公開リポジトリが混ざる、あるいはチームがモノレポを採用しない、といった「モノレポにできない」場合です。
セットアップの進め方
記事は、リポジトリが並んでいるフォルダで新しいセッションを開き、掲載のプロンプトを貼る手順を勧めています。プロンプトは、判断が必要な点だけをラウンド形式で尋ね、計画の承認までは読み取りに限るよう指示します。プロンプト本文は元記事を見てください。流れは次の4ステップです。

- リポジトリの棚卸し。 ホームディレクトリ以下のGitリポジトリを探し(依存関係のフォルダは除く)、パス、リモート、公開/非公開、最終コミット日を記録する。どのリポジトリを指すか(推奨は最近コミットがあるもの)、Home Repoの場所(推奨はほかのリポジトリのそばに置く新しい非公開リポジトリ)、個人かチームか、セッション開始時に読むファイルは何か、を決める。
- 共有物の棚卸し。 対象リポジトリとユーザーレベルのスキルフォルダ(例:
~/.claude/skills)から、スキル、AGENTS.md/CLAUDE.md、エージェント向けドキュメントを集め、共有・重複・リポジトリ固有・インストール済み、のいずれかに分類する。重複は差分を取り、新しい方を残す。 - 計画の合意。 各項目の移動先を表にし、Home Repoの
AGENTS.md案を出す。承認するまで適用しない。 - 適用。 Home Repoと
AGENTS.mdを作り、共有物をコピーする。各子リポジトリでは新しいローカルブランチを切り、移したコピーだけを消す。Home Repoへコミットする。pushするかどうかは利用者の判断です。
プロンプトは、.env などの秘密ファイルは読まない、とも指示しています。CLIは最初から不要です。CIや、記事が software factory と呼ぶ自動化環境では、サンドボックスにHome Repoを置き、必要に応じてほかのリポジトリをクローンします。
メリットと注意点
メリットは、スキルと指示の「正」が1か所になりコピーのずれを減らせること、起動場所が固定されてリポジトリ横断の計画と変更がしやすいこと、Gitでチーム共有できること、モノレポにできない事情(公開/非公開の混在など)でも導入できること、です。仕組みは小さく、まずはポインタ付きの AGENTS.md だけで始められます。
一方で、次の点には注意が要ります。
- ポインタは、自動で全部をつなぐ魔法ではない。 エージェントが、書かれたパスへ届くこと、必要ならクローンできることが前提です。ハーネスや権限の違いで、動きは変わります。
- ポインタを増やしすぎると、かえって判断を鈍らせる。 記事自身が、おおよそ400リポジトリではフラットな一覧は多すぎると書いています。
- 子リポジトリからの削除は、慎重に行う。 手順は、新しいローカルブランチでコピーを消す、としています。ブランチとレビューの単位は、リポジトリごとに残ります。
- チームで共有するなら、ローカルパスの約束が要る。 記事の例は
~/repos/...です。ホームディレクトリの位置やOSが違うと、同じポインタでは届きません。パスかクローン先の決め方を揃えておく必要があります。これは元記事が詳しく書いていない実務上の論点です。 AGENTS.mdを肥大させない。 同じ著者のAGENTS.md解説は、このファイルがほぼ毎回のリクエストで読み込まれること、古いパスや矛盾した指示が判断を壊すことを理由に、小さく保ち、詳細は別ファイルやスキルへ任せるべきだと書いています。
用語集は、同じ考え方の古い呼び方として "agent repo" や "meta-repo" は避ける、とも注記しています。
実践するときのヒント
導入時に押さえておきたいのは、次の点です。
- 承認までファイルを動かさない。 プロンプトは、Step 3 で計画を承認するまで読み取りに限るよう指示します。実際の書き込み権限はツールの設定で決まります。対象リポジトリ、Home Repoの場所、個人かチームか、読む指示ファイルを先に決め、
.envなどの秘密情報は今の場所に残します。 - セッションはいつもHome Repoから始める。 Home Repoから起動すると、共有の指示とポインタを起点にできます。子リポジトリ固有の注意はそちら側の
AGENTS.mdに残し、ポインタで先に読むよう指示します。たとえばClaude Codeでは、--add-dirで作業先を追加できますが、追加先のAGENTS.mdは自動では読み込まれません。 - ハーネスが読むファイルを実際に確認する。 Cursorは
AGENTS.mdを読みます。Claude Codeは、前述の読み込み条件を満たすセッションでAGENTS.mdを直接読みます。本体はAGENTS.mdに集約し、CLAUDE.mdも置く場合は、文章で「AGENTS.md を読め」と書くのではなく@AGENTS.mdで取り込むと確実です。公式ドキュメントも、文章で指示するだけでは、ファイルを開くかどうかがClaudeの判断に任されると書いています。 - モノレポで足りるなら、無理に導入しない。 記事自身が、モノレポにできるならそれがよい、と書いています。
まとめ
Home Repoパターンは、マルチリポジトリ環境でコーディングエージェントを使うときの「共通の拠点」をつくる方法です。共有スキルと指示ファイル、チームで揃えたいドキュメントを1つのリポジトリに集め、そこからほかのリポジトリへ短いポインタを張ります。コードは各リポジトリに残したまま、エージェントの起動場所だけを一つにします。
仕組みは小さく、最初に必要なのはポインタ付きの AGENTS.md と、共有したいスキルや規約です。規模が大きくなったらポインタを領域別に分け、モノレポにできるならモノレポを選ぶ。スキルのコピーや指示ファイルのずれに苦労しているなら、まず元記事のセットアッププロンプトで棚卸しだけでも試す価値があります。元のプロンプトは、計画を承認するまでは読み取りだけを行うよう指示しています。
出典
- The Home Repo Pattern(Matt Pocock / AI Hero、2026-11-12 19:30 JST / 10:30 UTC)
- Home Repo(dictionary-of-ai-coding)
- A Complete Guide To AGENTS.md(Matt Pocock / AI Hero、2026-01-18 15:01 UTC / 2026-01-19 00:01 JST)
- AGENTS.md(公式サイト)
- How Claude remembers your project(Claude Code 公式、CLAUDE.md / AGENTS.md)
- Rules(Cursor 公式、AGENTS.md の説明を含む)
- Agent Skills Overview
- Agent Skills Specification