Cursor AI ile Profesyonel Geliştirme: .cursor/rules, Agent Mode ve Gerçek Proje Örnekleri

Önemli Not: Bu yazıdaki teknik bilgiler yazım tarihi itibarıyla geçerlidir. Kullanılan kütüphaneler, API'ler ve servisler zaman içinde değişebilir. Ücretlendirme, yasal düzenleme ve vergi konularında ilgili resmi kaynakları ve uzmanları referans alınız. Bu içerik bilgilendirme amaçlı olup herhangi bir finansal veya hukuki tavsiye niteliği taşımamaktadır.

2026'da "Cursor AI nedir?" sorusunun cevabını bilen Türk geliştirici sayısı giderek artıyor. Ancak araçla verimli çalışmak bambaşka bir şey. Bu yazıda yüzeysel bir tanıtım yapmak yerine doğrudan iş akışına odaklanıyoruz: .cursorrules ile yeni .cursor/rules/ sistemi arasındaki fark, Agent mode'un gerçek yetenekleri, hangi @ referanslarının hâlâ geçerli olduğu ve Türkiye'den satın alma süreci.

Bu projeyi Next.js 16 + Drizzle ORM + Better Auth ile geliştiriyorum ve Cursor'ı günlük olarak kullanıyorum — yazıdaki örnekler gerçek production deneyimine dayanıyor.

---

1. 2026 AI IDE Ekosistemi: Hangi Araç, Ne Zaman?

Piyasadaki seçeneklere kısa bir bakış:

Genel öneri: Cursor, tam codebase anlayışı ve Agent mode gerektiğinde en güçlü seçenek. Windsurf benzer yeteneklerle farklı fiyat stratejisi sunar. Claude Code terminal üzerinden çalışmayı tercih edenler için ideal — üstelik Anthropic Türkiye'yi resmi olarak desteklediğini açıkça belirtiyor.

---

2. Cursor Kurulumu ve Türkiye'den Erişim

İndirme: cursor.com — macOS, Windows ve Linux için mevcut.

Türkiye'den satın alma: Kısıtlama yok. Türk Visa/Mastercard genellikle sorunsuz çalışır. Sorun yaşanırsa Wise sanal kart alternatif. Güncel plan seçenekleri ve fiyatlandırma için cursor.sh adresini ziyaret edin — fiyatlar değişkenlik gösterebilir.

Model seçimi: Pro ve üzeri planlarda Claude Sonnet 4.6, GPT-4o, Claude Opus 4.6 ve diğer frontier modellere erişebiliyorsunuz. Model seçimini Chat panelinden yapabilirsiniz.

---

3. Kural Dosyaları: .cursorrules mi, .cursor/rules/ mi?

Bu konuda Türkçe kaynaklarda sıkça yanlış bilgi görüyorum. Cursor 2.0 ile birlikte kural sistemi değişti, ancak eski yöntem hâlâ çalışıyor.

Eski Yol: .cursorrules (Hâlâ Çalışır)

Proje kökünde tek bir .cursorrules dosyası. Tüm kuralları tek yerde toplar, basit projeler için yeterli.

# .cursorrules örneği
Bu proje Next.js 16 + Drizzle ORM + Better Auth kullanmaktadır.

## Kod Stili
- TypeScript zorunlu, JavaScript kullanma
- Tab girinti (space değil)
- Türkçe UI metinleri, İngilizce kod ve yorumlar
- Biome formatter (ESLint/Prettier değil)

## Mimari Kurallar
- Server Components öncelikli; gereksiz 'use client' ekleme
- Veritabanı işlemleri için Drizzle ORM kullan, ham SQL yazma
- Route Handler'larda her zaman auth kontrolü yap

Yeni Yol: .cursor/rules/ Dizini (Önerilen)

Cursor 2.0+ ile gelen yeni sistem. Her kural ayrı bir .mdc (veya .md) dosyasında saklanır.

.cursor/
└── rules/
    ├── genel-kurallar.mdc
    ├── veritabani.mdc
    ├── ui-bilesenleri.mdc
    └── guvenlik.mdc

