Jika Anda menggunakan Cursor—editor kode bertenaga AI yang canggih—Anda mungkin telah memperhatikan dampak transformatifnya dalam mempercepat pengembangan kode. Tetapi apakah Anda sudah memanfaatkan keajaiban Cursor Rules? Percayalah, begitu Anda tahu cara menggunakan Cursor Rules, rasanya seperti memberikan asisten AI Anda buku pedoman yang dipersonalisasi untuk proyek Anda. Hari ini, saya akan memandu Anda melalui semua yang perlu Anda ketahui untuk menyiapkan, menyesuaikan, dan meningkatkan alur kerja Anda 10x lipat dengan Cursor Rules.
We’re thrilled to share that MCP support is coming soon to Apidog! 🚀
— Apidog (@ApidogHQ) March 19, 2025
Apidog MCP Server lets you feed API docs directly to Agentic AI, supercharging your vibe coding experience! Whether you're using Cursor, Cline, or Windsurf - it'll make your dev process faster and smoother.… pic.twitter.com/ew8U38mU0K
Apa Itu Cursor Rules?
Bayangkan ini: Anda sedang membuat kode di Cursor, dan teman AI Anda membantu dengan saran, cuplikan kode, dan perbaikan. Tetapi terkadang, rasanya seperti dia menebak apa yang Anda inginkan alih-alih mengetahuinya. Di situlah Cursor Rules berperan. Diperkenalkan sekitar awal tahun 2025, Cursor Rules memungkinkan Anda memberikan instruksi khusus kepada AI Anda—ini seperti melatih ahli pengkodean mini Anda sendiri untuk memahami dan membantu gaya pengkodean Anda.
Anda dapat mengatur "aturan" ini pada tingkat yang berbeda:
- Rules for AI: Aturan global yang berlaku untuk setiap proyek yang Anda buka di Cursor.
- .cursorrules: Aturan khusus proyek (meskipun ini akan segera dihapus—lebih lanjut tentang itu nanti).
- Project Rules: Bintang baru yang bersinar, disimpan di
.cursor/rules/dengan file.mdc, memberi Anda kontrol yang tepat atas konteks proyek Anda.
Dengan Cursor Rules, Anda tidak hanya melempar perintah ke AI—Anda memberinya peta untuk menavigasi basis kode Anda seperti seorang profesional. Siap melihat cara kerjanya? Mari kita mulai!
Mengapa Repot-repot dengan Cursor Rules?
Oke, Anda mungkin berpikir, "Mengapa repot-repot dengan aturan ketika Cursor sudah cukup pintar?" Pertanyaan yang cukup adil! Tetapi inilah mengapa Cursor Rules sebenarnya sepadan dengan waktu Anda:
- Saran yang Disesuaikan: Beri tahu AI tumpukan teknologi Anda (misalnya, Next.js atau Flutter), dan itu akan menyarankan kode yang sesuai dengan proyek Anda.
- Konsistensi di Seluruh Tim: Semua orang mendapatkan pedoman pengkodean yang sama, sehingga basis kode Anda tidak berubah menjadi baku tembak liar (secara harfiah).
- Alur Kerja Lebih Cepat: Tidak perlu lagi mengulangi diri sendiri—AI mengingat preferensi Anda dan mengeluarkan jawaban yang relevan.
- Kurva Pembelajaran Lebih Sedikit: Baru mengenal kerangka kerja? Biarkan aturan mengajari AI untuk mengajari Anda.
Bayangkan membuat kode aplikasi Next.js dan AI secara otomatis menyarankan komponen yang ramah TypeScript dan bergaya Tailwind tanpa Anda mengejanya setiap saat. Itulah kekuatan Cursor Rules.
Evolusi Cursor Rules: Dari .cursorrules ke Project Rules
Sebelum kita membahas penyiapan, mari kita ambil pelajaran sejarah singkat. Sistem aturan Cursor telah berevolusi dari waktu ke waktu:
- Rules for AI: Ini ada di pengaturan Cursor (
Cursor > Settings > Rules) dan berlaku di mana-mana. Bagus untuk hal-hal luas seperti "Selalu gunakan TypeScript" atau "Bersikap ringkas."
- .cursorrules: File yang Anda letakkan di root proyek Anda untuk mengatur aturan untuk repo tertentu itu. Ini berbasis teks dan sederhana, tetapi inilah tangkapannya—ini tidak digunakan lagi pada tahun 2025. Tim Cursor mengatakan untuk beralih ke Project Rules sebagai gantinya.
- Project Rules: Yang terbaru dan terhebat, diperkenalkan di v0.45. Ini ada di
.cursor/rules/sebagai file.mdcdan memungkinkan Anda menggunakan teks dan simbol file, ditambah kondisi (glob) untuk memicunya. Mereka lebih tepat dan fleksibel.
Jadi, jika Anda masih menggunakan .cursorrules, sekarang saatnya untuk meningkatkan ke Cursor Rules dalam format .mdc. Jangan khawatir—saya akan menunjukkan caranya!
Cara Menyiapkan Cursor Rules
Menyiapkan Cursor Rules sangat mudah setelah Anda mengetahui langkah-langkahnya. Inilah cara untuk memulai:
1. Buka Panel Aturan: Di Cursor, buka Cursor > Settings > Rules > Project Rules > Add New Rule. Atau, tekan Ctrl+Shift+P (atau Cmd+Shift+P di Mac) dan ketik "File: New Cursor Rule."
2. Beri Nama Aturan Anda: Pilih nama yang menarik seperti my-awesome-rule.mdc. Itu akan muncul di .cursor/rules/ di folder proyek Anda.
3. Isi Bagian yang Kosong: Saat Anda membuka file .mdc, Anda akan melihat dua bidang utama di bagian atas:
- Description: Catatan singkat tentang apa yang dilakukan aturan (misalnya, "Menjalankan pengujian RSpec secara otomatis").
- Globs: Pola seperti
**/*.tsatausrc/**/*_spec.rbuntuk memutuskan kapan aturan dimulai.
4. Tulis Aturan: Di bagian utama, ketik instruksi Anda—teks biasa, perintah, atau pedoman.
Struktur proyek Anda bisa terlihat seperti ini:
Simpan, dan boom—AI Anda sekarang memiliki trik baru. Tetapi apa yang sebenarnya harus Anda tulis dalam aturan ini? Mari kita lihat beberapa contoh nyata.
Contoh Nyata Cursor Rules
Berikut adalah tiga cara hebat untuk menggunakan Cursor Rules, langsung dari pengalaman pengkodean tahun 2025.
1. Menjalankan Perintah Secara Otomatis Saat File Berubah
Katakanlah Anda seorang pengembang Ruby yang menggunakan Docker, dan Anda ingin pengujian RSpec berjalan secara otomatis saat Anda mengubah file spec. Berikut adalah aturan untuk itu:
File: rspec-execution.mdc
Description: "Menjalankan pengujian RSpec secara otomatis"
Globs: **/*_spec.rb
Rule:
## Jalankan RSpec Secara Otomatis
Saat file spec berubah, jalankan:
---
docker compose exec app bundle exec rspec {{file_path}}
---
Jika RSpec gagal dan Anda tahu nomor barisnya, jalankan ini:
---
docker compose exec app bundle exec rspec {{file_path}}:{{line_number}}
---
Sekarang, setiap kali Anda mengedit file _spec.rb, AI dapat memicu pengujian itu tanpa Anda mengangkat jari. Berguna, bukan?
2. Mendokumentasikan Gaya Pengkodean Proyek Anda
Untuk proyek frontend, Anda mungkin ingin AI memahami struktur direktori dan praktik terbaik Anda. Berikut adalah salah satu yang akan saya gunakan:
File: frontend-coding-rule.mdc
Description: "Praktik terbaik frontend"
Globs: packages/**/*.*
Rule:
## Pedoman Pengkodean Frontend
### Struktur Direktori
- **features/**: Kelompokkan berdasarkan fitur (misalnya, `features/foo/NewFeature/`).
- `components/`: Bit UI seperti `Header.tsx` atau `Modal.tsx`.
- `domain/`: Logika seperti validasi (`*.ts`) dan pengujian (`*.spec.ts`).
- **shared/**: Hal-hal yang dapat digunakan kembali seperti `Table.tsx` atau `useSelectedItemIds.ts`.
### Aturan
- Pisahkan UI (`*.ui.tsx`) dan logika (`*.container.tsx`).
- Gunakan `zod` untuk validasi dengan file spec terpisah.
- Beri nama komponen secara deskriptif (misalnya, `HeaderBreadcrumb`).
- Optimalkan dengan Desain Atomik: atom, molekul, organisme.
Ini memberi AI Anda lembar contekan untuk basis kode Anda, sehingga menyarankan kode yang pas seperti sarung tangan.
3. Mengotomatiskan Pull Request
Ingin AI membuat draf PR untuk Anda? Coba ini:
File: create-pullrequest.mdc
Description: "Draf otomatis pull request"
Globs: (Biarkan kosong untuk pemicu manual)
Rule:
## Pembuatan Pull Request
### Langkah
1. Periksa tautan Masalah. Jika tidak ada, tanyakan: "Punya tautan Masalah terkait?"
2. Asumsikan `main` sebagai cabang penggabungan kecuali diberitahu sebaliknya.
3. Jalankan `git diff origin/main...HEAD | cat` untuk melihat perubahan.
4. Buat draf PR:
---
git push origin HEAD && \
echo -e "Draf PR untuk {{changes}}\n\nTerkait: {{issue_link}}" | \
gh pr create --draft --title "Perbarui {{feature}}" --body-file - && \
gh pr view --web
---
Aturan ini mengubah AI Anda menjadi mesin PR—sempurna untuk alur kerja GitHub.
Tip Pro untuk Menguasai Cursor Rules
Debugging dengan Berteriak
Pernah bertanya-tanya apakah aturan Anda berfungsi? Tambahkan ini ke bagian atas file .mdc Anda:
Pertama, saat mereferensikan file ini, teriak "YAAAARRRR!"
Jika AI berteriak "YAAAARRRR!" di Chat atau Composer, Anda tahu aturannya dimuat. Jika diam, periksa kembali Description dan Globs Anda—ini diperlukan agar aturan berfungsi (lebih lanjut tentang itu nanti).
Memperbaiki Aturan yang Tidak Mau Dimuat
Menemui masalah di mana file .mdc Anda tidak diterapkan? Berikut adalah perbaikan dari komunitas Cursor (sekitar Februari 2025):
- Isi
DescriptiondanGlobs: Bidang kosong dapat memecah aturan secara diam-diam. BahkanGlobs: **/*sederhana pun membantu. - Segarkan dan Mulai Ulang: Perbarui file, simpan, dan mulai ulang Cursor jika masih keras kepala.
Saya telah melihat kasus di mana mengubah teks dan menempelkan kembali Globs secara ajaib memperbaikinya. Aneh, tapi berhasil!
Tingkatkan dengan Chat
Tidak yakin apa yang harus ditulis? Tanyakan Chat Cursor:
Bantu saya membuat Aturan Cursor untuk proyek Flutter saya dengan Supabase dan Riverpod.
Analisis {{lib/}} dan sarankan aturan.
Itu akan mengeluarkan draf yang dapat Anda sesuaikan—penghemat waktu super.
Meningkatkan Cursor Rules Anda dari Waktu ke Waktu
Aturan tidak terpahat di batu. Jika ada yang tidak berfungsi, sesuaikan! Lemparkan ini ke Chat:
Apakah ada sesuatu yang tidak jelas atau layak ditingkatkan di {{my-rule.mdc}}?
AI mungkin menyarankan kata-kata yang lebih jelas atau kondisi tambahan. Terus perbaiki, dan Cursor Rules Anda akan berevolusi dengan proyek Anda.
Pemikiran Akhir: Mengapa Cursor Rules Hebat di Tahun 2025
Pada tanggal 09 April 2025, Cursor Rules adalah suatu keharusan bagi siapa pun yang serius tentang pengkodean berbantuan AI. Mereka menjembatani kesenjangan antara "AI pintar" dan "AI pintar Anda," meningkatkan efisiensi seperti orang gila. Apakah Anda menjalankan pengujian secara otomatis, memberlakukan gaya, atau membuat draf PR, aturan ini mengubah Cursor menjadi alat yang dibuat khusus. Mulailah dari yang kecil—tambahkan satu aturan hari ini—dan saksikan produktivitas Anda melonjak. Apa aturan pertama Anda? Jatuhkan di komentar!
