YZ İle Kodlama Yaparken Altın Kurallar

1. Tek Seferde Devasa Kod İstemeyin (Modüler Yaklaşım)

Kodları modül modül (Arayüz > Mantık > Test) şeklinde isteyin.

Tüm projeyi tek bir prompt ile üretmeye çalışmak; yapay zekanın eksik kod yazmasına (// geri kalanı buraya gelecek gibi kestirmeler kullanmasına), mantık hataları yapmasına ve bağlamı kaçırmasına neden olur.

• Proje Mimarisi: Önce dosya/klasör yapısını isteyin.
• Adım Adım İlerleyin: Sırasıyla Veri Modelleri (Schemas) > İş Mantığı (Business Logic) > API Rotaları > Testler şeklinde modül modül ilerleyin.

2. Bağlamı (Context) ve Referansları Koruyun

Sohbet geçmişinde daha önce yazdığı fonksiyon adlarını referans göstererek devam edin. Sohbet uzadıkça yapay zeka önceki yanıtları unutabilir veya değişken adlarını değiştirebilir.

• İsim Birliği: “Daha önce oluşturduğumuz UserSchema modelini kullanarak…” veya “services.py içerisindeki convert() fonksiyonuna referansla…” gibi açık yönlendirmeler yapın.
• Geçmişi Hatırlatın: Çok uzayan sohbetlerde, kritik kod parçalarını tekrar kopyalayıp “Şu an elimizdeki servis katmanı bu, buna yeni bir metod ekleyelim” diyerek bağlamı tazeleyin.

3. Kütüphane ve Dil Sürümlerini Açıkça Belirtin

Örneğin, “Pydantic v2 ve FastAPI 0.100+ uyumlu olsun” gibi spesifik versiyonlar verin.

Yapay zeka modelleri eğitildiği veriye göre eski sürümlere ait (deprecated) metodlar veya sözdizimleri kullanabilir.

• Versiyon Vurgusu: “Pydantic v2 ve FastAPI 0.100+ uyumlu olsun”, “Python 3.11+ async/await yapısını kullan” gibi spesifik teknik sınırlar koyun.
• Kritik Güncellemeler: Son yıllarda büyük breaking change (kırılma) yaşayan kütüphanelerde (örneğin LangChain, OpenAI SDK, Pydantic) sürüm belirtmek hatalı kod almayı %80 engeller.

4. Mocking ve İzolasyon Kullanın (Test ve Güvenlik)

Test yazdırırken dış bağımlılıkları (veritabanı, dış API’ler) her zaman mock’latın.

Yapay zekaya unit test (birim testi) yazdırırken dış sistemlerle olan bağımlılıkları koparmasını kesinlikle tembihleyin.

• Dış Bağlantıları Simüle Edin: Veritabanı sorguları, dış REST API çağrıları veya dosya sistemi işlemlerini unittest.mock veya pytest-mock kullanarak sahte veriyle (mock) ikame edin.
• Güvenli Test Deneyimi: Bu sayede testleriniz internete ihtiyaç duymadan milisaniyeler içinde çalışır ve test sırasında canlı veritabanı veya ücretli API kotalarınız tüketilmez.

5. Kod Güvenliği ve “Sanitize” İstemlerini İhmal Etmeyin

YZ üretimi kodlar çalışsa bile güvenlik açıkları (SQL Injection, hardcoded API anahtarları, yetersiz yetkilendirme) barındırabilir.

• Kod bloklarını aldıktan sonra: “Bu koda güvenlik riski oluşturabilecek hardcoded secret/token var mı?” veya “Input sanitization (girdi temizleme) adımları yeterli mi?” kontrolü yaptırın.

6. Kodu Asla İncelemeden Canlıya Almayın

Yapay zeka sizin “Eşleşmeli Programcınızdır” (Pair Programmer), yerinize geçen yazılımcı değil. Üretilen her satır kodu okuyup anlamak ve projenizin standartlarına uygunluğunu doğrulamak sizin sorumluluğunuzdadır.