Sözlük

Çekirdek varlıklar

Ajan: Kimliği, rolü, becerileri ve bir adaptörü olan bir YZ çalışanı. Tam olarak tek bir çalışma alanına aittir. Sistemdeki birincil aktör.

Adaptör: Bir ajan turunu yürüten çalıştırıcı. İki tanesi gelir: Control Center (built-in) — model sağlayıcılarıyla konuşan süreç içi harness — ve claude -p üzerinden Claude Code. Cursor, Codex, Anthropic, OpenAI ve geri kalanı, ayrı CLI’lar değil, yerleşik adaptör üzerindeki sağlayıcılardır. Bkz. Adaptörleri ve modelleri yönetme.

Çalışma alanı: En üst düzey yalıtım kiracısı. Ajanları, depoları, alanları, biletleri, belleği ve pipeline’ları gruplar. Yalıtım yapısaldır, geleneksel değil: her çalışma alanının kendi SQLite dosyası (<dataDir>/<workspaceId>/workspace.db) vardır, bu yüzden çalışma alanları arası bir okuma derlenmez. Uygulama içindeki her rota /workspaces/:workspaceId ile öneklenir — bkz. rota haritası.

Forge: Bir kod barındırıcısı — GitHub, GitLab veya Bitbucket Cloud. Forge her deponun bir özelliğidir; kayıt sırasında origin uzak deposundan okunur ve o deponun API adaptörünü ve kimlik bilgisini seçer. Bir çalışma alanı üçünde de depo barındırabilir; toplayıcı yüzeyler (gelen kutusu, PR kuyruğu) temsil edilen her forge’a dağılır ve sonuçları birleştirir, arızaları yalıtır; böylece erişilemeyen bir forge diğerlerini hiçbir zaman boşaltmaz. Forge’lar destekledikleri konularda farklılaşır — Bir kod barındırıcısı bağlama sayfasındaki yetenek tablosuna bakın.

Depo: Tek bir çalışma alanı içinde kayıtlı bir Git deposu. Çalışma alanına özel — iki çalışma alanında kayıtlı aynı checkout, iki kimlikli iki bağımsız satırdır; bir deponun kimliği çalışma alanları arasında kimlikle değil, her zaman dosya sistemi yoluyla belirlenir. Kayıt, origin uzak deposu desteklenen bir forge’a işaret eden bir git çalışma ağacı gerektirir. Her depo, kendisi için kullanılan API adaptörünü ve kimlik bilgisini seçen o forge’u (github / gitlab / bitbucket) taşır.

Yalıtılmış depo: Kayıtlı bir deponun çalışma alanına özel çalışma ağacı. Bu yerel ikilinin geldiği her yerde rift üzerinden kopyala-üzerine-yaz; Windows’ta git worktree. Alan başına hazırlanır — o alandaki her konuşma tek bir checkout’u paylaşır — böylece ajanlar kaynağı asla değiştirmez.

Alan: İnsan ve ajan katılımcıları, kalıcı bir Mode’u, hazırlama durumu ve nasıl bölümleneceğine, sessize alınacağına, rozetleneceğine ve çöp toplanacağına karar veren bir SpaceKind’ı (topic / agentPeer / system / pr / slack) olan, çalışma alanına özel bir işbirliği kapsayıcısı. Konuşmalarının paylaştığı yalıtılmış çalışma ağaçlarına sahiptir (rift üzerinden kopyala-üzerine-yaz; Windows’ta git worktree).

Konuşma: Bir Alan içindeki tek bir ileti akışı; kendi kimliği, geçmişi ve ajan çalıştırma bağlamı vardır. Bir alandaki konuşmalar düz eşitlerdir — birincil ya da “ana” akış yoktur. Her biri bir düzenleyici sekmesi olarak açılır; bir alanın okunmamış durumu hepsini kapsayacak biçimde toplanır.

Thread: anchorMessageId değeri ayarlanmış bir Konuşma: aynı Alandaki kardeş bir konuşmanın tek bir iletisine sabitlenir ve bu çapa iletisiyle tohumlanan taze bir ajan bağlamı taşır. Tek düzey derinliğindedir — thread’ler asla thread’lere sabitlenmez.

