Bu yazıda, Cursor kurallarının en iyi kullanım yöntemlerini ele alıyoruz: Kurallar nasıl yazılmalı, nasıl yapılandırılmalı ve projeler geliştikçe nasıl güncel ve işlevsel tutulmalı?

Cursor Kuralları Nedir?

Cursor kuralları, yapay zekâya verilen kalıcı yönergelerdir. Yapay zekânın kod üretim biçimini, açıklama tarzını ve etkileşim yöntemini belirlerler. Böylece her dosya açıldığında aynı talimatları tekrarlamak yerine bir kez kural tanımlar ve sürecin geri kalanını Cursor’a bırakırsınız.

Üç ana kural türü vardır:

Proje Kuralları – /.cursor/rules klasöründe saklanır, versiyon kontrolüne dâhildir ve yalnızca ilgili projeye özeldir.
Kullanıcı Kuralları – Tüm projelerde geçerli olan global kurallar (Cursor ayarlarından tanımlanır).
AGENTS.md – Daha basit, hafif senaryolar için Markdown tabanlı kurallar dosyası.

Not: Eski .cursorrules formatı hâlen desteklenmekle birlikte, aşamalı olarak .cursor/rules yapısına geçiş yapılmaktadır.

Kuralların Önemi

Kurallar olmaksızın yapay zekâ, kimi zaman tutarsız veya genelleştirilmiş kod üretebilir. Doğru tanımlanmış kurallar sayesinde:

Tutarlı bir kodlama standardı sağlanır (isimlendirme, biçim, noktalama vb.).
Teknoloji yığını netleştirilir, böylece gereksiz kütüphaneler önerilmez.
Projeye özel iş akışları oluşturulur (ör. “React’te yalnızca fonksiyonel bileşenler kullan”).
Yeni katılan geliştiriciler için açıklamalar daha anlaşılır hale gelir.

Kuralları, yapay zekâ asistanınız için yazılmış birim testleri gibi düşünebilirsiniz—çıktıların öngörülebilir, tutarlı ve standartlara uygun olmasını sağlar.

En İyi Uygulamalar

1. Doğru Kapsamı Belirleyin

Proje Kuralları: Framework, mimari veya isimlendirme gibi projeye özel konular.
Kullanıcı Kuralları: Noktalama, boşluk veya yorum biçimi gibi kişisel tercihler.
Bu ayrımı net tutarak proje gereksinimleriyle kişisel alışkanlıkların karışmasını önleyin.

2. Kuralları Modüler ve Odaklı Yazın

Her şeyi tek bir dosyaya toplamayın.
/.cursor/rules içinde küçük .mdc dosyaları kullanın: style.mdc, api-guidelines.mdc, testing.mdc vb.
Her dosyayı 500 satırın altında tutmaya özen gösterin.

3. Açık ve Uygulanabilir İfade Edin

Belirsiz talimatlardan kaçının.

❌ “React için en iyi uygulamaları kullan.”
✅ “Daima hook’larla fonksiyonel bileşen yaz. Sınıf bileşenlerinden kaçın. Lifecycle metodları yerine useState ve useEffect kullan.”

4. Kurallara Bağlam Ekleyin

Kurallar yalnızca “ne yapılmalı”yı değil, “neden”i de içermelidir. Kısa proje açıklamaları, yapay zekâyı doğru yönlendirir.

Bu proje, TailwindCSS kullanan bir Next.js uygulamasıdır.  
ESLint + Prettier (noktalı virgül yok) ile kodlama yapılır.  
Testler Jest ile yazılır.

5. Dosya Bazlı Kapsama Kullanın

Belirli klasör veya dosyalara özel kurallar yazabilirsiniz:

/src/components/**  -> component-style.mdc  /tests/**           -> testing-guidelines.mdc

6. Basit Tutun

Gereksiz kurallar Cursor’u yavaşlatır. Yalnızca gerçekten önemli olanları ekleyin.

7. Kuralları Kod Gibi Yönetin

Kuralları canlı dokümantasyon olarak görün:

Yapay zekâ tekrar eden bir hata mı üretiyor? → Yeni bir kural ekleyin.
Teknoloji yığını değişti mi? → Açıklamayı güncelleyin.
Ekipten geri bildirim mi geldi? → Açık talimatlara dönüştürün.

8. Topluluk Kaynaklarından Yararlanın

Her şeyi sıfırdan yazmak zorunda değilsiniz. Açık kaynak awesome-cursorrules deposunda hazır React, TypeScript, Tailwind ve Node kuralları bulabilirsiniz.

9. @ Bağlamıyla Güçlendirin

Kuralları, @File, @Code, @Docs gibi bağlamlarla birleştirdiğinizde Cursor daha etkili çalışır.

@File src/pages/index.tsx  Proje kurallarına uygun şekilde responsive bir navbar ekle.

10. Düzenli Gözden Geçirin

Kurallar, lint ayarları veya CI konfigürasyonları gibi düzenli güncellemeye ihtiyaç duyar.

Her sprint veya sürümde .cursor/rules dosyalarını gözden geçirin.
Eski talimatları kaldırın.
Yeni teknolojiler için gerekli kuralları ekleyin.

Örnek Minimal Kural Seti

React + TypeScript için basit bir style.mdc örneği:

# React + TypeScript Stil Rehberi
- Fonksiyonel bileşenleri hook’larla kullanın. Sınıf bileşenleri kullanmayın.  
- TypeScript strict mode açık olmalı.  
- Props ve state mutlaka tiplenmeli.  
- ESLint + Prettier (noktalı virgül yok) kullanılmalı.  
- TailwindCSS dışında stil kütüphanesi kullanılmamalı.  - Testler Jest + React Testing Library ile yazılmalı.

Sonuç

Cursor IDE tek başına güçlüdür; fakat doğru kurallar sayesinde tamamen sizin standartlarınıza uyumlu bir yapay zekâ asistanına dönüşür.

Kuralları doğru kapsamda belirleyin.
Modüler ve anlaşılır yazın.
Bağlam ve örneklerle destekleyin.
Kod gibi iteratif güncelleyin.

Böylece Cursor, yalnızca bir yardımcı değil, projenizi anlayan gerçek bir yazılım geliştirme partneri haline gelir.