Rules menyediakan instruksi tingkat sistem untuk Agent dan Inline Edit. Anggap mereka sebagai konteks persisten, preferensi, atau alur kerja untuk proyek Anda. Cursor mendukung tiga jenis rules:

Project Rules

Disimpan di .cursor/rules, dikontrol versi dan terbatas ruang lingkupnya pada codebase Anda.

User Rules

Global untuk lingkungan Cursor Anda. Didefinisikan dalam pengaturan dan selalu diterapkan.

.cursorrules (Legacy)

Masih didukung, tetapi sudah usang. Gunakan Project Rules sebagai gantinya.

​
Cara kerja rules

Model bahasa besar tidak menyimpan memori antar penyelesaian. Rules menyediakan konteks yang persisten dan dapat digunakan kembali di tingkat prompt. Ketika diterapkan, konten rule disertakan di awal konteks model. Ini memberikan panduan yang konsisten kepada AI untuk menghasilkan kode, menginterpretasikan edit, atau membantu dengan alur kerja.
Rule diterapkan dalam konteks dengan chat
Rules berlaku untuk Chat dan Inline Edit. Rules yang aktif ditampilkan di sidebar Agent.

​
Aturan proyek

Aturan proyek berada di .cursor/rules. Setiap aturan adalah sebuah file dan dikontrol versinya. Aturan dapat dibatasi menggunakan pola path, dipanggil secara manual, atau disertakan berdasarkan relevansi. Subdirektori dapat menyertakan direktori .cursor/rules mereka sendiri yang dibatasi pada folder tersebut. Gunakan aturan proyek untuk:
  • Mengkodekan pengetahuan khusus domain tentang codebase Anda
  • Mengotomatisasi alur kerja atau template khusus proyek
  • Menstandardisasi keputusan gaya atau arsitektur

​
Anatomi aturan

Setiap file aturan ditulis dalam MDC (.mdc), format yang mendukung metadata dan konten. Kontrol bagaimana aturan diterapkan dari dropdown tipe yang mengubah properti description, globs, alwaysApply.
Tipe AturanDeskripsi
AlwaysSelalu disertakan dalam konteks model
Auto AttachedDisertakan ketika file yang cocok dengan pola glob direferensikan
Agent RequestedTersedia untuk AI, yang memutuskan apakah akan menyertakannya. Harus memberikan deskripsi
ManualHanya disertakan ketika secara eksplisit disebutkan menggunakan @ruleName
---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Gunakan pola RPC internal kami saat mendefinisikan layanan
- Selalu gunakan snake_case untuk nama layanan.

@service-template.ts
File yang direferensikan seperti @service-template.ts disertakan sebagai konteks tambahan ketika aturan dipicu.

​
Aturan bersarang

Atur aturan dengan menempatkannya dalam direktori .cursor/rules di seluruh proyek Anda. Aturan bersarang secara otomatis terlampir ketika file dalam direktori mereka direferensikan. 
project/
  .cursor/rules/        # Aturan seluruh proyek
  backend/
    server/
      .cursor/rules/    # Aturan khusus backend
  frontend/
    .cursor/rules/      # Aturan khusus frontend

​
Membuat aturan

Buat aturan menggunakan perintah New Cursor Rule atau pergi ke Cursor Settings > Rules. Ini membuat file aturan baru di .cursor/rules. Dari pengaturan Anda dapat melihat semua aturan dan statusnya.
Perbandingan aturan ringkas vs panjang

​
Menghasilkan aturan

Hasilkan aturan langsung dalam percakapan menggunakan perintah /Generate Cursor Rules. Berguna ketika Anda telah membuat keputusan tentang perilaku agen dan ingin menggunakannya kembali.

​
Praktik terbaik

Aturan yang baik bersifat fokus, dapat ditindaklanjuti, dan memiliki cakupan yang jelas.
  • Batasi aturan di bawah 500 baris
  • Pisahkan aturan besar menjadi beberapa aturan yang dapat digabungkan
  • Berikan contoh konkret atau file referensi
  • Hindari panduan yang samar. Tulis aturan seperti dokumentasi internal yang jelas
  • Gunakan kembali aturan saat mengulangi prompt dalam chat

​
Contoh

Banyak contoh tersedia dari penyedia dan framework. Aturan yang dikontribusikan komunitas dapat ditemukan di berbagai koleksi crowdsourced dan repositori online.

​
Aturan Pengguna

Aturan pengguna adalah preferensi global yang didefinisikan di Cursor Settings → Rules yang berlaku untuk semua proyek. Aturan ini berupa teks biasa dan sempurna untuk mengatur gaya komunikasi atau konvensi coding yang diinginkan: 
Please reply in a concise style. Avoid unnecessary repetition or filler language.

​
.cursorrules (Legacy)

File .cursorrules di root proyek Anda masih didukung tetapi akan dihentikan. Kami merekomendasikan untuk bermigrasi ke Project Rules untuk kontrol, fleksibilitas, dan visibilitas yang lebih baik.

​
FAQ