Project Rules
Disimpan di
.cursor/rules
, di-version control dan di-scope ke codebase lo.User Rules
Global buat environment Cursor lo. Didefinisikan di settings dan selalu diterapkan.
AGENTS.md
Instruksi Agent dalam format markdown. Alternatif simpel buat
.cursor/rules
..cursorrules (Legacy)
Masih didukung, tapi deprecated. Mending pake Project Rules.
Cara kerja rules

Rules berlaku untuk Chat dan Inline
Edit. Rules yang aktif bakal muncul di sidebar Agent.
Aturan proyek
.cursor/rules
. Setiap aturan adalah sebuah file dan dilacak dengan kontrol versi. Aturan bisa dibatasi dengan pola path, dipanggil secara manual, atau disertakan berdasarkan relevansi. Subdirektori bisa memiliki direktori .cursor/rules
sendiri yang cakupannya hanya folder tersebut.
Gunakan aturan proyek untuk:
- Menyandikan pengetahuan domain-spesifik tentang codebase kamu
- Mengotomatiskan alur kerja atau templat khusus proyek
- Menyeragamkan keputusan gaya atau arsitektur
Anatomi rule
.mdc
), format yang mendukung metadata dan konten. Atur bagaimana rule diterapkan lewat dropdown tipe yang mengubah properti description
, globs
, alwaysApply
.
Tipe Rule | Deskripsi |
---|---|
Always | Selalu disertakan dalam konteks model |
Auto Attached | Disertakan saat file yang cocok dengan pola glob direferensikan |
Agent Requested | Tersedia untuk AI, yang memutuskan apakah akan menyertakannya. Harus menyertakan deskripsi |
Manual | Hanya disertakan saat disebutkan secara eksplisit menggunakan @ruleName |
Aturan bertingkat
.cursor/rules
di seluruh proyek lo. Aturan bertingkat bakal otomatis nempel saat file di direktori itu direferensiin.
Membuat rule
New Cursor Rule
atau lewat Cursor Settings > Rules
. Ini bakal bikin file rule baru di .cursor/rules
. Dari Settings kamu bisa lihat semua rule beserta statusnya.

Membuat rule
/Generate Cursor Rules
. Berguna kalau kamu udah nentuin perilaku agent dan pengin pakai ulang.
Praktik terbaik
- Jaga aturan tetap di bawah 500 baris
- Pecah aturan besar jadi beberapa aturan yang bisa dikomposisikan
- Sertakan contoh konkret atau file rujukan
- Hindari panduan yang samar. Tulis aturan seperti dok internal yang jelas
- Pakai ulang aturan saat ngeulang prompt di chat
Contoh
Standar untuk komponen frontend dan validasi API
Standar untuk komponen frontend dan validasi API
Aturan ini menetapkan standar untuk komponen frontend:Saat bekerja di direktori components:
- Selalu pakai Tailwind untuk styling
- Pakai Framer Motion untuk animasi
- Ikuti konvensi penamaan komponen
- Pakai zod untuk semua validasi
- Definisikan return type dengan skema zod
- Ekspor tipe yang dihasilkan dari skema
Template untuk layanan Express dan komponen React
Template untuk layanan Express dan komponen React
Aturan ini menyediakan template untuk layanan Express:Pakai template ini saat bikin layanan Express:
- Ikuti prinsip RESTful
- Sertakan middleware penanganan error
- Siapkan logging yang proper
- Interface Props di bagian atas
- Komponen sebagai named export
- Styles di bagian bawah
Mengotomatiskan alur kerja pengembangan dan pembuatan dokumentasi
Mengotomatiskan alur kerja pengembangan dan pembuatan dokumentasi
Aturan ini mengotomatiskan analisis app:Saat diminta menganalisis app:
- Jalankan dev server dengan
npm run dev
- Ambil log dari console
- Sarankan peningkatan performa
- Mengekstrak komentar kode
- Menganalisis README.md
- Menghasilkan dokumentasi markdown
Menambahkan pengaturan baru di Cursor
Menambahkan pengaturan baru di Cursor
Pertama, bikin properti toggle di Untuk dipakai di app, import reactiveStorageService dan gunakan propertinya:
@reactiveStorageTypes.ts
.Tambahkan nilai default di INIT_APPLICATION_USER_PERSISTENT_STORAGE
dalam @reactiveStorageService.tsx
.Untuk fitur beta, tambahkan toggle di @settingsBetaTab.tsx
, kalau bukan, tambahkan di @settingsGeneralTab.tsx
. Toggle bisa ditambahkan sebagai <SettingsSubSection>
untuk checkbox umum. Lihat bagian lain file untuk contoh.AGENTS.md
AGENTS.md
adalah file markdown sederhana untuk mendefinisikan instruksi agent. Simpan di root proyek sebagai alternatif .cursor/rules
untuk use case yang straightforward.
Berbeda dari Project Rules, AGENTS.md
adalah file markdown polos tanpa metadata atau konfigurasi yang kompleks. Pas banget buat proyek yang butuh instruksi sederhana, mudah dibaca, tanpa overhead aturan terstruktur.
Aturan Pengguna
.cursorrules
(Legacy)
.cursorrules
di root project lo masih didukung, tapi bakal ditinggalkan. Disaranin migrasi ke Project Rules buat kontrol, fleksibilitas, dan visibilitas yang lebih baik.
FAQ
Kenapa aturan aku nggak diterapkan?
Kenapa aturan aku nggak diterapkan?
Cek tipe aturan. Untuk
Agent Requested
, pastikan deskripsi sudah ditentukan. Untuk Auto Attached
, pastikan pola file cocok dengan file yang direferensikan.Apa aturan bisa mereferensikan aturan lain atau file?
Apa aturan bisa mereferensikan aturan lain atau file?
Bisa. Gunakan
@filename.ts
untuk menyertakan file ke konteks aturan kamu.Apa aku bisa bikin aturan dari chat?
Apa aku bisa bikin aturan dari chat?
Bisa, bikin aturan proyek dari chat pakai perintah
/Generate Cursor Rules
.
Kalau Memories diaktifkan, Memories bakal dibuat otomatis.Apa aturan berdampak ke Cursor Tab atau fitur AI lainnya?
Apa aturan berdampak ke Cursor Tab atau fitur AI lainnya?
Nggak. Aturan cuma berlaku untuk Agent dan Inline Edit