Bir Geliştirici Ekibi Üzerinde AI Kodlama Ajanlarını Nasıl Ölçeklendirirsiniz

Bir geliştirici ile bir kodlama ajanı, bir verimlilik hikayesidir. Anlatması kolaydır, iyi bir demo sunar ve gerçekten doğrudur.

Beş geliştirici ile yirmi ajan ise tamamen farklı bir durumdur. Bu bir koordinasyon problemidir ve koordinasyon problemleri, onları yaratan araçla çözülmez. Bu, kimsenin yazmadığı kısımdır, çünkü yalnızca heyecan aşamasından sonra ortaya çıkar: bireysel kazanımlar gerçektir, hemen gelir ve sonra üçüncü veya dördüncü geliştirici etrafında takım, yeni hızını kendini toparlamaya harcamaya başlar.

Aşağıda başarısızlık sırası yer almaktadır. Soyut bir en iyi uygulama listesi değil, şeylerin gerçekten bozulduğu sıradır, çünkü yanlış sırada düzeltmek bir çeyrek kaybettirir.

İlk olarak ne bozulur: paylaşılan bağlam

Bir ajan çalıştıran her geliştirici, sessizce kendi kod tabanının versiyonunu ona öğretmektedir.

Bir kişi, ajanına projenin sunucu eylemleri kullandığını ve asla API yolları kullanmadığını söyler. Diğer birisi bunu hiç anmaz, bu yüzden ajanı API yolları yazar. Üçüncüsü, bunu bir kez, üç gün önce sona eren bir oturumda belirtir. Hiç kimse yanlış değildir, hiç kimse yalan söylememektedir ve depo artık aynı kuralın üç yorumunu içermektedir. Bunu inceleme kuyruğunda fark edeceksiniz, bu da fark edilmesi gereken yanlış bir yerdir: o zamana kadar kod var.

Düzeltme sıkıcıdır ve bu sayfadaki en yüksek etki alanına sahip şeydir. Kuralları bir dosyaya koyun, dosyayı taahhüt edin.

CLAUDE.md Claude Code için, AGENTS.md Codex ve diğer çoğu CLI ajanı için ve pratikte birçok takım, iki ayrı dosya sürdürmek yerine bir taşınabilir bağlam dosyası tutar. Mekanizma, dosya adından daha önemlidir: talimatlar depoda yaşar, bu yüzden git pull ile gelir, odada bulunan kişinin aracılığıyla değil.

İçinde bulunması gerekenler:

• Bir ajanın kodu okuyarak çıkaramayacağı kurallar, özellikle kod tabanının şu anda bazı yerlerde ihlal ettiği kurallar
• Komutlar: testleri, derlemeyi, linter'ı nasıl çalıştıracağınız ve hangilerinin otomatik olarak çalıştırılmasına izin verildiği
• Dokunulması tehlikeli olan depo bölümleri ve nedenleri
• Takımın istemediği şeyler: kimsenin istemediği yeniden yapılandırma, eklenmemesi gereken bağımlılık, uzaklaşılan desen

İçinde bulunmaması gerekenler ve burada takımların yanıldığı yer: bir makineye özgü olan her şey. Mutlak yollar, kişisel API jetonları, yerel portlar, birinin tercih ettiği editör. Bir makineye özgü bir değer taahhüt edilmiş bir bağlam dosyasına düştüğü anda, diğer her geliştirici kendileri için yanlış olan bir ayarı miras alır ve ajanlar, artık geçerli olmayan talimatları sadakatle takip etme konusunda son derece iyidir.

Bir satır eklemeden önce yararlı bir test: Eğer bir takım arkadaşı bunu alırsa, onlara yardımcı olur mu yoksa onlara zarar mı verir?

İkinci olarak ne bozulur: iki ajan, bir dosya

Ajanlar müzakere etmez. Başka birinin düzenleme yapıp yapmadığını kontrol etmezler. Aynı modüle işaret eden iki ajan birbirini üzerine yazar ve hiçbiri bunu belirtmez, çünkü her birinin bakış açısından iş başarıyla tamamlanmıştır.

Tek başına, bu görünmezdir. Bir seferde bir ajan çalıştırırsınız veya birkaçını çalıştırırsınız ve bunlar farklı şeylere dokunur. Bir takımda bu yapısal hale gelir ve en kötü sınıf hatayı üretir: iki yeşil test çalışması arasında sessizce kaybolan iş.

Bunu düzeltmek için iki mekanizma vardır ve her ikisini de istemelisiniz.

İzolasyon. Git çalışma ağaçları, her göreve kendi depo kontrolünü verir, böylece paralel ajanlar fiziksel olarak çarpışamaz. Bu çözümün ucuz yarısıdır ve bunu yapmamak için hiçbir neden yoktur.

Sahiplik. İzolasyon, üzerine yazmayı durdurur; iki kişinin aynı problemi iki dalda, iki uyumsuz şekilde iki kez çözmesini durdurmaz. Bu, her görevi belirli dosyalara sınırlayarak ve bunu görevde belirtmekle çözülür. "Çekim akışını iyileştir" değil, "ödeme adımını değiştir, bu üç dosyada, sepeti dokunma" demektir.

İkinci yarısı, takımların atladığı kısımdır ve bu, birleştirmenin bir formalite mi yoksa bir öğleden sonra mı olduğunu belirler.

Üçüncü olarak ne bozulur: inceleme

Takım ölçeğinde inceleme ile ilgili her şey bir sayıdan kaynaklanır: saat başına ne kadar fark geliyor.

