34 lines
1.7 KiB
Markdown
34 lines
1.7 KiB
Markdown
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?" |