AGENTS.md & CLAUDE.md：AIコーディングエージェントのための新しいREADME

最近AIコーディングアシスタントを使ったことがあれば、あるパターンに気づいたはずです。どのツールもMarkdownファイルを必要としているのです。

GitHub CopilotはA.github/copilot-instructions.mdを読み込みます。Cursorは.cursor/rules/を読み込みます。Claude CodeはCLAUDE.mdを読み込みます。Windsurfは.windsurf/rulesを読み込みます。GoogleのJulesはJULES.mdを読み込みます。そして普遍的な標準としてAGENTS.mdがあります。これはすでに6万以上のオープンソースリポジトリで使用され、Linux FoundationのAgentic AI Foundationによって管理されています。

Markdownはドキュメントフォーマットから、AIコーディングエージェントのオペレーティングシステムへと進化しました。

AGENTS.mdとは何か？

AGENTS.mdは、リポジトリに置かれるシンプルなオープンフォーマットのMarkdownファイルで、AIコーディングエージェントへのブリーフィングパッケージとして機能します。README.mdの対になるものと考えてください。

• README.mdは人間向け：クイックスタート、プロジェクト説明、バッジ
• AGENTS.mdはAIエージェント向け：ビルド手順、テストコマンド、コーディング規約、アーキテクチャの決定事項

エージェントはディレクトリツリーの中で最も近いファイルを読み込むため、より近いファイルが優先されます。各サブプロジェクトには独自の指示を持たせることができます。

CLAUDE.mdとは何か？

CLAUDE.mdはAnthropicのClaude Code専用のファイルです。各セッションの開始時に自動的に読み込まれ、毎回プロンプトで繰り返さなくて済むプロジェクト固有の指示を保持します。

優れたCLAUDE.mdには通常以下が含まれます：

• プロジェクトのコンテキスト：プロジェクトの概要をClaudeに伝える一文
• コードスタイル：フォーマットの好み、命名規則、従うべきパターン
• コマンド：テスト、ビルド、リント、デプロイの方法
• アーキテクチャのメモ：Claudeが尊重すべき重要な決定事項

推奨されるアプローチ：共有の指示はAGENTS.mdに記述し（すべてのAIツールが恩恵を受けられるよう）、Claude固有の機能はCLAUDE.mdに追加します。

AIコーディング指示ファイルの全体像

主要なAIコーディングツールとそのMarkdown規約をまとめました：

ツール	ファイル	フォーマット
GitHub Copilot	.github/copilot-instructions.md	Markdown
Cursor	.cursor/rules/*.md	Markdown
Claude Code	CLAUDE.md	Markdown
Windsurf	.windsurf/rules	Markdown
Google Jules	JULES.md	Markdown
汎用	AGENTS.md	Markdown

パターンに気づきましたか？すべてMarkdownです。例外なく。

なぜMarkdownが選ばれたのか

Markdownはエージェント指示ファイルに最適なフォーマットです。なぜなら：

1. LLMがネイティブに理解できる --- トレーニングデータで最も一般的なフォーマット
2. 人間が読める --- 開発者が指示を確認・編集しやすい
3. バージョン管理できる --- コードと並んでgitで管理できる
4. 軽量 --- パースのオーバーヘッドなし、特別なツール不要
5. 汎用的 --- あらゆるAIツール、エディタ、プラットフォームで動作する

Visual Studio Magazineが述べたように：エージェントAIの世界では、すべてMarkdownにかかっています。

エージェント指示ファイルを書くためのベストプラクティス

数千のリポジトリを分析した結果を基にしています：

最小限から始める。 エージェントが同じミスを繰り返すのに気づいたときだけルールを追加します。過度に細かい指示はかえって混乱を招くことがあります。

コマンドは具体的に。 「テストを実行して」ではなく、pnpm testやpytest -x tests/と書きます。

アーキテクチャを説明する。 プロジェクトが特定のパターン（例：コンテンツスクリプトとサービスワーカー間のメッセージパッシング）を使用している場合は、それを説明します。エージェントはコードからアーキテクチャの決定を推測できません。

してはいけないことも書く。 否定的な指示は驚くほど効果的です：「データベーススキーマを直接変更しないこと」や「クラスコンポーネントを使わず、常にフックを使うこと」のように。

この世界におけるSaveの役割

エージェント指示ファイルを作成しているなら、ウェブからの参照資料も保存していることでしょう。ドキュメントページ、Stack Overflowの回答、GitHub README、APIリファレンスなどです。

SaveはこれらのウェブソースをワンクリックでクリーンなMarkdownに変換します。AIエージェントが必要とするコンテキストを構築するのに最適です。ドキュメントページを保存し、MarkdownをAGENTS.mdや参照ドキュメントに貼り付けるだけで、AIコーディングアシスタントは必要なコンテキストをすぐに把握できます。

ワークフロー：

1. ウェブで役立つドキュメントやコード例を見つける
2. SaveをクリックしてMarkdownに変換する
3. エージェント指示ファイルに参照または追加する
4. 保存するたびにAIコーディングアシスタントの精度が向上する

未来：AIのコントロールサーフェスとしてのMarkdown

MicrosoftとGitHubは現在、Markdownをアガンティックなふるまいの安定した監査可能なコントロールサーフェスとして扱っています。もはやドキュメントだけではありません。人間の意図とAIの実行の間のインターフェースです。

Markdownファイルが果たす役割は3つに分かれています：

1. ドキュメント：システムを人間に説明する
2. 指示：AIのふるまいを制約し導く
3. スキル：エージェントがワークフローを繰り返せるよう指示とリソースをまとめる

このトレンドはさらに加速するでしょう。AIコーディングアシスタントが高性能になるにつれ、それらを導くMarkdownファイルの重要性も増していきます。

---

SaveはどんなWebページもワンクリックでクリーンなMarkdownに変換します。参照ライブラリの構築、ドキュメントの取り込み、AIコーディングワークフローのコンテキスト作成に最適です。Saveを無料で試す。