Eğer, şık yapay zeka destekli kod editörü olan Cursor'ı kullanıyorsanız, kod geliştirme hızlandırması üzerindeki dönüştürücü etkisini fark etmişsinizdir. Ancak, henüz Cursor Kuralları'nın büyüsüne dokundunuz mu? İnanın bana, Cursor Kuralları'nı nasıl kullanacağınızı anladığınızda, yapay zeka asistanınıza projeniz için kişiselleştirilmiş bir oyun planı vermek gibi bir şey. Bugün, Cursor Kuralları ile kurulum, ayarlama ve iş akışınızı 10 kat artırmak için bilmeniz gereken her şeyi size anlatacağım.
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
Cursor Kuralları Nedir?
Şunu hayal edin: Cursor'da kod yazıyorsunuz ve yapay zeka arkadaşınız öneriler, kod parçacıkları ve düzeltmelerle yardımcı oluyor. Ancak bazen, ne istediğinizi bilmek yerine tahmin ediyor gibi hissediliyor. İşte tam da bu noktada Cursor Kuralları devreye giriyor. 2025 başlarında tanıtılan Cursor Kuralları, yapay zekanıza belirli talimatlar vermenizi sağlar; bu, yapay zeka asistanınızı kodlama tarzınızı anlaması ve size yardımcı olması için eğitmek gibidir.
Bu "kuralları" farklı seviyelerde ayarlayabilirsiniz:
- Yapay Zeka için Kurallar: Cursor'da açtığınız her proje için geçerli olan genel kurallar.
- .cursorrules: Proje özel kuralları (ancak bunlar kullanımdan kalkmak üzere - daha sonra bunun hakkında daha fazla bilgi).
- Proje Kuralları: Gösterinin yeni yıldızı,
.cursor/rules/içinde.mdcdosyalarıyla saklanır ve projenizin kontrolünü size verir.
Cursor Kuralları ile, yapay zekaya sadece istemler atmıyorsunuz; ona kod tabanınızda bir profesyonel gibi gezinmesi için bir harita veriyorsunuz. Nasıl çalıştığını görmeye hazır mısınız? Hadi başlayalım!
Neden Cursor Kuralları ile Uğraşmalısınız?
Tamam, "Cursor zaten oldukça akıllıken neden kurallarla uğraşayım?" diye düşünebilirsiniz. Oldukça adil bir soru! Ancak işte Cursor Kuralları'nın zamanınıza değmesinin nedeni:
- Özel Öneriler: Yapay zekaya teknoloji yığınınızı (örneğin, Next.js veya Flutter) söyleyin, sizin projenize uyan kodu önerecektir.
- Ekipte Tutarlılık: Herkes aynı kodlama yönergelerini alır, böylece kod tabanınız vahşi batı çatışmasına dönüşmez (kelimenin tam anlamıyla).
- Daha Hızlı İş Akışı: Artık kendinizi tekrar etmenize gerek yok; yapay zeka tercihlerinizi hatırlar ve ilgili cevapları verir.
- Daha Az Öğrenme Eğrisi: Bir çerçeveye yeni mi başladınız? Kuralların yapay zekayı size öğretmesini sağlayın.
Bir Next.js uygulaması kodladığınızı ve yapay zekanın, her seferinde belirtmenize gerek kalmadan, TypeScript uyumlu, Tailwind stilinde bileşenler önermesini hayal edin. İşte Cursor Kuralları'nın gücü bu.
Cursor Kurallarının Evrimi: .cursorrules'dan Proje Kurallarına
Kurulumuna geçmeden önce, hızlı bir tarih dersi alalım. Cursor'ın kural sistemi zamanla gelişti:
- Yapay Zeka için Kurallar: Bunlar Cursor'ın ayarlarında (
Cursor > Ayarlar > Kurallar) bulunur ve her yerde geçerlidir. "Her zaman TypeScript kullan" veya "Öz olun" gibi genel şeyler için harika.
- .cursorrules: O belirli depo için kurallar ayarlamak için projenizin köküne yerleştirdiğiniz bir dosya. Metin tabanlı ve basit, ancak işte püf noktası - 2025 itibarıyla kullanımdan kaldırıldı. Cursor ekibi bunun yerine Proje Kurallarına geçmenizi söylüyor.
- Proje Kuralları: En yeni ve en iyisi, v0.45'te tanıtıldı. Bunlar
.cursor/rules/içinde.mdcdosyaları olarak bulunur ve metin ve dosya sembollerini, ayrıca bunları tetiklemek için koşulları (glob'lar) kullanmanıza olanak tanır. Daha hassas ve esnektirler.
Bu nedenle, hala .cursorrules kullanıyorsanız, .mdc formatında Cursor Kuralları'na yükseltme zamanı. Merak etmeyin - size nasıl yapıldığını göstereceğim!
Cursor Kuralları Nasıl Kurulur
Cursor Kuralları'nı kurmak, adımları bildiğinizde çok kolaydır. İşte nasıl başlayacağınız:
1. Kurallar Panelini Açın: Cursor'da, Cursor > Ayarlar > Kurallar > Proje Kuralları > Yeni Kural Ekle'ye gidin. Veya, Ctrl+Shift+P (veya Mac'te Cmd+Shift+P) tuşlarına basın ve "Dosya: Yeni Cursor Kuralı" yazın.
2. Kuralınıza Ad Verin: my-awesome-rule.mdc gibi akılda kalıcı bir ad seçin. Proje klasörünüzde .cursor/rules/ içinde görünecektir.
3. Boşlukları Doldurun: .mdc dosyasını açtığınızda, en üstte iki ana alan göreceksiniz:
- Açıklama: Kuralın ne yaptığına dair hızlı bir not (örneğin, "RSpec testlerini otomatik olarak çalıştırır").
- Glob'lar: Kuralın ne zaman devreye gireceğine karar vermek için
**/*.tsveyasrc/**/*_spec.rbgibi kalıplar.
4. Kuralı Yazın: Ana bölümde, talimatlarınızı yazın - düz metin, komutlar veya yönergeler.
Proje yapınız şöyle görünebilir:
Kaydedin ve işte - yapay zekanız artık yeni bir numaraya sahip. Ancak bu kurallara aslında ne yazmalısınız? Bazı gerçek örneklere bakalım.
Cursor Kurallarının Gerçek Dünya Örnekleri
İşte 2025 kodlama hayatının siperlerinden doğrudan alınmış, Cursor Kuralları'nı kullanmanın üç harika yolu.
1. Dosyalar Değiştiğinde Komutları Otomatik Olarak Çalıştırın
Diyelim ki Docker kullanan bir Ruby geliştiricisisiniz ve bir spec dosyasını değiştirdiğinizde RSpec testlerinin otomatik olarak çalışmasını istiyorsunuz. İşte bunun için bir kural:
Dosya: rspec-execution.mdc
Açıklama: "RSpec testlerini otomatik olarak çalıştır"
Glob'lar: **/*_spec.rb
Kural:
## RSpec'i Otomatik Olarak Çalıştır
Bir spec dosyası değiştiğinde, şunu çalıştır:
---
docker compose exec app bundle exec rspec {{file_path}}
---
RSpec başarısız olursa ve satır numarasını biliyorsanız, şunu çalıştırın:
---
docker compose exec app bundle exec rspec {{file_path}}:{{line_number}}
---
Artık, bir _spec.rb dosyasını her düzenlediğinizde, yapay zeka parmağınızı kıpırdatmadan o testi tetikleyebilir. Kullanışlı, değil mi?
2. Projenizin Kodlama Stilini Belgeleyin
Bir ön uç projesi için, yapay zekanın dizin yapınızı ve en iyi uygulamalarınızı anlamasını isteyebilirsiniz. İşte benim kullanacağım bir örnek:
Dosya: frontend-coding-rule.mdc
Açıklama: "Ön uç en iyi uygulamaları"
Glob'lar: packages/**/*.*
Kural:
## Ön Uç Kodlama Yönergeleri
### Dizin Yapısı
- **features/**: Özelliğe göre gruplandırın (örneğin, `features/foo/NewFeature/`).
- `components/`: `Header.tsx` veya `Modal.tsx` gibi UI parçaları.
- `domain/`: Doğrulama (`*.ts`) ve testler (`*.spec.ts`) gibi mantık.
- **shared/**: `Table.tsx` veya `useSelectedItemIds.ts` gibi yeniden kullanılabilir şeyler.
### Kurallar
- UI'yı (`*.ui.tsx`) ve mantığı (`*.container.tsx`) ayırın.
- Ayrı spec dosyalarıyla doğrulama için `zod` kullanın.
- Bileşenleri açıklayıcı bir şekilde adlandırın (örneğin, `HeaderBreadcrumb`).
- Atomic Design ile optimize edin: atomlar, moleküller, organizmalar.
Bu, yapay zekanıza kod tabanınız için bir kopya kağıdı verir, böylece bir eldiven gibi oturan kodu önerir.
3. Çekme İsteklerini Otomatikleştirin
Yapay zekanın sizin için PR'lar hazırlamasını ister misiniz? Bunu deneyin:
Dosya: create-pullrequest.mdc
Açıklama: "Çekme isteklerini otomatik taslak yap"
Glob'lar: (Manuel tetikleme için boş bırakın)
Kural:
## Çekme İsteği Oluşturma
### Adımlar
1. Bir Issue bağlantısı olup olmadığını kontrol edin. Yoksa, şunu sorun: "İlgili bir Issue bağlantısı var mı?"
2. Aksi belirtilmedikçe, birleştirme dalı olarak `main`'i varsayın.
3. Değişiklikleri görmek için `git diff origin/main...HEAD | cat` komutunu çalıştırın.
4. Bir taslak PR oluşturun:
---
git push origin HEAD && \
echo -e "Draft PR for {{changes}}\n\nRelated: {{issue_link}}" | \
gh pr create --draft --title "Update {{feature}}" --body-file - && \
gh pr view --web
---
Bu kural, yapay zekanızı bir PR makinesine dönüştürür - GitHub iş akışları için mükemmeldir.
Cursor Kurallarında Uzmanlaşmak İçin İpuçları
Bağırarak Hata Ayıklama
Kuralınızın çalışıp çalışmadığını hiç merak ettiniz mi? .mdc dosyanızın en üstüne şunu ekleyin:
Öncelikle, bu dosyaya atıfta bulunurken, "YAAAARRRR!" diye bağırın.
Yapay zeka Chat veya Composer'da "YAAAARRRR!" diye bağırırsa, kuralın yüklendiğini bilirsiniz. Sessiz kalırsa, Açıklama ve Glob'lar'ı iki kez kontrol edin - kuralın devreye girmesi için gereklidirler (daha sonra bunun hakkında daha fazla bilgi).
Yüklenmeyen Kuralları Düzeltme
.mdc dosyanızın uygulanmadığı bir sorunla mı karşılaştınız? İşte Cursor topluluğundan bir düzeltme (yaklaşık Şubat 2025):
AçıklamaveGlob'larıDoldurun: Boş alanlar sessizce kuralı bozabilir. Basit birGlob'lar: **/*bile yardımcı olur.- Yenileyin ve Yeniden Başlatın: Dosyayı güncelleyin, kaydedin ve hala inatçıysa Cursor'ı yeniden başlatın.
Metni düzenlemenin ve Glob'ları yeniden yapıştırmanın sihirli bir şekilde düzelttiği durumlar gördüm. Garip, ama işe yarıyor!
Chat ile Seviye Atlayın
Ne yazacağınızdan emin değil misiniz? Cursor'ın Chat'ine sorun:
Flutter projem için Supabase ve Riverpod ile bir Cursor Kuralı oluşturmama yardım et.
{{lib/}}'i analiz et ve bir kural öner.
Düzenleyebileceğiniz bir taslak çıkaracaktır - süper zaman kazandırıcı.
Cursor Kurallarınızı Zaman İçinde Geliştirmek
Kurallar taşa yazılı değildir. Biri tıklamıyorsa, onu ayarlayın! Bunu Chat'e atın:
{{my-rule.mdc}}'de belirsiz veya geliştirilmeye değer bir şey var mı?
Yapay zeka daha net bir ifade veya ek koşullar önerebilir. Geliştirmeye devam edin ve Cursor Kurallarınız projenizle birlikte gelişecektir.
Son Düşünceler: Neden Cursor Kuralları 2025'te Harika
09 Nisan 2025 itibarıyla, Cursor Kuralları, yapay zeka destekli kodlama konusunda ciddi olan herkes için bir zorunluluktur. "Akıllı yapay zeka" ile "sizin akıllı yapay zekanız" arasındaki boşluğu doldurarak, verimliliği çılgınca artırırlar. Testleri otomatik olarak çalıştırıyor, stilleri uyguluyor veya PR'lar hazırlıyor olsanız da, bu kurallar Cursor'ı özel yapım bir araca dönüştürür. Küçük başlayın - bugün bir kural ekleyin - ve üretkenliğinizin yükselişini izleyin. İlk kuralınız ne olacak? Yorumlara bırakın!
