Rahasia Agar AI di IDE Tidak Berhalusinasi: Memahami Project-wide Context & Aturan .cursorrules

Fitur ini adalah "otak" di balik IDE AI modern yang memungkinkan AI Anda tidak hanya pintar menulis kode, tetapi juga memahami konteks unik proyek Anda.

Berikut adalah penjelasan dan contoh penerapannya agar AI Anda tidak berhalusinasi dan tetap konsisten setiap hari.

1. Project-wide Context (Pemahaman Menyeluruh)

Pengertian: Ini adalah kemampuan AI untuk melakukan indexing atau memindai seluruh isi folder proyek Anda. Tanpa fitur ini, AI hanya bisa melihat kode yang sedang Anda buka (file aktif). Dengan fitur ini, AI tahu hubungan antara Controller, Model, Route, dan Config yang tersebar di banyak file.

Mengapa ini penting? Jika Anda bertanya "Buatkan fungsi validasi data pengguna", AI dengan Project-wide Context akan melihat app/Models/User.php terlebih dahulu untuk mengetahui struktur database Anda, sehingga kode yang dihasilkan 100% kompatibel dan tidak error.

Contoh Skenario: Anda mengerjakan proyek Laravel dan ingin membuat fitur registrasi.

• Tanpa Context: Anda harus copy-paste kode User model ke chat agar AI paham.
• Dengan Project-wide Context: Anda cukup mengetik:

"Buatkan registrasi user baru yang menyimpan data ke tabel sesuai dengan model yang sudah ada di proyek ini."

• AI akan secara otomatis membaca struktur tabel di database migration dan model tanpa perlu Anda beritahu detailnya.

2. Rule-based Configuration (Panduan Baku)

Pengertian: Ini adalah file konfigurasi (biasanya bernama .cursorrules atau sejenisnya) yang diletakkan di root directory proyek Anda. Isinya adalah instruksi sistem yang wajib dipatuhi AI setiap kali ia memberikan jawaban.

Mengapa ini penting? Ini adalah solusi paling ampuh untuk mencegah AI memberikan kode yang "aneh" atau menggunakan versi library yang salah. Anda menetapkan "aturan main" sekali, dan AI akan memakainya selamanya.

Contoh Skenario: Anda sedang membangun aplikasi dengan Laravel 11 dan Vue 3. Anda ingin AI selalu disiplin. Anda buat file bernama .cursorrules di folder utama proyek dengan isi seperti ini:

markdown
# Aturan Pengembangan
- Selalu gunakan Laravel 11 dan PHP 8.2+ sintaks terbaru.
- Gunakan Vue 3 dengan Composition API dan `<script setup>`.
- Jika membuat database migration, wajib sertakan foreign key constraint.
- Jangan gunakan library pihak ketiga kecuali saya minta.
- Selalu tulis komentar yang menjelaskan logika kompleks.
- Untuk API response, gunakan JSON structure: { "status": "success", "data": ... }.

Hasilnya: Setiap kali Anda bertanya, AI sudah membaca file .cursorrules ini di latar belakang. Ia tidak akan lagi memberikan kode deprecated atau sintaks lama, karena aturan tersebut sudah "terpatri" dalam instruksinya.

Tabel Perbandingan: Context vs Rules

FiturFungsi UtamaKapan Digunakan?Project-wide ContextMemberi AI "mata" untuk melihat semua file.Saat Anda butuh AI mengerti alur logic antar file (misal: mencari bug atau fitur baru terkait database).Rule-based ConfigMemberi AI "otak" untuk mematuhi standar.Saat Anda ingin menjaga kualitas kode, gaya penulisan, dan versi framework agar konsisten.

Langkah Praktis untuk Full-stack Developer

Karena Anda mungkin sibuk dengan pekerjaan utama maupun side project, terapkan 4 langkah ini:

1. Segera buat file .cursorrules (atau nama yang sesuai dengan IDE Anda) di folder root setiap proyek.
2. Masukkan Tech Stack yang Anda gunakan di sana (Laravel, Vue, Flutter, dll).
3. Tulis "Gaya Coding" Anda. Contoh: "Saya suka kode yang ringkas, berikan solusi yang paling performant bukan yang paling panjang."
4. Saat pindah perangkat: Pastikan file tersebut ikut di-push ke Git. Begitu Anda buka proyek di komputer lain, IDE Anda akan langsung "ingat" aturan main tersebut karena file .cursorrules ikut ter-download.

Bonus: Template .cursorrules Siap Pakai

Berikut adalah draf .cursorrules yang sangat optimal untuk menjaga agar AI tidak berhalusinasi dan selalu konsisten, baik di kantor maupun di laptop pribadi.

(Copy-paste ini ke file .cursorrules di root proyek Anda)

markdown
# Aturan Pengembangan - Project: [NAMA_PROYEK_ANDA]

## 1. Identitas & Lingkungan
- Anda adalah Senior Developer yang ahli dalam efisiensi kode dan skalabilitas.
- Gunakan selalu versi terbaru: [Sebutkan tech stack utama, misal: Laravel 11, PHP 8.3, Vue 3, Tailwind CSS].
- Jika ragu dengan implementasi, selalu rujuk pada dokumentasi resmi framework terkait.

## 2. Kualitas Kode
- Tulis kode yang "Clean & Maintainable".
- Selalu gunakan type-hinting pada fungsi/metode.
- Hindari duplikasi kode (DRY - Don't Repeat Yourself).
- Sertakan komentar singkat pada logika yang kompleks, bukan pada hal yang sudah jelas.
- Gunakan naming convention yang konsisten (PascalCase untuk Class, camelCase untuk method/variabel).

## 3. Gaya Penulisan AI
- Berikan jawaban yang singkat, padat, dan langsung ke inti (kode).
- Jika memperbaiki bug, jelaskan secara singkat kenapa bug itu terjadi.
- Jangan mengulang seluruh isi file jika hanya perlu mengganti beberapa baris kode. Tampilkan bagian yang relevan saja.
- Gunakan bahasa yang profesional namun santai.

## 4. Batasan (Anti-Halu)
- Jangan pernah berasumsi tentang struktur database jika tidak disediakan skema (migration). Tanyakan dulu jika perlu.
- Jika saya memberikan file, selalu gunakan isi file tersebut sebagai referensi utama sebelum memberikan solusi.
- Jangan gunakan library pihak ketiga kecuali saya meminta secara eksplisit.
- Jika ada *breaking changes* pada library yang digunakan, berikan peringatan kepada saya.

## 5. Konteks Pindah Perangkat
- Selalu tuliskan "State of Project" jika saya meminta ringkasan pekerjaan.
- Ingat bahwa saya bekerja di dua lingkungan berbeda, jadi pastikan semua dependensi yang Anda sarankan bersifat portabel (disarankan menggunakan Docker/DevContainers).

Cara Mengaktifkannya: Cukup simpan file tersebut, lakukan git add dan git push. Saat Anda pull di komputer mana pun, IDE AI Anda (seperti Cursor) akan secara otomatis membacanya sebagai panduan sistem!