DokümantasyonKavramlar
Paralel çalışma ve yarış modu
Ajanı ikizlere çoğaltmak, liderin işi aralarında nasıl paylaştırdığı, görev bağımlılıkları, ekip farkındalığı, görev başına git çalışma kopyası ve yarış modu.
Aynı projede birden fazla ajan aynı anda çalışabilir. Görevleri birbirinden bağımsızsa bu kolaydır. İki yazılımcı aynı koda dokunduğunda ya da bir adım başka bir adımın sonucuna ihtiyaç duyduğunda iş zorlaşır. Bu sayfa Agentbits’in bunun için sunduğu araçları anlatır: ikizler, iş paylaşımı, bağımlılıklar, ekip farkındalığı, her görev için ayrı git çalışma kopyası ve yarış modu.
Ajanı çoğaltmak
Aynı yeteneklere sahip iki yazılımcı mı istiyorsun? Birini çoğalt. Organizasyon → Ajanlar’da ajanı seç ve Çoğalt’a tıkla. İkiz aynı rolü, iş tanımını, sağlayıcıyı, izinleri, takımları, skill’leri ve erişimleri (bağlantılar, uygulamalar, dosyalar) alır. Lider anahtarı ikize geçmez.
İkiz aynı takımlarda olduğu için aynı projelerde de hemen çalışmaya başlar.
İş nasıl paylaşılır?
Lider her üyenin kaç açık görevi olduğunu görür ve işi hepsini tek kişiye yığmak yerine aynı roldeki üyelere dağıtır.
Ayarlar → Genel → İkizler arasında iş paylaşımı açıkken (varsayılan) paylaşım iş sürerken de olur: boştaki ajan, meşgul ikizinin sırada bekleyen görevini devralır. İkiz, rolü ve uzmanlık etiketleri aynı olan ajandır. Görev akışına “↔” ile başlayan ve görevi kimin kime devrettiğini söyleyen bir not düşer. İnceleme notuyla geri gönderilen görevler kendi ajanında kalır, çünkü not ona yazılmıştır.
Birbirini bekleyen görevler
Lider sırayla yapılması gereken bir iş planladığında bir görevin başka bir görevden sonra başlayacağını belirtebilir. Kartta TA-n bekleniyor yazar ve otopilot onu ancak o görevler bitince başlatır. Sen yine de kendin başlatabilirsin.
Bekleyen görev başladığında ajan, önceki adımların rapor özetlerini de alır; böylece neyin zaten yapıldığını bilir.
Ekip farkındalığı
Her çalışmanın başında ajan, projede şu an başka kimin çalıştığını, hangi görevde olduğunu ve o çalışmanın şimdiye kadar hangi dosyalara yazdığını görür. Görev sırasında team_status aracıyla güncel durumu yeniden sorabilir. Ajanlardan bir ekip arkadaşının üzerinde çalıştığı dosyalardan uzak durmaları istenir; dokunmaları gerekirse değişikliği küçük tutup raporlarında belirtirler.
Bir ajan, başka bir ajanın o anda değiştirdiği bir dosyaya yazarsa ajanın dökümünde ve görev akışında bir uyarı çıkar: “⚠️ dosya şu anda ajan (görev) tarafından da değiştiriliyor”.
Dosya bilgisi Claude Code ve Demo ajanlarından gelir. Codex CLI ve API ajanları hangi dosyalara yazdıklarını bildirmez.
Not: Farkındalık prompt ve bir araç üzerinden işler. Ajanların birbirinin işini ezme ihtimalini azaltır ama engellemez. Gerçek yalıtım için görev başına çalışma kopyasını kullan.
Her göreve ayrı git çalışma kopyası
Paralel çalışan yazılımcılar için bir proje, her göreve ayrı bir git çalışma kopyasında kendi dalını verebilir; böylece ajanlar birbirinin üzerine yazmaz. Proje ayarlarında (proje sekmesine çift tıkla) Her görev kendi git çalışma kopyasında ayarını aç. Varsayılan olarak kapalıdır.
- Proje klasörü, en az bir commit’i olan bir git deposunun kökü olmalı.
- Her görev kendi dalında (
agentbits/ta-…), projenin içinde değil Agentbits’in veri klasöründeki bir kopyada çalışır. Ajanın terminalinde “🌿 … dalında kendi çalışma kopyası” yazar. - Çalışma başarıyla biterse değişiklikler o dala commit’lenir. Git bunları commit’leyemezse (ör. commit imzalama ayarı yüzünden) görev incelemeye gitmez: nedeniyle birlikte Yapılacak’ta bekler, değişiklikler de çalışma kopyasında kalır.
- Görev Bitti’ye geçince (lider onayladığında ya da sen taşıdığında) dal proje klasörüne birleştirilir. O zamana kadar proje klasörü değişmez.
- Bu görevi bekleyen görevler, dalı birleştirilene kadar başlamaz; kartlarında TA-n birleştirilmesi bekleniyor yazar.
- Proje klasöründe commit’lenmemiş değişiklikler varsa birleştirme bekler. Onları commit’le ya da stash’le, sonra görevde Şimdi birleştir’e bas.
- Birleştirmede çakışma çıkarsa görev ajanına geri döner; projenin son hâli onun dalına alınır ve ajan çakışmaları kendi kopyasında çözer.
Bu ayar yalnızca Claude Code ve Codex ajanları için geçerlidir. Kopyalarda node_modules gibi git’in izlemediği dosyalar bulunmaz; ajan gerekirse kendisi kurar. Agentbits’in kendi git komutları deponun hook’larını çalıştırmaz. Klasör commit’i olan bir git deposu değilse ya da çalışma kopyası hazırlanamazsa görev ortak klasörde çalışmaz: nedeniyle birlikte bekletilir. Commit’lenmemiş değişikliği olan bir çalışma kopyası asla silinmez.
Bir görevi açınca Ne değişti? bölümünü görürsün: değiştirdiği dosyalar, eklenen ve silinen satırlar ve fark — birleşene kadar çalışma kopyasından, birleşince birleştirmeden.
Agentbits yalnızca yerel dal, commit ve birleştirme yapar. Uzak depoya göndermez (push), pull request açmaz.
Yarış modu
Yarış modunda aynı görevi iki üye dener, lider de iyi olan denemeyi tutar. Ayarlar → Genel → Yarış modu’ndan açılır. Varsayılan olarak kapalıdır ve yaklaşık iki kat maliyetlidir.
- Bir görev ilk kez başlarken kopyası başka sağlayıcı ya da modeldeki boşta bir üyeye de verilir; örneğin bir Claude Code ajanına ve bir Codex ajanına. Başka türde sağlayıcı kullanan üye önce seçilir.
- İkisi de kendi denemesi üzerinde çalışır. Kartlarda Yarış rozeti görünür.
- İkisi de bitince lider denemeleri karşılaştırır ve birini tutar. Kazanan Kazandı olarak işaretlenir ve her zamanki gibi ilerler; diğeri Kaybetti olarak kapatılır, değişiklikleri atılır.
Birkaç kural:
- Lider incelemesi açık olmalı, çünkü kazananı lider seçer.
- Klasörü olan bir projede Her görev kendi git çalışma kopyasında açık olmalı. Değilse iki deneme birbirinin üzerine yazacağı için o görevde yarış atlanır ve görev akışı nedenini söyler.
- Başka sağlayıcı ya da model kullanan boşta bir üye yoksa görev tek başına çalışır.
- Lider kazananı seçemezse iki deneme de incelemede seni bekler.
Ayrıca bak
Yanlış ya da eksik bir şey mi buldun? GitHub'da bildir