agency-agents: Kodlama Ajanınız için 300+ Rol Tanımı ve Tutamadıkları

Kodlama ajanınızın tek bir varsayılan kişiliği vardır: yetenekli bir genel uzman. Ondan bir kimlik doğrulama akışını incelemesini isterseniz, mantıklı ama akılda kalmayan tavsiyeler alırsınız. Bir tehdit modeli ve kontrol listesi olan bir güvenlik gözden geçiricisine sorarsanız, bulgular elde edersiniz. Bu farkın maliyeti sadece bir markdown dosyası; agency-agents'in 149.312 yıldıza ulaşmasının nedeni de bu.

Kütüphane gerçekten faydalı. Ama aynı zamanda tek bir makinedeki bir dosya klasörü; birden fazla kişinin bu rollerin bir anlam ifade etmesini istediği anda sınır hâline geliyor. Bu yazıda neler elde ettiğinizi, yalnızca istediğiniz kısmı nasıl kuracağınızı ve bir rol tanımı ile bir ekibin iş atayabileceği bir Agent arasındaki farkı ele alıyoruz.

TL;DR

Bu, kodlama ajanlarını genişleten açık kaynak araçlar derlememizdeki beş derinlemesine incelemeden biri.

agency-agents, yaklaşık 20 kategoride 300'den fazla ajan rol tanımından oluşan, MIT lisanslı bir koleksiyon; tek bir komutla Claude Code, Cursor, Codex, Gemini CLI, OpenCode ve bir düzine kadar başka araca kurulabiliyor. Her dosya bir kimliği, bir çalışma sürecini, çıktıları ve bir tamamlanma tanımını açıklıyor. Rol, ajanın bir görevi nasıl çerçevelediğini değiştirir; ajana sahip olmadığı bilgiyi vermez ve oturum bittikten sonra varlığını sürdürmez. Tek bir bölüm kurun, dosyaları kendi teknoloji yığınınıza uyacak şekilde düzenleyin ve her hafta başvurduğunuz roller, bir ekibin iş atayabileceği kayıtlı yapılandırmalara dönüştürün.

Neyi kuruyorsunuz

1 Eylül 2026'da depo ağacından sayıldığında, 20 üst düzey kategori klasöründe 312 markdown dosyası var. Deponun README'si hâlâ “230+” diyor; bu bilgi güncel değil.

Çoğu ekibin başladığı yer engineering bölümü ve buradaki ayrıntı düzeyi, bir prompt koleksiyonunun genellikle ulaştığından daha yüksek. Frontend Developer ve Backend Architect'in yanı sıra Cisco IOS-XE ve Juniper Junos'a odaklanmış bir Network Engineer, ESP32 ve STM32 hedefleri için bir Embedded Firmware Engineer, olay sonrası incelemeler ve nöbet hazırlığı için bir Incident Response Commander ve bir depoyu salt okunur şekilde keşfedip değişiklik önermek yerine olguları ortaya koymak üzere yazılmış bir Codebase Onboarding Engineer bulunuyor.

Bu sonuncusu, yaklaşımın işe yaradığını gösteriyor. Açık bir düzenleme yasağı bulunan salt okunur bir rol, varsayılan ajanınızdan farklı bir araçtır ve maliyeti tek bir dosyadır.

Yalnızca ihtiyacınız olanı kurmak

git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents

./scripts/install.sh                                       # interactive
./scripts/install.sh --tool claude-code --division engineering,security
./scripts/install.sh --tool cursor --agent frontend-developer
./scripts/install.sh --list teams
./scripts/install.sh --tool opencode --division engineering --dry-run

Deponun belgelediği ama çoğu yazının atladığı bir uyarı: OpenCode'un çalışma zamanı yaklaşık 119 ajan kaydediyor ve geri kalanını sessizce düşürüyor. --division ile bir alt küme kurmak sizi sınırın altında tutar ve seçiminiz sınırı aşacaksa kurulum betiği sizi uyarır. Sessiz kırpma, karşılaşabileceğiniz en kötü hata modudur; çünkü istediğiniz rol eksiktir ve bunu size söyleyen hiçbir şey yoktur.

