İçeriğe geç
~/gamze_
cd ../blog

> cat ./blog/cursori-verimli-kullanmak.md

Cursor’ı Verimli Kullanmak

·3 dk okuma

#Yapay Zeka#Cursor

Cursor, VS Code tabanlı bir editör ve ajan doğrudan içinde yaşıyor. Terminal araçlarındaki CLAUDE.md ve AGENTS.md mantığı burada "kurallar" (rules) olarak karşımıza çıkıyor. Bu yazıda kuralları, @ ile bağlam vermeyi ve iş akışını anlatıyorum.

Kurallar: Ajan için kalıcı talimat

Dokümana göre büyük dil modelleri çağrılar arasında hafıza tutmaz. Kurallar bu boşluğu doldurur: uygulandıklarında içerikleri model bağlamının başına eklenir. Cursor dört tür kural sunuyor:

  • Proje kuralları: .cursor/rules altında, sürüm kontrolünde, koduna özel
  • Kullanıcı kuralları: Tüm projelerinde geçerli tercihler
  • Takım kuralları: Yönetim panelinden yönetilen, Team ve Enterprise planlarına özel
  • AGENTS.md: Basit, düz markdown alternatifi

Proje kuralları .mdc uzantılı olmalı. Düz .md dosyaları bu klasörde görmezden gelinir, çünkü açıklama ve glob bilgisi taşıyan başlık alanı yoktur.

Kural türleri ve örnekleri

Başlıktaki üç alan (description, globs, alwaysApply) kuralın ne zaman devreye gireceğini belirler.

Her zaman uygulanan kural:

---
alwaysApply: true
---

- `dist/` ve `build/` klasörlerindeki dosyalara dokunma
- Uygulama detayından emin değilsen, öneri yapmadan önce ilgili kaynak dosyaları oku

Belirli dosyalara otomatik eklenen kural:

---
globs: src/components/**/*.tsx
alwaysApply: false
---

- Varsayılan dışa aktarma yerine adlandırılmış dışa aktarma kullan
- Bileşeni 200 satırın altında tut, büyürse alt bileşene ayır
- Prop'ları katmanlar arasında taşımak yerine composition tercih et

Ajanın kendi karar verdiği kural:

---
description: Backend RPC servis kuralları ve kalıpları
alwaysApply: false
---

- Her servisi `src/services/` altında kendi dosyasına yaz
- Girdileri servis sınırında doğrula
- Hataları `code` ve `message` alanlı yapıyla döndür, ham string fırlatma

Sadece elle çağırdığın kural: Başlıkta alwaysApply: false bırakıp description ve globs vermezsen, kural yalnızca sohbette @kural-adi ile çağırdığında devreye girer.

Glob örnekleri: **/*.ts tüm .ts dosyalarını, src/** src altındaki her şeyi, birden çok desen için virgülle ayırıp docs/**/*.md, docs/**/*.mdx yazarsın.

Kural nasıl oluşturulur?

Sohbette /create-rule yazıp ne istediğini anlatırsan ajan başlık alanlarıyla birlikte dosyayı .cursor/rules altına yazar. Ya da kenar çubuğundan Customize bölümüne gidip Rules altında Add Rule seçebilirsin.

Dokümandaki tavsiyeler işine yarar:

  • Kuralları 500 satırın altında tut
  • Büyük kuralları bölüp birleştirilebilir parçalara ayır
  • Kodu kopyalamak yerine dosyaya referans ver
  • Kural yazmaya tekrarlanan hatalardan sonra başla, baştan mükemmelleştirmeye çalışma

Neyi yazmaman gerektiği de belirtilmiş: tüm stil kılavuzunu yapıştırmak yerine linter kullan, git ve npm gibi yaygın araçları anlatma, nadir uç durumlar için kural yazma.

AGENTS.md alternatifi

Yapılandırma yükü istemiyorsan proje köküne düz bir AGENTS.md koyabilirsin. Alt klasörlerde de destekleniyor ve daha spesifik olan öncelik kazanıyor:

## Kod stili
- Yeni dosyalar için TypeScript kullan
- React'te fonksiyonel bileşen tercih et

## Mimari
- Repository desenini uygula
- İş mantığını servis katmanında tut

Bu dosya Codex ile de uyumlu olduğu için, iki aracı birlikte kullanıyorsan talimatları tek yerde tutabilirsin. Ek olarak Claude Code’daki /import cursor komutu, Cursor yapılandırmanı Claude Code'a taşımana yardım ediyor (v2.1.265 ve üstü).

@ ile bağlam vermek

Sohbette @dosya.ts yazarak o dosyayı bağlama eklersin. Kuralların içinde de aynı sözdizimiyle şablon dosyalara referans verebilirsin:

Yeni Express servisi oluştururken bu şablonu kullan:

- RESTful ilkelere uy
- Hata yönetimi middleware'i ekle

@express-service-template.ts

Bu yöntem, şablonu kuralın içine kopyalamaktan çok daha iyi: kod değiştikçe kural eskimiyor.

Doğru araç, doğru iş

  • Cmd/Ctrl+K (satır içi düzenleme): Küçük ve yerel değişiklikler. Kullanıcı kuralları burada uygulanmaz, yalnızca ajan sohbetinde.
  • Ajan sohbeti: Çok dosyalı değişiklikler. Planlama modu (Plan Mode) ile önce plan çıkarttırmak büyük işlerde güven verir.
  • Cursor Tab: Otomatik tamamlama. Kurallar bunu etkilemez.

Dokümantasyonun Customize bölümünde ayrıca skill’ler, alt ajanlar (subagents), hook’lar ve MCP de var. Bunlar Claude Code’daki karşılıklarına benzer işler görüyor.

Sık yapılan hatalar

  1. Kural .md uzantısıyla kaydetmek. .cursor/rules içinde .mdc olmalı.
  2. description yazmadan "akıllı uygula" beklemek. Ajanın kararı açıklamaya bakıyor. Yoksa kural devreye girmez.
  3. Glob’u yanlış yazmak. Kural uygulanmıyorsa desen dosyanı gerçekten eşliyor mu diye kontrol et.
  4. Kuralı şişirmek. Kısa ve odaklı tut, örnek dosyaya referans ver.

Bu yazı ilk olarak Medium'da yayımlandı. Yorum ve alkış için:

Medium'da aç