Cursor AI ve Claude 3.5 Sonnet ile Sıfırdan Mikro SaaS Geliştirme Rehberi

Yazılım geliştirme ekosistemi, geleneksel kodlama alışkanlıklarını kökten değiştiren bir dönüşümün tam ortasında yer alıyor. Birkaç yıl öncesine kadar fikir aşamasından üretim aşamasına (production) geçmek aylar sürerken, günümüzde Cursor AI ve Claude 3.5 Sonnet kombinasyonu sayesinde tek bir geliştirici, sadece birkaç gün içinde çalışan bir Mikro SaaS (Yazılım Servisi) ürünü inşa edebiliyor.

Ancak yapay zeka araçlarıyla kod yazmak, sadece bir sohbet penceresine "bana bir SaaS projesi yap" demekten ibaret değildir. Proje büyüdükçe ortaya çıkan bağlam (context) kayıpları, çelişen kod blokları ve yanlış mimari kararlar, süreci bir çıkmaza sokabilir. Bu rehber, hayali senaryolardan uzak, Cursor'ın gelişmiş yeteneklerini ve Claude'un mantıksal akıl yürütme gücünü birleştirerek sıfırdan ölçeklenebilir bir Mikro SaaS geliştirmenin teknik adımlarını ve mimari metodolojisini ele almaktadır.

📐 Adım 1: Temel Mimari ve Kuralları Belirlemek (.cursorrules)

Yapay zeka modellerinin en büyük zafiyeti, projenin başındaki kararları ilerleyen aşamalarda unutmaya meyilli olmalarıdır. Claude 3.5 Sonnet'in projenizin dosya yapısına, kodlama standartlarına ve veri tabanı ilişkilerine sadık kalmasını sağlamak için projenin kök dizinine (root) bir .cursorrules dosyası eklemek zorunludur.

Cursor, bu dosyayı projenin "pasaportu" olarak kabul eder ve her kod üretme (Cmd+K / Composer) aşamasında bu kuralları arka planda prompt bağlamına dahil eder. Mikro SaaS projeleri için ideal bir .cursorrules şeması şu şekilde yapılandırılmalıdır:

# Micro SaaS Project Rules

## Tech Stack
- Frontend: Next.js 15 (App Router), Tailwind CSS, Shadcn UI
- Backend: Supabase (Auth, Database, Edge Functions)
- Payments: Stripe API

## Code Style & Architecture
- Use TypeScript for all files. Ensure strict type checking.
- Keep components modular and strictly separation of concerns.
- Always use server components for data fetching, client components only for user interactions.
- Never delete existing functions during refactoring unless explicitly requested.

## Error Handling
- Wrap all async operations in try-catch blocks with clean user-facing error logs.

⚡ Adım 2: Codebase Indexing ve Doğru Bağlam Yönetimi

Cursor'ı standart bir yapay zeka sohbetinden ayıran en önemli özellik, projenin tamamını anlamsal olarak tarayabilmesidir (Full Codebase Awareness). Projeye başlarken Cursor Ayarları (Settings > AI > Codebase Indexing) altından indekslemenin açık olduğundan emin olunmalıdır.

Kod yazdırırken veya hata ayıklarken Cursor'a bağlamı doğru beslemek için şu kısayol ve sembol hiyerarşisi disiplinli bir şekilde kullanılmalıdır:

• @Files: Sadece üzerinde değişiklik yapılacak spesifik dosyayı modele gösterir. Token tasarrufu sağlar ve modelin dağılmasını engeller.
• @Codebase: Projenin tamamını tarayarak, yeni yazılacak bir özelliğin mevcut veri tabanı şemasıyla veya diğer servislerle nasıl entegre olması gerektiğini analiz eder. "X özelliğini projeye nasıl eklerim?" gibi makro sorularda kullanılır.
• @Folders: Sadece belirli bir dizini (Örn: /src/app/api) referans göstererek yapay zekanın sadece o dikeydeki mantığı okumasını sağlar.

🛠️ Adım 3: Composer Modu ile Çoklu Dosya Yönetimi (Feature Engineering)