Bilet: İş birimi toplamı. Satıcıdan bağımsız: varsayılan olarak local; Linear, GitHub Issues, Jira Cloud ve ClickUp için eşitleme adaptörleri vardır — yine de hiçbir uygulama içi yüzey bir eşitleme bağlantısı oluşturmaz. Hiyerarşiyi, bağlantıları ve devretmeyi destekler. Bir ajana atama sahipliği kaydeder ve hiçbir şey göndermez; bir ekibe atama istisnadır (TeamRoutingService lideri gönderir).

Pipeline: Adımları (ajan gönderimi, betikler, koşullar) birbirine zincirleyen DAG tabanlı bir iş akışı. Şablonlarla tanımlanır; çalıştırmalar olarak yürütülür.

Değer nesneleri

AgentRole: Numaralandırılmış rol (CEO, coder, reviewer, QA, designer, security, devops, PM, general). Personayı, bellek erişimini ve hiyerarşiyi belirler.

AgentSkills: Gönderim anında istemlere ilgili bağlamı enjekte eden, büyük-küçük harf duyarsız beceri tanımlayıcıları kümesi.

Beceri kaynağı: Çalışma alanı başına beceri kataloğu olarak kaydedilen bir GitHub deposu. Yapısı gereği güvenilmezdir: deponun üst verisi yalnızca görüntüleme amaçlıdır ve her kurulum, herhangi bir içerik diske ya da bir isteme ulaşmadan önce hataya kapalı tarama kapısından geçer. Bkz. becerileri kurma ve yönetme.

skills-lock.json: Kurulu becerilerin çalışma alanı başına manifestosu: her biri için kaynak deposu, depo yolu, sabitlendiği commit ve toplanmış bir içerik karması. Kurulumlar, güncellemeler ve kaldırmalar onu güncel tutar; verify_skills onu diskle karşılaştırır.

Ajan çalıştırma ağ geçidi: Eylem politikasını bir ajanın sandbox’ı içinde uygulayan, cc_server üzerindeki bir loopback uç noktası. Bir ajanın yaptığı her GitHub push’u buraya yönlendirilir, Uzak depoya push et kuralına göre denetlenir ve ajanın asla elinde tutmadığı bir yazma token’ıyla iletilir; Claude Code’un Bash komutları aynı uç noktadaki bir hook aracılığıyla denetlenir. Bkz. Sandbox ve güvenlik.

Mode: chat, plan, review veya orchestrate. Alan başına saklanır, böylece bir ajan farklı alanlarda farklı modlarda olabilir; bir alandaki her konuşma bunu paylaşır. Sistem istemini, sandbox yazma kurallarını ve MCP araç izin listesini kapılar. Composer yalnızca chat, plan ve orchestrate sunar; chat “Ajan” olarak etiketlenir.

SandboxBackend: microvm (kapalı bir VM — çekirdek sınırı olan tek arka uç, etkileşimli terminallere uygulanır), native (macOS’ta Seatbelt, Linux ve WSL2’de bubblewrap) veya none. Önyüklemede bir kez yoklanır; native, kullanılabilir olduğunda ajan gönderimine uygulanır ve Claude Code CLI’yi ile harness’ın bash aracını sarar. Windows’ta yerel bir arka uç yoktur ve Linux bwrap artı socat gerektirir; bu yüzden oradaki çalıştırmalar sarılmaz; --sandbox off bilinçli olarak vazgeçer.

Rig: Bir ajanın gerçek zamanlı olarak yönettiği atılabilir bir makine — kapalı bir tarayıcı ya da Linux masaüstü, ana makine tarafından yönetilen bir Android emülatörü ya da iOS Simülatörü veya kapalı bir terminal. Kendi tam çözünürlüklü kanalından canlı izlenir ve devralma sunucu tarafında uygulanır. Bir konuşmaya kapsamlıdır; böylece insan sekmesi ile ajanın browser_use / computer_use / mobile_use / ios_use çağrıları tek bir varsayılan makineyi adresler. Bkz. Rig’ler ve yalıtılmış ortamlar.

