Çok ajanlı Git worktree'leri için path rezervasyonu ve serialize edilmiş merge kuyrukları

Paralel worktree'ler, tek darboğaz

Yakın tarihli bir dev.to yazısına göre, büyük otonom kodlama ajanı filolarını çalıştıran ekipler, Git worktree'lerinin yalnızca ilk ölçekleme sorununu çözdüğünü keşfetti. Worktree'ler birçok ajanın aynı anda kod yazmasını sağlıyor; her birinin diskte tam bir clone'a ihtiyaç duyması gerekmiyor. Ancak üretim paralelleştiğinde, tüm bu dalların tek bir kanonik dala birleşmesi gereken noktada verim düşüyor.

Entegrasyonun bozulduğu üç yol

Yazı, bu sınırda üç farklı başarısızlık modu tespit ediyor. İlki sıradan metinsel çatışma: aynı yapılandırma dosyasını veya route dizinini düzenleyen iki ajan, Git'in uzlaştıramayacağı çakışan değişiklikler üretiyor. İkincisi, bu çatışmaları otomatik bir modele devretmenin taşıdığı risk; modeller çatışma işaretlerini yanlış yorumlama eğiliminde. Üçüncüsü ve en tehlikelisi ise yazarın "sessiz semantik kayma" dediği şey: metin düzeyinde sorunsuz görünen ama runtime sözleşmelerini bozan bir merge. Verilen örnek: bir ajan bir fonksiyonun imzasını güncellerken ikinci bir ajanın kodu hâlâ eski sürümü çağırıyor ve merge yine de geçiyor.

Modeller zayıf çatışma çözücülerdir

Yazının ana iddiası mimari, tesadüfi değil: otonom bir kodlama modeline Git çatışmalarını çözdürtmeye çalışmak doğası gereği güvensiz. Yazarın anlatımına göre, bu roldeki modeller rutin olarak çözüm mantığı uyduruyor, diğer ajanların commit ettiği değişiklikleri sessizce düşürüyor veya production build'lerine kadar ulaşan kodda bozuk çatışma işaretleri bırakıyor. Önerilen yaklaşım bundan doğuyor: sistemler ya çatışkilerin merge aşamasına hiç gelmesini engellemeli ya da her merge'i katı programatik doğrulamayla desteklemeli. Modelin doğaçlama yapması kabul edilebilir bir orta yol değil.

Dispatch öncesi path rezervasyonu

Önerilen tasarımın ilk yarısı, task dispatch anında uygulanan kötümser kilitleme. Orkestratör bir görevi ajana verirken, aynı zamanda o görevin dokunacağı dosya path'lerini ve bağımlılıkları da rezerve ediyor. Yazı bunu agent-beta'ya atanan task-8842 için bir kilit kaydıyla örnekliyor: src/api/router.ts ve src/models/user.ts, acquired durumunda bir kilit statüsüyle rezerve ediliyor.

Sonraki bir görev zaten rezerve edilmiş dosyalara yazması gerekiyorsa, orkestratör onu paralel çalıştırmıyor. Bunun yerine bağımlılıklara dayalı serialize edilmiş bir sıralamayı zorunlu kılıyor. Paylaşılan dosyalar üzerindeki çatışmalar sonradan tespit edilip çözülmek yerine, baştan tasarımın dışında bırakılıyor.

Tek merge şeridi, fail-closed test

İkinci yarı ise entegrasyonun kendisini düzenliyor. Ajanlar izole worktree'lerinde kod yazmaya paralel devam ediyor, ancak kanonik dala merge kesinlikle tek şeritli. Bir ajan işini bitirdiğinde orkestratör dalını güncellenmiş main dalı üzerine rebase ediyor, otomatik test paketini bu rebase edilmiş bağlamda çalıştırıyor ve yalnızca tüm kontroller geçerse fast-forward merge yapıyor.

Belirleyici ayrıntı hata davranışı. Otomatik rebase merge çatışmasına denk gelirse veya testler bozulursa, sistem fail-closed davranıyor. Çatışmış durumu ajana geri verip modelin çatışma işaretlerini doğru tahmin etmesini ummuyor. Bozuk veya belirsiz bir merge basitçe ilerlemiyor.

Neden önemli

Agentic coding tek bir yardımcıdan onlarca eşzamanlı ajana doğru ölçeklenirken, verimin sınırlayıcı faktörü kod üretiminin kendisi değil, entegrasyon disiplini oluyor. dev.to'da anlatılan teknik, tam da hatalarının yakalanmasının en zor olduğu noktada — bir peer ajanın işini sessizce çöpe atarken temiz görünen bir merge'de — dil modelini döngüden çıkarması bakımından dikkat çekici. Ödünleşme bilinçli: çakışan görevler serialize edildiği ve merge'ler tek tek kuyruğa girdiği için bir miktar paralellik feda ediliyor, ama karşılığında kanonik dal doğrulanabilir kalıyor. Kodlama ajanı sürülerinin çevresine ajan orkestrasyonu veya CI pipeline'ı kuran ekipler için, dispatch anındaki path kilitleri artı fail-closed rebase testi kalıbı, çatışma çözümünü bir LLM'e emanet etmeye somut bir alternatif sunuyor.