Cevabı Laf Kalabalığına Gömmeyen Ajanlar: AI Kodlama Asistanlarında Bilişsel Yükü Sıfırlayan Sistem Kuralları

Terminalinizde veya kod editörünüzde kritik bir hata üzerinde çalışırken yapay zekâ asistanınıza bir soru sorduğunuzda şu senaryoyu muhtemelen yüzlerce kez yaşamışsınızdır: Model cevaba 'Harika bir soru! Auth akışınızı incelediğimde sistemde birkaç hareketli parça olduğunu fark ettim. Hadi bunu seninle adım adım ele alalım...' diyerek başlar. İki paragraf sonra kod parçasını verir ve en alta 'Umarım bu yardımcı olur! Başka bir sorun olursa sormaktan çekinme!' ekler.

Bu durum yalnızca bir üslup sorunu değildir; yazılımcının odaklanma yeteneğine ve çalışma belleğine (working memory) vurulan doğrudan bir darbedir. Kod yazarken zihninizde zaten değişkenleri, fonksiyon akışlarını ve yan etkileri tutuyorsunuzdur. Modelin laf kalabalığı arasında çalıştıracağınız tek satırlık terminal komutunu veya düzeltilecek dosya satırını aramak, 'bilişsel sürtünme' (cognitive friction) yaratır ve akış durumunu (flow state) anında parçalar.

Bilişsel Sürtünmenin 3 Kaynağı

• 1. Giriş ve Çıkış Nezaket Kalıpları: 'Harika bir soru', 'Hemen bakıyorum' veya 'Umarım yardımcı olur' gibi hiçbir bilgi değeri taşımayan dolgu cümleleri.
• 2. Yan Konuların Araya Sızması (Tangent Hijacking): Bir JWT hatasını çözerken modelin aniden 'Bu arada package.json dosyanızdaki şu paket de güncel değilmiş...' diyerek geliştiricinin dikkatini dağıtması.
• 3. Duygusal Hata Dili: 'Eyvah!', 'Üzgünüm bir hata oluştu' gibi yapay duygusal tepkiler yerine hatanın teknik nedenini doğrudan belirtmemek.

Bilişsel Yükü Sıfırlayan 7 'Action-First' Kuralı

İster Cursor'ın .cursorrules dosyası olsun, ister Claude Code'un CLAUDE.md belgesi ya da kendi yazdığınız bir LLM ajanı; asistanlarınızı aşağıdaki 7 temel prensiple kısıtlayarak çıktı kalitesini radikal şekilde artırabilirsiniz:

• Kural 1: İlk Satır Eylem Olmalıdır (Lead With Action): Modelin ürettiği ilk satır kullanıcının hemen uygulayabileceği bir komut, dosya yolu veya kod değişikliği olmalıdır. Açıklama metni gerekiyorsa bu eylemin altına yazılmalıdır.
• Kural 2: Adımları Numaralandırın ve 5 Maddeyle Sınırlayın: Çok adımlı işlerde her madde tek ve bağımsız bir eylemi temsil etmelidir. Bir kerede 5 maddeden fazla bilgi yığmayın.
• Kural 3: Tek Bir Somut Sonraki Adımla Bitirin: Belirsiz vedalar yerine, kullanıcının 2 dakika içinde yapabileceği tek bir net doğrulama adımı verin ('Şimdi: npm test çalıştırın ve ilk hata satırını yapıştırın').
• Kural 4: Yan Konuları Bastırın: Asıl görev tamamlanana kadar ikinci bir problemi veya tavsiyeyi araya sokmayın. Gerekirse ayrı bir görev olarak sıraya alın.
• Kural 5: Durumu Her Turda Netleştirin: Çok adımlı bir planda 'Adım 2/4 tamamlandı: Veritabanı şeması güncellendi. Sırada API ucu var.' şeklinde hafıza tazelemesi yapın.
• Kural 6: Somut Süre Tahminleri Verin: 'Biraz işimiz var' demek yerine 'Mevcut testler kapsıyorsa ~10 dakika, sıfırdan yazılacaksa bir öğleden sonra' gibi ölçülebilir birimler kullanın.
• Kural 7: Hatayı Dramasız ve Felsefesiz Açıklayın: 'Test 42. satırda çöktü: Beklenen 200, gelen 401. Neden: Eksik Bearer token. Çözüm: Başlığa token ekleyin.'

Editörünüze Ekleyebileceğiniz Hazır Sistem Kuralı Şablonu

Aşağıdaki kural bloğunu projenizin kök dizinindeki .cursorrules, CLAUDE.md veya özel ajan sistem prompt'unuza ekleyerek asistanınızın gereksiz laf kalabalığını anında kesebilirsiniz:

# ACTION-FIRST VE BİLİŞSEL YÜK KONTROL KURALLARI

1. Giriş ve Çıkış Nezaket Kalıpları Yasaktır:
   - Yasak Başlangıçlar: "Harika soru", "Hemen bakalım", "Tabii ki", "İncelediğimde..."
   - Yasak Bitişler: "Umarım yardımcı olmuştur", "Başka sorun olursa sorabilirsin"
   - Doğrudan cevabın kendisiyle başla, iş bittiğinde sus.

2. İlk Satır Eylem İçermelidir:
   - İlk satır mutlaka çalıştırılacak terminal komutu, değiştirilecek dosya ve satır numarası veya kod parçası olmalıdır. Açıklama sonraya bırakılmalıdır.

3. Çok Adımlı İşlerde Bounded Adımlar:
   - Adımları 1, 2, 3 şeklinde numaralandır. Her adım tek bir eylem içersin.
   - Listeleri en fazla 5 maddeyle sınırla.

4. Yan Konuları Bastır (No Tangents):
   - Kullanıcının sorduğu ana hata çözülene kadar ikincil eksikleri ("bu paket eski", "kod stilin şurada kötü") gündeme getirme.

5. Hata Bildirimi Formatı:
   - "Hata Satırı: [Dosya:Satır] | Neden: [Kısa Neden] | Çözüm: [Uygulanacak Kod]" formatını koru. Yapay duygusal ifadeler kullanma.

Göndermeden Önce Otomatik Öz-Denetim (Pre-Send Check)

Bu kural setinin en zarif tarafı, modelin kendi çıktısını göndermeden önce iki saniyelik bir filtreye sokabilmesidir: Kullanıcı sadece çıktının İLK satırını ve SON satırını okursa; (a) Az önce ne yapıldığını ve (b) Şimdi ne yapması gerektiğini anlıyor mu? Cevap evet ise çıktı mükemmeldir.

Kaynaklar ve İlgili Bağlantılar