Selamlar geliştirici dostlar ve teknoloji meraklıları,
Bir başkasının (veya aylar önceki kendinizin) yazdığı devasa bir kod deposuna (repository) ilk kez girdiğiniz o anı bilirsiniz. Yüzlerce bileşen, iç içe geçmiş klasörler, karmaşık veritabanı sorguları ve hiçbir yerde bulunamayan dokümantasyonlar… Hele bir de modern bir Next.js mimarisiyle veya ağır bir PHP/MySQL arka planıyla uğraşıyorsanız, işin içinden çıkmak günlerinizi alabilir.
2026′da Gemini 1.5 Pro’nun devasa bağlam penceresi sayesinde artık tüm bir GitHub reposunu tek seferde modele yükleyip analiz ettirebiliyoruz. Ancak modeli sadece bir arama motoru gibi kullanmak, bu gücü israf etmektir. Asıl marifet, o devasa veri yığınından mantıklı, yapılandırılmış ve işe yarar içgörüler çekip çıkarmakta yatıyor.
İşte karmaşık mimarileri dakikalar içinde haritalandıran, refactor süreçlerini hızlandıran ve “bu kod ne işe yarıyor” derdini bitiren 10 ileri seviye Gemini 1.5 Pro promptu.
—
💻 Karmaşık Repolar İçin 10 Analiz Promptu
1. Mimari Haritalandırma (Kuş Bakışı Görünüm)
“Yüklediğim bu kod deposunun genel sistem mimarisini analiz et. Front-end ve back-end bileşenlerinin birbirleriyle nasıl iletişim kurduğunu, veri akış yönünü ve temel katmanları (örneğin routing, state management, veritabanı bağlantıları) basit bir hiyerarşik yapı olarak çıkar. Uygulamanın bel kemiğini oluşturan en kritik 5 dosyayı ve neden önemli olduklarını açıkla.”
2. Yeni Geliştirici İçin ‘Onboarding’ Rehberi
“Bu projeye bugün dahil olan kıdemli bir yazılım geliştiriciyim. Projenin yerel ortamda (localhost) nasıl ayağa kaldırılacağını, bağımlılıkların (dependencies) neler olduğunu ve dizin yapısının mantığını anlatan kapsamlı ama gereksiz detaylardan arındırılmış bir ‘Onboarding.md’ dosyası oluştur. En sık karşılaşılabilecek 3 potansiyel derleme/kurulum hatasını da çözüm önerileriyle ekle.”
3. Veritabanı Şeması ve İlişki Çıkarımı
“Depodaki modelleri, migration dosyalarını ve SQL sorgularını incele. Veritabanının genel şemasını (schema) tersine mühendislik yaparak çıkar. Tablolar arasındaki ilişkileri (One-to-Many, Many-to-Many vb.) belirle. Hangi tabloların sistemin merkezinde olduğunu ve olası bir performans darboğazı (bottleneck) yaratabilecek eksik indekslemeleri (index) tespit et.”
4. Legacy Code (Eski Kod) Modernizasyon Planı
“Bu kod tabanında modern standartların (2026 pratikleri) gerisinde kalmış, okunabilirliği düşük veya ‘spagetti koda’ dönüşmüş bileşenleri tespit et. Özellikle güvenlik açığı yaratabilecek eski fonksiyonları listele. Bu yapıyı daha modern, modüler ve temiz (clean code) bir mimariye taşımak için bana adım adım bir refactoring yol haritası sun.”
5. Güvenlik ve Zafiyet Taraması
“Bir siber güvenlik analisti şapkası tak. Bu repoda XSS, SQL Injection, CSRF veya yetkilendirme (authorization) eksiklikleri gibi potansiyel güvenlik zafiyetlerini ara. API uç noktalarında (endpoints) açıkta kalmış hassas veriler veya çevre değişkeni (env) sızıntıları olup olmadığını kontrol et. Bulduğun riskleri kritiklik derecesine göre (Düşük/Orta/Yüksek) sınıflandır.”
6. Bileşen (Component) Bağımlılık Analizi
“Özellikle arayüz tarafındaki (UI) bileşenlerin birbirleriyle olan bağımlılıklarını analiz et. Hangi bileşenler gereğinden fazla state (durum) taşıyor? Hangi bileşenler yeniden kullanılabilir (reusable) hale getirilebilir? Vercel stili temiz bir UI/UX yapısına ulaşmak için parçalanması gereken devasa, hantal (monolitik) bileşenleri bana göster.”
7. API Uç Noktası (Endpoint) Haritası
“Arka uç (backend) kodlarını tarayarak projede tanımlı tüm API uç noktalarını bul. Bunları bir RESTful dokümantasyonu formatında (HTTP Metodu, Endpoint URL’i, Beklenen Parametreler, Dönen Yanıt Formatı) listele. Yetkilendirme gerektiren ve gerektirmeyen istekleri birbirinden net bir şekilde ayır.”
8. Mantıksal Hata (Bug) Avcılığı ve Debugging
“Kullanıcı kayıt işlemi veya veri kaydetme aşamasında sistemin sessizce hata verdiği veya yanlış veritabanı kaydı oluşturduğu potansiyel senaryoları simüle et. Hata yönetimi (error handling) eksik olan try-catch bloklarını veya asenkron işlemlerde (async/await) yaşanabilecek ‘race condition’ sorunlarını tespit edip bana satır numaralarıyla bildir.”
9. Eksik Birim Testi (Unit Test) Üretimi
“Projedeki en kritik iş mantığını (business logic) barındıran fonksiyonları belirle. Bu fonksiyonlar için yazılmış testleri kontrol et. Eğer test kapsamı (coverage) düşükse, eksik olan senaryolar (edge cases) için modern test kütüphanelerine (örn: Jest, PHPUnit) uygun, çalışmaya hazır test blokları yaz.”
10. Performans ve Yük Optimizasyonu
“Sistemin genel kod yapısını performans açısından değerlendir. Döngüler içindeki gereksiz veritabanı sorguları (N+1 problemi), gereksiz yere render edilen arayüz bileşenleri veya bellek sızıntısına (memory leak) yol açabilecek kötü pratikleri bul. Uygulamanın hızını artırmak için uygulanabilecek en etkili 3 kodlama pratiğini öner.”
—
💡 Analiz Sırasında Dikkat Edilmesi Gerekenler
Bütün bir projeyi yapay zekaya emanet etmek kulağa hoş gelse de, Gemini’nin sunduğu bu analizleri doğrudan “kesin doğru” olarak kabul etmeyin. Bazen değişken isimlerinden yola çıkarak yanlış mantıksal bağlantılar kurabiliyor.
Modelden gelen çıktıları her zaman projenin bağlamına göre kendi manuel filtrelerinizden geçirin. Promptların gücü size kod yazmaktan çok, kodu “anlama” ve strateji geliştirme aşamasında zaman kazandırmasıdır.
Kodsuz kalmayın, mimariniz her daim sağlam olsun.
