Rehberler/Git worktree

Git worktree ile yapay zekâ kod ajanlarını paralel çalıştırın

Birden fazla yapay zekâ ajanının aynı depoda birbirine basmadan aynı anda çalışması — Git worktree her ajanı nasıl izole eder, sonuçlar nasıl güvenle birleştirilir?

Vulgr ekibi··2 dk okuma

Kısa cevap: her ajana kendi Git worktree’sini verin: aynı deponun, kendi dalında duran ayrı bir kopyası. Ajanlar birbirinin dosyalarına ya da sizin çalışma ağacınıza dokunmadan aynı anda düzenleme yapabilir, derleyebilir ve test çalıştırabilir. Bittiğinde dalları birleştirin, testleri birlikte çalıştırın ve birleşik diff’i inceleyin.

Git worktree nedir?

Worktree, aynı depoya bağlı ek bir çalışma dizinidir. Her birinin kendi dalı ve diskte kendi dosyaları vardır, ama hepsi tek bir .git geçmişini paylaşır. Şöyle oluşturulur:

git worktree add ../uygulamam-gorev-a -b gorev-a

Dizinler ayrı olduğu için bir worktree’de npm install çalıştıran ya da bir dosyayı yeniden yazan ajan diğerlerini bozamaz.

Ajanlar neden izolasyona ihtiyaç duyar?

Aynı kopyayı düzenleyen iki ajan birbirinin değişikliklerinin üzerine yazar, yarım kalmış derlemelere takılır ve hiçbir anlamı olmayan test sonuçları üretir. İzolasyon bu karmaşayı bağımsız görevlere dönüştürür:

  • her ajan üzerinde çalışacağı temiz bir dal alır,
  • her biri kendi değişikliklerine karşı kendi testlerini çalıştırır,
  • sizin çalışma ağacınız bıraktığınız gibi kalır.

Güvenli bir paralel akış

  1. Hedefi, kodun farklı yerlerine dokunan görevlere bölün.
  2. Her görev için bir worktree oluşturun ve her birinde bir ajan başlatın.
  3. Her görevi birleştirmeden önce kendi worktree’sinde test edin.
  4. Dalları birleştirin ve çakışmaları çözün.
  5. Birleşik sonuç üzerinde tüm test paketini çalıştırın.
  6. Birleşik diff’i inceleyin — mümkünse onu yazanlardan farklı bir ajanla.

Vulgr’da yapmak

Vulgr’ın Orchestrator’ı bu adımları otomatikleştirir: planlayıcı hedefi bir görev grafiğine böler, işçiler her görevi kendi worktree’sinde ve testleriyle paralel yürütür, parçalar birleştirilip birlikte test edilir ve sonuç çalışma ağacınıza ulaşmadan önce bir reviewer onaylar. Agent Swarm de izole bir worktree içinde çalışabilir.

Vulgr worktree’lerini .git/info/exclude ile gizlenen bir .worktrees/ klasöründe tutar — .gitignore dosyanıza hiç dokunulmaz — ve kullanılmayan (yetim) worktree’leri otomatik temizler.

Sık sorulan sorular

Kaç ajan paralel çalışabilir?

Birbirine bağımlı olmayan görev sayınız kadar — ve ajan planlarınızın kullanım limitleri izin verdiği ölçüde. Üç paralel işçi iyi bir başlangıçtır.

İki görev aynı dosyayı değiştirirse ne olur?

Birleştirme adımı bir çakışma gösterir. Hedefi görevlerin farklı dosyalara dokunacağı şekilde bölmek çoğunu önler; gerisini reviewer adımı yakalar.

Vulgr, yapay zekâ kod ajanlarını — Claude Code, Codex, Gemini CLI, Cursor, OpenCode ve Antigravity — yan yana çalıştırmak için ücretsiz ve açık kaynak (MIT) bir masaüstü terminalidir. Her ajana bir görev verir: biri kodu yazar, biri inceler, biri test eder ve iş geçene kadar döngüde kalırlar. macOS, Windows ve Linux’ta yerelde çalışır ve zaten kurulu olan ajan CLI’larını kullanır.

Vulgr’da deneyin