Ekranda Göster, AI Koda Gitsin

SourceMap inceleme modu: ekrandaki her component adı ve dosya:satırıyla çerçeveleniyor

Problem: insan koda inmek zorunda kalıyor

Bir masaüstü uygulaması geliştirirken yapay zekâ ile çalışıyorsun. Ekranda bir şey görüyorsun — bir buton yanlış yerde, bir liste kasıyor, bir kart bozuk görünüyor. AI'ya "şunu düzelt" demek istiyorsun.

Ama AI senin gördüğünü göremiyor. Ona tarif etmek için sen koda iniyorsun: hangi dosya, hangi satır, hangi component? Koca repoda arıyorsun. Her seferinde tekrar eden bir el-emeği, bir sürtünme.

Oysa temel ilke şu olmalı: gördüğün her şey, AI'ya tarif edilebilir olmalı. Sen ekranda göster, kod-yolu kendiliğinden çıksın.

Fikir: insan UI katmanında kalsın

İnsan–AI etkileşiminde insanın yeri UI katmanıdır — gözünle gördüğün yüzey. Kod tarafına inmek zorunda kalman senin işin değil, aracın eksikliğidir.

Çözüm basit: UI ile kodu birbirine bağlamak. Ekrandaki her görsel elementin, koddaki konumunu (dosya:satır) taşıması.

Bu yeni bir problem değil. Tarayıcılarda çoktan çözülmüş: "Inspect Element" ile bir web sayfasında herhangi bir öğeye gelirsin, kaynağını görürsün. On yıllardır var. Eksik olan, aynı deneyimin macOS native uygulamalarda olmaması. SourceMap tam olarak bunu yapıyor.

Nasıl çalışıyor

SwiftUI view'ına bir kez etiket koyuyorsun:

CartView().sourceMap("cart")

Sonrası:

• ⌥I ile inceleme modunu açıyorsun — ekrandaki her component, adı ve dosya:satır'ıyla çerçeveleniyor (yukarıdaki ekran görüntüsü tam olarak bu)
• Fareyi gezdiriyorsun — iç içe geçmiş component'ler zincirleniyor
• ⌥scroll ile derinliğe iniyorsun, en içteki elementi nişan alıyorsun
• ⌥C ile cart — CartView.swift:42 panoya kopyalanıyor

Bu metni doğrudan AI'ya yapıştırıyorsun. Artık AI aramıyor — tam o dosyaya, o satıra gidiyor.

Önemli ayrıntı: dosya:satır'ı sen yazmıyorsun. Swift derleyicisinin #fileID ve #line sabitleri bunu etikete otomatik gömüyor. Etiketi koydun mu, gerisi kendiliğinden gelir; satır numarası elle takip edilmez.

Tek kimlik, üç yüzey

İşin asıl güzel tarafı: aynı isim üç yerde birebir yaşıyor.

EKRAN          KOD                      DOSYA
cart      =    .sourceMap("cart")  =    ...component.Cart.swift

Biri değişince diğeri kırılır. İsmi değiştirdin mi, ekranda da kodda da dosyada da senkron olmak zorunda. Yanlış eşleme fiziksel olarak imkânsız — çünkü hepsi tek kaynaktan türüyor.

Altında derin bir tasarım ilkesi var: hatayı çözmek yerine, hatanın var olmasını engellemek. İki yeri elle eşleştirirsen er ya da geç kayar. Tek yerden türetirsen kayamaz.

Neden bu kadar hızlandırıyor

Bir hata gördüğünde döngü şu hale geliyor:

ekranda elementi göster → ad — dosya:satır kopyala → AI'ya ver → AI nokta atışıyla o satıra gider → düzeltir.

Arama yok. Tahmin yok. "Hangi dosyaydı bu?" yok. Ne yaptığını biliyorsun, çünkü gördüğün şey doğrudan koda bağlı. macOS'ta yazılım geliştirme bu yüzden inanılmaz hızlanıyor: insan gözüyle görür ve gösterir, AI koda gider.