AIエージェントと設定ファイルの関係が、わからなくなることがあります。
そこで、自分向けにまとめました。
あくまで自分に向けたメモです。対応関係が間違ってたらごめんなさい。
| 大分類 | 中分類 | 詳細説明 | ファイル | 概要 | Copilot (汎用) | GitHub Copilot | Claude | Gemini | Google AI Studio | OpenAI |
|---|---|---|---|---|---|---|---|---|---|---|
| 共通 | 基本 | プロジェクトの顔 | README.md | プロジェクトの全体像と基本説明 | △ | △ | △２ | △２ | △２ | △２ |
| 共通 | 指示・制約 | AIの振る舞い（憲法） | AI.md | すべてのAIが守るべき共通の「憲法」 | △ | △ | △２ | △２ | △２ | △２ |
| 共通 | 指示・制約 | AIの役割定義 | SKILL.md | AIに期待する専門能力の定義 | △ | △ | △２ | △２ | △２ | △２ |
| 共通 | 指示・制約 | コーディング規約 | RULES.md | コードの書き方や禁止事項を定義 | △ | △ | △２ | △２ | △２ | △２ |
| 共通 | 指示・制約 | 用語集 | VOCABULARY.md | 専門用語や命名規則の固有名詞定義 | △ | △ | △２ | △２ | △２ | △２ |
| 共通 | 指示・制約 | セキュリティ方針 | SECURITY.md | 脆弱性報告手順と禁止コードパターン | △ | △ | △２ | △２ | △２ | △２ |
| 共通 | 実行・管理 | 現在のタスク仕様 | SPEC.md | 仕様書。AIに「何を作るか」を教える | 〇 | 〇 | △２ | △２ | △２ | △２ |
| 共通 | 実行・管理 | タスク進捗管理 | TASKS.md / TODO.md | AIに「次に何をすべきか」を判断させる | 〇 | 〇 | △２ | △２ | △２ | △２ |
| 共通 | ナレッジ | プロジェクトの地図 | STRUCTURE.md | ディレクトリ構造の解説と役割一覧 | △ | △ | △２ | △２ | △２ | △２ |
| 共通 | ナレッジ | 背景と経緯 | CONTEXT.md | 歴史や技術選定の意図 | △ | △ | △２ | △２ | △２ | △２ |
| 共通 | ナレッジ | 詳細ドキュメント | docs/ | 長期記憶用の詳細ドキュメント一式 | △ | △１ | △２ | △２ | △２ | △２ |
| 共通 | 環境設定 | 無視設定 | .gitignore | AIのスキャン対象から除外する設定 | ✕ | ✕ | ✕ | ✕ | ✕ | △３ |
| 共通 | 環境設定 | 依存関係 | package.json / reqs.txt | 使用技術・ライブラリの定義 | 〇 | 〇 | △２ | △２ | △２ | △２ |
| 共通 | 環境設定 | 技術選定理由 | DEPENDENCIES.md | 採用ライブラリの選定理由と代替案 | △ | △ | △２ | △２ | △２ | △２ |
| 共通 | 環境設定 | エディタ設定 | .vscode/settings.json | エディタとAI拡張機能の制御 | △ | △ | ✕ | ✕ | ✕ | ✕ |
| 個別 | エージェント | 権限管理 | AGENTS.md | 自律型エージェントの動作権限定義 | △ | △ | △２ | △２ | △２ | △２ |
| 個別 | GitHub専用 | 直接指示 | .github/copilot-instructions.md | GitHub Copilot専用の指示書 | ✕ | 〇 | ✕ | ✕ | ✕ | ✕ |
| 個別 | GitHub専用 | 定型文 | .github/PROMPTS.md | Copilot用の再利用可能なプロンプト集 | ✕ | 〇 | ✕ | ✕ | ✕ | ✕ |
| 個別 | GitHub専用 | 除外設定 | .copilotignore | Copilot専用のインデックス除外設定 | ✕ | 〇 | ✕ | ✕ | ✕ | ✕ |
| 個別 | GitHub専用 | 整形規則 | .editorconfig | エディタ全般およびCopilotが参照 | △ | △ | △４ | △４ | △４ | △４ |
| 個別 | Claude専用 | プロジェクトルール | CLAUDE.md | Cursor等のClaude統合環境用ルール | ✕ | ✕ | △５ | ✕ | ✕ | ✕ |
| 個別 | Gemini専用 | 長大文脈用 | GEMINI.md | Gemini統合ツール向けコンテキスト | ✕ | ✕ | ✕ | △５ | △５ | ✕ |
〇 ：
高確率で自動参照・強く影響
△ ：
参照される可能性あり（条件依存）
✕ ：
ほぼ参照されない
△１：
ローカルインデックス（VS Code標準）は最大2500ファイルに制限されている。GitHub Copilot は リポジトリ全体を参照する。ただし、階層が深すぎたり、ファイル数が多すぎると、インデックスから漏れる可能性がある。
△２：
Claude、Gemini、OpenAIのWeb版チャットUIは、「今開いているタブ」のみ自動参照する。リポジトリ全体をアップロードするか、AIエージェント経由で読み込ませる必要がある。
△３：
ChatGPTのリポジトリ読込み機能は、Gitの仕組みを直接使っているわけではない。.gitignore で隠しているファイルを有効なファイルとして認識することがある。
△４：
IDE（VS Codeなど）がコードを整形する際にeditorconfig を参照する。AIモデルは、このファイルを読み取ってスタイルを矯正する機能は持っていない。
△５：
特定ツール（Cursor等）でのみ有効。