.cursorrules vs CLAUDE.md vs AGENTS.md：どのAIコーディングルールファイルが必要か？

すべてのAIコーディングツールは、プロジェクトのルールを含むMarkdownファイルを求めます。しかしそれぞれが異なるMarkdownファイルを求めます。

複数のAIツールを使用している場合（ほとんどの開発者がそうですが）、これはすぐに混乱します。どのファイルが必要で、それぞれに何を書くべきかについての決定版ガイドをお届けします。

ファイルの概要

ファイル	ツール	場所	スコープ
AGENTS.md	汎用（全ツール）	プロジェクトルート	全AIエージェント共有ルール
CLAUDE.md	Claude Code	プロジェクトルート	Claude専用指示
.cursor/rules/*.md	Cursor	.cursor/rules/ディレクトリ	Cursor専用ルール
.github/copilot-instructions.md	GitHub Copilot	.github/ディレクトリ	Copilot専用指示
.windsurf/rules	Windsurf	.windsurf/ディレクトリ	Windsurf専用ルール
JULES.md	Google Jules	プロジェクトルート	Jules専用指示

AGENTS.md：汎用標準

最適な用途： 複数のAIツールを使用するチーム、オープンソースプロジェクト

AGENTS.mdは、私たちが持つ汎用標準に最も近いものです。現在6万以上のリポジトリで使用されており、Linux FoundationのAgentic AI Foundation（MCPやgooseとともに）によって管理されています。

共有の指示をここに記述します。すべてのAIツールが知っておくべき事項：

• プロジェクト構造とアーキテクチャ
• ビルドとテストのコマンド
• コードスタイル規約
• 一般的なパターンとアンチパターン
• 依存関係とセットアップ手順

すべての主要なAIコーディングツールがAGENTS.mdを読み込むため、プロジェクトのAI指示の唯一の情報源になります。

CLAUDE.md：Claude Codeのメモリ

最適な用途： Claude Codeユーザー、Anthropicを標準とするチーム

CLAUDE.mdはすべてのClaude Codeセッションの開始時に自動的に読み込まれます。メモリの永続性やセッションコンテキストなど、Claude固有の機能をいくつかサポートしています。

CLAUDE.mdを使用する用途：

• Claude固有のふるまいの調整
• Claude Codeのみがサポートする機能
• ClaudeのためにAGENTS.mdをオーバーライドまたは拡張する

推奨パターン：共有ルールはAGENTS.mdに、Claude固有の追加事項はCLAUDE.mdに。

.cursorrules / .cursor/rules/：Cursorのアプローチ

最適な用途： Cursorユーザー、Cursorをメインのエディタとして使用するチーム

Cursorは元々単一の.cursorrulesファイルを使用していましたが、より細かい制御のために.cursor/rules/ディレクトリへと進化しました。ディレクトリ内の各ファイルはCursorが適用する個別のルールです。

Cursorルールの用途：

• Cursor固有のエージェントふるまい
• CursorのComposerとAgentモードのルール
• ファイルタイプ固有の指示（例：.tsxと.pyで異なるルール）

copilot-instructions.md：GitHubの規約

最適な用途： GitHub Copilotユーザー、GitHubを中心としたワークフロー

GitHub Copilotはプロジェクトレベルの指示のために.github/copilot-instructions.mdを読み込みます。.github/ディレクトリに設定を置くGitHubの規約に従います。

推奨セットアップ

ほとんどのプロジェクトで必要なのは最大2ファイルです。

AIツールを一つだけ使用する場合：

そのツールのネイティブファイルだけを使用します（Claude CodeならCLAUDE.md、CursorならA.cursor/rules/など）。

複数のAIツールを使用する場合：

1. AGENTS.md --- すべての共有ルール（アーキテクチャ、ビルドコマンド、規約）
2. ツール固有ファイル --- そのツール独自の機能のみ

構成例：

your-project/
  AGENTS.md              # 共有：ビルドコマンド、アーキテクチャ、規約
  CLAUDE.md              # Claude専用：メモリの好み、ツール使用
  .cursor/rules/style.md # Cursor専用：Composerのふるまい
  .github/copilot-instructions.md  # Copilot専用

ルールに含めるべき内容

数千のリポジトリの分析に基づくと、最も効果的な指示ファイルには以下が含まれます：

必ず含める：

• プロジェクトのビルドと実行方法
• テストの実行方法
• 重要なアーキテクチャの決定事項
• コーディングスタイルの好み

しばしば有用：

• してはいけないこと（否定的指示は驚くほど効果的）
• ファイル構造の説明
• 一般的なデバッグ手順
• 依存関係管理コマンド

省略する：

• 明らかな言語の機能
• AIがすでに知っていること
• 過度に細かいルール（最小限から始め、必要に応じて追加）

Webコンテキストを使ったAIルールの構築

優れたAI指示ファイルを書くには、外部ドキュメント、スタイルガイド、アーキテクチャパターンを参照する必要があることが多いです。ここでWebコンテンツをMarkdownフォーマットで持つことが役立ちます。

例えば、プロジェクトがドキュメントページの特定のAPIパターンに従っている場合：

1. Saveを使ってそのドキュメントページをMarkdownに変換する
2. 関連セクションをAGENTS.mdに参照または抜粋する
3. AIコーディングアシスタントはこれでフルコンテキストを持つ

フレームワークドキュメント、スタイルガイド、ベストプラクティス記事、Stack Overflowの解決策にも同じことが言えます。クリーンなMarkdownは、あなたとAIツールの両方が最も効率的に作業できるフォーマットです。

まとめ

AIコーディングルールのエコシステムはまだ進化中ですが、パターンは明確です：すべてMarkdownです。一つのツールを使おうと五つを使おうと、プロジェクトのAI指示はMarkdownファイルに記述され、バージョン管理され、人間が読め、機械が解析できます。

汎用ルールにはAGENTS.mdから始め、必要に応じてツール固有のファイルを追加し、繰り返し発生する問題が解決の価値があると判断するまですべてを最小限に保ちます。

---

SaveはどんなWebページもクリーンなMarkdownに変換します。AIコーディングアシスタントが必要とする参照資料とドキュメントコンテキストの構築に最適です。Saveを無料で試す。