Cursor itu pintar. Tapi tanpa arahan, dia juga bisa “kreatif liar”: bikin pola beda tiap file, naruh comment basah, atau tiba-tiba nambah library yang kamu nggak minta.
Di 2026, developer yang produktif bukan cuma yang jago ngetik prompt. Yang menang biasanya yang punya rules project — semacam SOP kecil biar AI coding nurut stack, style, dan batasan tim.
Artikel ini bahas cara setup .cursorrules / project rules di Cursor Pro biar Agent, chat, dan inline edit lebih konsisten. Cocok buat solo dev, freelancer, dan tim kecil yang bikin SaaS, dashboard, bot, atau toko digital.
Kalau kamu masih baru di Cursor, onboarding dulu lewat tutorial Cursor pemula. Kalau masih galau Pro worth it atau enggak, baca review Cursor Pro 2026.
Kenapa Project Rules Itu Game Changer
Tanpa rules, tiap session AI “nebak-nebak”:
- Pakai TypeScript strict atau any-any aja?
- Fetch pakai axios atau native fetch?
- Component taruh di mana?
- Boleh rewrite auth flow tanpa izin?
- Bahasa comment Indonesia atau English?
Akibatnya: PR berantakan, code review capek, dan kamu buang waktu fix gaya koding AI.
Dengan rules yang bagus, kamu kasih pagar:
- Stack & versi yang boleh dipakai
- Struktur folder yang wajib diikuti
- Style (naming, error handling, logging)
- Larangan (jangan commit secret, jangan nambah dependency sembarangan)
- Definition of done (test, tipe, docs singkat)
Ini mirip kasih brief ke junior dev yang rajin — bedanya, junior ini ngetik secepat kilat.
Rules di Cursor: Intinya Apa?
Istilah di UI Cursor bisa berubah antar versi, tapi prinsipnya stabil:
- Ada aturan level project yang kebaca sebagai context
- Biasanya hidup di root repo (file rules) dan/atau lewat project rules di settings
- Berlaku ke chat, edit, dan agent multi-file
- Bisa digabung dengan docs/README biar model ngerti domain bisnis
Di komunitas, orang masih sering nyebut .cursorrules. Anggap itu “kontrak koding” buat AI di repo ini.
Kalau workflow-mu mix Cursor + API key biar hemat, padukan dengan setup AI coding workflow hemat dan cara setup Cursor + Claude Code + Atmo API.
Step 1: Audit Project 10 Menit Sebelum Nulis Rules
Jangan langsung generate rules generik dari internet. Rules generik = hasil generik.
Jawab dulu:
- Bahasa: TypeScript / Python / Go / mixed?
- Framework: Next.js, Nest, FastAPI, Laravel, dll?
- Package manager: npm, pnpm, bun, uv?
- Test runner: ada atau belum?
- Deploy target: Vercel, VPS, Docker?
- Hal paling sering AI “salah tebak” di project ini apa?
Contoh pain point seller/digital product stack:
- Jangan hardcode harga di banyak file
- Jangan sentuh payment webhook tanpa test
- Selalu validasi input API key / order id
- UI copy Bahasa Indonesia konsisten
Pain point itu yang dimasukin ke rules.
Step 2: Buat File Rules di Root Project
Di root repo, buat file rules (contoh klasik: .cursorrules). Kalau versi Cursor-mu pakai project rules lewat UI, paste konten yang sama ke sana biar single source of truth.
Prinsip nulis rules:
- Spesifik > puitis
- Pendek > novel 5 halaman
- Larangan jelas > “sebisa mungkin”
- Contoh mini > teori doang
Target panjang: kira-kira 40–120 baris. Kebanyakan malah bikin model bingung prioritas.
Step 3: Template Rules yang Bisa Langsung Dipakai
Copy template ini, sesuaikan:
# Project Rules — [Nama Project]
## Goal
Kamu adalah senior engineer yang bantu maintain codebase ini.
Prioritas: correctness, security, readability, minimal diff.
## Stack
- Runtime: Node 20 + TypeScript strict
- Framework: Next.js App Router
- UI: Tailwind + komponen existing di /components
- DB/ORM: [isi]
- Package manager: pnpm (jangan switch ke npm tanpa diminta)
## Struktur
- Fitur baru taruh sesuai folder existing
- Jangan bikin folder paralel “utils2”, “helpers-new”
- API route ikuti pola di /app/api/*
## Coding style
- TypeScript strict, hindari `any` kecuali justified singkat
- Nama file & function: jelas, bukan singkatan aneh
- Error handling: return response konsisten, log cukup, jangan swallow error
- Jangan tambah dependency baru kecuali benar-benar perlu + bilang dulu
## Security
- Jangan commit secret, token, API key, private key
- Secret hanya lewat env
- Validasi input user di boundary (API/form)
- Jangan log data sensitif (email lengkap, key, password)
## Product domain (penting)
- Ini marketplace akun digital & API key
- Harga, stok, dan status order harus konsisten
- Jangan “improve” payment flow tanpa diminta eksplisit
- Copy UI default Bahasa Indonesia, tonenya santai-profesional
## Cara kerja dengan AI edit
1. Baca file terkait dulu sebelum rewrite besar
2. Prefer patch kecil yang benar daripada refactor heroik
3. Kalau requirement ambigu, tanya / sebut asumsi
4. Setelah edit: ringkas file yang diubah + cara test manual
## Definition of done
- Kode jalan untuk happy path
- Edge case penting di-handle
- Nggak ada secret hardcode
- Ada cara verifikasi singkat (command/test/langkah UI)
Template ini generic-aman. Keampuhannya naik pas kamu isi bagian Product domain dan Stack dengan detail project-mu.
Step 4: Contoh Rules Spesifik — Next.js Dashboard
Kalau project-mu mirip dashboard admin jual akun:
## Next.js specific
- Pakai Server Components default; Client Components hanya kalau perlu interactivity
- Jangan fetch di client kalau data bisa di server
- Form action / route handler ikut pola existing
- Loading & empty state wajib untuk tabel order
## Data & auth
- Semua query user-scoped (jangan bocor data antar user)
- Role admin dicek di server, bukan cuma hide tombol di UI
- Pagination default 20
## Jangan lakukan
- Jangan migrate ke Pages Router
- Jangan ganti Tailwind ke CSS-in-JS
- Jangan rewrite auth library tanpa brief
Dengan ini, Agent Cursor jarang “iseng” migrasi arsitektur pas kamu cuma minta fix bug filter tanggal.
Step 5: Contoh Rules Spesifik — Python API / Bot
Buat bot Telegram, automasi, atau service API:
## Python stack
- Python 3.11+
- Pakai venv/uv sesuai repo
- Type hints wajib di public function
- Formatting: ikuti tool existing (ruff/black) — jangan perang style
## API & bot behavior
- Timeout & retry dengan batas jelas
- Jangan spamming external API
- Simpan correlation id di log request
- Secret dari environment, bukan .py
## Testing
- Kalau ada pytest, update/tambah test untuk perubahan logic
- Jangan hapus test biar “hijau”
Ini krusial kalau kamu pakai AI buat Telegram bot OpenAI API atau automasi marketing — AI suka “lupa” edge case rate limit.
Step 6: Cara Pakai Rules biar Beneran Ngefek
Rules bukan jimat. Cara minta ke Cursor tetap penting.
Prompt bagus
“Tambah endpoint cek sisa kuota API key user. Ikuti project rules: minimal diff, validasi input, jangan sentuh payment. Update test kalau ada.”
Prompt kurang bagus
“Bikin sistem kuota yang keren dan scalable.”
Yang kedua ngundang overengineering.
Tips praktis:
- Sebut batasan di prompt meski sudah ada di rules (double anchor)
- Untuk refactor besar, pecah jadi 2–3 request
- Minta “list file yang akan diubah” dulu sebelum apply
- Review diff kayak review junior — cepat, tapi jangan blind accept
Step 7: Perbaiki Rules dari Kesalahan Nyata
Rules terbaik lahir dari luka production.
Tiap kali AI:
- nambah library random
- nulis comment novel
- rusak i18n
- bypass validasi
…langsung tambah 1–2 baris larangan di rules.
Contoh update setelah kejadian:
## Learned the hard way
- Jangan pakai moment.js (project pakai date-fns)
- Jangan ubah copy tombol checkout tanpa minta
- Jangan auto-format full file kalau task cuma 5 baris
Dalam 2–3 minggu, rules-mu jadi “otak kedua” project.
Rules + Model + API Key: Combo Hemat
Project rules menaikkan kualitas per token. Artinya:
- Lebih dikit putaran “salah paham → revisi”
- Agent jarang nulis ulang file utuh tanpa perlu
- Kamu bisa pilih model lebih kecil untuk task sepele
Strategi hemat yang sering dipakai:
- Task kecil (rename, copy tweak): model cepat
- Task arsitektur / multi-file: model premium
- Custom API key kalau usage harian tinggi biar bill terukur
Kalau mau hitung kasar biaya, pelajari cara hitung biaya API AI per project dan tips hemat kuota token API AI.
Buat akses key/akun coding AI, banyak developer Indonesia ambil dari marketplace terpercaya biar nggak drama billing luar negeri — termasuk opsi di abdijualan.online.
Checklist Setup 20 Menit
- [ ] Audit stack & pain point AI di project
- [ ] Buat file project rules di root / lewat UI Cursor
- [ ] Isi stack, struktur, security, domain produk
- [ ] Tambah “jangan lakukan” yang spesifik
- [ ] Commit rules bareng repo (biar tim/AI session lain konsisten)
- [ ] Tes: minta Cursor bikin fitur kecil, cek apakah nurut
- [ ] Iterasi rules setelah 3–5 kesalahan nyata
- [ ] Pisahkan model: sepele vs berat
Kesalahan Umum
- Rules terlalu panjang — model kehilangan prioritas
- Rules copy-paste orang lain — nggak cocok stack-mu
- Nggak ada larangan security — API key ke-commit = traumatis
- Conflict antar rule (“minimal diff” vs “rewrite clean architecture”)
- Set rules sekali, nggak diupdate — project berubah, rules basi
- Blind trust Agent — rules bantu, review tetap wajib
Penutup: Bikin AI Jadi Junior yang Nurut, Bukan Intern yang Overconfident
Cursor Pro + model bagus tanpa rules = kecepatan tanpa arah.
Cursor Pro + rules rapi = kecepatan yang bisa di-maintain.
Kalau kamu freelancers atau builder yang pegang banyak client repo, rules juga jadi onboarding kilat: clone, buka Cursor, AI langsung ngerti pagar project.
Action plan hari ini:
- Buka 1 repo yang paling sering kamu sentuh
- Tulis rules 50–80 baris dari template di atas
- Minta Cursor kerjain 1 task kecil dengan batasan jelas
- Catat 2 kesalahan AI → masukin ke rules
- Ulangi minggu depan
Mau setup coding environment yang lebih solid (Cursor + model + API key hemat)? Bandingkan dulu kebutuhanmu lewat Cursor vs Windsurf vs Claude Code, lalu ambil akses yang sesuai di abdijualan.online. Yang penting: tools-nya nurut ke cara kerjamu — bukan sebaliknya.