Agentic Kodlama

Ajanla çalışmak, sohbetteki "soruyu sor, cevabı kopyala" düzenine benzemez. Ajana bir iş verirsiniz: dosyaları açar, kodu değiştirir, komutları çalıştırır. Sizin işiniz görevi doğru kurmak ve çıkan sonucu kontrol etmektir.

Ajan döngüsü

Claude Code dokümanı ajanın çalışmasını üç aşamada anlatıyor: bağlam toplar, aksiyon alır, sonucu doğrular. Hedef bitene kadar döngüyü tekrarlar ve her adımda bir öncekinden öğrendiğine göre ne yapacağını seçer.¹ Siz de döngünün içindesiniz, istediğiniz an durdurup yönlendirebilirsiniz.¹

"Sepet toplamı yanlış çıkıyor, düzelt" dediğinizde ajan şöyle ilerler: testleri çalıştırır, hata çıktısını okur, ilgili dosyaları arar, CartSummary.tsx'i düzenler, testleri yeniden çalıştırır.¹ Yani sonucun kalitesi, ajanın kullanabileceği bir kontrole (test, lint, tip kontrolü) bağlıdır. Prompt ve Context Engineering rehberinde buna "bitiş ölçütü" demiştik.

Planla, uygula, test et, commit et

Claude Code'un önerdiği akış dört adım: keşfet, planla, uygula, commit.² Cursor ekibi de aynı yerden başlıyor: yapabileceğiniz en etkili değişiklik, kodlamadan önce planlamak.³

1. Planla

Her iş için plan gerekmez. Claude Code dokümanı pratik bir ölçüt veriyor: değişikliği tek cümleyle anlatabiliyorsanız planı atlayın.²

Shift+Tab ile Plan moduna geçin (iki araçta da aynı kısayol). Ajan dosyalara dokunmadan projeyi okur, gerekirse size soru sorar ve bir plan çıkarır.²³ Planı düzenleyebilirsiniz.

2. Uygula

Planı onaylayıp ajana planı izleyerek kodlatın. Sonuç beklediğiniz gibi çıkmadıysa takip mesajlarıyla düzeltmeye çalışmayın: değişiklikleri geri alın, planı daha net yazın ve yeniden çalıştırın. Cursor bunun çoğu zaman daha hızlı ve daha temiz sonuç verdiğini söylüyor.³

3. Test et

Ajan "bitti" dediğinde kanıt isteyin: test çıktısı, çalıştırdığı komut, ekran görüntüsü. Kanıtı okumak, doğrulamayı baştan yapmaktan hızlıdır.² Testleri önce yazdırmak da iyi çalışıyor (Cursor'ın TDD akışı):³

1. Ajana beklenen girdi-çıktı çiftlerine göre test yazdırın. Henüz olmayan kod için sahte uygulama yazmamasını söyleyin.

2. Testleri çalıştırıp başarısız olduklarını görün. Bu aşamada uygulama kodu yazmasın.

3. Testleri commit edin.

4. Ajandan testlere dokunmadan, hepsi geçene kadar kod yazmasını isteyin.

5. Uygulamayı commit edin.

Frontend'de bu, Vitest ile Component Testi rehberinde yazdığınız component testlerini ajana hedef olarak vermek demektir.

4. Commit et

Küçük ve sık commit atın. Her commit, ajanın bir sonraki hatasında geri dönebileceğiniz bir kayıt noktasıdır. Addy Osmani'nin kuralı net: açıklayamadığınız kodu commit etmeyin.⁴

Claude Code'un checkpoint'leri git'in yerini tutmaz. Yalnızca ajanın dosya düzenleme araçlarıyla yaptığı değişiklikleri kapsar, terminal komutlarıyla yapılanları ve uzak sistemlerdeki işlemleri (deploy, veritabanı) kapsamaz.¹²

Subagent'lar

Subagent, kendi context penceresi olan yardımcı bir ajandır. Ağır işi orada yapar, ana konuşmaya yalnızca özet döner.⁵⁶ Böylece ana konuşmanızın bağlamı şişmez (bkz. Prompt ve Context Engineering).

Örnek: "Projedeki tüm fetch çağrılarına bak, hangilerinde hata yönetimi yok raporla." Ajan onlarca dosya okuyacak. Bunu subagent'a verirseniz o dosyaların içeriği ana konuşmaya girmez, yalnızca "şu dört dosyada eksik" özeti gelir.

Ne zaman subagent, ne zaman ana konuşma?

Hazır olanlar: Claude Code'da salt okunur ve hızlı arama yapan Explore ile plan modunda araştırma yapan Plan kendiliğinden devreye girer. Cursor'da Explore ve tarayıcıyı kontrol edip gürültülü DOM çıktısını özetleyen Browser var.⁵⁶ Bunları ayarlamanız gerekmez.

Kendi subagent'ınızı yazmak: Aynı işi aynı talimatla tekrar tekrar veriyorsanız subagent'ı bir Markdown dosyasına yazın. Claude Code'da .claude/agents/, Cursor'da .cursor/agents/ klasörüne konur (Cursor .claude/agents/ klasörünü de okur).⁵⁶ En önemli alan description: ajan ne zaman devredeceğine bunu okuyarak karar verir.⁵⁶

---
name: a11y-reviewer
description: Değişen bileşenlerde erişilebilirlik sorunlarını inceler. Bir bileşen yazıldıktan veya değiştirildikten sonra kullan.
tools: Read, Grep, Glob
---

Sen erişilebilirlik konusunda titiz bir frontend geliştiricisin.
Değişen bileşenlerde şunlara bak: etiketsiz form alanları, `alt` metni
olmayan görseller, klavyeyle erişilemeyen etkileşimler, yetersiz kontrast.
Dosyalara yazma, bulduklarını dosya ve satır numarasıyla raporla.

Claude Code'da tools ile araçları kısıtlarsınız. Cursor'da karşılığı readonly: true.⁵⁶

Paralel çalışma: Birden çok ajan aynı klasörde çalışırsa birbirinin dosyasını ezer. Her ajanı kendi git worktree'sinde çalıştırın. Cursor worktree'leri kendisi yönetir, Claude Code'da ayrı oturumları worktree'lerde açarsınız.²³⁶

Maliyet: Her subagent kendi token'ını harcar. Cursor'a göre beş subagent'ı paralel çalıştırmak, kabaca tek ajanın beş katı token demek. Bağlam izolasyonu hız değil düzen sağlar: basit işte ana ajan daha hızlıdır.⁶ İki-üç odaklı subagent'la başlayın, "yardımcı" diye onlarca genel subagent açmayın.⁶ Claude Code'da subagent açıklamaları da bağlamdan yer kaplar.⁵

Kendin dene

1. Birkaç dosyaya dokunan küçük bir özellik seçin (örneğin ürün listesine fiyat sıralaması). Plan modunda isteyin, planı okuyun, bir adımı silip ya da ekleyip uygulatın.

2. Aynı özellik için önce testleri yazdırın, başarısız olduklarını görün, sonra geçene kadar kod yazdırın. Kaç tur sürdüğünü not edin.

3. Bir subagent'a "bu değişiklikte erişilebilirlik sorunu var mı, yalnızca raporla" dedirtin. Claude Code'daysanız /context ile ana konuşmanın bağlamının ne kadar değiştiğine bakın.