1.7 KiB
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.
- 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.
- 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.
- 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.
- İş 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?"