Rules

Kendalikan perilaku model Agent dengan instruksi yang dapat digunakan ulang dan memiliki cakupan tertentu.

Rules memberikan instruksi level sistem buat Agent dan Inline Edit. Anggap ini sebagai konteks, preferensi, atau alur kerja yang persisten buat proyek lo.

Cursor mendukung empat jenis rules:

Project Rules

Disimpan di .cursor/rules, masuk version control dan cakupannya terbatas ke codebase lo.

User Rules

Berlaku global di environment Cursor lo. Diatur di settings dan selalu diterapkan.

AGENTS.md

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

.cursorrules (Legacy)

Masih didukung, tapi sudah deprecated. Pakai Project Rules sebagai gantinya.

Cara kerja rules

Large language models nggak menyimpan memori antar-completion. Rules menyediakan konteks yang persisten dan bisa dipakai ulang di level prompt.

Saat diterapkan, isi rule disertakan di awal konteks model. Ini ngasih panduan yang konsisten buat AI untuk menghasilkan kode, menafsirkan edit, atau bantu workflow.

Rules berlaku untuk Chat dan Inline Edit. Rules yang aktif muncul di sidebar Agent.

Aturan proyek

Aturan proyek ada di .cursor/rules. Setiap aturan berupa file dan berada di bawah kontrol versi. Aturan bisa diberi cakupan dengan pola path, dijalankan secara manual, atau disertakan berdasarkan relevansi. Subdirektori bisa menyertakan direktori .cursor/rules sendiri yang cakupannya hanya untuk folder tersebut.

Gunakan aturan proyek untuk:

• Mengenkode pengetahuan domain-spesifik tentang codebase kamu
• Mengotomatisasi workflow atau template yang spesifik untuk proyek
• Menstandarkan keputusan gaya atau arsitektur

Anatomi rule

Setiap file rule ditulis dalam MDC (.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

---
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 lo. Aturan bertingkat akan otomatis diterapkan ketika file di direktori tersebut direferensikan.

project/
  .cursor/rules/        # Aturan untuk seluruh proyek
  backend/
    server/
      .cursor/rules/    # Aturan khusus backend
  frontend/
    .cursor/rules/      # Aturan khusus frontend

Membuat rule

Bikin rule pakai perintah 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 rules

Bikin rules langsung di percakapan pakai perintah /Generate Cursor Rules. Berguna kalau kamu sudah mutusin perilaku agent dan mau pakai ulang.

Praktik terbaik

Aturan yang bagus itu fokus, bisa dipraktikkan, dan punya cakupan yang jelas.

• Jaga aturan tetap di bawah 500 baris
• Pecah aturan besar menjadi beberapa aturan yang bisa dikomposisikan
• Sertakan contoh konkret atau file referensi
• Hindari panduan yang samar. Tulis aturan layaknya dok internal yang jelas
• Pakai ulang aturan saat mengulang prompt di chat

Contoh

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

Aturan ini juga menerapkan validasi untuk endpoint API:

Di direktori API:

• Pakai zod untuk semua validasi
• Definisikan tipe nilai balik dengan skema zod
• Ekspor tipe yang dihasilkan dari skema

Templat untuk layanan Express dan komponen React

Aturan ini menyediakan templat untuk layanan Express:

Pakai templat ini saat bikin layanan Express:

• Ikuti prinsip RESTful
• Sertakan middleware penanganan error
• Siapkan logging yang benar

@express-service-template.ts

Aturan ini mendefinisikan struktur komponen React:

Komponen React sebaiknya mengikuti susunan berikut:

• Interface Props di bagian atas
• Komponen diekspor sebagai named export
• Styles di bagian bawah

@component-template.tsx

Mengotomatiskan alur kerja pengembangan dan pembuatan dokumentasi

Aturan ini mengotomatiskan analisis app:

Saat diminta menganalisis app:

1. Jalankan dev server dengan npm run dev
2. Ambil log dari console
3. Sarankan peningkatan performa

Aturan ini membantu menghasilkan dokumentasi:

Bantu menyusun dokumentasi dengan:

• Mengekstrak komentar kode
• Menganalisis README.md
• Menghasilkan dokumentasi dalam format Markdown

Menambahkan pengaturan baru di Cursor

Pertama, buat properti untuk toggle di @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.

<SettingsSubSection
				label="Your feature name"
				description="Your feature description"
				value={
					vsContext.reactiveStorageService.applicationUserPersistentStorage
						.myNewProperty ?? false
				}
				onChange={(newVal) => {
					vsContext.reactiveStorageService.setApplicationUserPersistentStorage(
						'myNewProperty',
						newVal
					);
				}}
			/>

Untuk dipakai di app, import reactiveStorageService dan gunakan propertinya:

const flagIsEnabled = vsContext.reactiveStorageService.applicationUserPersistentStorage.myNewProperty

Banyak contoh tersedia dari berbagai penyedia dan framework. Aturan kontribusi komunitas bisa ditemukan di beragam koleksi dan repositori crowdsourced online.

AGENTS.md

AGENTS.md adalah file markdown sederhana untuk mendefinisikan instruksi agent. Taruh di root proyek kamu sebagai alternatif .cursor/rules untuk skenario penggunaan yang sederhana.

Berbeda dengan Project Rules, AGENTS.md adalah file markdown biasa tanpa metadata atau konfigurasi yang kompleks. Cocok buat 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

Aturan Pengguna

Aturan pengguna adalah preferensi global yang ditentukan di Cursor Settings → Rules dan berlaku di semua proyek. Aturan ini berupa teks biasa—pas buat ngatur gaya komunikasi yang kamu pengin atau konvensi penulisan kode:

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 ditinggalkan. Kami menyarankan untuk bermigrasi ke Project Rules demi kontrol, fleksibilitas, dan visibilitas yang lebih baik.

FAQ

Kenapa aturan aku nggak diterapkan?

Cek tipe aturan. Untuk Agent Requested, pastikan ada deskripsi. Untuk Auto Attached, pastikan pola file cocok dengan file yang dirujuk.

Apakah aturan bisa mereferensikan aturan lain atau file?

Bisa. Gunakan @filename.ts untuk menyertakan file ke konteks aturan kamu.

Bisa nggak aku bikin aturan dari chat?

Bisa, kamu bisa bikin aturan proyek dari chat pakai perintah /Generate Cursor Rules. Kalau Memories diaktifkan, memori bakal dibuat otomatis.

Apakah aturan berpengaruh ke Cursor Tab atau fitur AI lainnya?

Nggak. Aturan cuma berlaku buat Agent dan Inline Edit