Geleneksel yapay zeka asistanları tek seferde yalnızca bir dosyanın kodunu üretirken, Cursor bünyesindeki Composer (Cmd+I) arayüzü, Claude 3.5 Sonnet'in tek bir komutla birden fazla dosyayı eş zamanlı olarak oluşturmasına veya revize etmesine olanak tanır.

Bir Mikro SaaS projesinde "Kullanıcı Profil Sayfası ve Veri Tabanı Bağlantısı" gibi uçtan uca bir özellik ekleneceği zaman, Composer modunda süreç şu şekilde işletilmelidir:

1. Supabase veya PostgreSQL üzerindeki ham tablo şeması SQL kodu olarak kopyalanır.
2. Composer penceresi açılarak modelden özellik talep edilir: "Ekteki SQL şemasını kullanarak, kullanıcıların profillerini güncelleyebileceği bir client component, bunu işleyecek Next.js API rotasını ve gerekli TypeScript arayüzlerini tek seferde oluştur."
3. Claude 3.5 Sonnet, bağımlılıkları analiz ederek /types, /api ve /components klasörleri altında birbiriyle uyumlu dosyaları aynı anda oluşturur.

🐛 Adım 4: Terminal Entegrasyonu ve Otonom Hata Ayıklama (Debugging)

SaaS projelerinde en sık karşılaşılan kriz, yapay zekanın yazdığı kodun terminalde veya tarayıcı konsolunda hata (runtime error) vermesidir. Kodu kopyalayıp tekrar chat penceresine yapıştırmak yerine Cursor'ın terminal entegrasyonu kullanılmalıdır.

Terminalde bir derleme (build) veya çalışma hatası alındığında, terminal satırının hemen yanında beliren "Debug with AI" butonuna tıklandığında süreç otonomlaşır:

// Örnek bir Tip Uyuşmazlığı Hatası Alındığında:
Type 'string | null' is not assignable to type 'string'.
[Cursor AI Terminal üzerinden doğrudan ilgili dosyayı @Files ile bağlama alır ve düzeltilmiş temiz kodu satır içi inline (Cmd+K) olarak mevcut koda enjekte eder.]

📊 Gerçek Deneyimlerden Çıkarılan Altın Kurallar

Gerçek üretim ortamlarında (production) yapılan testler ve Mikro SaaS projelerinin geliştirilme süreçleri, yapay zeka ile çalışırken şu teknik gerçekleri doğrulamıştır:

• Mimari Kararları Sorumluluğunuzdadır: Claude 3.5 Sonnet, talep ettiğiniz her sistemi yazar; ancak sistemin ölçeklenebilirliğini sorgulamaz. Örneğin, anlık veri takibi gereken bir özellik için modele REST API mimarisi kurgulatırsanız model bunu yapar ancak sistem 100 kullanıcıda çöker. WebSockets veya CRDT gibi temel mimari altyapı kararlarını geliştiri olarak sizin vermeniz ve modeli bu yönde manipüle etmeniz gerekir.
• Sık Sık Git Commit Alın: Yapay zeka ajanları bazen bir hatayı düzeltmeye çalışırken çalışan diğer 3 fonksiyonu bozabilir (regresyon hatası). Her başarılı özellik eklemesinden sonra küçük Git commit'leri atmak, modelin geri dönülemez hasarlar vermesini engeller.
• Bağlam Penceresini Temizleyin (Context Reset): Saatlerce süren tek bir sohbet oturumu, bir süre sonra token sınırına ulaşır ve Claude eski mesajları unutarak saçmalamaya başlar. Tamamlanan her özellikten sonra yeni bir sohbet (New Chat) açarak sadece ilgili dosyaları @Files ile dahil etmek kod kalitesini maksimumda tutar.

🗒️ Sonuç

Cursor AI ve Claude 3.5 Sonnet, kod yazma ameleliğini ortadan kaldırarak yazılımcıyı bir "kod yazıcısı" konumundan, sistemleri yöneten bir "yazılım mimarı" konumuna yükseltmektedir. Projenin başında kuralları doğru koymak, dosya bağlamlarını (context) sıkı denetlemek ve mimari kararlarda ipleri elden bırakmamak, sıfırdan çalışan ve fatura kesebilen bir Mikro SaaS projesini günlerce süren kısa bir zaman diliminde yayına almanın tek geçerli yoludur.