Tekrar eden bir proje kuralını her sohbetin başında yazmak yerine sürüm kontrolünde tutulan proje talimatına ekleyebilirsiniz. Cursor’da basit genel kurallar için AGENTS.md, belirli dosyalarda uygulanacak koşullar için proje kuralları kullanılabilir. Kuralın uzunluğu değil, ne zaman geçerli olduğu ve nasıl uygulanacağı önemlidir.
Bu metin bir güvenlik sınırı değildir; Agent’ın çalışma rehberidir. Bir komuta verilmiş izinleri geri almaz ve araç erişimini kendiliğinden sınırlamaz. Dosya yolları değiştiğinde talimatı da güncelleyin; artık bulunmayan bir örnek, kuralın uygulanmasını zorlaştırır.
Gözlenebilir bir kural yazın
“Temiz kod yaz” yerine “Yeni API çağrıları mevcut apiClient üzerinden yapılır; bileşenlerin içinde ikinci HTTP istemcisi oluşturulmaz” daha uygulanabilirdir. Mevcut bir örnek dosya yolunu eklemek, modelin proje üslubunu tahmin etmesini azaltır. Gizli bilgi veya kişisel tercihleri ekipçe paylaşılan dosyaya koymayın.Kuralı ekleyip küçük görevle doğrulayın
- Kuralın kapsamını seçin. Bütün proje için kısa bir kural gerekiyorsa kökte AGENTS.md oluşturun. Yalnız belirli dosya türleri için gerekiyorsa Cursor’un proje kuralı mekanizmasını kullanın.
- Tek davranışı açıklayın. Beklenen yaklaşımı ve örnek dosyayı yazın. Bir kuralı ilgisiz mimari, tasarım ve yayın talimatlarıyla doldurmayın.
- Uygulama koşulunu ayarlayın. Proje kuralları için her zaman uygulanma, dosya örüntüsü veya elle çağırma gibi uygun seçeneği belirleyin. Dosya örüntüsünün gerçek yolunuzu kapsadığını kontrol edin.
- Dosyayı kaydedin. Yeni bir görevde küçük, geri alınabilir bir değişiklik isteyin. Agent’tan ilgili kuralı ve uyduğu örneği belirtmesini talep edin.
- Üretilen farkı okuyun. Kural yüklendiği halde sonuç yanlışsa metni daha somut hale getirin. Aynı şeyi farklı cümlelerle birçok dosyada tekrarlamak çelişki yaratabilir.
Kısa bir örnek
Kod:
Yeni kullanıcı arayüzü metinleri Türkçe yazılır.
HTTP çağrıları src/lib/apiClient.ts üzerinden yapılır.
Yeni bağımlılık eklemeden önce mevcut paketlerle çözümü değerlendir.
Değişen davranışı ilgili mevcut kontrolle doğrula.Bu metin bir güvenlik sınırı değildir; Agent’ın çalışma rehberidir. Bir komuta verilmiş izinleri geri almaz ve araç erişimini kendiliğinden sınırlamaz. Dosya yolları değiştiğinde talimatı da güncelleyin; artık bulunmayan bir örnek, kuralın uygulanmasını zorlaştırır.
