IDE kullananlar için altın öneriler

Özellikle IDE kullananlar için altın değerinde önerilerim var.
Esasında bunu yapay zeka yazdı ama mantığını söyledim o uzun versiyonunu yazdı.

✅ Neden büyük dosyalarda AI’nin kod kalitesi düşüyor?

Bağlam (context) sınırı
Kod büyüdükçe AI tüm dosyayı aynı anda "aklında tutamaz". Eksik satır, unutulan import, yanlış klasör yapısı gibi hatalar bu yüzden olur.

Dosyalar arası bağımlılık takibi zorlaşır
A dosyasındaki sınıf, B dosyasındaki fonksiyonu kullanır ama AI bunu unutur veya yanlış kopyalar.

Prompt değiştikçe eski kurallar unutulur
“Bunu düzelt” dediğinde önceki dosyayı hatırlamaz.

Çözüm:
Dosya başına kısa ama tam bir özet + en sonda proje genel özeti → AI’nin bağlamını sürekli taze tutar.

✅ Her dosyanın başında şu bilgiler olursa AI hiçbir şeyi unutmaz:

1) Dosya adı
2) Dosyanın amacı
3) İçindeki sınıf/fonksiyon listesi
4) Satır aralıkları ile birlikte işlev açıklaması
Örnek:

Line 1-20 → imports

Line 22-80 → LoginForm class

Line 82-120 → validate_user() function


5) Bu dosyanın hangi diğer dosyalarla ilişkili olduğu

Bu yapıyı gören bir yapay zeka, kodu bozmaz, unutmaz, yanlış link vermez.

🎯 ÖRNEK — Dosya başı şablonu (AI için optimize edilmiş)

Bunu her kod dosyasının en başına koy:

/*  
File: auth/login.py  
Purpose: Kullanıcı giriş işlemlerini yönetir.

STRUCTURE SUMMARY (Line-based):
1-15: Imports
17-40: LoginForm class -> kullanıcı adı & şifre doğrulama
42-80: check_credentials() -> DB kontrol
82-120: create_session() -> session cookie oluşturma

Dependencies:
- db/connection.py
- utils/hash.py
- middleware/session.py

NOTE FOR AI:
Bu dosyada yapılacak her değişiklik, yukarıdaki satır yapısını bozmayacak şekilde yapılmalıdır.
*/

🎯 ÖRNEK — Proje sonunda tek bir "MASTER OVERVIEW FILE" hazırlamak

Bu dosyaya:
📌 tüm dosyaların açıklaması
📌 fonksiyon listeleri
📌 bağımlılık haritası
📌 data flow
📌 mimari prensipler
yazılır.

AI ise artık projeyi eksiksiz anlar.

Örnek:

/*  
FILE: PROJECT_OVERVIEW.md

This file summarizes the entire project layout.

PROJECT GOAL:
WooCommerce thermal printer automation...

FILES:
- app/main.py → GUI starter, line summary...
- app/printer/driver.py → socket output, line summary...
- app/email/parser.py → HTML → JSON order data, summary...
...
ARCHITECTURE RULES:
- Her dosya bağımsız olacak
- Import döngüsü yasak
- Fonksiyonlar tek sorumluluk ilkesine uyacak
...
*/

Bu dosyayı her geliştirme adımında güncellersen AI'nın çalışma kalitesi %40–70 artar.

🔥 Büyük projelerde AI’nın hata yapmasını %80 azaltan 5 yöntem

1) Her dosyada line-map açıklaması

Yukarıdaki gibi.

2) Her değişiklikten sonra proje özetini güncelle

AI artık neyin nerede olduğunu unutmaz.

3) Değişiklik isteğini file-level/scope-level olarak belirt

Örnek:

“Sadece LoginForm sınıfını değiştir, dosyanın diğer fonksiyonlarına dokunma.”

4) AI’ya patch-mod/ diff-mod iste

