Thrum — Çoklu-Ajan Kodlama Ekibi Orkestratörü
Thrum Çoklu-Ajan Kodlama Ekibi Orkestratörü, dört uzman yapay zekâ ajanını (claude, codex, aider ve gemini) izole Git Worktree dalları üzerinde paralel çalıştıran, IPC Mesaj Veri Yolu üzerinden ajanlar arası koordinasyonu yöneten ve Döngüde İnsan (Human-in-the-Loop) müdahalesiyle gerçek zamanlı kod birleştirme simülasyonu sunan çift yüzeyli bir mühendislik tezgâhıdır.
Dokun & Boz: Canlı Kod Deneyleri
Okumaya başlamadan önce sol sahnedeki canlı kodu tek tıkla değiştirin veya kasıtlı hata enjekte edip farkı anında görün.
Deney 1: Hızlandırılmış Ajan Adım İlerlemesi
Üst çubuktaki "1 Adım İlerlet" düğmesine her basıldığında aktif ajanın ilerleme çubuğuna eklenen artışı 7 yerine 28 yaptığınızda, ajanlar dört kat daha hızlı tamamlanma oranına ulaşır ve tek turda görev yüzdelerini %100 seviyesine kilitler.
ag.progress = Math.min(100, ag.progress + 7);
ag.progress = Math.min(100, ag.progress + 28);
Deney 2: Kademeli Worktree Başlangıç Dağılımı
"Orkestrasyonu Başlat" tetiklendiğinde dört ajanın başlangıç ilerleme yüzdelerini birbirine yakın 68 + i * 8 bandı yerine 20 + i * 22 formülüyle dağıttığınızda, claude, codex, aider ve gemini kartları %20'den %86'ya uzanan belirgin bir boru hattı (pipeline) kademesi sergiler.
ag.progress = Math.min(100, 68 + i * 8);
ag.progress = Math.min(100, 20 + i * 22);
Deney 3: Ağır Entegrasyon Testi Gecikme Simülasyonu
runVerificationSuite() içindeki test süresi üretecini 9–30ms aralığındaki bellek-içi birim testi hızından 180–600ms aralığına çıkardığınızda, alt doğrulama şeridindeki test rozetleri gerçek konteyner ve Redis entegrasyon testlerinin gecikme profilini yansıtır.
t.ms = (Math.floor(Math.random() * 22) + 9) + 'ms';
t.ms = (Math.floor(Math.random() * 420) + 180) + 'ms';
Deney 4 (Boz ve Hatayı Gör): Ters Filtreleme ile Kaynak Kodu Silme Hatası
Çakışma enjekte edildiğinde geçici çakışma işaretçileri num: 0 satır numarasıyla eklenir. resolveConflict içindeki filtre koşulunu !== 0 yerine === 0 yaptığınızda, çözücü çakışma satırlarını silmek yerine asıl kaynak kodun tamamını siler ve dosyada yalnızca bozuk çakışma başlıklarını bırakır!
f.lines = f.lines.filter(l => l.num !== 0);
f.lines = f.lines.filter(l => l.num === 0);
Deney 5 (Boz ve Hatayı Gör): Modulo Unutulduğunda Dairesel Sıra Taşması
Dört ajanı sırayla gezen sayaçtan % order.length modulo işlemini kaldırdığınızda, dördüncü adımdan itibaren order[stepCounter] ifadesi undefined döner; bir sonraki satırdaki ag.progress ataması çalışma zamanında TypeError fırlatarak tüm simülasyon döngüsünü kilitler.
stepCounter = (stepCounter + 1) % order.length;
stepCounter = stepCounter + 1;
Sahne Arkası: Mimari & Matematiksel Sırlar
Altı çizili kavram etiketlerinin üzerine gelerek veya tıklayarak tanımlarını anında inceleyebilirsiniz.
İzole Git Worktree Ağı ve Alt Görev Dağıtım Motoru
Sol panelde yer alan thrum-daemon://ipc-bus orkestrasyon yüzeyi, her ajanı kendi bağımsız çalışma ağacına (wt/claude-arch, wt/codex-perf, wt/aider-git, wt/gemini-sec) bağlayan AGENTS veri sözlüğü üzerine kuruludur. Böylece mimari şema tasarımı, sıcak döngü (hot-path) optimizasyonu, dal hizalama ve güvenlik testleri aynı dosya sistemi kilidine takılmadan paralel ilerler. stepSimulation() fonksiyonu dairesel stepCounter = (stepCounter + 1) % order.length sayacıyla sıradaki ajanı tetiklerken, cycleSubtaskAgent(subtaskIdx) işlevi herhangi bir alt görevi bağlam özetiyle birlikte bir sonraki uzmana aktaran kesintisiz Görev Devri (Agent Handoff) mekanizmasını çalıştırır.
Birleşik Fark Görünümü ve AST Düzeyinde Çakışma Çözücü
Sağ yüzeydeki kod inceleme çalışma alanı, seçili senaryonun (SCENARIOS[currentScenarioIdx]) çoklu dosya sekmelerini renderFileTabs() ve renderDiffView() ile satır satır işleyerek her satırın hangi ajan tarafından eklendiğini veya silindiğini gösteren bir Birleşik Fark Görünümü (Unified Diff) üretir. XSS riskini önlemek için kod satırları DOM'a basılmadan önce escapeHtml() süzgecinden geçirilir. injectConflictScenario() tetiklendiğinde num: 0 işaretli çakışma blokları (<<<<<<<, =======, >>>>>>>) dosya başına enjekte edilerek gerçekçi bir Birleştirme Çakışması (Merge Conflict) oluşturulur; resolveConflict(strategy) ise 'claude', 'codex' veya 'hybrid' stratejilerinden seçileni uygulayıp çakışma işaretçilerini temizler.
Döngüde İnsan Direktifleri, Doğrulama Paketi ve Atomik Birleştirme
Mühendisin ajanlara canlı talimat göndermesini sağlayan sendHumanDirective() ve quickDirective(target, text) fonksiyonları, hem mesaj veri yoluna insan direktifi kaydı düşer hem de ilgili ajanın aktif dosya yamasına canlı kod satırı ekler. Kalite kapısı aşamasında runVerificationSuite() dört izole çalışma ağacı üzerinde birim ve güvenlik testlerini koşarak gecikme telemetrilerini günceller; mergeAllWorktrees() ise açık çakışmaları temizleyip tüm yamaları onaylayarak ana dala (main) Hızlı İleri Sarma (Fast-Forward Merge) birleştirmesini tamamlar.
Gerçek Dünya Senaryoları & Uyarlamalar
Bu laboratuvardaki motor ve algoritmaları kendi projelerinizde nerelerde kullanabilirsiniz?
Çoklu-Ajan Yazılım Geliştirme (SWE-Agent) Kontrol Panelleri
CI/CD Kalite Kapısı ve Kod İnceleme (Code Review) Platformları
Yazılım Mühendisliği ve Git Eğitimi Simülatörleri
git worktree paralelliğini, üç yollu birleştirme çakışmalarını (3-way merge conflict) ve hibrit çözüm stratejilerini terminal korkusu olmadan görsel olarak öğreten interaktif laboratuvarlar.Meydan Okuma: Görevler & Mülakat Quizi
Öğrendiklerinizi sol sahnede veya Float Studio'da uygulayıp görevleri işaretleyin.
#messageStream başlığına ajan seçici düğmeler ekleyerek renderMessages() fonksiyonunun yalnızca seçilen ajanın gönderdiği veya hedef alındığı (m.from === secili || m.to === secili) IPC mesajlarını listelemesini sağlayın.resolveConflict() ve quickDirective() bir dosyayı değiştirmeden önce f.lines dizisinin derin kopyasını bir historyStack dizisine kaydeden ve kullanıcıya son müdahaleyi tek tıkla geri alma imkânı tanıyan bir durum yöneticisi ekleyin.injectConflictScenario() ile oluşan çakışma bloğunda hazır 3 butonun yanı sıra kullanıcının birleşecek fonksiyon imzasını doğrudan düzenleyip sözdizimi doğrulamasından geçirerek kaydedebileceği canlı bir özel birleştirme kipi (Custom Merge Editor) geliştirin.git checkout) değiştirerek çalıştırmak yerine neden git worktree mimarisi tercih edilir?git checkout tek bir çalışma dizinini (working directory) değiştirdiği için iki ajan aynı anda farklı dallarda dosya derleyip test çalıştıramaz; birbirlerinin geçici dosyalarını ve HEAD işaretçisini ezerler. git worktree ise aynı .git nesne veritabanını paylaşan tamamen ayrı fiziksel klasörler açarak N ajanın sıfır dosya kilidi çakışmasıyla eşzamanlı kod yazıp test koşmasına olanak tanır.renderDiffView() içinde kod satırlarını ekrana basarken escapeHtml(line.code) kullanılmazsa hangi güvenlik ve görüntüleme hatası oluşur?Promise<RateLimitResult>) veya çakışma işaretçileri (<<<<<<<) innerHTML içine ham metin olarak verilirse tarayıcı bunları bilinmeyen HTML etiketleri sanarak gizler; daha da tehlikelisi kullanıcı direktifinden gelen <img onerror=...> gibi girdiler doğrudan çalışarak Siteler Arası Betik Çalıştırma (XSS) zafiyeti doğurur.Kopyala & Üret: AI Master Prompt Kasası
Bu mimariyi sıfırdan kendi temanızla üretmek için hazır mühendislik promptları.
Tek bir HTML dosyasında çalışan (HTML, CSS ve saf JS bir arada, sıfır harici CDN bağımlılığı olan) Türkçe bir "Çoklu-Ajan Kodlama Ekibi ve Git Worktree Orkestratörü" (1.html) oluştur.
MÜHENDİSLİK VE DB_CORE ALTYAPI KURALLARI:
1. <head> bölümünde Türkçe <title> ve tam cümle <meta name="description"> yer alsın. Tüm renkleri :root { --bg; --surface; --border; --text; --accent; --agent-arch; --agent-perf; --agent-git; --agent-sec; } CSS değişkenleriyle yönet.
2. <script> başında tüm orkestrasyon sabitlerini const CONFIG = { maxAgents: 4, stepIncrement: 10, defaultStrategy: 'hybrid', autoScrollBus: true }; nesnesinde tanımla.
3. Ekranı 50/50 iki sütunlu bir çalışma tezgâhı olarak tasarla: Sol sütunda 4 izole git worktree ajan kartı, tıklayınca görev devri (handoff) yapan alt görev listesi, canlı IPC mesaj veri yolu ve insan müdahale (Human-in-the-Loop) çubuğu bulunsun.
4. Sağ sütunda çoklu dosya sekmeli Birleşik Fark Görünümü (Unified Diff), tek tıkla simüle edilebilen 3-yollu birleştirme çakışması (Merge Conflict) çözücü, birim test koşucu ve ana dala atomik birleştirme akışı yer alsın.
5. Kod satırlarını XSS'e karşı HTML kaçışından geçir; tarayıcı alert/confirm/prompt pencerelerini kesinlikle kullanma.
Tek bir HTML dosyasında (1.html), harici kütüphane veya CDN kullanmadan saf HTML5, CSS Grid ve Vanilla JS ile çalışan Türkçe bir "Otonom CI/CD Boru Hattı ve Kod İnceleme Simülatörü" oluştur.
MÜHENDİSLİK VE DB_CORE ALTYAPI KURALLARI:
1. Renkleri :root CSS değişkenleriyle, simülasyon hız ve eşik katsayılarını <script> başındaki const CONFIG = { stageCount: 4, testPassThreshold: 95, maxLatencyMs: 250 }; nesnesiyle kontrol et.
2. Statik Analiz, Performans Benchmark, Güvenlik Taraması ve Kanarya Dağıtımı aşamalarını izleyen canlı düğüm kartları, tıklanabilir dosya yamaları (diff) ve satır içi onay/ret mekanizması kur.
3. Hata enjeksiyonu düğmesiyle bir aşamada regresyon veya birleştirme çakışması tetiklenebilsin; kullanıcı düzeltme stratejisini seçtiğinde Web Audio API ses geri bildirimiyle testler yeniden koşup dağıtımı tamamlasın.
İnteraktif Kavram Küpü
Bir kavrama dokunun veya üzerine gelin; mühendislik tanımı anında aşağıda açılsın.
Henüz yorum yapılmamış. Düşüncelerinizi ve geri bildirimlerinizi ilk siz paylaşın!
Yorumlar
Yorum Gönder