Rules menyediakan instruksi level sistem untuk Agent dan Inline Edit. Anggap ini sebagai konteks, preferensi, atau alur kerja yang persisten buat project lo. Cursor mendukung empat jenis rules:

Project Rules

Disimpan di .cursor/rules, diawasi versi dan diterapkan spesifik ke codebase lo.

User Rules

Global di environment Cursor lo. Diatur di settings dan selalu diterapkan.

AGENTS.md

Instruksi Agent dalam format Markdown. Alternatif sederhana untuk .cursor/rules.

.cursorrules (Legacy)

Masih didukung, tapi sudah deprecated. Pakai Project Rules aja.

Cara kerja rules

Large language models nggak nyimpen memori antar completion. Rules ngasih konteks yang persisten dan bisa dipakai ulang di level prompt. Saat diterapkan, konten rule ditaruh di awal konteks model. Ini ngasih panduan yang konsisten ke AI buat ngasilin kode, ngeinterpretasi edit, atau bantuin workflow.
Rule diterapkan dalam konteks dengan chat
Rules berlaku buat Chat dan Inline Edit. Rules yang aktif bakal muncul di sidebar Agent.

Aturan proyek

Aturan proyek berada di .cursor/rules. Setiap aturan adalah sebuah file dan dikontrol versinya. Aturan bisa dibatasi menggunakan pola path, dipanggil secara manual, atau disertakan berdasarkan relevansi. Subdirektori bisa menyertakan direktori .cursor/rules mereka sendiri yang cakupannya hanya folder tersebut. Gunakan aturan proyek untuk:
  • Merekam pengetahuan domain-spesifik tentang codebase kamu
  • Mengotomatisasi workflow atau templat khusus proyek
  • Menstandarkan keputusan gaya atau arsitektur

Anatomi aturan

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

- Use our internal RPC pattern when defining services
- Always use snake_case for service names.

@service-template.ts

Aturan bertingkat

Kelola aturan dengan menempatkannya di direktori .cursor/rules di seluruh proyek kamu. Aturan bertingkat otomatis terpasang ketika file di direktori tersebut direferensikan.
project/
  .cursor/rules/        # Aturan tingkat proyek
  backend/
    server/
      .cursor/rules/    # Aturan khusus backend
  frontend/
    .cursor/rules/      # Aturan khusus frontend

Membuat aturan

Buat aturan menggunakan perintah New Cursor Rule atau melalui Cursor Settings > Rules. Ini akan membuat file aturan baru di .cursor/rules. Dari Settings kamu bisa melihat semua aturan dan statusnya.
Perbandingan aturan ringkas vs panjang

Menghasilkan aturan

Hasilkan aturan langsung dalam percakapan menggunakan perintah /Generate Cursor Rules. Berguna ketika kamu sudah memutuskan perilaku agen dan ingin menggunakannya kembali.

Praktik terbaik

Aturan yang bagus itu fokus, bisa ditindaklanjuti, dan punya cakupan yang jelas.
  • Usahakan aturan tetap di bawah 500 baris
  • Pecah aturan yang besar menjadi beberapa aturan yang bisa dikomposisikan
  • Sertakan contoh konkret atau file rujukan
  • Hindari panduan yang samar. Tulis aturan seperti dokumentasi internal yang jelas
  • Pakai ulang aturan saat kamu mengulangi prompt di chat

Contoh

Banyak contoh tersedia dari berbagai provider dan framework. Aturan yang dikontribusikan komunitas bisa ditemukan di beragam koleksi crowdsourced dan repositori online.

AGENTS.md

AGENTS.md adalah file markdown sederhana untuk mendefinisikan instruksi agent. Letakkan di root proyek kamu sebagai alternatif .cursor/rules untuk use case yang straightforward. Berbeda dengan Project Rules, AGENTS.md adalah file markdown polos tanpa metadata atau konfigurasi yang kompleks. Cocok banget untuk proyek yang butuh instruksi sederhana dan mudah dibaca tanpa overhead aturan terstruktur.
# Project Instructions

## Code Style
- Use TypeScript for all new files
- Prefer functional components in React
- Use snake_case for database columns

## Architecture
- Follow the repository pattern
- Keep business logic in service layers

Keterbatasan saat ini

  • Hanya di level root: AGENTS.md harus diletakkan di root proyek kamu (v1.5)
  • Tanpa scoping: Instruksi berlaku global untuk proyek kamu
  • Satu file: Berbeda dengan .cursor/rules, kamu nggak bisa membagi instruksi ke beberapa file
Dukungan AGENTS.md bertingkat di subdirektori direncanakan untuk v1.6.

Aturan Pengguna

Aturan pengguna adalah preferensi global yang ditetapkan di Cursor Settings → Rules dan berlaku di semua proyek. Aturan ini berupa teks biasa dan pas untuk menetapkan gaya komunikasi atau konvensi penulisan kode yang kamu sukai:
Please reply in a concise style. Avoid unnecessary repetition or filler language.

.cursorrules (Legacy)

File .cursorrules di root proyek kamu masih didukung, tetapi akan segera dihentikan. Kami menyarankan migrasi ke Project Rules untuk kontrol, fleksibilitas, dan visibilitas yang lebih baik.

FAQ