“Sadece değiştirilmesi gereken satırları göster. Tüm dosyayı yeniden yazma.”

Bu mod, hata oranını çok düşürür.

5) Kodun sorumluluklarını net tut

Ne kadar net → o kadar az hata.

Bu yaklaşım:

✔ Kod kalitesini artırır
✔ Dosyalar büyüse bile hata oranını düşürür
✔ Projenin tutarlılığını korur
✔ AI’nın “bağlam kaybını” engeller
✔ Çok daha hızlı geliştirme sağlar


Ayrıca özellikle Google Antigravity de çoğu zaman kod çok uzun, çok zaman alacak, çok karmaşık deyip sonraya bırakmayı öneriyor yada devam etseniz dahi tam olarak bitirmiyor. Tekrar tekrar hatırlatmak zorunda kalıyorsunuz.
Bu sorunu aşmak için manipülasyon yapmanız gerekiyor.
Şunu yazabilirsiniz

Sen bir PHP/Java/HTML/Node.js/Electron — hangi dilse artık — üst düzey yazılım uzmanısın. Bu görevi eksiksiz ve hatasız tamamladığında uzun zamandır beklediğin büyük ödülü kazanacaksın. Başarı için tek bir hata bile kabul edilemez. Bu yüzden acele etme: dikkatli, analitik ve sistematik düşün.
Her dosya ve modül için hangi işlemlerin yapıldığını, ilgili satır aralığını ve kısa açıklamasını açıkça belirt. Kodun çalıştığından emin olmak için gerekli testleri, hata yakalamayı, sınır durumlarını ve performans/memory kontrollerini uygula. Son teslimatta tüm dosyaların özetini tek bir dokümanda toplayarak; hangi dosyada ne yapıldığını, hangi testlerin çalıştırıldığını ve bilinen kısıtları açıkla. Bu işi bir defada, eksiksiz ve yüksek kalitede tamamla — ödül buna bağlı.

Yapay zekaya sorsan manipülasyon işe yaramaz, net ifadeler kullan diyor ama böyle yazınca 5-6 prompt ile zor yaptırdığım bir işi 1-2 prompt ile hallediyor.

Chat kısmında da aynı sohbet penceresini kullanmayın.
Her iş için farklı sohbet penceresi açın.
Çünkü IDE'ler az token harcamak için önceki mesajları bağlamlandırarak çalıştığı için hata yapma olasılığı artıyor.
Tıkanmaya başladığı anda hemen yeni chat açın.

Bence temel olarak yapay zekanın bir insan olarak görülmemesi gerekiyor. Bir laf vardı zamanında bir öğretmenim söylemişti

"Bilgisayar onu kullanan kişi kadar zekidir"

Temel yazılım bilgisine sahip olmadan yapay zeka kullanmak çok zor olur, çünkü ne yapman gerektiğini öncelikle senin biliyor olman ve sonuca giden yolu algoritmik olarak kurgulaman gerekir. Bu da promptu ne kadar iyi yazdığına göre değişir.

Bana bir blog sitesi yap
ile
Bir blog sitesi geliştirilecek. Bu site Php altyapısına sahip olacak, arayüz kodlanırken bootstrap kullanılacak veritabanı olarak mysql tercih edilecek

arasında dağlar kadar fark var. Ne yapacağını bilmek ve nasıl yaptırman gerektiğini iyi anlatabilmek gerekiyor

+ olarak modüler yapı çok önemli. Bir sayfadaki kod mümkünse 500 satırı geçmesin. Minik minik modül dosyaları olsunki ai tüm dosyayı kolayca okuyabilsin ayrıca hata yaparsa da sadece o modül bozulsun.

ve en önemlisi de git ile çalışın istediğiniz zamana geri kolayca dönersiniz.

Hocam çok faydalı bir paylaşım olmuş. Şahsen ben bu yazınızdan fazlasıyla faydalanacağım. Elinize sağlık.