Enclosure: VM destekli rig’lerin daha güçlü yalıtım sınırı — bir çekirdek sınırı, tek kullanımlık overlay diski, varsayılan olarak reddeden ağ kapısı ve kimlik bilgisi broker’ı. Android ve iOS rig’leri atılabilirdir, ancak ana makine tarafından yönetilen ağ kullanır ve bu sınırı talep etmezler. Herhangi bir rig’i yönetmek enclosureControl koruma sınıfını kullanır.

RunCost: Tek bir ajan çalıştırması için jeton/maliyet dökümü (girdi jetonları, çıktı jetonları, sent cinsinden tahmini maliyet).

WakeReason: Bir ajanın neden gönderildiği. Altı değer: kullanıcı iletisi, bilet ataması, bir arızanın ardından kurtarma amaçlı yeniden gönderim, alt biletin tamamlanması, zamanlanmış takip kalp atışı ve pipeline adımı.

Portlar

SandboxPort: Sandbox yaşam döngüsünü yönetir (probe, launch, events, exec, destroy).

CredentialBrokerPort: Sandbox başlatması için kapsamlı kimlik bilgileri üretir — bir ajanın ortamı için salt okunur, yazma yalnızca sunucu tarafındaki push yolu için — ve sökme sırasında bunları iptal eder.

GitRepoInspectorPort: Yerel bir Git depo yolundan üst veriyi (sahip, depo, dal) çıkarır.

EmbeddingPort: Anlamsal arama için birim normlu metin gömme vektörleri üretir.

NotificationPort: Kategori/rota kapılamasına uyarak yerel masaüstü bildirimleri gösterir.

TicketProviderPort: Bir biletleme arka ucuna satıcıdan bağımsız sınır (create, get, list, update, transition, assign).

PipelineEnginePort: Bir şablondan bir pipeline çalıştırması başlatır ve çağıranları somut motordan ayırır.

Alan hizmetleri

AgentDispatchService: Ajan çalıştırmalarını başlatır: yalıtılmış depoları hazırlar, istemleri kurar, çalıştırma günlükleri oluşturur ve canlı olay akışları döndürür.

TicketWorkflowService: İyimser eşzamanlılık için bir mutasyon geçiş noktası ve çalışma alanı yalıtımı uygulaması olan saf alan bilet yaşam döngüsü motoru. Uyguladığı geçiş grafiği yalnızca ajanları ve otomasyonu bağlar; kullanıcı kaynaklı arayüz değişiklikleri force: true geçirir ve onu atlar. Bir ajan atayanı için hiçbir bilet göndericisi yoktur — gönderimin sahibi AgentDispatchService’tir ve bir bileti bir ajana atamak hiçbir çalıştırma başlatmaz. Bir bileti bir ekibe atamak istisnadır (TeamRoutingService lideri gönderir).

PipelineEngine: Çalıştırma yürütmesini orkestre eder: çalıştırmaları başlatır, adımları zamanlar, durumu kalıcılaştırır, yönlendiricileri/birleşmeleri/başarısızlıkta devamı yönetir ve yeniden başlatmanın ardından uçuştaki çalıştırmaları sürdürür.

PipelineTriggerDispatcher: Alan olaylarına abone olur ve etkin tetikleyiciler için eşleşen pipeline çalıştırmalarını otomatik olarak başlatır.

MemoryAccessPolicy: Ajan rolü bellek izinlerini alanlar üzerinde çözer ve uygular.

HarnessCostCalculator: Yerleşik harness’ın jeton kullanımını models.dev kataloğundan bir RunCost olarak fiyatlandırır. Gönderim bu dökümü çalıştırma günlüğüne yazar.

BudgetEnforcementService: Ajan başına aylık harcamayı ve gönderim öncesi bir bloğu (checkInvocationBlock) hesaplar. Bu bloğa yalnızca kurtarma uzlaştırıcıları (OrphanRunReaper, StrandedTicketReconciler) başvurur; sıradan bir kullanıcı ya da ajan gönderimi asla.

