Kısaca: agency-agents, 1 Eylül 2026 itibarıyla 149.312 yıldızla GitHub'daki en büyük derlenmiş yapay zeka ajanı persona koleksiyonudur. Yaklaşık 20 kategori klasöründe 300'den fazla ajan tanımlama dosyası sunar ve bunları tek bir komutla Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Windsurf, Aider ve diğer bir düzine araca yükler. Elde ettiğiniz şey yetenek değil, çerçevedir. Personalar, aracınızın bir göreve yaklaşımını değiştirir; ona sahip olmadığı gerçekleri vermezler ve oturumdan sonra varlıklarını sürdürmezler.
Bu, 2026'da kurulmaya değer beş açık kaynaklı yapay zeka ajanı aracından oluşan özetimizdeki bir araca derinlemesine bir bakıştır.
Kodlama aracınızın tek bir kişiliği var: yardımcı genelci. Ondan bir kimlik doğrulama akışını incelemesini isteyin ve mantıklı, unutulabilir tavsiyeler alın. Tehdit modeli ve kontrol listesi olan bir güvenlik denetçisinden isteyin ve bulgular elde edin.
İşte agency-agents bu boşluğu dolduruyor. Ajan uzmanlaşması hakkında bir Reddit başlığı olarak başladı ve o kadar büyük bir kadroya dönüştü ki, hepsini yüklemek en az bir popüler ajan çalışma zamanını bozuyor. İşte içinde gerçekte ne var, istediğiniz parçaları nasıl kuracağınız ve bir persona kütüphanesinin sizin için yapamayacağı iki şey.
Gerçekte ne yüklüyorsunuz?
Her ajan bir markdown dosyasıdır. Tek satırlık bir sistem istemi değil, kod içeren bir eklenti de değil. Bir dosya bir kimlik ve kişiliği, temel bir görevi, bir çalışma sürecini, örneklerle teknik çıktıları ve başarı metriklerini içerir.
1 Eylül 2026'da depodaki markdown dosyalarını saydığımızda, 20 üst düzey kategori klasöründe 312 tane bulunuyor veya examples/ dizinini hariç tuttuğunuzda 306 tane. Dağılım, bir şeyler inşa etmeye yönelik dengesizdir:
| Bölüm | Aracı dosyaları |
|---|---|
| mühendislik | 59 |
| uzmanlık alanı | 58 |
| pazarlama | 36 |
| oyun geliştirme | 21 |
| entegrasyonlar | 18 |
| strateji | 16 |
| gis | 13 |
| güvenlik | 12 |
| tasarım | 10 |
| satış | 9 |
| test | 9 |
| ücretli medya | 7 |
| proje yönetimi | 7 |
| akademik | 6 |
| uzamsal hesaplama | 6 |
| destek | 6 |
| finans | 5 |
| ürün | 5 |
| sağlık | 3 |
Depo README'sinin hala "230'dan fazla ajan" reklamı yaptığını belirtmekte fayda var. Bu satır güncel değil. Ağaç 300'ü aştı.
Mühendislik bölümü çoğu geliştiricinin başlayacağı yerdir ve özgüllük bir istem koleksiyonundan bekleyeceğinizden daha yüksektir. Açık Frontend Geliştirici ve Backend Mimar girişlerinin yanı sıra Cisco IOS-XE, Juniper Junos ve Palo Alto PAN-OS'a yönelik bir Ağ Mühendisi, ESP32, STM32 ve Nordic hedefleri için bir Gömülü Yazılım Mühendisi, ölüm sonrası analizler ve çağrıya hazır olma durumu için bir Olay Müdahale Komutanı ve değişiklik önermek yerine bir depoyu salt okunur olarak keşfetmek ve hakkında gerçekleri belirtmek üzere yazılmış bir Kod Tabanı Onboarding Mühendisi bulunmaktadır.
Bu sonuncusu, kalıbın çalıştığına dair iyi bir örnektir. Açık bir düzenleme yapmama yetkisine sahip salt okunur bir persona, varsayılan aracınızdan gerçekten farklı bir araçtır ve size bir dosyadan başka hiçbir şeye mal olmaz.
Kurulumunuzu bozmadan yükleme
Depo, dönüştürme ve yükleme betikleri içerir. Etkileşimli yol, ne yüklediğinizi algılar ve ne istediğinizi sorar:
git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
./scripts/install.sh
Belirli bir aracı ve bölümlerin bir alt kümesini hedeflemek daha akıllı bir varsayılandır:
# her şey, Claude Code'a
./scripts/install.sh --tool claude-code
# sadece iki bölüm
./scripts/install.sh --tool claude-code --division engineering,security
# sadece adlandırılmış ajanlar
./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer
# kaydetmeden önce ne olduğunu görün
./scripts/install.sh --list teams
./scripts/install.sh --tool opencode --division engineering --dry-run
Desteklenen hedefler arasında Claude Code, Cursor, Codex, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Aider, Kimi Code, Hermes, Antigravity, Osaurus ve Mistral Vibe bulunmaktadır. Ayrıca macOS, Linux ve Windows için agencyagents.app adresinde kadroyu gezen, tek tıklamayla yükleyen ve otomatik güncellenen yerel bir masaüstü uygulaması ve bir Homebrew cask de mevcuttur.
Her şeyi kurmadan önce bunu okuyun. OpenCode'un çalışma zamanı şu anda yalnızca yaklaşık 119 ajanı kaydeder ve geri kalanını sessizce düşürür; bu durum, depo tarafından bir yukarı akış hatasına karşı belgelenmiştir. --division ile bir alt küme kurmak sizi limitin altında tutar ve bir seçim bu limiti aşacaksa yükleyici sizi uyarır. Sessiz kesme, mevcut en kötü hata modudur, çünkü istediğiniz ajan eksiktir ve size hiçbir şey söylemez.
Bu özel hata dışında bile, 300 persona kurmak kötü bir fikirdir. Hatırlayamayacağınız bir kadro, kullanmayacağınız bir kadrodur. Çalıştığınız iki bölümü kurun, dört veya beş dosyayı okuyun ve ekibinizin gerçekte nasıl çalıştığıyla eşleşmeyenleri silin.
Bir persona neyi değiştirir, neyi değiştirmez
Bir persona bir çerçevedir. Aracının ne aradığını, hangi formatta çıktı üreteceğini ve neyi tamamlanmış saydığını belirler. Bu, kulağa geldiğinden daha değerlidir, çünkü kötü ajan çıktısının büyük bir kısmı modelin yanlış olmasından değil, modelin yanlış cevap biçimi için optimize edilmesindendir.
Bir personanın yapamayacağı şey, modelin sahip olmadığı bilgiyi sağlamaktır. Bu, insanların bir hafta içinde keşfettiği sınırdır ve API'ler etrafında en sert şekilde ortaya çıkar.
Backend Mimarını yükleyin ve ondan dahili faturalama hizmetiniz için bir istemci yazmasını isteyin. Bulduğu bir yanıt biçimine karşı temiz, deyimsel kod üretecektir. Hizmetinizin, bir kimlik anahtarı tekrarlandığında farklı bir hata zarfıyla 409 döndürdüğünü veya sayfalama imlecinin bir ofset yerine opak olduğunu bilme yolu yoktur. Persona kodu daha iyi organize etti. Ancak onu doğru yapmadı.
Aynı sınır test bölümü için de geçerlidir. Bir QA persona, API'nin kendi zihinsel modeline karşı kapsamlı testler yazar, böylece testler geçer ve hiçbir şeyi kanıtlamaz. Bu özel döngünün neden tehlikeli olduğunu deterministik olmayan yapay zeka ajanlarını test etmede ve gerçek şekil değiştiğinde neyin bozulduğunu API değişiklikleri yapay zeka ajanlarını bozduğunda ne olduğunda ele aldık.
Çözüm, personanın telafi edeceğini ummak yerine ajana sözleşmeyi vermektir. API'niz Apidog'da tasarlandıysa, OpenAPI spesifikasyonu doğruluk kaynağıdır: gerçek şemalar, gerçek durum kodları, gerçek hata zarfları. Ajan bunları çağrı sitelerinden yeniden oluşturmak yerine okur. Mock'lar, personanın asla taklit etmeyi düşünmeyeceği hata dalları da dahil olmak üzere aynı spesifikasyondan üretilir ve gerçeklik ile spesifikasyon sapması durumunda test paketi CI'da yüksek sesle başarısız olur.
Bu eşleştirme faydalı zihinsel modeldir. Persona, aracının nasıl çalıştığına karar verir. Spesifikasyon, neyin doğru olduğuna karar verir. İlgili okuma: OpenAPI spesifikasyonunuzu ajan araçları olarak kullanma ve ajanlar için API araç şemaları tasarlama. Canlı bir spesifikasyonu aracınızın bağlamına bağlamak isterseniz, Apidog'u indirin ve mevcut projenize yönlendirin.
İkinci sınır: bir persona bir ekip değildir
Kadronun vaat ettiği ama yerine getirmediği şey budur.
Öneri, parmaklarınızın ucunda eksiksiz bir ajanstır. Uygulamada, bir oturumda tek bir personayı etkinleştirirsiniz, bir görev yapar ve oturum sona erer. Yarın aktivasyonu tekrar yazarsınız. Bir ekip yoktur, çünkü kalıcı hiçbir şey yoktur: atama yok, güvenlik denetçisinin geçen Salı ne bulduğuna dair bir kayıt yok ve bir meslektaşın bunları görmesi için bir yol yok. Bu depodaki bölümlerin dokuzu, yalnızca bir kuruluş içinde anlam ifade eden rolleri tanımlar ve bunları kuran aracın böyle bir kavramı yoktur.
Kadro fikrinin tek bir terminal oturumundan sonra da devam etmesini istiyorsanız, eksik katman iş yönetimidir. Sharkly tam da bunun için inşa edilmiştir ve agency-agents ile eşleşme, açıklanmaya değer kadar yakındır.
- Sharkly'de bir Ajan, yeniden yazdığınız bir istem değil, kaydedilmiş bir konfigürasyondur. Talimatları, çalışma zamanını, becerileri, depoları ve ortamı barındırır. Bir kez ayarladığınız bir persona yeniden kullanılır, bu da
~/.claude/agents/içindeki bir.mddosyasının ulaşmaya çalıştığı kalıcı versiyondur. - Bir Ekip, bir lider ajan artı diğer ajanlar ve insanlardır. Bu, gerçek mekaniklere sahip bölüm kavramıdır. Ekipler lider-öncelikli çalışır: lider görev bağlamını okur, hangi üyeleri dahil edeceğine karar verir ve sonuçlarını tek bir yerde birleştirir; her uzmanın aynı anda başlayıp acele etmesi yerine.
- İş atanır, çağrılmaz. Bir Ajana, bir takım arkadaşına verdiğiniz şekilde bir görev verirsiniz. Bir alanda, bir projede ve bir sprintte yaşar, ekibiniz zaten orada çalışıyorsa Jira senkronizasyonu ile.
- Yürütme sizin kendi seçiminizdir. Dizüstü bilgisayarınız, bir sunucu veya bir konteyner olabilen bir Bilgisayar bağlarsınız ve Sharkly, üzerinde zaten kurulu olan Çalışma Zamanını kullanır. Claude Code veya Codex aboneliğiniz işi yapar; kimse size jetonları yeniden satmaz.
- Çıktı incelenebilirdir. İlerleme, araç çağrıları ve sonuçlar göreve geri akar ve ajanın çıktısı yanıtlayabileceğiniz yorumlar olarak görünür. Gecikmelerdeki bir görev bir çalıştırmayı başlatmaz, böylece her şey yürütülmeden önce işi hazırlayabilirsiniz.
Açıkça söylemek gerekirse: agency-agents size iş tanımlarını verir ve Sharkly size bu işlerin atanacağı, yürütüleceği ve inceleneceği yeri verir. Depoyu, gerçek Ajanları beslemek için bir rol tanımları kütüphanesi olarak kullanın, kurup unuttuğunuz bir klasör olarak değil.
Onlarınkini şablon olarak kullanarak kendinizinkini yazmak
Bu depodan elde edeceğiniz en kalıcı şey bir formattır. Birkaç dosyayı okuduktan sonra, kendi yığınınıza yönelik bir persona yazmak yaklaşık on beş dakika sürer ve eve özgü bir persona, genel bir personadan her zaman daha iyidir.
İyi dosyalarda tekrar eden yapı:
- Kimlik ve ses tonu. Bu ajanın kim olduğu ve nasıl konuştuğu. Kozmetik gibi görünür ve ajanın uzun bir görevin ortasında genel asistan moduna geri dönmesini durduran kısımdır.
- Temel görev. Başarının ne anlama geldiğini anlatan tek bir cümle. Kod Tabanı Onboarding Mühendisi dosyası temiz bir örnektir: salt okunur olarak keşfet, kod yollarını izle, yapı ve davranış hakkında gerçekleri belirt, hiçbir şey önerme.
- Çalışma süreci. Ajanın izlediği sıralı adımlar. Bu, çalmaya değer kısımdır. Yedi adımlı bir sürece sahip bir inceleme personası oturumlar arasında tutarlı çıktı üretir; buna sahip olmayan ise modelin o gün ne hissettiğini üretir.
- Çıktılar. Belirli formatta somut artefaktlar. "Bir rapor" yerine "ciddiyet, dosya yolu ve satır numarası ile bulguların markdown tablosu" deyin.
- Başarı metrikleri. Ajanın işinin bittiğini nasıl bildiği, aynı zamanda işini kontrol ettiğiniz şey olarak da ikiye katlanır.
API işleri için bir ev versiyonu şöyle görünebilir:
# API Sözleşme Denetleyicisi
## Görev
Yeni veya değiştirilmiş uç noktaların bu depodaki OpenAPI spesifikasyonuyla incelemeye gelmeden önce eşleştiğini doğrulayın. Uyumsuzlukları raporlayın. Kodu düzenlemeyin.
## Süreç
1. Mevcut farktan etkilenen her uç nokta için spesifikasyonu okuyun.
2. Her biri için işleyiciyi spesifikasyonla karşılaştırın: durum kodları,
yanıt şeması, hata zarfı, gerekli başlıklar, sayfalama stili.
3. Sözleşme testlerini çalıştırın. Hataları kelimesi kelimesine kaydedin.
4. Yeni uç noktaların sadece yönlendiriciye değil, spesifikasyona da eklendiğini kontrol edin.
5. Kodda bulunan ancak spesifikasyonda olmayan herhangi bir yanıt alanını işaretleyin.
## Çıktılar
Bir tablo: uç nokta, metot, uyumsuzluk türü, spesifikasyon satırı, kod satırı, ciddiyet.
Nesir özeti yok. İstenmedikçe önerilen düzeltmeler yok.
## Tamamlanma Kriteri
Farktaki her uç nokta bir kararla birlikte tabloda yer aldığında ve
sözleşme testi çıktısı kanıt olarak eklendiğinde.
Bu dosya kısa ve bir arka uç ekibi için depoda bulunan 59 mühendislik personasından herhangi birinden daha fazlasını yapar, çünkü spesifikasyonunuzu, testlerinizi ve tamamlanma tanımınızı belirtir. Üçüncü adım önemlidir: persona, bir görüş yerine kanıt üretmek üzere talimatlandırılmıştır, bu da üzerinde hareket edebileceğiniz bir inceleme ile bir rahatlama paragrafı arasındaki farktır.
Aynı numara olay müdahalesi, geçiş çalışmaları, bağımlılık yükseltmeleri ve işe alıştırma için de işe yarar. Dosya yapısını alın, süreç disiplinini koruyun, genel içeriği kendinizinkiyle değiştirin. Ajan çıktısının bir insana veya başka bir ajana aktarımda hayatta kalması gerektiğinde, format sözleşmesi işin çoğunu yapar, bu da ajan aktarımı ve bağlam geçişi konusunda belirttiğimiz noktadır.
Buradaki yıldız sayıları anlamlı mı?
149.312 yıldız çoktur ve bir uyarıyı hak eder. Persona depoları, anlaşılması kolay, paylaşılması kolay ve denemesi bedava olduğu için diğer kategorilerden daha hızlı yıldız toplar. Bir yıldız, birinin bunun iyi bir fikir olduğunu düşündüğü anlamına gelir, hala kullandığı anlamına gelmez.
Bu depoyu güvenilir kılan, sayıdan ziyade işin şeklidir. Ekim 2025'ten bu yana gerçek bir katkı geçmişi vardır, MIT lisanslıdır, OpenCode kayıt sınırı dahil kendi sınırlarını belgeler ve ajan dosyaları genel rol dolgusu yerine belirli alan içeriği taşır. Bunu zirveye çıkıp durmuş birçok "harika istemler" deposuyla karşılaştırın.
Bunu, iyi bildiğiniz bir bölümde üç dosya açarak değerlendirin. Eğer Frontend Geliştirici dosyası iyi bir frontend geliştiricisinin söyleyeceği şeyleri söylüyorsa, gerisi muhtemelen sorunsuz demektir. Eğer bir iş ilanına benziyorsa, depoyu atlayın.
Bundan gerçekten nasıl değer elde edilir?
Ayakta kalan bir iş akışı:
- Bir bölüm kurun. Günlük işinize uyanı seçin. Çoğu okuyucu için Mühendislik.
- Dosyaları okuyun. Dört veya beşini baştan sona. Saklamaya değer kısım olan süreç bölümlerini arıyorsunuz.
- Onları düzenleyin. Yığınınızı, kurallarınızı, tamamlanma tanımınızı ekleyin. Genel bir React mağazasını tanımlayan bir persona, test kurallarınızı içeren aynı dosyadan daha az değerlidir.
- Düzenlenmiş personalara gerçek girdiler verin. OpenAPI spesifikasyonunuzla bir güvenlik denetçisi sözleşme sorunlarını bulur. Aynısı olmadan aynı denetçi bir kontrol listesi üretir.
- Kalıcı olanları yükseltin. Haftada iki kez başvurduğunuz herhangi bir persona, makineler arasında kopyaladığınız bir dosya yerine bir iş yönetimi sisteminde kaydedilmiş bir Ajan haline gelmelidir.
Son adım, ekiplerin ya bunu ölçeklendirdiği ya da sessizce terk ettiği yerdir.
Sıkça Sorulan Sorular
agency-agents Cursor ve Codex ile mi yoksa sadece Claude Code ile mi çalışır? Hepsiyle. convert.sh betiği, araca özel entegrasyon dosyaları oluşturur ve install.sh --tool belirli birini hedefler. Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Copilot, Windsurf, Aider, Kimi Code ve diğerleri desteklenmektedir. API işleri için ajan istemcilerini karşılaştırıyorsanız, Cursor ve Copilot'taki API istemcilerine bakışımıza göz atın.
300 ajanın hepsini kurmalı mıyım? Hayır. OpenCode'da yapamazsınız, çünkü çalışma zamanı yaklaşık 119'unu kaydeder ve geri kalanını sessizce düşürür. Diğer araçlarda teknik olarak yapabilirsiniz, ancak çoğunu asla kullanmazsınız. Bölümlere göre kurun.
Personalar ajanı daha akıllı yapar mı? Onu daha iyi yönlendirirler. API'nizin ne döndürdüğü de dahil olmak üzere gerçek sorularındaki doğruluk değişmez. Bu, gerçek bir spesifikasyon gerektirir; bu da yapay zeka ajanları çağında hala bir API aracına ihtiyacınız var mı argümanıdır.
Kurulum betiğini çalıştırmak güvenli mi? Ajan tanımlama dosyalarını aracınızın yapılandırma dizinlerine yazar. Amacı budur. Tam kaynak kodu mevcut ve MIT lisanslıdır ve --dry-run ne yapacağını yapmadan önce size gösterir. Önce kuru çalıştırmayı yapın. Ajanların neye dokunmasına izin verdiğinize dair genel ilke yapay zeka ajanı koruyucularındadır.
Bununla bir ajan çerçevesi arasındaki fark nedir? Personaların her oturumda bir tane yerine birkaçının aynı anda çalışmasını istiyorsanız, bu Orca'dır. Strands veya AgentKit gibi bir çerçeve size kodda çalışma zamanı orkestrasyonu sağlar. agency-agents, mevcut bir ajanın davranışını değiştiren markdown dosyaları verir. Farklı bir katman, çakışma yok.
Özetle
agency-agents, belirli bir fikrin en iyi versiyonudur: ajanınız hangi rolü oynadığını bildiğinde daha iyi iş çıkarır. Bir bölüm kurun, dosyaları okuyun, ekibinize uyacak şekilde düzenleyin ve yaklaşık yirmi dakikalık bir kurulumla gerçek değer elde edeceksiniz.
Ardından, çözemediği iki şey hakkında dürüst olun. Personalar API'nizin ne döndürdüğünü bilmez, ki bunun için Apidog vardır; ve bir ekibin görebileceği veya inceleyebileceği hiçbir şeye kalıcı olarak dönüşmezler, ki bunun için Sharkly vardır. Bir kadro iyi bir başlangıçtır. Bir organizasyon değildir ve bir doğruluk kaynağı değildir.