🚀 Agentesk

The Next-Generation Agentic Development Platform for Codex

Agentesk, yazılım geliştirme görevlerini analiz eden, parçalayan, uygun yapay zeka ajanlarına yönlendiren, güvenli çalışma alanlarında yürüten ve tüm süreci görsel olarak izlenebilir hale getiren gelişmiş bir orkestrasyon çerçevesidir.

Basit bir "kod üreten asistan" olmaktan öte; Agentesk 3.0, projelerinizde sizinle birlikte çalışan dijital bir mühendislik takımı kurmanızı sağlar.

Özellikler • Kurulum • Hızlı Başlangıç • Mimari • Agentesk 3.0

🌟 Öne Çıkan Özellikler

| Özellik | Açıklama | | :-------------------------- | :-------------------------------------------------------------------------------------------------------------------------------- | | 👥 Multi-Agent Mimarisi | Frontend, Backend, Security gibi spesifik ajanlar birbiriyle konuşarak aynı Task Graph üzerinde paralel çalışır. | | ⏸️ Human-in-the-Loop | Kritik işlemlerde ajan duraklar ve UI üzerinden insandan Approve (Onay) veya Reject (Ret) bekler. | | 🛡️ Self-Healing | Yazılan kod Quality Gate (Derleme, test, lint) aşamasında hata verirse, ajan hatayı okur ve kendi kendini iyileştirir (Retry). | | ⏳ Git Checkpointing | Riskli işlemlerden önce gizli bir git worktree/branch snapshot'ı alınır. Hata anında tüm kod anında geri sarılır. | | 📊 Agent Office (UI) | Ajanların iç seslerini, console loglarını ve task ağaçlarını ws://localhost:4782 üzerinden Canlı Web Dashboard ile izleyin. | | 🔌 MCP Entegrasyonu | Model Context Protocol üzerinden Slack, Jira, GitHub gibi dış dünyayla yerel bağlantılar kurun. |

📦 Kurulum

🌍 Global Kurulum (Önerilen)

NPM üzerinden saniyeler içinde yükleyin:

npm install -g agentesk
# veya
npx agentesk init

💻 Local Development (Kaynak Koddan)

Monorepo ortamında geliştirmek isterseniz:

git clone https://github.com/your-username/agentesk.git
cd agentesk
pnpm install
pnpm run build
npm link

⬆️ Versiyon 3.0.0'a Geçiş Rehberi (Migration Guide)

Eğer Agentesk'in önceki bir sürümünü (örn: 2.1.0) kullanıyorsanız, veri kaybı yaşamadan 3.0 vizyonuna geçmek için şu adımları izleyin:

1. Global Paketi Güncelleyin: Eski sürümü yeni sürüme geçirmek için terminalden global update komutunu çalıştırın:

   npm update -g agentesk
   # Veya alternatif olarak: npm install -g agentesk@latest

2. Projelerinizi Yükseltin: Mevcut projenizin klasörüne girip update komutunu çalıştırın. Bu komut; mevcut ajan hafızasını (memory), loglarınızı ve özel yetkinliklerinizi (skills) bozmadan, .agents/ altyapısını 3.0 özellikleriyle (Vektör Veritabanı ve Dinamik Skill Sentezi) güncelleyecektir:

   agentesk update

🛠 Kullanım Reçetesi

1️⃣ Projeyi İlklendirme

Yeni bir projede Agentesk'i aktif etmek için projenizin kök dizininde çalıştırın:

agentesk init

Not: Bu komut projeyi analiz eder, .agents/ dizinini oluşturur, projedeki teknoloji yığınını belirleyip PROJECT.md içerisine kaydeder.

Mevcut ajanları ve yetkinlikleri listelemek için:

agentesk agent list
agentesk skill list
agentesk workflow list