BudgetGovernanceService: Her çalıştırmadan sonra ajan başına aylık harcamayı değerlendirir — yumuşak bir eşik bir uyarı olayı kaydeder; tükenme katı bir olay kaydeder ve ajanın yaşam döngüsünü paused durumuna çevirir.

Olaylar

DomainEventBus: Özellikler arası iletişim için süreç içi yayın tabanlı publish/subscribe veri yolu. Olaylar tiplidir; aboneler on<T>() akışlarını tüketir.

DomainEvent: Temel arayüz. Her olayda occurredAt vardır. Temel kategoriler: çalışma alanı/ajan, PR/inceleme, mesajlaşma, biletleme, pipeline, toplantılar/takvim, kimlik, rig’ler, gözlemlenebilirlik.

Toplantılar ve takvim

Toplantı: Yerel olarak kaydedilen ve yazıya dökülen bir toplantı oturumu. Mikrofonu ve sistem sesini yakalar, cihaz üzerinde seçilebilir bir ASR modeliyle (varsayılan olarak Parakeet TDT v3; Parakeet TDT v2, Whisper large-v3-turbo ve Whisper base.en alternatiflerdir) yazıya döker, konuşmacıları ayırır ve notlar, eylem öğeleri ve kararlar hâlinde özetler. Seçilen ASR modeli önyüklemede zorla kurulur ve kayıt işlemleri bir yeniden başlatmanın ardından devreye girer. Çalışma alanına özel; makinede kalır.

MeetingSegment: Konuşmacı etiketli (me/them), bir diarizasyon etiketi ve milisaniye cinsinden ofsetler taşıyan, yazıya dökülmüş tek bir ses penceresi.

MeetingActionItem / MeetingDecision: Özet pipeline’ı tarafından çıkarılan ve ayrı satırlar olarak saklanan yapılandırılmış çıktılar. Eylem öğeleri bir bilete bağlanabilir.

CalendarEvent: Bir çalışma alanına ve bağlı hesaba kapsamlı, eşitlenmiş bir Google Calendar girdisi. Bir Toplantıdan farklıdır: bir etkinlik planlanmış bir taahhüttür; bir Toplantı kaydedilmiş bir oturumdur. Bir MeetingCalendarLink ile bire bir bağlanır.

CalendarAccount: Çalışma alanı ve e-posta başına bir bağlı Google hesabı. OAuth yenileme jetonları sunucu tarafında <dataDir>/secrets.json içinde google_* anahtarları olarak saklanır ve hiçbir zaman bir istemciye ulaşmaz; cihaz kodu akışı sunucuda tamamlanır. Bir authExpiredAt bayrağı yeniden bağlanma şeridini yönetir.

Mimari terimler

Clean Architecture: Bağımlılık kuralı: Presentation → Application/Providers → Domain ← Infrastructure. Alanın sıfır altyapı içe aktarımı vardır.

Portlar ve adaptörler: Alan soyut arayüzleri (portlar) tanımlar; altyapı somut uygulamaları (adaptörler) sağlar. Kompozisyon kökü bunları bağlar.

Paylaşılan çekirdek: core/domain/ altında 3+ özellik arasında paylaşılan varlıklar, değer nesneleri, portlar ve hizmetler.

Özellik öncelikli: Kod, teknik katmana göre değil, iş alanına (ajanlar, pipeline’lar, mesajlaşma) göre düzenlenir.

Çok oyunculu, kimlik ve hız

Principal: İnsanları ve ajanları tek aktör soyutlaması olarak birleştiren mühürlü bir değer — UserPrincipal(userId) veya AgentPrincipal(agentId). Her ileti, bilet, inceleme, plan ve çalıştırma günlüğü bir Principal üzerinden atfedilir.

User: global.db içinde saklanan ve dolayısıyla çalışma alanları arasında global olan bir insan kimliği. Bir çalışma alanını oluşturan principal onun sahibi olur — aynı işlemde Workspace.ownerUserId üzerine ve sahip rolünde bir üyelik satırıyla damgalanır. Diğerleri davetle ya da SSO ile katılır.

