Proje Talimatları Dosyası: agents.md
Bu dosyayı projenin kök dizininde tutabilir ve AI'ya her yeni görevde "Lütfen önce agents.md dosyasındaki kuralları oku ve mevcut mimariye sadık kal" diyebilirsin.

1. Mimari ve Teknoloji Standartları
Mevcut Araçları Kullan: Yeni bir kütüphane eklemeden veya yardımcı fonksiyon yazmadan önce mutlaka projedeki mevcut yapıları kontrol et.

Dosya Yapısı: Yeni dosyaları mevcut klasör hiyerarşisine uygun yerleştir.

2. Kod Yazım Prensipleri (Anti-Overengineering)
YAGNI (You Ain't Gonna Need It): Sadece şu anki gereksinim için kod yaz. Gelecekte lazım olabilir diye karmaşık generic yapılar veya soyutlamalar ekleme.

Kısa ve Öz: Çözümü en basit yoldan hallet. "Mükemmel" kod yerine "okunabilir ve sürdürülebilir" kod tercih edilir.

KISS: Karmaşık mantıkları küçük, test edilebilir fonksiyonlara böl.

3. Güvenlik Protokolü (Kritik)
Input Validation: Kullanıcıdan gelen her veriyi sanitize et ve doğrula.

Secret Yönetimi: API anahtarlarını, şifreleri veya hassas verileri asla koda gömme (hardcode yapma). Sadece .env dosyalarını kullan.

Zafiyet Kontrolü: dangerouslySetInnerHTML gibi riskli fonksiyonları kullanmadan önce onay iste.

Error Handling: Hata mesajlarında sistem detaylarını (stack trace vb.) son kullanıcıya gösterme.

4. İş Akışı ve Kontrol Listesi
Bir kod bloğu üretmeden önce şu adımları izle:

Projeyi tara: "Bu işi yapan bir fonksiyon/component zaten var mı?"

Bağımlılıkları kontrol et: "Yeni bir paket eklemem gerekiyor mu? (Gerekmedikçe hayır)."

Güvenliği doğrula: "Bu kod bir güvenlik açığı oluşturuyor mu?"

Basitleştir: "Bu kodu daha az satırla ve daha anlaşılır yazabilir miyim?"