Bu hata olmasa bile 300 rolün tamamını kurmak bir hatadır. Hatırlayamadığınız bir kadro, kullanmayacağınız bir kadrodur. Çalıştığınız bölümü kurun, beş dosya okuyun ve ekibinizin çalışma şekline uymayanları silin.

Rol tanımının bittiği yer

Rol bir çerçevedir. Ajanın neye baktığını, hangi biçimde çıktı ürettiğini ve neyi tamamlanmış saydığını belirler. Bu, kulağa geldiğinden daha değerli; çünkü ajan çıktısını zayıf yapan şeyin büyük kısmı modelin yanlış olması değil, modelin yanlış türde bir yanıt için optimizasyon yapmasıdır.

Rolün yapamayacağı iki şey var.

Modelin sahip olmadığı bilgiyi sağlayamaz. Bir Backend Architect rolü, kendi çıkarımıyla varsaydığı bir arayüze karşı düzenli kod üretir. Rol yapıyı iyileştirdi. Sonucu doğru hâle getirmedi.

Oturumdan sonra varlığını sürdüremez. Bir rolü etkinleştirirsiniz, görevi yapar, terminal kapanır. Ertesi gün etkinleştirmeyi yeniden yazarsınız. Bu depodaki dokuz bölüm, yalnızca bir kurum içinde var olan işleri tanımlıyor; ancak bunları kuran aracın kurum diye bir kavramı yok. Ne bir görev ataması var, ne güvenlik gözden geçiricisinin geçen salı ne bulduğuna dair bir kayıt, ne de bir iş arkadaşının bunlardan herhangi birini görmesinin bir yolu.

Rol tanımından iş atanabilir bir Agent'a

Rol tanımı, yeniden yazdığınız bir prompt'tur. Sharkly'de bir Agent ise kayıtlı bir yapılandırmadır: talimatlar, çalışma zamanı, Skills, depolar ve ortam. Bu, ~/.claude/agents/ içindeki bir dosyanın ulaşmaya çalıştığı şeyin kalıcı sürümüdür.

Her parçanın tek bir işi var. Agent, işin nasıl ele alınacağını tanımlar. Computer, ana makineyi ve yerel kaynakları sağlar. Runtime, ekibinizin zaten kurmuş olduğu kodlama aracını kullanarak gerçek ajan oturumunu yürütür. Task ise paylaşılan kayıt olarak kalır.

Sharkly, Claude Code, Codex veya bu depodaki rollerin yerine geçmez. Bunların etrafına paylaşılan görev, Computer, bağlam, kontrol ve gözden geçirme katmanını ekler. Model kullanımı, bu araçlarda yapılandırılmış abonelikler veya API anahtarları üzerinden devam eder.

Bölüm kavramı doğrudan karşılık buluyor. Bir Crew, tek bir lider Agent tarafından koordine edilen, yeniden kullanılabilir bir People ve Agent grubudur. Crew'ler lider öncelikli çalışır: her uzman aynı anda işe koyulmak yerine, lider görev bağlamını okur, hangi üyelerin dahil olacağına karar verir ve sonuçlarını tek bir Task'ta toplar. agency-agents'in sekiz bölümüyle işaret ettiği ama uygulayamadığı şey tam da bu; çünkü bir dosya klasörünün ne lideri vardır ne de sonuçların dönebileceği paylaşılan bir görevi.

Yürütme, engeller, sonuçlar ve takip tartışmaları görev zaman çizelgesine döner. Birisi güvenlik gözden geçiricisinin ne bulduğunu sorduğunda, yanıt Task'ın içindedir.

Depoyu bir ekip gibi değil, bir kütüphane gibi kullanın

Tek kişiyseniz, yerel olarak çalışıyorsanız ve bugünkü işinize daha iyi bir çerçeve kazandırmak istiyorsanız agency-agents'i doğrudan kullanın. Bir bölüm kurun, dosyaları okuyun, yirmi dakikada fayda elde edin.

