Claude Code için bir terminal açıyorsunuz, Codex için bir başkasını, belki Gemini CLI için bir üçüncüsünü daha... Hepsi de gayet iyi kod yazıyor. Ancak hiçbiri hangi ajanın hangi görev üzerinde çalıştığını, siz toplantıdayken neyin tamamlandığını, neyin sessiz sedasız çöktüğünü ya da bir dalda (branch) bir insanın incelemesini bekleyen nelerin kaldığını söyleyemez. Kodlama ajanı yönetiminin devreye girdiği yer tam da bu boşluktur ve bu yazıda ele alacağımız temel sorun da budur.
Bu boşluk kendini çok hızlı hissettirir. İkinci bir terminalde açılan ilk ajan tamamen bir kazanç gibi görünür. Ancak beşinci ajana geldiğinizde; kimin ne yaptığını hatırlamak için sürekli pencereler arasında geçiş yapar, worktree'leri elle temizler ve daha önce incelediğiniz diff'leri tekrar tekrar okurken bulursunuz kendinizi. Yürütme araçları işi yürütme konusunda çok başarılıdır; fakat asla birbirlerini koordine etmek üzere tasarlanmamışlardır.
Sharkly tam da bu koordinasyon katmanı için geliştirildi ve bu makalede somut örnek olarak ele alacağımız iş akışını temsil ediyor. Sharkly kod yazmaz ve hâlihazırda kullandığınız ajanların yerini almaz. Onların bir katman üzerinde konumlanır: Claude Code ve Codex'i kullanmaya devam edersiniz; Sharkly ise bunların etrafındaki görevleri, bağlamı, ilerlemeyi, engelleri, sonuçları ve insan denetimi süreçlerini yönetir. Yazının devamında, bu seviyedeki bir "yönetim"in ne anlama geldiğini ve buna gerçekten ihtiyacınız olup olmadığını nasıl anlayacağınızı ele alıyoruz.
Kodlama ajanı yönetimi ne anlama gelir?
Kodlama ajanı yönetimi; her ajan için ayrı bir terminal kullanmak yerine, birden fazla yapay zekâ kodlama ajanının yürüttüğü işleri tek bir ortak merkezden atama, takip etme, izole etme ve inceleme pratiğidir. Altındaki ajanlarla rekabet eden bir araç değil, onların üzerinde yer alan bir katmandır.
Bu mimariyi yukarıdan aşağıya doğru düşünmek anlamayı oldukça kolaylaştırır:
Models Claude / GPT / Gemini (reason and generate)
Coding agents Claude Code / Codex / Gemini CLI (execute tasks)
Management layer Sharkly (assign, track, isolate, review)
Team you and other developers (set direction, accept results)
Her satırın tek bir görevi vardır. Model akıl yürütür. Kodlama ajanı; bir talebi düzenlenen dosyalara, çalıştırılan komutlara ve bir diff'e dönüştürür. Yönetim katmanı ise hangi ajanın hangi görevi alacağına karar verir, değişikliklerin birbiriyle çakışmasını önler ve herkesin inceleyeceği kayıtları tutar. Siz yönü belirler ve ortaya çıkan sonucu onaylarsınız. İnsanlar ajanları birer otomatik tamamlama (autocomplete) aracı değil de çalışanlar olarak tanımladığında, aslında zihinlerinde canlandırdıkları organizasyon şeması tam olarak budur; yönetim katmanı ise bugüne kadarki kurulumların çoğunda eksik kalan parçadır.
Bu katmanın bağımsız olmasının çok geçerli bir sebebi vardır: Bir kodlama ajanı, diğer ajanlarınızın durumundan tamamen habersizdir (stateless). Claude Code, iki dizin ötede Codex'in aynı dosyayı düzenlediğini bilemez. Bunu yönetmek ajanın işi değildir; bir ajandan diğerlerine dadılık yapmasını istemek ise kaosun yerini değiştirmekten başka bir işe yaramaz.
Alt katmandaki araçların çözemediği sorun
Aynı anda üç veya dört ajanın çalıştığı yoğun bir öğleden sonrasının dürüst bir muhasebesini yapın: Hangi ajan ne üzerinde çalışıyor, bir sonraki görevi hangisi almalı, ne bitti, ne hata verdi ve merge edilmeden önce hangisinin bir insana ihtiyacı var? Buna bir de alttaki teknik yükleri ekleyin: birden fazla terminal, birden fazla worktree, birden fazla branch, birden fazla repository ve arka planda faturalandırılan çok sayıda abonelik.
Bunların hiçbiri Claude Code ya da Codex'in yetersizliğinden kaynaklanmaz. Bu, üzerlerinde hiçbir denetim mekanizması olmadan aynı anda birden fazla yetenekli yürütücüyü çalıştırmanın doğal bedelidir. Yapılan iş gerçektir, paralel olarak yürütülür ama görünmezdir. Bir ajanın yanlış bir yola saptığını olay anında değil, ancak en sonunda onun penceresine geçtiğinizde fark edersiniz.
Burada adını koymamız gereken asıl düşman rakip bir ürün değil, ajansal kaostur. İş akışınız kapatmaktan korktuğunuz bir terminal duvarına dönüştüğü an, ajanları teker teker çalıştırma sınırını çoktan aşmışsınız demektir. Geliştiricilerin çoğu bu duvara birden fazla Claude Code ajanını aynı anda çalıştırmayı veya aynı kod tabanında Claude Code ve Codex'i birlikte kullanmayı denerken toslar; üstelik yönetim sorunu, verimlilik artışından çok daha önce kapıyı çalar.
Yönetim katmanının sorumlulukları nelerdir?
Bu katmanı en temel işlevlerine indirgediğinizde karşınıza dört ana görev çıkar: atama, izolasyon, görünürlük ve inceleme. Bunları doğru kurgulamak, pratikte yapay zekâ ajanı orkestrasyonu kavramının büyük bir kısmını oluşturur.
Atama. Yapılacak iş bir Göreve (Task) dönüşür; Görev ise o an açık olan terminale yapıştırdığınız alelade bir prompt değil, ajana teslim ettiğiniz bağımsız bir birimdir. Bir Görev kendi hedefini, bağlamını ve kabul kriterlerini barındırır; böylece ajan boş bir sohbet ekranı yerine işin mevcut durumundan yola çıkar.
İzolasyon. İki ajanın tek bir repository üzerinde çalışması, her ikisi de aynı dosyalara dokunana kadar sorunsuz görünür. Bunun çözümü Görev başına bir worktree tanımlamaktır; böylece her ajan kendi checkout'una sahip olur ve yaptıkları değişiklikler çalışma esnasında asla çakışmaz. Bunu Git kullanarak kendiniz de kurabilirsiniz; yönetim katmanının görevi ise bu izole worktree'leri oluşturmak, izlemek ve temizlemektir, böylece tüm bunları elle yapmak zorunda kalmazsınız.
Görünürlük. Yürütme süreci, engeller, sonuçlar ve takip eden tartışmalar, çoktan kapattığınız bir terminalde kayıp gitmek yerine Görev zaman tüneline (timeline) işlenir. Tek bir merkez, "şu anda her ajan ne yapıyor?" sorusunu yanıtlar; bu da tam olarak bir ajan kontrol panelinin size göstermesi gereken şeydir.
İnceleme. Ajanlar araştırır, yürütür, test eder ve raporlar. İnsanlar ise yönü belirler, yetki verir ve sonucu onaylar. Yönetim katmanının en kritik sınırı, ekibin muhakeme yeteneğinin gerektiği yerde otomasyonun durmasıdır: Bir ajan değişikliği hazırlayabilir, testleri çalıştırabilir ve kanıtları ekleyebilir; ancak merge kararı bir insana aittir. Bu insan denetimi (human-in-the-loop) kontrol noktası bir yavaşlatıcı değil, aksine bir avantajdır.
İşte karar vermenizi sağlayacak dürüst bir kıyaslama: Tek bir kodlama ajanı kullanıyorsanız, tek bir terminalde çalışıyor ve bir sonraki işe geçmeden önce mevcut görevi bitiriyorsanız, bir yönetim katmanına ihtiyacınız yoktur; böyle bir durumda bir katman eklemek yalnızca gereksiz bir ek yük olur. Ancak birden fazla görev, worktree veya repository genelinde iki veya daha fazla ajan çalıştırmaya başladığınız ya da ikinci bir kişinin ajanların ne yaptığını görmesi gerektiği anda denklem tamamen değişir. İşte bu katman tam da bu noktada kendini amorti etmeye başlar.
Sharkly ile kodlama ajanı yönetimi
Bu örnekte yönetim katmanı olarak Sharkly'yi ele aldığımız için, sistemin pratikte nasıl işlediğini somutlaştıralım.
Öncelikle, bir ajan oturumunun çalışabileceği herhangi bir makineyi (dizüstü bilgisayarınız, bir sunucu veya her ikisi) yani bir Computer'ı bağlarsınız. Yeni bir model değil, işin nasıl ele alınacağını belirleyen yeniden kullanılabilir bir yapılandırma olan bir Agent tanımlarsınız. Kendi aboneliklerinizi kullanmaya devam edersiniz: Model kullanımı, hâlihazırda ödemesini yaptığınız Claude Code, Codex veya Gemini hesaplarınız üzerinden yürütülür. Sharkly koordine eder; model çıkarımını (inference) yeniden satmaz.
Ardından bir Görev (Task) atarsınız. Diyelim ki SH-312 görevi "kararsız (flaky) ödeme adım testini düzelt ve test kapsamını artır" olsun. Bu görevi Claude Code destekli bir Ajan'a verirsiniz ya da daha büyük bir hedefi bir Ekibe (Crew) bölersiniz; burada lider Ajan kapsamı yorumlar ve diğer Ajanların sonuçlarını tek bir Görevde bir araya getirir. Görev, bağlı bir Bilgisayarda kendi worktree'si içinde çalışır. Görev yürütülürken ilerleme durumu, engeller ve diff, Görev zaman tüneline aktarılır. Tamamlandığında Ajan; değişiklik özetini, test sonuçlarını ve bilinen kısıtlamaları ekler ve Görev inceleme aşamasına geçer. Siz inceler, değişiklik talep eder veya merge işlemini onaylarsınız.
Bu iş akışında Claude Code ya da Codex'ten vazgeçmenizi gerektiren hiçbir şey yoktur. İşlerin bağımsız terminallere dağılması yerine atanabilir ve izlenebilir olması için hâlihazırda kullandığınız ajanları tek bir çalışma alanına yönlendirirsiniz. Mevcut tüm seçenekleri görmek isterseniz, tek bir iş akışının herkese uyacağını iddia etmek yerine paralel kodlama ajanlarını yönetmeye yönelik araçları karşılaştırdığımız yazımıza göz atabilirsiniz.
Bu katman neden hangi ajanın kazandığından daha önemlidir?
Açıkça bir öngörü olduğunu belirterek söyleyelim: "En iyi kodlama ajanı" sürekli değişecek ve iş akışınızı bugünün kazananına bağlamak kırılgan bir adımdır. Claude Code, Codex, Gemini ve bundan sonra çıkacak her araç; görevden göreve ve çeyrekten çeyreğe liderliği el değiştirecektir. Tüm sürecinizi bunlardan yalnızca birinin etrafında kurmak, sıralama her değiştiğinde süreci baştan inşa etmek anlamına gelir.
Yönetim katmanı, bu hızlı değişimden sağ çıkan parçadır. Görevleriniz, bağlamınız, izolasyonunuz ve inceleme süreçleriniz ajanların üzerinde konumlanıyorsa, ekibinizin iş atama ve inceleme yöntemine hiç dokunmadan belirli bir Görevi hangi ajanın yürüteceğini kolayca değiştirebilirsiniz. Sağlayıcı bağımsızlığı (provider neutrality) sıradan bir özellik onay kutusu değildir; birkaç ayda bir kartların yeniden dağıtıldığı bir pazara karşı alınan bir sigortadır.
Bunların hiçbiri Sharkly'nin yönettiği ajanlardan daha iyi kod yazdığını iddia etmez; yazmaz da. Ajanlar işi yürütür, katman ise koordine eder. Bu dönemde yapmaya değer asıl yatırım tek bir ajana değil, hepsini çevreleyen iş akışına odaklanmaktır: Zaten paralel olarak yürüteceğiniz görevleri belirleyin ve terminal sayısı kontrolden çıkmadan önce üzerlerine gerçek bir yönetim katmanı yerleştirin.
Hâlihazırda birden fazla kodlama ajanı çalıştırıyorsanız, Sharkly size görevlerini atayabileceğiniz, çalışmalarını izole edebileceğiniz ve sonuçlarını inceleyebileceğiniz tek bir merkez sunar. Bunların çoğunu worktree'ler ve kişisel disiplinle kendiniz de inşa edebilirsiniz; ya da mevcut kodlama ajanlarınızı Sharkly üzerinden çalıştırabilir ve koordinasyonu bu katmana bırakabilirsiniz.
