JOURNAL — 2026-07-16
AIエディタの裏側を知る：自分OSを正しく動かす仕様と除外設定の技術
ツールの自動読み込み仕様、情報の3分法、Git管理とAI除外の違いをより深く理解するための専門的解説。
開発・技術AI-OS
けんさん
案内人個人事業主として、Web・写真・AI活用などに日々向き合っている案内人。現場で試しながら、本質を丁寧に整理する。
まりなさん
受け手けんさんのアシスタント。一般人目線で素朴な疑問や感想を代弁し、読みやすさをサポートする。
AI先生
整理係日々の対話相手であるLLMを擬人化した存在。親しみを込めて「先生」と呼ぶ、構造化の頼れる相棒。
けんさん、前回の話で自分OSの全体像はわかったんですけど、実際にAGENTS.mdやSKILL.mdを作るとき、エディタの裏側でAIがどうやって動いているのかが気になって……。ツールの仕様とか言われると、急に難しくなって頭がフリーズしそうです！
そうだなぁ。確かにエンジニア寄りの話になると難しく感じるよね。でも、AIエージェントが「どうやってファイルを読んでいるか」の仕様を知っておかないと、思った通りに動いてくれないんだ。まりなさんにも分かるように、裏側の仕組みを一つずつ紐解いていこう。
ONE PAGE SUMMARY
自分OSを正しく動かす核心は、「自動読み込み仕様」と「除外設定」の裏側を理解し、AIへ渡す文脈を人間が厳密にコントロールすること。
AIにすべてを任せるのではなく、仕様を理解して指示を制御します。
.gitignore で管理
目的：GitHubへのアップロード除外。不要なビルドファイルや秘密キーなどをGit管理下から外す設定です。
.cursorignore 等で管理
目的：AIの検索や自動読込の除外。無駄なメモや無関係な過去ログをAIに読み込ませず、トークン節約と精度維持を図ります。
- 自動読込の仕組み
- 階層ルーティング
- INDEX.mdによる目次化
- 除外設定の使い分け
ここからひとつずつ、図で整理していきます。
整理すると、自分OSを正しく機能させるための専門知識は大きく3つの要素に分かれます。自動読み込みの仕様、階層のルーティング、そしてAIの除外設定です。
そもそもCLAUDE.mdやAGENTS.mdとは？なぜ読んでくれるのか？
自分OSの基本ファイルであるCLAUDE.md、AGENTS.md、SKILL.mdは、ただのテキストファイルです。それなのに、なぜ置いておくだけでAIがルールとして認識するのでしょうか。その裏側には、エディタによる「ルール注入」のメカニズムがあります。
ルール検出
エディタが起動時に「CLAUDE.md」や「.cursorrules」という特定のファイルを発見。
プロンプト注入
人間には見えない裏側のプロンプトの先頭に、ルールファイルの中身を合体。
ルール遵守で思考
AIは合体した共通ルールをあらかじめ頭に入れた状態から会話を開始する。
そもそも、CLAUDE.mdとかAGENTS.md、SKILL.mdってただのテキストファイルですよね？なんでこれを置いておくだけで、AIが勝手にルールを守って動いてくれるんですか？
良い質問です。AIがこれらのファイルを読むのは、AI自身がフォルダを探検しているからではなく、エディタが起動時に指定のルールファイルを自動検知し、プロンプトへ注入（連結）する仕組みになっているからです。
各ツールの「ファイル読み込み仕様」の違い
エディタによって、自動で検出・注入されるファイルの形式や探索ルートは異なります。「これを置けばどのエディタでも同じように動く」わけではないため、仕様を理解して適切な名前で配置する必要があります。
CLAUDE.md
Anthropicの公式CLIツール。起動時にワークスペース直下の「CLAUDE.md」を強制的にコンテキストに読み込みます。
.cursorrules / Project Rules
ワークスペース直下に置かれた「.cursorrules」ファイル、またはエディタ本体のProject Rulesが、AI機能時に自動で注入されます。
AGENTS.md
Google Antigravity用の共通指示ファイル。「Respect .gitignore」の挙動に準拠しながら、エージェント実行時に優先的コンテキストに注入されます。
なるほど、エディタの側が「このファイルを読みなさい！」ってAIに渡してくれてるんですね。でも、CLAUDE.mdとAGENTS.md、それにエディタのルール設定って、全部同じものなんですか？
要は、ルールを届けるルートがそれぞれ違うんだよね。CLAUDE.mdはClaude Code用、Cursor RulesはCursor用というように、自分が使っているツールがどれを読むのかを理解して使い分ける必要があるんだ。
AI-OSのルーティング設計（上位から下位への流れ）
AIは自発的に関連フォルダを探したり、上層にある無関係な「SKILL.md」を遡って自動で読みに行くことはありません。最上位の憲法に「どの条件の時にどのフォルダの何を読むべきか」のルーティングを書いておき、AIを必要な時だけ下位の専門「SKILL.md」に誘導する必要があります。
最上位憲法
AGENTS.md / CLAUDE.md。全体の行動原則とルーティングの定義。
ワークスペース案内板
WORKSPACE_MAP.md。どの仕事でどのフォルダを検索するかの索引。
専門分野別の方針
Website/AGENTS.md 等。領域ごとに異なる前提条件。
専門作業手順書
Skills/Diagram/SKILL.md。再現可能で厳密な作業実行マニュアル。
え、じゃあ、指定した作業フォルダの外にある別のSKILL.mdとか、上の方の階層にある手順ルールをAIが自動で探しに行って、勝手に学習してくれることはないんですか？
そうなんだよね。AIは『親フォルダに戻ってルールがないか探そう』とはしないんだ。だからこそ、最上位のAGENTS.md（憲法）から案内板を通って専門レシピへAIを誘導する流れを作ってあげるか、人間がチャットで直接指定する必要があるんだよね。
補足すると、この一方向（上から下）への誘導により、不要なマニュアルがAIの脳内で混線するのを防いでいます。「複雑なタスクでは最上位の方針に戻り、単一の作業では専門SKILL.mdのみを参照する」という優先度判定ルールを憲法に書いておくことで、自動的なルーティングが機能します。
世界を切り替える：開くフォルダが「AIの視界のすべて」になる
AIにとっての「世界の境界線」は、あなたがエディタで開いているWorkspaceのフォルダです。開くフォルダを切り替えることで、AIに見せるルールやファイルを物理的にコントロールできます。
視界：ワークスペース全体
ルートにある全体憲法（AGENTS.md）が自動注入されて全体に適用されます。各プロジェクトを横断した指示や検索が可能です。
視界：その下層フォルダ内だけ
親フォルダにある全体憲法や、隣のフォルダはAIの視界から「完全に遮断」されます。下層直下にAGENTS.mdがあれば、それが新しい憲法として自動注入されます。
えっ、じゃあ、エディタで開くフォルダをどこにするかによって、AIが見ている世界そのものをコントロールできるってことですか！？
その通り！これを『Workspaceの境界仕様』と言うんだ。下層フォルダだけを開けば、親フォルダの憲法すら完全にシャットアウトできるから、ノイズをなくしてその作業に100%集中させたい時にめちゃくちゃ便利なんだよね。
補足すると、この時、下層フォルダ直下にAGENTS.mdがあれば、それが新たな『その世界における憲法』として自動注入されます。エディタが開いている場所こそが、AIにとっての絶対的なルートなのです。
資料を宝箱に隠す「INDEX.md」設計
日々の学習メモや参考資料をすべてAIに読み込ませると、無駄な通信量（トークン）が増えるだけでなく、AIの頭が混乱して回答精度が下がります。すべてのファイルを読ませるのではなく、目次（INDEX.md）を活用したフィルタリングを行いましょう。
散らかった机
大量のReferences全部。AIの頭が溢れてルールが埋もれてしまう。
本の目次
References/INDEX.md。各資料の概要と検索キー。
必要な本だけ
指定された特定ファイル。目次を見て指示されたファイルだけを読む。
メモや過去ログを全部読ませると、AIの頭がいっぱいになって「机が散らかった状態」になっちゃうから、INDEX.md（目次）だけを読ませて、必要なときだけ「この本を取って！」って言うんですね！
まさにその通り。これをすることで、AIの頭を常にすっきりさせて、トークンの無駄遣いも減らすことができるんだよね。
Git管理とAI除外設定の根本的な違い
機密情報を守るため、またはAIの誤読を防ぐために、除外設定ファイルがあります。これはGitの管理除外と、AIの読み込み除外で明確に別物として考える必要があります。
公開リポジトリからの漏洩防止
対象：APIキー、環境変数ファイルなど。目的：不要データのバージョン管理化を防ぐ。注意：これだけでは「AIに読ませないこと」は保証されません。
誤読と無駄なトークン消費の防止
対象：無関係なReferences、古いメモなど。目的：AIの誤読による精度低下を防ぐ。仕様：エディタごとに固有の除外ルールが定義されています。
| Cursor | プロジェクトルートに .cursorignore を配置。検索インデックスのみ外す場合は .cursorindexingignore も使用可能。 |
|---|---|
| Claude Code | デフォルトで .gitignore を尊重するほか、.claudeignore ファイルで明示的に除外対象を指定。 |
| Antigravity IDE | 独自ファイルではなく、エディタ設定の「Respect .gitignore」を有効にして自動除外。Tab予測補完は「Allow Gitignored Files」で制御。 |
| Copilot等 | プロジェクトルートに .copilotignore を配置し、コード提案・コンテキスト生成の対象外に設定。 |
え！`.gitignore`って「AIに読ませない設定」じゃないんですか！？GitHubに上げない設定と、AIに見せない設定って別物なんですか……？
補足すると、Gitは「ファイルのバージョン管理」のための仕組みであり、AI除外は「エディタがAIにファイルを読み込ませるか」の設定です。これらを混同すると、GitHubに上げたいのにAIに読まれない、またはその逆の問題が発生します。
ツールの仕様をちゃんとコントロールすることが、自分OSを賢く使いこなすための秘密だったんですね。すごくスッキリしました！
よかった。次はまず、自分が使っているエディタに合わせて、`.cursorignore`の設定や、簡単な `INDEX.md` を作ってみるのがおすすめだね。一歩ずつ仕様を味方にしていこう。
この話、あなたの現場ではどうですか。
記事の話題そのままで構いません。「あの記事の件で聞きたい」——それだけで最初の一言になります。
- ヒアリング無料
- 全国対応（オンライン可）
- しつこい営業はしません