---
title: "AGENTS.md: パスと形式 · DotsAgent"
description: "AGENTS.mdの配置場所、形式とfrontmatter、グローバル版とネストされた版の統合方法、読み込むツールを解説します。2026-10-01時点で確認済み。"
url: https://dotsagent.io/ja/instructions/files/agents-md
---

AGENTS.md

# AGENTS.md: 配置場所とツールでの読み込み方

AGENTS.md は、ほとんどのコーディングエージェントが特別な設定なしで読み込む、プレーンな Markdown 形式のプロジェクト指示ファイルです。OpenAI はこれを Linux Foundation 傘下の Agentic AI Foundation に寄贈しており、6万を超えるオープンソースプロジェクトで使われています。

## 配置場所

- リポジトリのルートに置く AGENTS.md。プロジェクト全体に適用されます。
- サブディレクトリやパッケージに置く、ネストされた AGENTS.md。エージェントはツリー内で最も近いファイルを使います。
- OpenAI Codex: グローバル設定の ~/.codex/AGENTS.override.md。空または存在しない場合は ~/.codex/AGENTS.md。
- Cline: グローバル設定の ~/.agents/AGENTS.md。
- Claude Code は .claude/AGENTS.md にも対応しています。

## 形式

frontmatter も必須フィールドもないプレーンな Markdown で、見出しは自由に設定できます。形式上のサイズ制限はありませんが、OpenAI Codex はデフォルトで 32 KiB の project_doc_max_bytes に達すると読み込みを停止します。

`AGENTS.md`

```
# Acme web app

Customer-facing web app with an admin area and a REST API.

## Commands

- Install: `pnpm install`
- Test: `pnpm test`
- Lint and type-check: `pnpm lint && pnpm tsc --noEmit`

## Code style

- TypeScript strict mode; no `any` in new code.
- Keep database access in `src/db/`.

## Never

- Never commit secrets or .env files.
- Never edit files under `src/generated/` by hand.
```

## 優先順位と統合

編集対象のファイルに最も近い AGENTS.md が優先され、チャットで明示された指示はどのファイルよりも優先されます。OpenAI Codex はプロジェクトルートから作業ディレクトリまで、各ディレクトリにつき 1 ファイルを連結するため、より近いファイルほど後に追加され、優先されます。CLAUDE.md がある場合、Claude Code はデフォルトで AGENTS.md を読み込みません。

## 読み込むツール

| ツール | 対応状況 |
| --- | --- |
| [OpenAI Codex](https://developers.openai.com/codex/guides/agents-md) | ネイティブ対応。グローバルファイルを読み込み、その後、ルートから作業ディレクトリまで各ディレクトリにつき最大 1 ファイルを読み込みます。デフォルトの上限は 32 KiB です。 |
| [Claude Code](https://code.claude.com/docs/en/memory) | v2.1.277 からネイティブ対応。ただし、claude-md-and-agents-md に設定しない限り、CLAUDE.md または CLAUDE.local.md が存在しない場合に限ります。 |
| [Cursor](https://cursor.com/docs/context/rules) | ネイティブ対応。ルートとネストしたファイルに対応し、ネストしたファイルは親の内容と統合され、より具体的なファイルのルールが優先されます。 |
| [GitHub Copilot (cloud agent, code review, VS Code)](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions) | ネイティブ対応。リポジトリ内のどこに置いても使え、最も近いファイルが優先されます。 |
| [Devin Desktop (formerly Windsurf)](https://docs.windsurf.com/windsurf/cascade/memories) | ネイティブ対応。ルートのファイルは常に適用され、サブディレクトリのファイルはそのディレクトリ内に適用されます。 |
| [Cline](https://docs.cline.bot/features/cline-rules) | ネイティブ対応。グローバル設定の ~/.agents/AGENTS.md にも対応しています。Rules パネルで有効または無効にできます。 |
| [Gemini CLI](https://geminicli.com/docs/cli/gemini-md/) | オプトイン方式。.gemini/settings.json の context.fileName に AGENTS.md を追加します。 |
| [Aider](https://agents.md/) | オプトイン方式。.aider.conf.yml に read: AGENTS.md を追加します。 |
| [OpenClaw](https://docs.openclaw.ai/concepts/agent) | ネイティブ対応。エージェントのワークスペースで必須の操作指示ファイルとして使われます。 |
| [Listed on agents.md (not individually re-verified)](https://github.com/agentsmd/agents.md/blob/main/components/CompatibilitySection.tsx) | agents.md の一覧にある 23 個のツールのうちの 1 つです。Amp、Jules、Zed、Warp、goose、opencode、JetBrains Junie などが含まれます。これらは個別には再検証していません。 |

## ヒント

- 既存の AGENT.md の名前を変更する場合は、agents.md が mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md を提案しています。これにより、どちらの名前でも使い続けられます。
- テストと lint のコマンドを記載しましょう。エージェントは見つけたチェックを実行し、完了前に失敗を修正しようとします。
- モノレポでは、ルートのファイルを長くするのではなく、パッケージごとに短い AGENTS.md を追加しましょう。
- OpenAI Codex では、同じディレクトリにある AGENTS.override.md が AGENTS.md より優先されます。

1つのフォームから、AGENTS.mdと5つのツールに対応するルールファイルを生成します。 [AGENTS.mdジェネレーターを開く →](https://dotsagent.io/ja/instructions)

## その他の指示ファイル

[CLAUDE.md](https://dotsagent.io/ja/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/ja/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/ja/instructions/files/cursor-rules)

[.github/copilot-instructions.md](https://dotsagent.io/ja/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/ja/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/ja/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/ja/instructions/files/openclaw-workspace)

## 出典

1. [agents.md](https://agents.md/)/
2. [github.com](https://github.com/agentsmd/agents.md)/agentsmd/agents.md
3. [linuxfoundation.org](https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation)/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foun
4. [openai.com](https://openai.com/index/agentic-ai-foundation/)/index/agentic-ai-foundation/
5. [developers.openai.com](https://developers.openai.com/codex/guides/agents-md)/codex/guides/agents-md

AIエージェント開発者向けの独立したリファレンスです。ここに記載されているいずれのベンダーとも提携していません。

© 2026 DotsAgent · 確認日: 2026年10月1日