Configuring Agentic AI Coding Tools: An Exploratory Study
本論文は、2,923 の GitHub リポジトリを対象とした実証研究を通じて、Claude Code や GitHub Copilot などのアジェンティック AI コーディングツールの設定メカニズムを分析し、`AGENTS.md` ファイルが支配的な標準となっている一方で、高度な機能の採用は限定的であり、ツールごとに異なる設定文化が形成されていることを明らかにしたものである。
原論文は CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/) でライセンスされています。 これは以下の論文のAI生成解説です。著者が執筆または承認したものではありません。技術的な正確性については原論文を参照してください。 免責事項の全文を読む
この論文は、**「AI プログラミング助手（エージェント）をどうやって『自分好みにカスタマイズ』しているか」**という、とても面白い調査結果を報告したものです。
想像してみてください。あなたは新しい**「天才的なアシスタント」を雇いました。彼はプログラミングが得意ですが、あなたの会社のルールや、プロジェクトの特殊な事情をまだ知りません。
そこで、あなたは彼に「マニュアル（設定ファイル）」**を書いて渡します。これがこの論文で扱っている「設定」の正体です。
研究者たちは、世界中の 2,900 以上のプロジェクトを調査して、以下の 3 つの大きな発見をしました。
1. みんな「共通の辞書」を使っている（AGENTS.md の台頭）
以前は、使う AI 助手ごとに「マニュアルの書き方」がバラバラでした。
- Claude という助手なら「CLAUDE.md」という名前のファイル。
- Copilot なら「.github/copilot-instructions.md」という名前。
- Cursor なら「.cursorrules」という名前。
まるで、**「アメリカ人なら英語、フランス人ならフランス語」**のように、使うツールによって言語（ファイル形式）を変えていたのです。
しかし、調査の結果、**「AGENTS.md」という新しい共通のファイル形式が、まるで「国際共通語（エスペラント語）」のように広がりつつあることがわかりました。
多くの開発者が、特定の AI 助手に依存せず、まずはこの「AGENTS.md」から書き始めています。これは、「どの助手が来ても読める、共通の取扱説明書」**として定着しつつあるのです。
2. 「本格的なマニュアル」はほとんど使われていない（浅い設定）
AI 助手には、単なる「メモ（Context Files）」だけでなく、もっと高度な機能があります。
- スキル（Skills）： 特定のタスクを自動化する「魔法のレシピ」や「実行可能なスクリプト」。
- サブエージェント（Subagents）： 特定の専門分野（例えば「セキュリティチェック」だけ担当する）の**「専門家の部下」**を雇う機能。
これらは、AI を単なる「会話相手」から「自律的な労働者」に進化させる強力な機能です。
しかし、調査結果は**「悲しいほどシンプル」**でした。
- 多くのプロジェクトでは、これらの高度な機能は**「使われていない」か、「名前だけ登録して中身は空っぽ」**の状態です。
- 「スキル」を使っている場合でも、それは「実行可能なプログラム」ではなく、**「ただのテキストのメモ書き」**として使われていることがほとんどでした。
【アナロジー】
これは、「高級な料理屋（AI）に、プロのシェフ（スキル）を雇う権利を与えたのに、実際には『塩を振ってください』というメモ（テキスト）だけ渡して、シェフには何もさせていない」ような状態です。
開発者たちは、複雑な設定をするのが面倒だから、あるいはどうやって使うかわからないから、「一番簡単なメモ書き（Context Files）」だけで済ませているのです。
3. ツールごとに「文化」が違う
使う AI 助手によって、設定の「雰囲気」が全く違うこともわかりました。
- Claude Code ユーザー： 最も多様な機能を使いこなそうとする「冒険家」たち。
- Cursor ユーザー： 「ルール（Rules）」を重視し、厳格な指示を出すことを好む「管理職」タイプ。
- Copilot ユーザー： 基本的なメモ書きだけで満足する「シンプル志向」タイプ。
まるで**「異なる国（ツール）に住んでいると、生活習慣（設定の仕方）も自然と変わってくる」**ような現象が起きています。
まとめ：何が重要なのか？
この研究は、AI プログラミング助手の未来について、以下のような示唆を与えています。
- まずは「AGENTS.md」から始めよう：
特定の AI に縛られず、誰でも読める共通のファイル形式が標準になりつつあります。これから設定するなら、これが一番の入り口です。 - もっと「本気」の設定ができるはず：
今のところは「メモ書き」レベルの設定が主流ですが、AI はもっと複雑な作業（コードを実行したり、専門家の部下を使ったり）ができるはずです。開発者がもっとそのポテンシャルに気づけば、AI はもっと劇的に進化できるかもしれません。 - ツールごとの「文化」に注意：
使う AI によって、設定の仕方や考え方が違うため、チームで使う場合は「誰がどのツールを使っているか」を統一したり、共通のルールを作る必要があります。
一言で言えば：
「AI 助手はすでに手元にありますが、私たちはまだ『メモ書き』でしか指示を出していません。本当の力を引き出すには、もっと本格的な『マニュアル』や『部下』の使い方を学ぶ必要がありますよ」という、開発者への優しいメッセージです。
自分の分野の論文に埋もれていませんか？
研究キーワードに一致する最新の論文のダイジェストを毎日受け取りましょう——技術要約付き、あなたの言語で。