Bir geliştirici her satırı okuduğunda sorun yoktur. Dört ajan çalıştıran beş geliştirici, takımın okuyabileceğinden daha fazla fark üretir ve dürüst sonuç dikkatli bir inceleme değil, onay tiyatrosudur. Akşam 6'da dokuz yüz satırlık bir farkı gözden geçiren bir insan, bilgi üretmeden bir imza üretir, bu da inceleme yapmamaktan daha kötüdür, çünkü var olmayan bir güvence üretir.

Hayatta kalan politika "her şeyi incele" değildir ve "ajanlara güven" de değildir. İncelemeyi işin iki sınırına taşımaktır: ajan başlamadan önce planı okuyun, çünkü mükemmel bir şekilde uygulanan yanlış bir plan, mevcut en pahalı başarısızlık modudur, ardından değişikliğin neyi bozabileceğine orantılı olarak farkı okuyun. Pazarlama metni ve CSS bir göz atma alır. Kimlik doğrulama, ödemeler, izinler, kişisel veriler ve göçler her seferinde bir insan tarafından satır satır okunur, fark ne kadar temiz görünürse görünsün.

Bu, kendi başına bir konuşmayı hak ediyor ve bunu ayrı olarak yazdık: AI ajanınızın kodunu hala incelemeli misiniz, bir değişikliğin yanlış gittiğini gösteren on nesnel belirtiyi ve takımların olduğu gibi benimseyebileceği patlama yarıçapı tablosunu ele alır.

Bir takım spesifik ekleme. Birden fazla ajan bir depoyu paylaştığında, inceleme atıf gerektirir: hangi ajan, hangi görev, hangi geliştirici. Olmadan, bir farkın yazarı yoktur ve inceleme arkeolojiye dönüşür. Bu, üç veya dört eşzamanlı ajandan geçtiğinizde ayarınızdaki düzeltilecek en yararlı şeydir.

Dördüncü olarak ne bozulur: maliyet ve maliyet hakkında konuşma

Token harcaması, bir takım faturasına yansıdığı anda kişisel bir detay olmaktan çıkar.

Tuzağı, fatura aylık ve toplu olduğu için, ürettiği konuşma da aylık ve toplu hale gelir, bu da bir düzeltme yerine bir politika üretir. Birisi herkes için daha ucuz bir model önerir. Başka birisi oturumları sınırlamayı önerir. Her ikisi de tahmindir.

Gerçek dağılım neredeyse hiç uniform değildir. Bir veya iki projede, tüm gün boyunca büyüyen ve asla sıfırlanmayan bağlamla, uzun süreli oturumların küçük bir sayısıdır. Bu düzeltilebilir bir davranıştır ve bunu yalnızca oturum ve proje başına harcamayı görebiliyorsanız düzeltebilirsiniz, aylık değil. Bunun mekaniklerini token kullanımını nasıl kontrol edeceğiniz ve yavaşlamadan nasıl kesileceğini ele aldık.

Rakamı, bir yönetim konusu haline gelmeden önce, onu üreten kişilere görünür hale getirin. Bir geliştirici, bir oturumun önceki gününden daha fazla maliyetli olduğunu görebiliyorsa, alışkanlıklarını kendiliğinden değiştirir ve bu, takıma siyasi olarak hiçbir maliyet getirmez.

Takımın ritüellerinde ne gerçekten değişiyor

Üç şey, deneyimimize ve takımların bildirdiğine göre.

Standup, durumdan engelleri kaldırmaya kayar. Her kişinin dün ne yaptığı büyük ölçüde dallarda görünür. Beş dakikayı değerli kılan, hangi ajanların sıkıştığı ve ne üzerinde olduğudur.

İstekler ortak varlık haline gelir. Bir geliştirici için iyi bir sonuç veren talimat, takıma ürettiği koddan daha değerlidir ve bu, özel terminal geçmişinde buharlaşan bir şeydir. Depoda paylaşılan bir istek kütüphanesi tutan takımlar, her hafta aynı ifadeyi yeniden keşfetmeyi bırakır.

Uzmanlık, insanlardan rollere kayar. Ajanlar yazmayı hallettikten sonra, ilginç soru kimin neyi inceleyeceğidir ve takımlar doğal olarak, insanlara atadıkları gibi ajana da roller atamaya yönelir: bir uygulama üzerinde, bir inceleme üzerinde, bir test üzerinde. Bu, Agent Teams arkasındaki fikirdir; burada bir görev, bir Dev rolünden bir QA rolüne, fark, riskler ve test ipuçları ile birlikte devredilir ve kalite kapıları, bir ajanın kendi işine dair görüşünden ziyade test paketiniz tarafından belirlenir.

Tutarlı olan ayar

Önemli olan sırayla yoğunlaştırılmış:

İlk dört, yalnızca anlaşma gerektirir. Son iki, bir takımın sonunda terminalin üzerinde bir şey istemesinin nedenidir: terminalin kötü olduğu için değil, çünkü bir terminal bir seferde bir ajan gösterir ve "şu anda kim neyi, hangi projede çalıştırıyor" sorusunu yanıtlamanıza olanak tanımaz.

Bu, takımlar için AgentsRoom etrafında inşa edilen problemdir: her projedeki her ajan, rolü, durumu ve maliyeti ile birlikte tek bir görünümde, ve takımın masalarında olmadığı zamanlar için bir mobil yardımcı. Bu, Claude Code ve Codex ile aynı şekilde çalışır, bu da duyduğunuzdan daha önemlidir: çoğu takım sonunda her ikisini de çalıştırır ve bir sağlayıcıyı varsayan bir ayar, sessizce bir sonraki bozulacak şey haline gelir.

Ancak bağlam dosyası ile başlayın. Ücretsizdir, bir öğleden sonra alır ve bu çeyrekte yükleyebileceğiniz herhangi bir araçtan daha fazla sürtünmeyi ortadan kaldırır.