プロンプト二重管理から脱却するスマートなAIエディタ共存設定術

この記事の要点（結論）

• 複数のAIエディタを使い分ける際は、全AI共通のルールを「SSOT（単一の真実源：CLAUDE.md 等）」として一元管理するのがおすすめです。
• 個別のAI環境には「SSOTを読め」というポインターと追加ルールのみを書く「ラップ（Pointer）方式」を採用すると、設定の二重管理から脱却できます。
• さらに「ラッパーはSSOTが定義した委譲点の実装に限定する（SSOTと矛盾する上書きはしない）」原則を守ることで、ClaudeやAntigravityそれぞれの強みを安全に引き出すことが可能になります。

目次

AIエディタ併用で直面する「プロンプト二重管理」の課題

複数のAIエディタ（Claude Code, Cursor, Antigravityなど）を用途に合わせて使い分けるのが一般的なスタイルになってきました。しかし、そこで多くの場合直面する課題が、「システムプロンプト（ルールや役割を定義したマークダウンファイル）の二重管理」です。

「Claude用」「その他のAI用」とルールファイルを分けてしまうと、新しいプロジェクトを作るたびに設定の手間がかかり、ルールを更新するたびに両方を修正しなければなりません。筆者としても、情報の同期漏れがトラブルの元になると考えています。

実は現在の主要なAIエディタ・エージェントには、「特定の名前のファイルやフォルダを置いておけば、無音・全自動で読み込む」というネイティブな仕様が備わっています。

主要AIエディタ・エージェントの自動参照ファイル仕様まとめ

複数環境を併用するなら、この「ネイティブの自動読み込み仕様」を利用するのが効率的なプロンプト管理の第一歩です。代表的な環境の読み込み仕様を整理しました。

AI環境	最初に自動参照されるファイル名	AI動作を制御するフォルダと自動参照ファイル
Antigravity 2.0	.agents/AGENTS.md	.agents/skills/<スキル名>/SKILL.md
Claude Code	CLAUDE.md	.claude/ (skills / agents 等)
Cursor	.cursorrules	.cursor/rules/*.mdc
GitHub Copilot	.github/copilot-instructions.md	（標準では特定フォルダの自動ロード機構なし）

目指すゴールは「Single Source of Truth（SSOT）」と「委譲点」

AIごとの専用ファイルを作るのではなく、目指すべき実用的な設計方針は以下の通りです。

• コアとなる役割やルールは共通のファイル（SSOT）で一元管理する
• 各AIエディタが得意な固有機能（振る舞い）は、SSOTが定義した「委譲点」の範囲内でのみ追加・オーバーライドする

これを実現するのが、上記で紹介した自動ロード機能（Antigravityなら .agents/AGENTS.md）を活用した「ラップ（Pointer）方式」です。自動ロードされる設定ファイルに直接長々とルールを書くのではなく、「共通ファイル（CLAUDE.md 等）を読みに行け」という指示（ポインター）と、その環境固有の追加ルールだけを記載します。

また重要な点として、「環境固有ルールはSSOTと矛盾する上書きを禁止し、SSOT側に設けた委譲点の実装に留める」と定めておくことで、ルールの破綻を防ぐことができます。

【実践】スムーズに共存させるフォルダ・ファイル構成案

上記の自動参照仕様を踏まえ、複数AI環境をスムーズに共存させるための実践的なディレクトリ構成例を紹介します。

📁 プロジェクトルート
 ├── CLAUDE.md             ← 【SSOT】純粋なルール・知識 (全AI共通)
 ├── MEMORY.md             ← 【SSOT】記憶・データ (全AI共通)
 │
 ├── .agents/              ← Antigravity用制御フォルダ
 │    ├── AGENTS.md        ← "CLAUDE.mdを読め ＋ Artifact等を使え" と指示
 │    └── skills/          ← Antigravity専用の拡張スキル群
 │
 ├── .cursor/rules/        ← Cursor用制御フォルダ (必要に応じて)
 │    └── blog_rules.mdc   ← "CLAUDE.mdを読め ＋ Cursor特有の指示"
 │
 └── (.github/copilot-instructions.md) ← Copilot用 (必要に応じて)

構成の基本は、全環境共通の「共用部（CLAUDE.md / MEMORY.md）」と、AIエディタごとの「専用部（ラッパー）」へ役割を明確に分離することです。

① 共用部 (CLAUDE.md / MEMORY.md)

AIのプラットフォームに依存しない、純粋な「ブログ執筆の手順、ターゲット読者、トーン＆マナー」などを記述する中核ファイルです。Claude Codeなどのツールは、このファイルを標準で直接読み込みます。

② Antigravity専用部 (.agents/AGENTS.md)

ワークスペースルートに .agents/AGENTS.md を作成し、以下のように記述します。ポインター指示に加え、Antigravityならではの拡張機能（Artifactや画像生成など）を指示します。

# Antigravity Workspace Rules

あなたは私のブログ執筆・投稿運用を担うAIアシスタントです。
タスクを開始する前に、自身のファイル読み込みツールを使用して、以下の共用ルールファイルを順番に読み込み、思考・生成に反映させてください。

1. `../CLAUDE.md` (役割・ワークフロー・編集ルール)
2. `../MEMORY.md` (ナレッジ・事実)

---
## Antigravity固有の実行ルール (Execution Overrides)

ラッパーは「SSOTが定義した委譲点の実装」に限定し、SSOTと矛盾する上書きは禁止です。

- **アーティファクトの活用:** 記事の下書きを作成する際は、直接Markdownファイルに出力する前に、必ず「Artifact」としてリッチなプレビューを提示すること。
- **画像の自動生成:** （共通ルール側の委譲点に基づき有効）記事内で画像が必要な箇所については、画像生成ツール(`generate_image`)を活用してアイキャッチや挿絵を自律的に作成し、提案すること。
- **サブエージェントの活用:** リサーチタスクが発生した場合は、リサーチ用サブエージェント(`research`)を起動して並行調査を行うこと。

この設計がもたらす主なメリット

この「共用コア＋固有ラップ」設計を採用することで、実務上で次のような大きなメリットが得られると考えています。

1. メンテナンス負荷の軽減: 記事ネタや基本ルール（共用部）を更新した場合、ClaudeにもAntigravityにも即座に最新状態が反映されます。二重管理によるルール不整合のリスクを低減できます。
2. 各AIの強みをしっかり引き出せる: Claude Codeは指定通り堅実にMarkdownを直接出力し、AntigravityはArtifact機能でプレビュー画面を出しつつ、画像生成まで活用してくれます。それぞれのAIの持ち味を損なわずに運用可能です。

まとめ

今後さらに新しいAIエージェントが登場したとしても、この「Single Source of Truth」の設計思想があれば、環境ごとのラッパーファイル（今回の .agents/AGENTS.md にあたるもの）を一枚被せるだけで柔軟に対応可能です。

複数のAI環境を併用していてプロンプト管理に頭を悩ませている方は、ぜひこのラップ方式を自分のワークスペースでも試してみてください。