Tutorial Cursor Rules: Membuat .cursorrules Efektif untuk Vibe Coding

Vibe coding menjadi semakin populer sejak AI coding assistant seperti Cursor, Windsurf, dan GitHub Copilot masuk ke dalam workflow sehari-hari developer. Namun, banyak yang belum memanfaatkan fitur rules secara maksimal. Cursor Rules memungkinkan kamu mendefinisikan preferensi kode, arsitektur, dan batasan sehingga AI menghasilkan output yang lebih konsisten sesuai keinginan tim.

Mengapa Cursor Rules Penting?

Secara default, AI coding assistant menghasilkan kode berdasarkan pattern training data-nya. Hasilnya sering kali tidak sesuai dengan style guide, tech stack, atau konvensi yang digunakan oleh tim. Cursor Rules menambahkan konteks spesifik tentang cara kerja codebase kamu.

Dengan aturan yang jelas, AI bisa menghasilkan kode yang lebih rapi, mengikuti best practices, dan menghindari dependency yang tidak diinginkan. Ini mengurangi waktu review dan refactoring signifikan. Bayangkan jika setiap kode yang dihasilkan AI sudah lolos linting dan sesuai dengan convention tanpa perlu revisi manual.

Cursor Rules juga mengurangi cognitive load saat prompting. Kamu tidak perlu mengulang-ulang instruksi seperti "gunakan TypeScript" atau "jangan pakai default export" setiap kali meminta AI bekerja. Semua preferensi tersimpan dalam satu file yang dibaca otomatis.

Prasyarat

Sebelum membuat aturan, pastikan kamu memiliki:

• Cursor Editor versi terbaru (0.40+)

• Project yang sudah memiliki struktur direktori dan tech stack tetap

• Style guide atau coding convention yang sudah disepakati tim

• Contoh kode yang merepresentasikan best practice di codebase

Jika belum punya style guide, mulai dengan mengumpulkan aturan implisit yang sering muncul di code review. Catat pola yang sering dikritik atau diperbaiki, lalu ubah menjadi aturan eksplisit.

Langkah 1: Membuat File .cursorrules

Cursor Rules diatur dalam file teks bernama .cursorrules yang diletakkan di root direktori project. File ini akan dibaca oleh AI setiap kali kamu meminta generate atau edit kode.

Buat file baru dengan nama .cursorrules di root project. Jangan lupa titik di depan nama file. Cursor secara otomatis mengenali file ini tanpa konfigurasi tambahan. Kamu juga bisa membuat file .cursorrules di subdirektori jika aturan spesifik untuk modul tertentu.

Contoh struktur direktori setelah ditambahkan:

my-project/
  .cursorrules
  src/
  package.json
  ...

File ini menggunakan format plain text. Setiap baris adalah satu aturan. Kamu bisa menambahkan komentar dengan awalan tanda pagar jika ingin memberikan konteks tambahan untuk manusia yang membaca.

Langkah 2: Menulis Aturan Dasar

Isi file dengan aturan yang jelas dan spesifik. Gunakan bahasa Inggris atau Indonesia terserah preferensi tim. Cursor memahami konteks dari aturan yang kamu tulis.

Contoh aturan untuk project TypeScript dengan React:

Always use functional components with hooks.
Prefer const over let unless reassignment is necessary.
Use TypeScript strict mode. Avoid any type.
Follow the existing folder structure: components go in src/components.
Use named exports instead of default exports.
Write JSDoc comments for public functions.

Pastikan setiap aturan bersifat imperatif dan actionable. Hindari aturan yang ambigu seperti "tulis kode yang bagus" karena AI tidak bisa menginterpretasikan subjektivitas. Gunakan kata kerja aktif: use, avoid, prefer, always, never.

Jika codebase menggunakan formatter seperti Prettier atau Biome, sebutkan juga aturan yang spesifik. Misalnya: gunakan single quote, trailing comma, atau tab width 2.

Langkah 3: Menambahkan Context Arsitektur

Selain style guide, tambahkan informasi tentang arsitektur dan dependency. Ini membantu AI memahami boundary antar modul dan menghindari circular dependency.

Contoh:

We use a layered architecture: UI, Services, Repository.
UI layer must not import Repository directly.
Always use dependency injection for services.
Database access is abstracted through Repository pattern.

Jika project menggunakan monorepo dengan banyak package, sebutkan juga aturan impor antar package. Misalnya: package ui hanya boleh mengimpor dari types dan utils, tidak dari api.

Arsitektur yang kompleks seperti micro-frontend atau modular monolith memerlukan aturan yang lebih detail. Sebutkan konvensi komunikasi antar modul, protokol yang digunakan, dan format payload yang diharapkan.

Langkah 4: Menggunakan Rules untuk Testing

Cursor Rules juga bisa digunakan untuk memastikan AI menghasilkan test yang sesuai dengan framework yang dipakai. Definisikan framework testing, style assertion, dan coverage minimum.

Contoh aturan testing:

Write unit tests using Vitest.
Use describe/it blocks for grouping.
Mock external API calls using MSW.
Ensure every utility function has at least one test.

Dengan aturan ini, AI akan menghasilkan test case yang mengikuti konvensi tim, bukan test generik yang tidak relevan. Kamu juga bisa menambahkan aturan spesifik untuk e2e testing, seperti framework Playwright atau Cypress.

Aturan coverage bisa berupa: setiap route handler harus memiliki minimal satu test case untuk status 200 dan 400. Ini memaksa AI memikirkan edge case, bukan hanya happy path.

Langkah 5: Menambahkan Aturan Keamanan

Keamanan adalah aspek yang sering terlupakan dalam vibe coding. Cursor Rules bisa meminimalkan risiko dengan mendefinisikan constraint keamanan.

Contoh aturan keamanan:

Never hardcode API keys or secrets.
Always validate user input before processing.
Use parameterized queries for database operations.
Sanitize output to prevent XSS.

Aturan ini menjadi safety net yang mengurangi kemungkinan AI memasukkan praktik tidak aman ke dalam kode. Tambahkan juga aturan tentang environment variable dan konfigurasi secret management.

Untuk project yang menangani data sensitif, sebutkan juga aturan compliance seperti GDPR atau SOC 2. Misalnya: jangan log data pribadi user, gunakan hashing untuk password, dan aktifkan audit trail untuk semua operasi write.

Langkah 6: Menguji dan Iterasi Rules

Setelah membuat rules, uji dengan meminta Cursor menghasilkan fitur baru. Evaluasi apakah output sesuai dengan aturan. Jika tidak, perjelas wording atau tambahkan contoh.

Proses iterasi mirip dengan prompt engineering. Semakin spesifik aturan, semakin konsisten output AI. Diskusikan juga dengan tim untuk menambahkan edge case yang sering muncul di codebase.

Versioning file .cursorrules juga direkomendasikan. Gunakan commit message yang jelas setiap kali mengubah aturan. Ini memudahkan rollback jika perubahan malah merusak output AI.

Kesimpulan

Cursor Rules adalah force multiplier untuk vibe coding. Dengan investasi awal yang relatif kecil, kamu bisa mendapatkan kode yang lebih konsisten, aman, dan sesuai arsitektur tim. Jangan biarkan AI menebak-nebak. Berikan arahan yang jelas melalui .cursorrules.

Untuk detail lebih lanjut tentang fitur Cursor, kunjungi dokumentasi resmi Cursor. Mulailah dengan aturan sederhana, lalu perluas seiring dengan pertumbuhan codebase dan kebutuhan tim.