Generator AGENTS.md
Isi satu formulir untuk membuat AGENTS.md yang berisi perintah, konvensi, dan batasan tegas Anda. Anda juga akan mendapatkan satu aturan berbasis path untuk Cursor, GitHub Copilot, Claude Code, Cline, dan Devin Desktop, serta file penghubung untuk tool yang tidak membaca AGENTS.md secara default.
Lokasi file instruksi untuk setiap tool →
# Aplikasi web Acme
Aplikasi web untuk pelanggan dengan area admin dan REST API kecil.
## Stack
Next.js, React, TypeScript, pnpm
## Perintah
- Instalasi: `pnpm install`
- Jalankan secara lokal: `pnpm dev`
- Pengujian: `pnpm test`
- Lint dan pemeriksaan tipe: `pnpm lint && pnpm tsc --noEmit`
- Build: `pnpm build`
## Gaya kode
- Ikuti pemformatan yang diwajibkan linter dan biarkan file yang tidak diubah tetap apa adanya.
- Utamakan fungsi kecil dengan input dan output yang jelas; batasi efek samping di bagian tepi.
- Minta persetujuan sebelum menambahkan dependency baru.
- Jelaskan alasan di balik kode yang tidak jelas, bukan apa yang dilakukan setiap baris.
## Pengujian
- Tambahkan atau perbarui pengujian untuk setiap perilaku yang Anda ubah.
- Jalankan perintah pengujian dan perbaiki kegagalannya sebelum menyatakan pekerjaan selesai.
- Jangan hapus atau lewati pengujian yang gagal hanya agar seluruh pengujian berhasil.
## Commit dan pull request
- Tulis subjek commit dalam bentuk perintah dan kurang dari 72 karakter.
- Batasi setiap pull request pada satu perubahan dan jelaskan dalam deskripsinya cara Anda mengujinya.
- Jalankan lint dan pengujian sebelum setiap commit.
## Jangan pernah
- Jangan pernah commit rahasia, API key, atau file .env.
- Jangan pernah mengedit langsung file yang dihasilkan di bawah src/generated/; buat ulang file tersebut.
- Jangan pernah menjalankan perintah database yang destruktif terhadap production.
- Jangan pernah melakukan force-push ke main atau menulis ulang riwayat yang digunakan bersama.
Aturan yang sama untuk lima tool
---
description: Konvensi untuk file yang cocok dengan glob ini
globs: app/**/*.tsx
alwaysApply: false
---
Ikuti pola yang sudah digunakan oleh file-file di dekatnya dalam folder ini. Setiap fungsi yang diekspor harus memiliki docstring dan pengujian di file pengujian yang sesuai.
---
applyTo: "app/**/*.tsx"
---
Ikuti pola yang sudah digunakan oleh file-file di dekatnya dalam folder ini. Setiap fungsi yang diekspor harus memiliki docstring dan pengujian di file pengujian yang sesuai.
---
paths:
- "app/**/*.tsx"
---
Ikuti pola yang sudah digunakan oleh file-file di dekatnya dalam folder ini. Setiap fungsi yang diekspor harus memiliki docstring dan pengujian di file pengujian yang sesuai.
---
paths:
- "app/**/*.tsx"
---
Ikuti pola yang sudah digunakan oleh file-file di dekatnya dalam folder ini. Setiap fungsi yang diekspor harus memiliki docstring dan pengujian di file pengujian yang sesuai.
---
trigger: glob
globs: app/**/*.tsx
---
Ikuti pola yang sudah digunakan oleh file-file di dekatnya dalam folder ini. Setiap fungsi yang diekspor harus memiliki docstring dan pengujian di file pengujian yang sesuai.
Cara membuat file instruksi yang efektif
Letakkan perintah yang tepat di bagian awal
Cantumkan perintah instalasi, pengujian, dan lint yang benar beserta flag-nya di bagian awal file. Sebutkan stack dan versinya dengan tepat, lalu berikan contoh kode singkat jika penjelasan dengan kata-kata saja kurang jelas.
Tulis aturan larangan secara eksplisit
Nyatakan dengan jelas hal-hal yang tidak boleh dilakukan agen, misalnya menyentuh secret, kode vendored, atau production. Jangan pernah commit secret adalah batasan bermanfaat yang paling umum ditemukan dalam file yang ditinjau GitHub.
Pastikan setiap instruksi bisa diverifikasi
Jalankan npm test sebelum commit dapat diverifikasi; uji perubahan Anda tidak. Hapus instruksi yang bertentangan, karena saat dua baris tidak selaras, model bisa mengikuti salah satunya.
Buat tetap ringkas dan pisahkan berdasarkan path
Anthropic menyarankan kurang dari 200 baris per file dan Cursor kurang dari 500 per aturan. Pindahkan panduan untuk area tertentu ke aturan yang dibatasi berdasarkan path agar hanya dimuat saat file tersebut digunakan. Import merapikan file, tetapi tidak mengurangi biaya konteks.
Lewati hal yang sudah diketahui agen
Dalam studi terhadap empat coding agent, file konteks tidak secara konsisten meningkatkan keberhasilan tugas dan menambah biaya inference lebih dari 20%. File yang ditulis LLM sedikit menurunkan hasil, sementara ringkasan repository tidak membantu. Jadi, batasi isi file pada persyaratan yang tidak jelas, seperti penggunaan tool tertentu.
Tambahkan aturan jika kesalahan berulang
Mulailah dengan aturan sederhana, lalu tambahkan satu baris saat agen melakukan kesalahan yang sama lebih dari sekali. Jadikan file yang sudah ada sebagai contoh, alih-alih menempelkan seluruh panduan gaya.
Pertanyaan tentang AGENTS.md
Apakah Claude Code membaca AGENTS.md?
Ya, mulai v2.1.277. Secara default, Claude Code hanya membaca AGENTS.md atau .claude/AGENTS.md jika tidak ada CLAUDE.md, .claude/CLAUDE.md, atau CLAUDE.local.md di direktori kerja atau direktori di atasnya. Pengaturan claude-md-and-agents-md memuat keduanya, dan CLAUDE.md yang berisi @AGENTS.md berfungsi di semua versi.
Apakah AGENTS.md memerlukan frontmatter atau heading tertentu?
Tidak. AGENTS.md adalah Markdown biasa tanpa kolom wajib, dan Anda bebas menggunakan heading apa pun. Situs agents.md menyarankan bagian seperti ringkasan project, perintah build dan test, gaya kode, pengujian, catatan keamanan, serta panduan pull request.
Bagaimana cara menggunakan AGENTS.md di monorepo?
Letakkan satu AGENTS.md di root dan satu lagi di setiap package yang memerlukan aturannya sendiri. Agen membaca file yang paling dekat dengan kode yang sedang diedit; jika ada konflik, aturan di file tersebut yang berlaku. Saat agents.md mendokumentasikan hal ini, repository utama OpenAI memiliki 88 file AGENTS.md.
Bagaimana cara membuat Gemini CLI membaca AGENTS.md?
Secara default, Gemini CLI masih menggunakan GEMINI.md. Tambahkan AGENTS.md ke context.fileName di .gemini/settings.json, misalnya ["AGENTS.md", "GEMINI.md"]. Jalankan /memory show untuk memeriksa file yang dimuat.
Coding agent mana yang mendukung AGENTS.md?
Kami memeriksa dokumentasi OpenAI Codex, Claude Code, Cursor, GitHub Copilot, Devin Desktop, Cline, dan OpenClaw. Semuanya membaca file ini secara native, sedangkan Gemini CLI dan Aider memerlukan satu baris konfigurasi. Situs agents.md mencantumkan total 23 tool yang kompatibel, termasuk Zed, Warp, goose, opencode, Jules, dan JetBrains Junie.
Siapa yang memelihara format AGENTS.md?
OpenAI menyumbangkan AGENTS.md kepada Agentic AI Foundation, sebuah dana yang dikelola Linux Foundation dan diumumkan pada 2025-12-09 bersama MCP dan goose. Situs agents.md menyebutkan bahwa lebih dari 60k proyek open source menggunakannya.