Kodlama ajanlarıyla (Cursor, Claude Code vb.) her gün çalışıyorum. Çıktı kalitesindeki en büyük fark model seçiminden çok önce oluşuyor: görevi yazdığınız beş dakikada.
İlk denemede başarılı bir ajan görevinin dört parçası var:
1) Bağlam. Ajan kodu görür ama neden öyle göründüğünü bilmez. Değişikliğin neden gerekli olduğunu bir cümleyle yazın; sorun tek dosyadaysa adıyla belirtin.
2) Bitti tanımı. "Formu düzelt" ucu açık bir görevdir. "Form kaydediyor, boş alanda hata gösteriyor, mevcut testler geçiyor" kontrol edilebilir bir görevdir.
3) Sınırlar. Hangi klasöre dokunabilir, mevcut API'yi değiştirebilir mi, bağımlılık yükseltebilir mi — bunları baştan yazın, çıktıdan sonra pazarlık konusu olmasın.
4) Doğrulama. Hangi komut testleri çalıştırıyor, beklenen sonuç ne — ajan teslim etmeden önce kendini kontrol etsin, siz hisse değil kanıta bakın.
Dört satırlık tam örnek: "checkout.ts'de hata var: submit'e çift tıklama iki sipariş oluşturuyor. Bitti = çift tıklama tek sipariş, tüm testler geçiyor. Sınırlar = yalnızca checkout.ts ve testleri, bağımlılık yükseltme yok. Doğrulama = npm test checkout."
Beş dakikalık yazım, iki-üç tur on beşer dakikalık düzeltme döngüsünü ortadan kaldırıyor.
Konunun tam rehberi (İngilizce, SSS bölümüyle): https://ofershap.github.io/en/posts/agent-task-spec-first-try/