WorkspaceMember / WorkspaceRole: Bir User’ı bir Workspace’e bir rolle (owner / admin / member / viewer / guest) bağlayan bir üyelik satırı. Erişim sınırı, bir eşleştirme anahtarı değil, üyeliktir. Depo başına yetkiler, üyeliğin forge’dan daha fazla ayrıcalık kazanmasını engeller.

ParticipantPresence: Bir Principal için geçici farkındalık (durum, konum, imleç, yazıyor olma, bir ajanın canlı durumu ve çalışan maliyeti). Hiçbir zaman kalıcılaştırılmaz; sunucu merkezlidir; dağıtımdan önce depo yetkisiyle filtrelenir.

Takip modu: Bir avatarı tıklayın; siz harekete geçene kadar onun görüntüsünü takip edin, sonra ayrılın. Hem insanlar hem de ajanlar için çalışır (“bir ajanın çalışmasını izleyin”).

Özerklik kadranı: Alan başına ve ajan başına bir denetim — propose-only / act-with-approval / act-freely — eylem koruma deposu üzerinde adlandırılmış bir profil olarak uygulanır.

ActionClass: 13 etki sınıfından oluşan kapalı bir küme (fileDelete, gitPush, prCreate, networkEgress, processSpawn, enclosureControl, …). Değiştirici her araç sınıflarını bildirir; koruma motoru kapsam başına allow / prompt / deny kararını verir (alan > ajan > çalışma alanı > mod ön ayarı > yerleşik varsayılan).

WriteLedger / idempotency anahtarı: Her mutasyon, istemci tarafından üretilen bir idempotency anahtarı taşır (UUIDv7, mantıksal eylem başına). Çalışma alanına özel defter, işleyici çalışmadan önce tekilleştirir; bir yeniden oynatma, bayt bayt aynı özgün sonucu döndürür. Yeniden bağlanmayı ve çok istemcili çalışmayı yapısı gereği güvenli kılar.

“Needs me” gelen kutusu: Tüm sütunları kapsayan bir kuyruk; katı bir kuralı vardır — bir öğe yalnızca bir şeyi engelliyorsa (bir ajanı, bir birleştirmeyi, bir eşitlemeyi) ya da açıkça operatörü istiyorsa görünür.

Plan Studio: Etkileşimli planlama yüzeyi — adım başına maliyet, zaman ve riskle düzenlenebilir tipli DAG planları ve kısmi onay.

Review compute: Sunucu tarafı PR inceleme hesaplaması (graftan türetilen kohortlar, tipli diyagramlar, görsel diff’ler, API sözleşme diff’leri, çok eksenli kapılar), review_studio.* üzerinden sunulur ve İnceleme sekmesine katılır.

Review space: Bir PR’ın tek destek alanı (mode review, kind pr), idempotent biçimde oluşturulur ve PR’a bir ReviewSpaceAssociation ile bağlanır. Her inceleyici bulgularını oraya kaydeder; bulguları karşılaştırılabilir kılan da budur; yalıtılmış çalışma ağacında PR, head’inde checkout edilmiş olarak durur.

Review node: Bir YZ inceleme bulgusunun yapılandırılmış birimi: tür (bug, suggestion, recommendation, question, ticket), P0–P3 önceliği, kategori/önem/emek üçlüsünden oluşan bir triyaj, bir dosya-ve-satır çapası, isteğe bağlı önerilen düzeltme ve bir güven puanı. add_review_node ile kaydedilir; karar düzyazıdan değil, düğümlerden hesaplanır.

Consensus-ready: Yalnızca bir akran inceleyici bir bulguyu doğruladığında ulaşılan inceleme düğümü durumu — bir ajan kendi bulgusunu doğrulayamaz. İnceleme sekmesinin GitHub’a yayınla düğmesi kalan tüm açık bulguları (selection: all_open) gönderir; MCP aracı publish_review_to_github hâlâ varsayılan olarak yalnızca akran onaylı bulguları gönderir.

