AI / Ajan Sistemleri
230+ Hazır Ajan Personası: agency-agents ile Kendi Dijital Ajansını Kurmak
Bir Reddit tartışmasından çıkıp 137 bin yıldıza ulaşan repo, 22 bölümde 230’dan fazla uzman ajan tanımı sunuyor. Claude Code’dan Cursor’a 14 araca kuruluyor — ama hepsini kurmak yapılacak en kötü şey.
Claude Code’da alt ajanlarla çalışmaya başladığında ilk fark ettiğin şey şu: “bir geliştirici gibi davran” demek yetmiyor. Ajan ne üreteceğini, hangi kurallara uyacağını ve işi bitirdiğini nasıl anlayacağını bilmiyorsa çıktı hep genel kalıyor.
agency-agents tam bu boşluğu dolduruyor. Kendi tanımıyla “parmaklarının ucunda eksiksiz bir AI ajansı”: 22 bölüme dağılmış 230’dan fazla uzman ajan tanımı, her biri kişiliği, süreci ve teslim edeceği çıktılarla yazılmış. Repo bir Reddit tartışmasından doğmuş ve geliştiricisinin ifadesiyle “aylarca iterasyon” sonucu bugünkü hâline gelmiş.
Repo künyesi
| Özellik | Değer |
|---|---|
| Geliştirici | msitarzewski |
| Yıldız | ~137.600 |
| Fork | ~22.500 |
| Ana dil | Shell |
| Lisans | MIT |
| Açılış tarihi | Ekim 2025 |
| Ajan sayısı | 230+ |
| Bölüm sayısı | 22 |
Rakamlar Temmuz 2026 itibarıyla. Dokuz ayda 137 bin yıldız, bu tür bir kütüphaneye ne kadar ihtiyaç olduğunu gösteriyor.
Bölümler ve içinden çıkan ajanlar
Kök dizindeki her klasör bir bölüm. Kapsam gerçekten geniş — sadece yazılım değil, bir ajansın veya şirketin neredeyse tüm fonksiyonları var:
| Bölüm | Örnek ajanlar |
|---|---|
| engineering (~55 ajan, en büyük bölüm) | Frontend Developer, Backend Architect, DevOps Automator, Code Reviewer, Database Optimizer, RAG Pipeline Engineer, Prompt Engineer, Privacy Engineer, WebAssembly Engineer |
| design | UI Designer, UX Researcher, Brand Guardian, Whimsy Injector, Inclusive Visuals Specialist |
| marketing (~35 ajan) | Growth Hacker, SEO Specialist, Reddit Community Builder, LinkedIn Content Creator, Podcast Strategist, AI Citation Strategist |
| security | Security Architect, Penetration Tester, Threat Intelligence Analyst, Compliance Auditor, AI-Generated Code Security Auditor |
| testing | Evidence Collector, Reality Checker, Performance Benchmarker, Accessibility Auditor, API Tester |
| product & project-management | Sprint Prioritizer, Feedback Synthesizer, Product Manager, Senior Project Manager, Experiment Tracker |
| sales & paid-media | Outbound Strategist, Deal Strategist, PPC Campaign Strategist, Tracking & Measurement Specialist |
| game-development | Unity, Unreal, Godot, Blender ve Roblox için ayrı ajanlar + Game Designer, Narrative Designer |
| spatial-computing | XR Interface Architect, visionOS Spatial Engineer, XR Immersive Developer |
| finance, healthcare, gis, academic | CFO, Financial Analyst, Clinical Evidence Agent, GIS Analyst, Statistician, Historian |
| specialized (~65 ajan) | Agents Orchestrator, MCP Builder, Workflow Architect, Chief of Staff, Grant Writer, Codebase Archaeologist |
Bir ajan dosyası neden işe yarıyor?
Asıl mesele burada. Her ajan dosyası aynı şablona uyuyor ve bu şablon, iyi bir sistem prompt’unun bileşenlerini eksiksiz taşıyor:
- Frontmatter: ajanın adı, açıklaması ve rengi (araçların ajanı tanıması için)
- Identity & Memory: ajanın kim olduğu ve neyi hatırladığı
- Core Mission: tek cümlelik görev tanımı
- Critical Rules: alana özgü, ihlal edilmemesi gereken kurallar
- Technical Deliverables: örnekleriyle birlikte ne teslim edeceği
- Workflow Process: işi hangi sırayla yürüteceği
- Success Metrics: işin bittiğini nasıl anlayacağı
Repo toplamda 10.000’den fazla satır kişilik, süreç ve kod örneği içeriyor. Tasarım felsefesi olarak beş ilke sayılıyor: güçlü kişilik, net teslimatlar, başarı metrikleri, kanıtlanmış iş akışları ve kalıp tanıma için “Learning Memory”.
Kurulum: dört yol
1. Masaüstü uygulaması (önerilen)
macOS, Linux ve Windows’ta çalışan bir eşlik uygulaması var. Ajan kadrosunu göz atarak seçiyor, tek tıkla destekli araçlara kuruyor ve kendini otomatik güncelliyor. macOS’ta Homebrew ile: brew install --cask msitarzewski/agency-agents/agency-agents
2. Claude Code
Script ile: ./scripts/install.sh --tool claude-code. Ya da tek bir kategoriyi elle kopyalayabilirsin: cp engineering/*.md ~/.claude/agents/. Sonrasında ajanları oturum içinde doğal dille çağırıyorsun.
3. Sadece referans olarak okumak
Hiçbir şey kurmadan dosyaları okuyup işine yarayanı kendi prompt’una uyarlamak. Bence çoğu kişi için en verimli başlangıç bu.
4. Diğer araçlar
İki adım: ./scripts/convert.sh entegrasyon dosyalarını üretiyor, ./scripts/install.sh ise kurulu araçları otomatik algılayıp onay kutulu bir arayüz sunuyor. Doğrudan hedeflemek için --tool <ad> kullanıyorsun.
Seçmeli kurulum bayrakları
| Bayrak | Ne yapıyor |
|---|---|
| --division engineering,security | Sadece belirtilen bölümleri kurar |
| --agent frontend-developer,ui-designer | Sadece tek tek seçilen ajanları kurar |
| --list teams | Ekipleri ve ajan sayılarını listeler |
| --dry-run | Hiçbir şey yazmadan ne yapacağını gösterir |
| --no-interactive | CI ortamı için soru sormadan çalışır |
| --parallel ve --jobs N | Çoklu çekirdek kullanarak kurulumu hızlandırır |
Desteklenen araçlar ve kurulum yolları
Repo 14 farklı araca kurulum yapabiliyor ve her biri için ajan formatını dönüştürüyor:
| Araç | Format | Kurulum yeri |
|---|---|---|
| Claude Code | yerel .md | ~/.claude/agents/ |
| GitHub Copilot | yerel .md | ~/.github/agents/ + ~/.copilot/agents/ |
| Antigravity | ajan başına SKILL.md | ~/.gemini/config/skills/agency-<slug>/ |
| Gemini CLI | .md | ~/.gemini/agents/ |
| OpenCode | .md | .opencode/agents/ |
| Cursor | .mdc kuralları | .cursor/rules/ |
| Aider | tek CONVENTIONS.md | proje kökü |
| Windsurf | tek .windsurfrules | proje kökü |
| OpenClaw | SOUL.md + AGENTS.md + IDENTITY.md | ~/.openclaw/agency-agents/ |
| Qwen Code | .md SubAgents | ~/.qwen/agents/ |
| Kimi Code | YAML spec | ~/.config/kimi/agents/ |
| Codex | TOML özel ajanlar | ~/.codex/agents/ |
| Osaurus | SKILL.md | ~/.osaurus/skills/ |
| Hermes | lazy-router eklentisi | ~/.hermes/plugins/ |
Çağırma biçimi de araca göre değişiyor: Antigravity’de @agency-frontend-developer, OpenCode’da @backend-architect, Cursor’da kural referansı, Claude Code ve Copilot’ta ise düz dille ajanı işaret ediyorsun. OpenClaw’da kurulumdan sonra openclaw gateway restart çalıştırman gerekiyor.
Örnek senaryolar
Repoda ajanları ekip hâlinde eşleştiren altı işlenmiş örnek var: startup MVP’si, pazarlama kampanyası lansmanı, kurumsal özellik geliştirme, ücretli medya hesabı devralma, sekiz bölümü birlikte çalıştıran kapsamlı bir ürün keşif egzersizi (Nexus Spatial Discovery) ve BIM, drone çekimi, 3D sahne ve QA’yı birleştiren akıllı kampüs dijital ikizi.
Bu örnekler asıl fikri gösteriyor: tek ajan çağırmak değil, doğru ajanları bir ekip olarak sıraya koymak. Bir ürün fikrini Product Manager’dan Software Architect’e, oradan Frontend Developer ve Accessibility Auditor’a devretmek, tek bir “geliştirici” ajanına her şeyi yıkmaktan çok daha iyi sonuç veriyor.
Nasıl kullanmalı?
- 1Repoyu klonla ve önce ./scripts/install.sh --list teams ile neyin olduğunu gör.
- 2--dry-run ile kurulumun ne yazacağını kontrol et.
- 3Kendi işine en yakın iki bölümü seç ve sadece onları kur (örneğin --division engineering,testing).
- 4Kurduğun ajanlardan birinin dosyasını aç ve Critical Rules ile Success Metrics bölümlerini kendi projene göre düzenle.
- 5Bir görevi tek ajanla değil, iki ajanlı bir zincirle dene: biri üretsin, diğeri (örneğin Code Reviewer veya Reality Checker) denetlesin.
- 6Gerçekten kullandığın ajanları not et, kullanmadıklarını kaldır.
Ben bu repoyu iki şekilde değerlendiriyorum. Birincisi doğrudan kullanım: birkaç ajanı Claude Code’a kurup kendi projeme uyarlıyorum. İkincisi ve belki daha değerlisi, şablonu ödünç almak — bir ajan tanımının hangi bölümlerden oluşması gerektiğini bu repo net biçimde göstermiş.