Neden bu sistem daha iyi?

• Kurallar modüler — büyük projelerde yönetimi kolaylaşır
• .mdc frontmatter ile her kurala özel davranış tanımlanabilir
• Takım kuralları (Team Rules) proje kurallarının üzerinde çalışır

.mdc Frontmatter Desteği

.mdc dosyalarının gücü frontmatter özelliklerinden geliyor:

Kopyala---
description: Veritabanı sorguları için Drizzle ORM kuralları
alwaysApply: false
globs: **/*.ts, **/*.tsx
---

# Drizzle ORM Kuralları

- Tüm veritabanı işlemlerinde Drizzle ORM kullan
- Raw SQL sadece Drizzle'ın desteklemediği durumlarda
- Her zaman try/catch ile hata yönetimi ekle
- Transaction'larda atomicity'e dikkat et

Frontmatter alanları:

• alwaysApply: true — her promptta kural aktif (genel kurallar için)
• alwaysApply: false — yalnızca ilgili dosyalarda aktif
• globs — hangi dosya tiplerinde uygulanacağı (örn. **/*.tsx)
• description — Cursor'ın kuralı ne zaman aktifleştireceğini anlamak için

Kural hiyerarşisi: Team Rules > Project Rules > User Rules

---

4. Gerçek Proje Örneği: Next.js + PayTR + Drizzle İçin .cursor/rules/

Bu projedeki kural yapısına benzer bir örnek — iki ayrı .mdc dosyası:

Kopyala---
description: Proje geneli geliştirme kuralları — her promptta aktif
alwaysApply: true
---

# Genel Proje Kuralları

## Stack
- Next.js 16 App Router (proxy.ts — middleware değil; params/searchParams await zorunlu)
- React 19.2, TypeScript strict mode
- Tailwind CSS v4 (@theme direktifi, tailwind.config.js yok)
- Drizzle ORM + PostgreSQL (Neon serverless)
- Better Auth (admin: email/şifre, müşteri: magic link)
- Biome (ESLint/Prettier değil)

## Kod Stili
- Tab girinti — space kullanma
- Türkçe UI metinleri (ı, ş, ç, ü, ö, ğ — asla i yerine ı yazma)
- İngilizce teknik terimler ve değişken adları

## Güvenlik
- Server Actions ve Route Handler'larda her zaman auth kontrolü
- Kullanıcı girdisini hiçbir zaman doğrudan SQL'e geçirme
- KVKK: Kişisel veri loglanmaz

Kopyala---
description: Ödeme entegrasyonu kuralları
alwaysApply: false
globs: **/api/paytr/**, **/api/odeme/**
---

# PayTR Entegrasyon Kuralları

- Token oluşturma HER ZAMAN server-side (Route Handler)
- HMAC-SHA256 alanlarını sıra değiştirmeden kullan
- Callback URL her zaman public — auth middleware hariç tut
- Postback yanıtı olarak düz metin "OK" dön (JSON değil)
- payment_amount = TL x 100 (integer)

---

5. Composer, Chat ve Inline Düzenleme: Ne Zaman Hangisi?

Cursor'ın üç farklı etkileşim modu var:

Inline Düzenleme (Cmd+K / Ctrl+K)

• Tek dosyada, cursor'ın bulunduğu yerde hızlı değişiklik
• "Bu fonksiyona error handling ekle" gibi küçük görevler
• En hızlı geri bildirim döngüsü

Chat Paneli (Cmd+L / Ctrl+L)

• Soru-cevap ve açıklama isteklerinde
• Kod bloğunu referans alarak analiz
• Çoklu dosya bağlamı ile sorgu

Composer / Agent Mode (Cmd+I / Ctrl+I)

• Çoklu dosya değişikliği gerektiren görevler
• "Bu özelliği baştan sona yaz" tarzı büyük görevler
• Terminal komutları çalıştırma, test run etme
• Bağımsız çalışma — siz beklerken ilerliyor

---

6. Agent Mode: Gerçek Yetenekler

Cursor 2.6'daki Agent mode, birçok Türkçe içerikte yanlış anlatılıyor. Gerçek yetenekler:

Dosya Operasyonları

• Proje genelinde dosya okuma, yazma, düzenleme, silme
• Yeni dosya ve dizin oluşturma
• Semantik codebase arama (sadece text match değil, anlam bazlı)

Terminal Entegrasyonu

• Terminal komutları çalıştırma ve çıktıyı izleme
• bun install, bunx drizzle-kit push gibi komutları tetikleme
• Build ve test sonuçlarını okuyarak kodu düzeltme

Web Araması

• Güncel dokümantasyon arama (bu artık otonom — eski @Web referansı kaldırıldı)
• Hata mesajını web'de arayarak çözüm bulma

Tarayıcı Kontrolü

• Ekran görüntüsü alarak UI sorunlarını tespit etme
• Localhost'ta çalışan uygulamayı test etme

Checkpoints

Büyük bir Agent görevi başlatmadan önce Cursor otomatik snapshot alır. İşler yanlış giderse tek tıkla geri dönebilirsiniz — git geçmişini kirletmeden.

Pratik örnek: "PayTR Route Handler yazıyorum, HMAC hata veriyor" diyorsunuz. Agent:

1. İlgili dosyaları okur
2. PayTR dokümantasyonunu arar
3. HMAC alanlarının sırasını kontrol eder
4. Düzeltilmiş kodu yazar
5. Build'i çalıştırarak TypeScript hatasını doğrular

---

7. @ Referansları: Ne Kaldı, Ne Kaldırıldı?

Cursor 2.0 sonrasında bazı @ komutları kaldırıldı — agent artık bunları otomatik yapıyor.

Mevcut @ Referansları:

• @dosyaadi.ts — Spesifik dosyayı bağlama ekler
• @src/components/ — Dizini bağlama ekler
• @fonksiyonAdı — Fonksiyon veya sembol tanımı
• @Docs — Eklediğiniz özel dokümantasyonu referans alır
• @Past Chats — Önceki konuşma bağlamına atıfta bulunur
• @my-rule — Proje kuralını manuel olarak çeker

Kaldırılan (Agent Otomatik Yapıyor):

• @Web — Artık yok; agent gerektiğinde otonom web araması yapıyor
• @Git — Kaldırıldı
• @Definitions — Kaldırıldı
• @Linter Errors — Kaldırıldı

Özel Dokümantasyon Eklemek: @Docs

Cursor'a kendi belirlediğiniz bir URL'den dokümantasyon ekliyorsunuz, agent o dökümana @Docs ile atıfta bulunabiliyor:

1. Ayarlar → Features → Docs sekmesini açın
2. URL girin (örn. Drizzle ORM veya Better Auth dokümantasyon URL'si)
3. Cursor sayfayı index'ler
4. Promptta @Docs ile referans verin

Özellikle az bilinen kütüphanelerde (Drizzle, Better Auth, PayTR SDK) çok faydalı.

---

8. MCP Desteği: Cursor 2.6 ile MCP Apps

Cursor 2.6'nın önemli yeniliklerinden biri MCP Apps. MCP (Model Context Protocol), harici araçları ve servisleri Cursor'a bağlamanın standart yolu.

Kurulum — iki yöntem:

1. Ayarlar → MCP panelinden görsel olarak
2. .cursor/mcp.json dosyası oluşturarak

Kopyala{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}

Cursor 2.6'daki MCP Apps yeniliği: Figma, Amplitude, tldraw gibi araçların interaktif UI'ları artık Cursor içinde çalışıyor. Figma dosyasından doğrudan kod üretmek gibi iş akışları mümkün hale geldi.

---

9. Privacy Mode ve Kod Gizliliği

Şirket projeleri veya hassas kod tabanları için önemli bir özellik:

• Ayarlar → General → Privacy Mode: Enabled ile kodunuz Cursor'ın sunucularında saklanmıyor
• Modelin kodu eğitim verisi olarak kullanması engelleniyor
• Teams planında organizasyon genelinde zorunlu hale getirilebilir

KOBİ müşteri projelerinde KVKK kapsamındaki veriler içeriyorsa bu ayarı aktif etmenizi öneririm.

---

10. Cursor vs Diğerleri: Gerçek Kullanım Karşılaştırması

Kişisel görüşüm: Tam gün geliştirme için Cursor'ın codebase anlayışı ve Agent mode gücü öne çıkıyor. Claude Code ise terminal'e yakın çalışmak isteyenler ve mevcut editörlerini bırakmak istemeyenler için ideal.

---

11. Sıkça Sorulan Sorular

.cursorrules ile .cursor/rules/ arasındaki fark nedir?

.cursorrules tek dosyalık eski sistem — hâlâ çalışır. .cursor/rules/ yeni sistem; her kural ayrı .mdc dosyasında, frontmatter ile bağlam kontrolü mümkün. Küçük projeler için .cursorrules yeterli; büyük veya takım projelerinde .cursor/rules/ önerilir.

Türkiye'den Cursor Pro satın alabilir miyim?

Evet, kısıtlama yok. Türk Visa/Mastercard genellikle sorunsuz çalışıyor. Sorun yaşarsanız Wise sanal kart kullanabilirsiniz. Güncel fiyatlar ve planlar için cursor.sh adresini ziyaret edin.

@Web referansı neden çalışmıyor?

Cursor 2.0 sonrasında @Web referansı kaldırıldı. Artık Agent mode gerektiğinde otomatik olarak web araması yapıyor. @Docs referansı ise hâlâ aktif — Ayarlar'dan özel dokümantasyon URL'si ekleyerek kullanabilirsiniz.

Agent mode terminal komutlarını otomatik çalıştırıyor mu?

Evet, ancak her terminal komutu için onay istiyor (ilk kez). "Güvenli komutları otomatik çalıştır" seçeneğini açarsanız bun install gibi zararsız komutlar için onay istemez. Destructive komutlar her zaman onay gerektirir.

Hangi modeli kullanmalıyım, Claude mi GPT-4o mi?

Genel geliştirme görevleri için Claude Sonnet 4.6 dengeli bir seçim — hız, maliyet ve kalite açısından. Karmaşık mimari kararlar ve uzun bağlam gerektiren görevlerde Claude Opus 4.6. Her ikisi de Türkçe içerik üretimi için yeterince iyi performans gösteriyor.

.mdc ve .md dosyaları arasındaki fark ne?

.mdc, Cursor'a özel format — frontmatter (alwaysApply, globs, description) desteği var. .md dosyaları da çalışır ama frontmatter özellikleri olmadan. Yeni projelerde .mdc kullanın.

Cursor'a projemin tüm dosyalarını göstermek güvenli mi?

Privacy Mode aktifse kodunuz sunucularda saklanmıyor. Hassas projeler için Settings → Privacy Mode açın. Çok gizli kimlik bilgileri hiçbir zaman .env dışına çıkmamalı — kural dosyalarına API key yazmayın.

---

Sonuç

Cursor'ı sadece "zekice bir otomatik tamamlama" olarak kullanıyorsanız potansiyelinin küçük bir kısmından faydalanıyorsunuz demektir. Asıl güç, projenizi anlayan bir kural sistemi kurduğunuzda ortaya çıkıyor.

Bu projeyi Next.js 16 + Drizzle ORM + Better Auth ile geliştirirken Cursor'ın en çok değer kattığı anlar şunlar oldu: yeni bir ödeme entegrasyonu yazarken HMAC mantığını doğrulatmak, schema değişikliklerinin tüm type'ları güncellediğini doğrulamak ve özellikle büyük refactor görevlerinde Agent mode ile çoklu dosyayı aynı anda tutarlı tutmak.

Başlangıç için önerim:

1. Projenize .cursor/rules/genel.mdc dosyası ekleyin — stack ve kod stili kurallarıyla
2. Bir hafta boyunca Agent mode'u aktif kullanın
3. Yavaş yavaş domain-spesifik kurallar (ödeme, auth, UI) ekleyin

Cursor hakkında sorunuz varsa veya projeniz için .cursor/rules yapılandırması desteğine ihtiyaç duyuyorsanız iletişime geçin.