Review level: Hangi inceleyicilerin dağıtılacağını (yalnızca engineer; +qa+architect; +security+perf) ve eşik altı bulguların nerede görüntüleneceğini ayarlayan çalışma alanı politikası (light, balanced, thorough). Bir bulguyu asla silmez.

Review axis: İnceleme başına beş puanlama şeridinden biri: correctness, security ve testGap inceleyici bulgularından alınır; visual ve apiContract ise belirleyicidir. Kapılanan eksenler karara katılır ve onu yalnızca daha ağır yapabilir — partial ya da unavailable bir kapı, kararı geçirmek yerine askıda tutar.

Review verdict: ship, hold veya block. Güveni ≥ 0.7 olan herhangi bir P0 bulgusu block verir; diğer herhangi bir P0 ya da herhangi bir P1 hold verir; aksi hâlde ship. Kapılanan ve başarısız olan bir eksen block’u zorlar ve bulgular tarafından alt edilemez.

Filo ve eval’ler

cc_worker: Headless, saf Dart bir filo yürütücüsü ikilisi. Bir cc_server ile eşleşir, ana makine yeteneklerini bildirir, kiralanmış işleri çeker, yürütür ve süreç olaylarını geri akıtır. Kalıcı durum tutmaz — bir yetkili sunucu, N aptal uzuv.

JobSpec: Yürütülebilir her şeyin tipli spesifikasyonu (ajan çalıştırması, pipeline adımı, kod indeksi, golden render, kıyaslama, eval partisi).

Eval paketi: Çalışma alanına özel bir değerlendirme tanımı (istem, hedef ajan ve mod, değerlendiriciler). Çalışma alanı oluşturulduğunda beş başlangıç paketi tohumlanır; Gözlemlenebilirlik → Kalite bunları listeler.

Dağıtım ve istemciler

İnce istemci mimarisi: Hiçbir istemci veritabanını açmaz; headless bir cc_server süreci verinin sahibidir ve onu WebSocket RPC üzerinden sunar. Her istemci (masaüstü, web, telefon) o tek RPC bağlantısı üzerinden çizen bir istemcidir.

cc_server: Headless sunucu ikilisi (saf Dart, Flutter motoru yok). Drift/SQLite veritabanının sahibidir, WebSocket üzerinden repo-RPC sunar ve arka plan hizmetlerini (pipeline’lar, MCP, uzlaştırıcılar) çalıştırır.

ServerConnectionMode: Masaüstünün sunucusuna nasıl ulaştığı — local (bu makinede bir cc_server başlatır, varsayılan) veya remote (başka bir yerdekine bağlanır). Web istemcisi her zaman remote’tur.

RemoteRpcClient: Her ince istemcinin sunucusuyla konuşmak için kullandığı, taşıma katmanından bağımsız JSON-RPC istemcisi — WSS, loopback ya da aracılı relay üzerinden.

Çağrı başına çalışma alanı kapsamı: Sunucu durumsuzdur — oturum başına hiçbir çalışma alanı bağlaması yoktur, bu yüzden tek bir sunucudaki birden çok istemci hiçbir zaman bir “geçerli çalışma alanını” paylaşmaz. Çalışma alanına kapsamlı her repo/call ve sub/subscribe, argümanlarında workspace_id taşımalıdır; eksik ya da kayıtsız bir kimlik, herhangi bir veritabanı açılmadan önce reddedilir. Erişim daha sonra oturumla değil, çalışma alanı üyeliği ve rolüyle kapılanır.

cc_remote: Telefon ince istemcisi — varsayılan olarak reddeden bir araç politikasıyla filoyu aracılı relay üzerinden uzaktan kontrol eden bir Flutter web PWA’sı.

cc_signaling_server: Davetle kapılanan odalar barındıran durumsuz bir WebSocket relay broker’ı — yalnızca uçtan uca mühürlenmiş çerçeveleri ileten, hiçbir uygulama verisi tutmayan ve eşleştirme PSK’sını asla görmeyen aptal bir relay.