Görseli tek başına verme; varsa işaretleri, açıklamayı ve source ilişkisini birlikte taşı

13 Tem 2026Nasıl çalışıyorum?

Etiketler

LINEAGEParent/child/relation soy ağacı gerekiyor.
EVIDENCE-UIGörsel kanıtla anlaşılır.

Soy ağacı grafiği, arayüzde görünen bir parçayı tek başına resim olarak bırakmaz. Resim, varsa resmin üzerindeki işaretler ve onların anlamı, o parçanın ait olduğu component/source-map izi ve kullanıcının konuşarak verdiği niyet birlikte okunur.

Bu yüzden burada her kart görsel kanıt, açıklama ve kartlar arası akış metni taşır. Görselin üzerinde gerçek işaretler varsa onların açıklaması da aynı kartta kalır; işaret yoksa numaralı legend üretilmez. Kartlar arası metin en az görsel kadar önemlidir; çünkü “bu örnek neden var, bir sonrakine nasıl bağlanıyor?” sorusunu o cevaplar.

Temel amaç şu: kod tarafını anlatmak yerine, gördüğün çıktıyı işaretlemek. İnsan UI üzerinde konuşur ve işaretler; agent, o işaretli yüzeyden component'i, source dosyasını ve yapılacak değişikliği bulur. Böylece çalışma, “hangi kodu değiştir?” sorusundan “hangi gözlenen sonucu istiyoruz?” sorusuna döner.

İlk kapalı set, What's New entry'si için kuruldu. Buradaki önemli ders şu: ortaklaştırılacak en küçük parça resim değildir; ortaklaştırılacak en büyük güvenli parça image-card soy ağacıdır. Yani resim ve caption her zaman, yalnız görselde karşılığı olan işaretlerin legend'ı ise koşullu olarak tek ailede taşınır.

What's New entry için kapalı soy ağacı seti — What's New image-card soy ağacı, çıplak resim yerine paylaşılacak en büyük güvenli component'i tanımlar.

Bu kapalı setin pratik sonucu şudur: Guide, What's New içindeki 15 indeksli Cockpit kartını kullanacaksa sadece PNG'ye link vermez. Source entry'deki feature-block ve image-card'ı çağırır. Böylece caption ve 1–15 indeks açıklamaları ikinci kez yazılmaz, ama Guide'da da görünür kalır.

Aynı mantık doküman içinde de çalışır. Bir ekran görüntüsünü dokümana koyduğunda, görüntünün etrafındaki source-map veya component satırı da soy ağacının parçasıdır. Agent yalnız resmi değil, “bu resimde hangi component/source ipucu seçilmiş?” bilgisini de görür.

Dokümanda source map ve yakalama aksiyonlarıyla işaretlenmiş lineage örneği — Dokümandaki lineage görünür olunca agent, işaretlenen UI parçası ile source map bilgisini aynı bağlamda okur.

Bu örnekte doküman, hızlı bir açıklama yüzeyi gibi çalışır. Kullanıcı resmi koyar, index çizer, konuşarak neye baktığını söyler. Resmin altında source-map görünür olduğu için agent “bu UI parçası hangi dosya/component ile ilişkili?” sorusunu tahminle değil, görünür kanıtla yanıtlar.

Bir sonraki örnekte aynı işlem daha dar bir seçime iner. Burada bütün ekran değil, seçilen node/component satırı önemlidir. Geliştirme sırasında çoğu karar böyle daralır: önce geniş görüntü, sonra seçili component, sonra source path.

Component satırı seçilmiş lineage graph örneği — Seçili satır, hangi component'in konuşulduğunu ve hangi kaynak dosyanın değişeceğini görünür yapar.

Bu iki doküman örneği, soy ağacının sadece UI süsü olmadığını gösterir. Soy ağacı, node ve edge ilişkisini görünür yapan çalışma protokolüdür: görünen yüzey → seçili component → source map → konuşma niyeti → agent aksiyonu.

Bu protokolün asıl değeri, çalışma ekranının tamamında görünür olur. Geliştirme düzeninde ürün yüzeyi, VS Code Cockpit paneli, agent terminalleri, terminal içeriği ve Source Control aynı anda görünür. Böylece kullanıcı kodu açıp tarif etmek yerine, çıktılar arasında swap atarak konuşur.

optionOS, VS Code Cockpit, agentlar, terminal ve Source Control ile çalışma düzeni — Çalışma düzeni; ürün yüzeyi, Cockpit paneli, agentlar, terminal ve source view aynı ekranda tutulduğunda hızlı konuşarak geliştirme mümkün olur.

Bu düzenin glue layer'ı şudur: kullanıcı kendi uygulaması üzerinde ses kaydını açar, gördüğü sonucu konuşarak işaretler, agent ise terminalde gerçek işi yapar. Source Control tarafı da sonuç judge'ı gibi kalır; hangi dosyalar değişti, ne staged, ne unstaged görünür olur.

Terminal ve agentlar çoğalınca bir üst kontrol yüzeyi gerekir. Cockpit burada devreye girer. Cockpit, agent oturumlarını kartlara çevirir: bekleyenleri, çalışanları, host uygulamayı, modeli ve hızlı aksiyonları tek grid içinde gösterir.

Cockpit uygulamasında ajan kartları, bekleme durumu ve özel agent kartları — Cockpit, çalışan ve bekleyen agentları kart olarak gösterir; bekleyen kartlar aksiyon yüzeyi olur, çalışanlar ise düşük öncelikli izleme sinyali olarak kalır.

Bu katmanda amaç “tüm agentları okumak” değildir. Amaç, insan kararını değiştiren agentı bulmaktır. Waiting kartı aksiyon ister; çalışan kartlar ise sadece izleme sinyalidir. Codex gibi hızlı ve kontrol edilebilir agentlar bu yüzden ayrı kart olarak hızlı başlatılır.

Aynı ilişki fikri sadece agent kartlarında değil, component seçimi sırasında da kullanılır. Inspector açıldığında UI'daki parça seçilir, o parçanın source path'i görünür olur ve konuşmadaki işaret aynı aileye bağlanır.

Inspector ile component seçimi ve source map lineage ilişkisi — Inspector açıldığında seçilen component, source path ve konuşmadaki işaret aynı lineage ailesine bağlanır.

Bu sayede geliştirme yaparken “şu Swift dosyasını aç” diye tarif etmek gerekmez. Kullanıcı Inspector'ı açar, component'i seçer, işaretler ve konuşur. Agent, seçili component ile source path arasındaki bağı kullanarak doğru dosyaya gider.

Son katman yakalama akışıdır. Capture Actions menüsü, Inspector, konuşma sırasında yakalanan resimler/dosyalar ve akıllı yerel uygulama barı aynı anda görünür olduğunda kullanıcı indeksleri bile konuşarak üretebilir. Yani işaretleme ayrı bir manuel dokümantasyon işi olmaktan çıkar, çalışma akışının parçası olur.

Yakalama aksiyonları, inspector ve konuşma yakalama listesi — Inspector, yakalama aksiyonları ve konuşma listesi birleştiğinde kullanıcı kodu tarif etmeden UI parçasını, dosyayı ve niyeti agent'a verebilir.

Büyük resim şu: her görsel kendi içinde bir soy ağacı taşır; görsel + açıklama ve varsa görseldeki işaretlerin legend'ı bir image-card ailesidir; image-card aileleri arasındaki metin de workflow soy ağacıdır. Bu yüzden doküman sadece resim galerisi değildir. Konuşmanın glue layer'ı, görselleri tek bir çalışma yöntemine bağlar.