Dış dünyadan (örneğin GitHub'dan) yeni bir skill çekmek:

agentesk skill add alirezarezvani/claude-skills --skill playwright-pro

2️⃣ Hedef Belirleme ve Orkestrasyon (Task Graph)

Agentesk'e kompleks bir iş verin. Sistemin Planner (Planlayıcı) motoru bu işi bağımlılıkları olan alt görevlere (DAG - Directed Acyclic Graph) bölecektir:

agentesk orchestrate "Kullanıcı giriş sistemini JWT ve Redis kullanarak baştan yaz"

Eğer direkt çalıştırmak yerine sadece ajanın ne planladığını (Task Graph) görmek isterseniz:

agentesk route "Kullanıcı giriş sistemini JWT..." --plan-only

3️⃣ Agent Office Dashboard'u Başlatma (Canlı İzleme)

Ajanların ne yaptığını görsel olarak izlemek için arka planda Daemon ve Dashboard arayüzünü aynı anda ayağa kaldırın:

agentesk office

🌐 Erişim: http://localhost:4545
Bu komut, Web soketleri üzerinden tüm logları, ajan düşüncelerini ve task onaylarını (Human-in-the-loop) ekrana yansıtır.

4️⃣ Kalite Geçitleri (Quality Gates) & Focus Modu

Ajanın ürettiği çözümü veya projeyi doğrulamak için:

agentesk verify
agentesk quality run build

Spesifik bir ajanı, örneğin backend asistanınızı bir bağlama kilitleyip onunla sohbet etmek için:

agentesk focus backend-specialist
agentesk ask "Sadece user repository interface'ine findByEmail metodu ekle"

💻 CLI Komutları (Tüm Liste)

Agentesk'in gücünü terminalden kontrol etmek için kullanabileceğiniz tüm komutlar:

Temel Sistem ve Kurulum

• agentesk init : Projeyi analiz edip Agentesk yapılandırmasını başlatır.
• agentesk install : Gerekli AGENTS.md ve gizli klasörleri mevcut projeye kopyalar.
• agentesk update : Proje hafızasını bozmadan sistem dosyalarını günceller.
• agentesk status : Projenin ve ajanların o anki durumunu gösterir.
• agentesk doctor : Geliştirme araçlarının ve yapılandırmaların sağlığını kontrol eder.
• agentesk analyze : Proje mimarisini, araçları, riskleri ve entegrasyonları analiz eder.

Orkestrasyon & Görev Yönetimi

• agentesk route <task> : Verilen göreve en uygun ajanı, yetkinliği (skill) ve riski önerir.
• agentesk task create <task> : Yeni bir JSON görev dosyası ve uygulama planı oluşturur.
• agentesk plan create <name> : Şablondan yepyeni bir adım-adım görev planı üretir.

Ajanlar & İş Akışları (Envanter)

• agentesk agent list : Sistemdeki kullanılabilir tüm ajanları listeler.
• agentesk agent show <name> : Belirli bir ajanın detaylarını ve yetkinliklerini gösterir.
• agentesk workflow list : Mevcut tüm iş akışlarını listeler.
• agentesk workflow show <name> : Belirli bir iş akışının adımlarını gösterir.

Ajan Etkileşimi (Focus Modu) & Promptlar

• agentesk focus <agent> : Tüm sonraki işlemler için belirli bir ajana odaklanır.
• agentesk focus status : O an hangi ajanın aktif odak (focus) modunda olduğunu gösterir.
• agentesk focus clear : Odaklanmayı iptal eder.
• agentesk focus profile <name> : Belirli bir proje profiliyle odaklanma moduna girer.
• agentesk ask <task> : Odaklanılan ajana özel bir "prompt" üretip iletişim kurar.
• agentesk prompt list : Kayıtlı tüm prompt şablonlarını listeler.
• agentesk prompt create <name> : Tekrar kullanılabilir yepyeni bir Codex promptu üretir.

Profil ve Eklenti (Plugin) Yönetimi

• agentesk profile list : Projedeki mevcut profilleri listeler.
• agentesk profile apply <name> : Belirli bir proje profilini aktif hale getirir.
• agentesk plugin list : Yüklü olan tüm eklentileri (plugins) listeler.
• agentesk plugin install <path> : Yerel (local) bir Agentesk eklentisini yükler.
• agentesk plugin remove <name> : Belirli bir eklentiyi kaldırır.

Yetkinlik (Skill) Yönetimi & Sentezleme

• agentesk skill list : Sistemdeki kullanılabilir tüm yetkinlikleri listeler.
• agentesk skill show <name> : Belirli bir yetkinliğin detaylarını gösterir.
• agentesk skill create <name> : Sadece bu projeye özel, manuel bir yetkinlik (skill) oluşturur.
• agentesk skill synthesize <d> : (YENİ 3.0) Yapay Zeka kullanarak anında yeni bir yetkinlik (skill) sentezler.
• agentesk skill run <name> <script> : Denetlenmiş (reviewed) bir betiği kısıtlı ortamda çalıştırır.

Harici Yetkinlik Kayıtçıları (External Registries) & Güvenlik

• agentesk registry list : Dışarıdan skill çekilen kayıtçıları (registry) listeler.
• agentesk registry add <owner/repo> : Yeni bir GitHub skill kayıtçısı ekler.
• agentesk skill search <query> : Kayıtçılarda yetkinlik arar.
• agentesk skill add <owner/repo> --skill <name> : Dışarıdan (örneğin GitHub) yetkinlik indirir.
• agentesk skill installed : İndirilmiş olan harici yetkinlikleri listeler.
• agentesk skill audit <name> : İndirilen yetkinliklerdeki güvenlik zafiyetlerini arar (Denetim).
• agentesk skill score <name> : Bir yetkinliğin ne kadar güvenilir olduğunu (trust score) puanlar.
• agentesk skill update <name> : İndirilmiş bir harici yetkinliği günceller.
• agentesk skill update-all : İndirilmiş tüm harici yetkinlikleri topluca günceller.
• agentesk skill remove <name> : İndirilmiş bir harici yetkinliği kaldırır.

Yetkinlik Paketleri (Skill Packs)

• agentesk skill pack list : Hazır (built-in) yetkinlik paketlerini listeler.
• agentesk skill pack install <name> : Belirli bir yetkinlik paketi profilini yükler.

Kalite Geçitleri (Quality Gates)

• agentesk validate : Tüm ajanları, yetkinlikleri (skills) ve referansları doğrular.
• agentesk check : Projedeki mevcut denetimleri çalıştırır.
• agentesk verify : Tüm kontrollerden geçirip JSON formatında bir rapor yazar.

Görselleştirme (UI)

• agentesk dashboard : localhost:4545 üzerinden ajanları canlı izleyebileceğiniz Web Arayüzünü başlatır.

🏗 Sistem Mimarisi

graph TD
    A[Kullanıcı Görevi] --> B(Session Engine)
    B --> C{Context & Planner}
    C -->|Task Graph Üretimi| D[Agent Router]
    D -->|Dağıtım| E((Multi-Agent Worker))
    E -->|Git Sandbox| F[Quality Gates]
    F -->|Başarısız| E
    F -->|Başarılı| G[Human-in-the-loop Onayı]
    G --> H[Proje Hafızasına Kayıt & Merge]

🔮 Gelecek Vizyonu: Agentesk 3.0

Yol haritamızda olan ve sıradaki devasa güncellemeler (Faz 15 - 19):

• 🧠 Dinamik Araç Üretimi (Skill Synthesis): Ajanın o an ihtiyacı olan tool'u kendi kendine yazıp anında kullanması.
• 📚 Semantik RAG Bellek: Vektör veritabanları (Chroma/SQLite-VSS) entegrasyonu ile aylar önceki spesifik çözümlerin anlamsal (semantic) hatırlanması.
• 💸 Bütçe Yöneticisi: Task başına harcama limiti belirleme ve token bazlı caching sistemi.
• 🕸️ React Flow Dashboard: Ajanların arasındaki iletişimin canlı, hareketli bir node (düğüm) haritası olarak web'den izlenmesi.
• ☁️ Dağıtık Ajan Kümesi: İş yüklerinin farklı donanımlar (GPU/CPU) üzerine Redis/RabbitMQ ile dağıtılması.