Paralel ajanlar

Ajan bir özellik üzerinde çalışırken onu izlemek zorunda değilsiniz. Aynı sürede ikinci bir ajana bir hata düzeltmesi, üçüncüsüne bir araştırma verebilirsiniz. Sorun şu: hepsi aynı klasörde çalışırsa birbirinin dosyasını ezer. Çözüm, her ajana kendi çalışma kopyasını vermektir.

Worktree nedir?

Git worktree, aynı repoya bağlı ikinci bir çalışma klasörüdür. Kendi dosyaları ve kendi branch'i vardır, ama commit geçmişi ve remote ortaktır.¹² Bir ajan feature/coupon worktree'sinde kupon özelliğini yazarken diğeri fix/cart-total worktree'sinde sepet toplamını düzeltir. İkisi birbirinin değişikliğini görmez.

Ajan kullanmadan da worktree açabilirsiniz:¹

git worktree add ../shop-coupon -b feature/coupon
cd ../shop-coupon
pnpm install

git worktree list hepsini gösterir, iş bitince git worktree remove ../shop-coupon ile silersiniz.¹

Claude Code'da worktree

Claude Code worktree'yi sizin yerinize açar. Her terminalde farklı bir isimle başlatın:¹

claude --worktree coupon
claude --worktree cart-total

Worktree repo kökünde .claude/worktrees/<isim>/ altına, worktree-<isim> adında yeni bir branch'le açılır. Çıkarken değişiklik yoksa worktree ve branch kendiliğinden silinir. Değişiklik varsa tutmak isteyip istemediğiniz sorulur.¹

İki ayar işinizi kolaylaştırır:¹

• .claude/worktrees/ klasörünü .gitignore'a ekleyin. Yoksa ana klasörde takip edilmeyen dosyalar olarak görünür.

• Worktree temiz bir checkout'tur, .env gibi gitignore'daki dosyalar gelmez. Kökteki .worktreeinclude dosyasına yazdıklarınız her yeni worktree'ye kopyalanır.

.env
.env.local

Subagent'lar da kendi worktree'lerinde çalışabilir. Subagent dosyasının frontmatter'ına isolation: worktree eklemeniz yeterli.¹

Cursor'da worktree

Cursor'da Agents penceresinden bir ajanı worktree'de başlatırsınız. Editörde /worktree komutu aynı işi yapar, /apply-worktree değişiklikleri ana klasöre getirir.³ Kurulum adımlarını .cursor/worktrees.json'a yazarsınız:³

{
  "setup-worktree": ["pnpm install", "cp $ROOT_WORKTREE_PATH/.env .env"]
}

/best-of-n aynı görevi birkaç modele aynı anda verir, her biri kendi worktree'sinde çalışır. Sonuçları karşılaştırıp beğendiğinizi alırsınız. Hiçbirini kendiliğinden birleştirmez.³

Ne paralellenir?

Paralel çalışmanın sınırı ajan sayısı değil, sizin inceleme hızınızdır. Simon Willison büyük değişikliklerden aynı anda yalnızca birini düzgün inceleyip birleştirebildiğini yazıyor.⁴ Bu yüzden yanına az dikkat isteyen işler ekliyor:⁴

Net bir spec incelemeyi hızlandırır.⁴ Paralel ajana vereceğiniz işi Spec-driven geliştirme dersindeki gibi önce yazın.

Willison'ın bir önerisi daha var: zor bir iş için bir ajanı keşif amacıyla çalıştırın. Kodunu birleştirmeyi düşünmeyin. Amaç hangi dosyaların zor olduğunu ve sorunun nasıl çözülebileceğini görmek.⁴

Birleştirme

Her worktree ayrı bir branch'tir. İşi bitenden bir PR açın, testler ve inceleme ana branch'teki gibi çalışsın. İki worktree aynı dosyaya dokunduysa çakışmayı birleştirirken çözersiniz. İşleri baştan farklı dosyalara bölmek bu yüzden önemlidir.

Aynı anda iki uygulamayı çalıştıracaksanız portları ayırın: biri pnpm dev, diğeri pnpm dev --port 3001.

Kendin dene

• İki terminalde iki worktree açın: birinde ürün listesine sıralama, diğerinde footer metni değişikliği. git worktree list ne gösteriyor?

• .worktreeinclude olmadan bir worktree açıp uygulamayı çalıştırın. .env eksik olduğu için ne kırılıyor?

• Aynı küçük hatayı iki ajana ayrı worktree'lerde verin. İki çözüm aynı mı? Hangisini incelemek daha kolay?

• Bir worktree'yi değişiklik yapmadan kapatın. Branch hâlâ duruyor mu?

Detaylı öğrenmek için

• Resmi doküman: Claude Code "Run parallel sessions with worktrees"; --worktree, .worktreeinclude, temizlik ve subagent izolasyonu.¹

• Yazı: Simon Willison, "Embracing the parallel coding agent lifestyle"; hangi işlerin paralel gittiği ve inceleme darboğazı.⁴

• Resmi doküman: Cursor "Worktrees"; kurulum script'i, /best-of-n ve worktree limiti.³