Kayıtlı Agent'ları ise rolün birden fazla kişi tarafından yeniden kullanılması gerektiğinde, çıktının geçerli sayılmadan önce gözden geçirilmesi gerektiğinde veya üç ay sonra birinin bir rolün ne ürettiğini ve neden ürettiğini soracağı durumlarda kullanın. Eşik, ekip büyüklüğü değil. Rolün oturumdan daha uzun yaşaması gerekip gerekmediğidir.

Pratik iş akışı, depoyu kaynak malzeme olarak ele almaktır. Gerçekten yeniden kullanılabilir kısım olan dosya yapısını alın, genel içeriği kendi teknoloji yığınınız ve tamamlanma tanımınızla değiştirin ve haftada iki kez başvurduğunuz her şeyi kayıtlı bir yapılandırmaya dönüştürün. İyi dosyaların hepsi aynı yapıyı paylaşıyor: kimlik, misyon, sıralı süreç, belirli bir biçime sahip çıktılar ve başarı kriterleri. Yedi adımlı bir sürece sahip bir gözden geçirme rolü, oturumlar boyunca tutarlı çıktı üretir. Buna sahip olmayan bir rol ise modelin o gün canı ne isterse onu üretir.

Agent'lar araştırır, yürütür, test eder ve raporlar. İnsanlar yön belirler, yetki verir ve sonucu kabul eder.

Sıkça sorulan sorular

agency-agents, Claude Code dışındaki araçlarla çalışır mı? Evet. Bir dönüştürme betiği her araç için entegrasyon dosyaları üretir ve install.sh --tool belirli bir aracı hedefler. Desteklenen hedefler arasında Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Copilot, Windsurf, Aider ve Kimi Code bulunuyor. Ayrıca macOS, Linux ve Windows için bir masaüstü uygulaması da var.

300 rolün tamamını kurmalı mıyım? Hayır. OpenCode'da kuramazsınız; çünkü yaklaşık 119'u kaydediliyor ve geri kalanı uyarı verilmeden düşürülüyor. Diğer araçlarda kurabilirsiniz ama çoğunu kullanmazsınız. Bölüm bazında kurun.

Roller bir ajanı daha yetenekli yapar mı? Ajanı daha iyi yönlendirir. Tutarlılık ve çıktı biçimi iyileşir. Modelin hiç sahip olmadığı olgulara dair bilgi ise değişmez.

Bu, bir ajan çerçevesiyle aynı şey mi? Hayır. Bir çerçeve size kod içinde çalışma zamanı orkestrasyonu sunar. agency-agents ise mevcut bir ajanın davranışını değiştiren markdown dosyaları verir. Farklı bir katman, örtüşme yok.

Bunun Sharkly Skills ile ilişkisi nedir? Bir Skill, bir Agent'ın yapılandırmasına eklediğiniz bir yetenektir; böylece her makinede yeniden kurulmak yerine o Agent ile birlikte yeniden kullanılır. Bu depodaki rol tanımları, bunları yazmak için iyi bir ham madde.

Kısa özet

agency-agents, tek bir fikrin mevcut en iyi hâli: bir ajan hangi rolü oynadığını bildiğinde daha iyi iş çıkarır. Bir bölüm kurun, dosyaları okuyun, ekibinize uyacak hâle getirin.

Sonra sınırı net bir şekilde belirleyin. Roller, modelinize hiç verilmemiş olguları bilmez ve bir ekibin görebileceği veya gözden geçirebileceği herhangi bir şeyde varlığını sürdürmez. Bir kadro iyi bir başlangıçtır. Ama bir organizasyon değildir. Diğer yarısını Sharkly tutuyor: Task paylaşılan kayıttır, yürütme zaten ödeme yaptığınız çalışma zamanları üzerinden bağladığınız Computer'larda gerçekleşir ve sonuçlar bir kişinin gözden geçirip kabul edebileceği bir yere döner.