Learning / AI Tools & Agent

AGENTS.md & CLAUDE.md: "README" untuk Agent Koding

Diagram hierarki file instruksi

Diagram buatan sendiri.

Kenapa perlu?

Setiap sesi agent dimulai tanpa ingatan. Supaya tidak perlu menjelaskan ulang cara menjalankan, menguji, dan aturan proyek setiap kali, kita menulisnya sekali dalam file instruksi:

  • AGENTS.md: format terbuka lintas tool. Dibaca OpenCode, Codex, Cursor, Gemini CLI, GitHub Copilot, dan lainnya. Isinya Markdown biasa tanpa field wajib.
  • CLAUDE.md: file instruksi khusus Claude Code, dimuat di awal setiap sesi.

Lokasi CLAUDE.md (dari docs Claude Code)

LokasiBerlaku untuk
~/.claude/CLAUDE.mdKamu, di semua proyek
./CLAUDE.md atau ./.claude/CLAUDE.mdTim, satu proyek (di-commit)
./CLAUDE.local.mdKamu saja, proyek ini (masukkan ke .gitignore)
Kebijakan managed (admin organisasi)Semua user di organisasi

Claude Code membaca file dari folder kerja naik ke atas dan menggabungkan semuanya (tidak saling menimpa). CLAUDE.md di subfolder dimuat saat Claude membuka file di subfolder itu. Perintah /init membuat draf CLAUDE.md otomatis dari isi repo.

Penting: Claude Code membaca CLAUDE.md, bukan AGENTS.md. Kalau repomu sudah punya AGENTS.md, buat CLAUDE.md yang mengimpornya:

@AGENTS.md

## Khusus Claude Code
- Pakai plan mode untuk perubahan di folder tools/.

Aturan AGENTS.md

  • Taruh di root repo. Di monorepo boleh ada AGENTS.md per subproyek. File terdekat dari file yang sedang diedit yang dipakai.
  • Prompt eksplisit dari user di chat mengalahkan isi file.
  • Kalau ada perintah tes di dalamnya, agent akan berusaha menjalankannya.

Template siap pakai (untuk situs Belajar AI)

# AGENTS.md

## Proyek
Situs statis kursus "Belajar AI". HTML/CSS/JS tanpa framework.

## Perintah
- Jalankan lokal: python3 -m http.server 8000
- Build materi: python3 tools/build-learning.py
- Cek materi: python3 tools/check-learning.py

## Aturan
- Ubah materi di content/learning/*.md, jangan edit learning/*.html langsung.
- Bahasa Indonesia santai tapi jelas.
- Jangan pernah menulis API key/token di file frontend.
- Jangan git push atau commit tanpa izin.

## Selesai berarti
- Checker lolos tanpa error, halaman terbuka tanpa error console.

Tips menulis

  • Spesifik dan bisa diverifikasi: "indentasi 2 spasi", bukan "kode rapi".
  • Ringkas: docs Claude menyarankan di bawah 200 baris per file. Pecah aturan per area ke .claude/rules/.
  • Pakai @path/file untuk mengimpor dokumen lain daripada menyalin isinya.
  • Jangan masukkan secret, karena file ini di-commit.
  • Perbarui setiap kali agent mengulang kesalahan yang sama.

Troubleshooting

MasalahSolusi
Claude mengabaikan AGENTS.mdTambahkan @AGENTS.md di CLAUDE.md
Instruksi tidak dipatuhiTerlalu panjang atau samar; persingkat dan buat spesifik; cek dengan /memory
Aturan bentrok antar-fileHapus duplikat; file lebih dekat/lebih spesifik yang dipakai
CLAUDE.local.md ikut ter-commitTambahkan ke .gitignore

Latihan

  1. Buat AGENTS.md dengan template di atas di proyek latihanmu.
  2. Buka OpenCode atau Codex, lalu tanya "Bagaimana cara build materi?". Jawabannya harus mengutip perintah dari file.
  3. Buat CLAUDE.md berisi @AGENTS.md, lalu tanya hal yang sama di Claude Code.

Glosarium

  • Memory/instruksi persisten: konteks yang dimuat otomatis tiap sesi.
  • Import (@): menyertakan isi file lain.
  • Monorepo: satu repo berisi banyak proyek.

Video tutorial

Video milik kreatornya masing-masing, disematkan dari YouTube (tidak diunggah ulang). Jika isi video berbeda dengan materi, ikuti materi & dokumen resmi.

Video baru dimuat setelah diklik (youtube-nocookie.com).
CLAUDE.md vs AGENTS.md...
Channel: ZazenCodes · Bahasa: Inggris · Tutorial komunitas

⚠️ Cek perilaku terbaru di docs Claude Code: Claude membaca CLAUDE.md; impor AGENTS.md dengan @AGENTS.md.

Tonton di YouTube ↗
Video baru dimuat setelah diklik (youtube-nocookie.com).
Claude Code - 01 Instalasi & Setup [Indonesia]
Channel: TUKUCODE · Bahasa: Indonesia · Video terkait (dasar Claude Code sebelum menulis CLAUDE.md)Tonton di YouTube ↗
Gabung grup