Cursor Rules

Masalah: AI Editor yang Pelupa

Kamu sudah mengatur AI di Cursor: "komentar bahasa Indonesia, jangan pakai library X". Sesi ini ia patuh. Besok buka file lain, ia lupa lagi. Setiap chat baru = mengulang instruksi yang sama. Cursor Rules menyelesaikan ini: aturan tertulis yang otomatis dibaca AI di setiap sesi, untuk file/proyek yang kamu tentukan.

Konsepnya sama dengan AGENTS.md/CLAUDE.md (modul agent-skills), tapi terintegrasi ke editor: rules bisa bersifat global (berlaku di semua proyek), per proyek, bahkan per jenis file (aturan khusus untuk file test vs file komponen).

Contoh 1: Menulis Project Rules Pertama (Praktik)

Buat file rules di proyekmu (lokasi persisnya ikut dokumentasi Cursor terbaru; konsepnya yang penting):

# Project Rules: kasir-sederhana

## Selalu
- Komentar dan nama fungsi yang jelas dalam bahasa Indonesia untuk logika bisnis
- Validasi semua input user sebelum diproses
- Setelah edit, jelaskan cara menguji perubahannya

## Jangan pernah
- Menambah dependency npm tanpa izin
- Mengubah struktur folder yang ada
- Menghapus kode tanpa menjelaskan kenapa

## Konteks proyek
- Single file app: index.html berisi semua HTML/CSS/JS
- Target: berjalan offline di browser HP

Uji efektivitasnya: buka chat baru, minta tugas kecil ("tambahkan tombol reset"). Perhatikan: apakah AI mengikuti aturan tanpa diingatkan? Apakah komentarnya bahasa Indonesia? Kalau ada yang lolos, perbaiki kata-kata rule-nya (aturan kabur = tidak dipatuhi, prinsip dari modul agent-skills).

Contoh 2: Rules Spesifik per Jenis File (Praktik)

Kekuatan Cursor Rules dibanding file instruksi biasa: aturan bisa berbeda per pola file. Contoh:

# Rules untuk *.test.js
- Setiap test harus punya nama yang menjelaskan skenario dalam bahasa Indonesia
- Jangan mock hal yang sedang di-test; mock hanya dependensi luar
- Satu file test, satu fokus: jangan campur test utilitas dan test UI

# Rules untuk src/components/*
- Komponen maksimal 100 baris; pecah jika lebih
- Props harus didokumentasikan di komentar atas komponen
- Jangan ada logika bisnis di komponen; pindahkan ke src/lib/

Ini menyelesaikan masalah klasik: aturan umum yang tidak cocok untuk semua file. Test butuh aturan berbeda dari komponen UI, dan sekarang AI tahu bedanya secara otomatis.

Pola lanjutan: notepads (catatan konteks yang bisa disertakan ke chat dengan @). Simpan konteks yang sering dibutuhkan: "arsitektur aplikasi ini", "daftar endpoint API", "keputusan desain penting". Saat butuh, referensikan dengan @namafile, AI langsung mendapat konteksnya tanpa kamu paste ulang.

Catatan teknis: Cara kerja rules di balik layar: isi rules dimasukkan ke system prompt / konteks tiap permintaan AI di editor. Implikasinya sama dengan semua instruksi: (1) budget konteks: rules yang 500 baris memakan token di SETIAP request (termasuk tiap saran autocomplete!), jadi prioritaskan yang penting; (2) konflik: rules global vs rules proyek yang bertentangan = perilaku tidak menentu, audit berkala; (3) urutan: umumnya yang lebih spesifik (per file) menang atas yang umum. Praktik terbaik: rules global untuk preferensi pribadi (bahasa komentar, gaya umum), rules proyek untuk konvensi tim, rules per file untuk kasus khusus. Total ideal: di bawah 100 baris gabungan.

Kesalahan Umum

1. Rules kepanjangan. 300 baris rules = dibaca sekilas + boros token tiap request. Sama seperti skills: 10-20 aturan terpenting saja.
2. Tidak pernah menguji kepatuhan. Rules yang tidak diuji = pajangan. Uji tiap rule baru dengan tugas yang memancing pelanggaran.
3. Duplikasi dengan chat instructions. Menulis aturan yang sama di rules DAN diulang di tiap chat = boros dan berisiko konflik versi. Satu sumber kebenaran: rules.
4. Rules basi. Proyek pindah dari single-file ke multi-file tapi rules masih bilang "single file app" = AI dibingungkan oleh instruksimu sendiri. Review rules tiap perubahan arsitektur besar.

Rangkuman

Cursor Rules = instruksi permanen yang otomatis dibaca AI editor: global untuk preferensimu, per proyek untuk konvensi tim, per pola file untuk kasus khusus. Tulis ringkas (di bawah 100 baris total), uji kepatuhannya, jadikan satu-satunya sumber kebenaran, dan perbarui saat arsitektur berubah. Ditambah notepads untuk konteks yang sering dipakai, editor AI-mu berubah dari "pintar tapi pelupa" menjadi "asisten yang kenal proyekmu".