---
title: "AGENTS.md: jalur dan format · DotsAgent"
description: "Lokasi AGENTS.md, format dan frontmatter-nya, cara salinan global dan bertingkat digabungkan, serta tool yang membacanya. Diperiksa pada 2026-10-01."
url: https://dotsagent.io/id/instructions/files/agents-md
---

AGENTS.md

# AGENTS.md: lokasi dan cara tool membacanya

AGENTS.md adalah file instruksi proyek berformat Markdown biasa yang dibaca sebagian besar coding agent tanpa konfigurasi tambahan. OpenAI menyumbangkannya ke Agentic AI Foundation di bawah Linux Foundation, dan lebih dari 60k proyek open source menggunakannya.

## Lokasi

- AGENTS.md di root repository, untuk seluruh proyek.
- File AGENTS.md di subdirektori atau paket; agent menggunakan file terdekat dalam hierarki.
- OpenAI Codex: file global ~/.codex/AGENTS.override.md atau, jika file tersebut kosong atau tidak ada, ~/.codex/AGENTS.md.
- Cline: file global ~/.agents/AGENTS.md.
- Claude Code juga menerima .claude/AGENTS.md.

## Format

Markdown biasa tanpa frontmatter atau kolom wajib; judul apa pun boleh digunakan. Format ini tidak menetapkan batas ukuran, tetapi OpenAI Codex berhenti membaca setelah project_doc_max_bytes, yang secara default bernilai 32 KiB.

`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.
```

## Prioritas dan penggabungan

File AGENTS.md yang paling dekat dengan file yang sedang diedit menjadi acuan, sementara instruksi eksplisit di chat mengesampingkan semua file. OpenAI Codex menggabungkan satu file dari setiap direktori, mulai dari root proyek hingga direktori kerja, sehingga file yang lebih dekat dibaca terakhir dan menjadi prioritas. Secara default, Claude Code melewati AGENTS.md jika ada CLAUDE.md.

## Tool yang membacanya

| Tool | Dukungan |
| --- | --- |
| [OpenAI Codex](https://developers.openai.com/codex/guides/agents-md) | Didukung secara native. Membaca file global, lalu maksimal satu file dari setiap direktori mulai dari root hingga direktori kerja, dengan batas 32 KiB secara default. |
| [Claude Code](https://code.claude.com/docs/en/memory) | Didukung secara native sejak v2.1.277, tetapi hanya jika tidak ada CLAUDE.md atau CLAUDE.local.md, kecuali disetel ke claude-md-and-agents-md. |
| [Cursor](https://cursor.com/docs/context/rules) | Didukung secara native di root dan subdirektori; file dalam subdirektori digabungkan dengan file induknya, dan file yang lebih spesifik menjadi prioritas. |
| [GitHub Copilot (cloud agent, code review, VS Code)](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions) | Didukung secara native di mana saja dalam repository; file terdekat menjadi acuan. |
| [Devin Desktop (formerly Windsurf)](https://docs.windsurf.com/windsurf/cascade/memories) | Didukung secara native. File root selalu berlaku; file di subdirektori berlaku untuk direktori tersebut. |
| [Cline](https://docs.cline.bot/features/cline-rules) | Didukung secara native, juga dengan file global ~/.agents/AGENTS.md; aktifkan atau nonaktifkan di panel Rules. |
| [Gemini CLI](https://geminicli.com/docs/cli/gemini-md/) | Opsional: tambahkan AGENTS.md ke context.fileName di .gemini/settings.json. |
| [Aider](https://agents.md/) | Opsional: tambahkan read: AGENTS.md ke .aider.conf.yml. |
| [OpenClaw](https://docs.openclaw.ai/concepts/agent) | Didukung secara native sebagai file instruksi operasi wajib di ruang kerja agent. |
| [Listed on agents.md (not individually re-verified)](https://github.com/agentsmd/agents.md/blob/main/components/CompatibilitySection.tsx) | Salah satu dari 23 tool dalam daftar agents.md, termasuk Amp, Jules, Zed, Warp, goose, opencode, dan JetBrains Junie; kami tidak memeriksanya satu per satu. |

## Tips

- Mengganti nama AGENT.md lama? agents.md menyarankan mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md agar kedua nama tetap berfungsi.
- Cantumkan perintah untuk test dan lint: agent akan mencoba menjalankan pemeriksaan yang ditemukan dan memperbaiki kegagalan sebelum selesai.
- Dalam monorepo, tambahkan AGENTS.md singkat untuk setiap paket alih-alih memperpanjang satu file root.
- Di OpenAI Codex, AGENTS.override.md lebih diprioritaskan daripada AGENTS.md di direktori yang sama.

Buat AGENTS.md dan file aturan yang sesuai untuk lima tool dari satu formulir. [Buka generator AGENTS.md →](https://dotsagent.io/id/instructions)

## File instruksi lainnya

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

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

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

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

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

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

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

## Sumber

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

Referensi independen bagi mereka yang membangun agen AI. Tidak berafiliasi dengan vendor mana pun yang disebutkan di sini.

© 2026 DotsAgent · Fakta diperiksa 1 Oktober 2026