Bir Geliştirici Takımında AI Kodlama Ajanlarını Nasıl Ölçeklendirilir

Bir kodlama ajanına sahip bir geliştirici, bir verimlilik hikayesidir. Anlatması kolaydır, iyi bir şekilde gösterilir ve gerçekten doğrudur.

Beş geliştirici, yirmi ajanla çalıştığında ise durum tamamen farklıdır. Bu bir koordinasyon sorunudur ve koordinasyon sorunları, onları yaratan araçla çözülmez. Bu, kimsenin yazmadığı bir 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 civarında ekip, yeni hızını kendisiyle ilgilenmek için 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 versiyonunu kod tabanına öğretmektedir.

Bir kişi, ajanına projenin sunucu eylemleri kullandığını ve asla API yolları kullanmadığını söyler. Diğer bir kişi bunu hiç anmaz, bu nedenle 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öylemez ve depo artık aynı kuralın üç yorumunu içermektedir. Bunu inceleme kuyruğunda fark edeceksiniz, bu da fark etmenin yanlış yeridir: o noktada kod zaten mevcuttur.

Düzeltme sıkıcıdır ve bu sayfadaki en yüksek kaldıraçtır. 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 ekip, bir taşınabilir bağlam dosyası tutar, iki dosyayı ayrı tutmak yerine. Mekanizma dosya adından daha önemlidir: talimatlar depoda yaşar, bu nedenle git pull ile gelir, odaya kimin girdiğine bağlı olarak değil.

İçinde bulunması gerekenler:

• Bir ajanın kodu okuyarak çıkaramayacağı kurallar, özellikle kod tabanının şu anda ihlal ettiği yerler
• 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 parçaları ve nedenleri
• Ekibin istemediği şeyler: kimsenin istemediği yeniden yapılandırma, eklenmemesi gereken bağımlılık, uzaklaşılması gereken desen

İçinde bulunmaması gerekenler ve burada ekiplerin 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: bir ekip arkadaşı bunu çektiğinde, onlara yardımcı mı olur yoksa 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 ekipte bu yapısal hale gelir ve en kötü türde bir 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 kısmıdır ve bunu yapmamak için hiçbir neden yoktur.

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

İkinci kısım, ekiplerin atladığı kısımdır ve birleştirmenin bir formalite mi yoksa bir öğleden sonra mı olduğunu belirleyen kısımdır.

Üçüncü olarak ne bozulur: inceleme

Ekip ölçeğinde inceleme ile ilgili her şey bir sayıdan kaynaklanır: saatte ne kadar fark geldiği.

Her satırı okuyan bir geliştirici iyi çalışır. Dört ajan çalıştıran beş geliştirici, ekiplerin 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 ki bu, inceleme yapmamaktan daha kötüdür, çünkü güvenilirlik üretir, oysa güvenilirlik yoktur.

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 hızlıca gözden geçirilir. Kimlik doğrulama, ödemeler, izinler, kişisel veriler ve göçler her zaman, her seferinde, 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 eder ve bunu ayrı olarak yazdık: AI ajanınızın kodunu hala incelemeli misiniz, bir değişikliğin yanlış gittiğine dair on nesnel belirtiyi ve ekiplerin benimseyebileceği patlama alanı tablosunu ele alır.

Bir ekip özel eklemesi. Birkaç 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 kurulumunuzda düzeltilecek en yararlı şeydir.

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

Token harcaması, bir ekip 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 olur, 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 tahminlerdir.

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üren oturumların küçük bir sayısıdır. Bu düzeltilebilir bir davranıştır ve bunu yalnızca harcamayı oturum başına ve proje başına görebiliyorsanız düzeltebilirsiniz, ayda değil. Bunu token kullanımını nasıl kontrol edeceğinizi ve yavaşlamadan nasıl kesileceğini ele aldık.

Sayının, 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örebildiğinde, kendi başına alışkanlıklarını değiştirir ve bu, ekibe siyasi olarak hiçbir maliyeti yoktur.

Ekibin ritüellerinde gerçekten ne değişiyor

Üç şey, deneyimimize ve ekiplerin 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ı hak eden şey, hangi ajanların takıldığını ve ne üzerinde takıldıklarıdır.

İstekler ortak varlık haline gelir. Bir geliştirici için iyi bir sonuç veren talimat, ekibe ürettiği koddan daha değerlidir ve bu, özel bir terminal geçmişinde buharlaşan türden bir şeydir. Depoda paylaşılan bir istem kütüphanesi tutan ekipler, her hafta aynı ifadeyi yeniden keşfetmekten kurtulurlar.

Uzmanlık, insanlardan rollere kayar. Ajanlar yazmayı hallettikten sonra, ilginç soru kimin neyi incelediğidir ve ekipler doğal olarak, insanlara atadıkları gibi ajana da roller atamaya yönelir: biri uygulamada, biri incelemede, biri testlerde. Bu, bir görevin bir Geliştirici rolünden bir QA rolüne geçişiyle ilgilidir; fark, riskler ve test ipuçları eklenir ve kalite kapıları, bir ajanın kendi işine dair görüşünden ziyade test kümeniz tarafından belirlenir.

Tutarlı olan kurulum

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

İlk dört, yalnızca anlaşma gerektirir. Son iki, bir ekibin sonunda terminalin üzerinde bir şey istemesinin nedenidir: terminaller 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" sorusuna cevap vermenin bir yolunu sunmaz.

Bu, Ekipler için AgentsRoom etrafında inşa edilen sorundur: her projedeki her ajanı tek bir görünümde, rolü, durumu ve maliyeti ile birlikte gösterir ve ekibin masalarında olmadığı zamanlar için bir mobil yardımcıdır. Bu, Claude Code ve Codex ile aynı şekilde çalışır, bu da duyulandan daha önemlidir: çoğu ekip sonunda her ikisini de çalıştırır ve bir sağlayıcıyı varsayılan olarak varsayan bir kurulum, sessizce bir sonraki bozulacak şey haline gelir.

Ancak bağlam dosyasıyla 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.