テック技報最新号へ →
AIコーディング

複数リポジトリをまたぐ作業は「ホームリポジトリ」1つでエージェントを動かす

スキル・指示ファイル・Wiki を置いた「ホーム」リポジトリでエージェントを起動し、作業対象のリポジトリはその中にクローンして .gitignore する。AGENTS.md には各リポジトリへの道案内だけを書く。

@mattpocockuk · 投稿 2026-11-10
#ai-coding#agents-md#マルチリポジトリ#スキル#ワークフロー

どんなときに使うか

  • サービスが複数のリポジトリに分かれていて、1つの機能追加で2〜3個のリポジトリを同時に変える
  • 各リポジトリに同じスキルや設定（例: mattpocock/skills のセットアップ）をコピーして保守するのが大変になっている
  • 質問攻め（grill）や計画を立てるとき、エージェントに全体像を見せたい

やり方

  1. ホーム用のリポジトリを1つ作り、スキル・ステアリング用のファイル・Wiki・複数リポジトリにまたがる issue をここに置く
  2. 作業対象のリポジトリは、ホームの中に普通に git clone し、ホームの .gitignore に入れる（特別な仕組みは使わない）
  3. エージェントはホームのルートで起動する。AGENTS.md には「どのリポジトリが何をしているか・どこにあるか」という道案内を書く
  4. ビルドコマンドなどリポジトリ固有の情報は、それぞれのリポジトリの中（各リポジトリの AGENTS.md など）に置き、ホームには道案内だけを置く。ホームが肥大化しない
  5. 同じリポジトリで並行作業するときは、各クローンの中で worktree を切る。使い終わった worktree は自分で消す（放っておくとディスクが埋まる）
  6. チームで使うなら、ホームリポジトリはチームのものにし、全員がそこでエージェントを動かす

注意点

  • エージェント1つが全リポジトリを触れる構成になる。作者は「個別のエージェントがそれぞれ一部を触るのと比べて特に危なくはない」という立場だが、鍵や権限の範囲は自分で確認する
  • 投稿の画像にはユーザーの声として「38リポジトリでもうまくいった。docs を grill と writing-for-agents で必要最小限に削ったのが効いた」という報告がある（作者本人の計測ではない）
  • 本当のモノレポなら、この形でなくてもよい（作者は「それも良いが、道具立てが多く要る」と返信）

関連

出典

X の元の投稿を開く