Ö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.