Anatomy: Kavramı kutu ve okla değil, çalışan bir makineyle anlatan skill

Kutu ve ok yerine makine

Mermaid, D2 ya da Excalidraw gibi araçlar neyin neye bağlı olduğunu gösterir. Anatomy’nin derdi başka: Bir şeyin nasıl davrandığını göstermek. Bunun için ajana, kavramın kendisi gibi çalışan fiziksel bir nesne icat ettiriyor. README’deki örnekte, hiçbir şey değişmediyse işi atlayan bir önbellek anahtarı, ancak bütün pimler hizalanınca dönen bir kilide dönüşüyor.

Sitedeki örnekler arasında LRU önbelleği, TCP el sıkışması, Bloom filtresi, B-tree indeksi, debounce ve throttle, mutex ve dil modellerindeki “temperature” ayarı var. Bir de Raptor roket motoru ya da turbofan gibi doğrudan makine çizimleri.

Proje, @wheresryan22 kullanıcı adlı bir geliştiricinin 8 Ekim’de yayımladığı, MIT lisanslı bir depo. İki haftadan kısa sürede GitHub’da 18 binden fazla yıldız topladı.

Nasıl çalışıyor?

Anatomy standart bir agent skill, yani kökünde SKILL.md olan bir klasör. Bunun ne demek olduğunu agent skill yazımızda anlattık. Claude Code, Codex, OpenCode, Antigravity ve MiniMax Code’da çalışıyor. npx skills add wheresryan22/anatomy -g ile kuruluyor, sonra /anatomy explain how a token bucket rate limiter works, interactive gibi bir istek yazıyorsun. Bağımlılığı yok, Node 20.10 yeterli. Çıktı tek başına bir HTML sayfası, bir SVG dosyası ya da React bileşenleri olarak projene düşüyor.

Üç tür figür var: Gölgeli izometrik parçalardan oluşan SVG; ateş, su, ışık gibi çizgiyle çizilemeyen şeyler için SVG + WebGL; parçaların gerçekten üç boyutta döndüğü ve henüz beta olan 3D modu.

Asıl ilginç olan, skill’in çalışma sırası. İlk adım gerçek sayıları toplayıp kavramın küçük bir modelini kurmak. Çizim ancak ondan sonra geliyor. Ekrandaki göstergeler elle yazılmıyor, bu modelden besleniyor. Sonra ajan arka planda Chrome açıp kendi çizimini kontrol ediyor: Hiçbir boru başka bir parçanın içinden geçiyor mu, her çizgi bir yere bağlı mı? Ekran görüntülerini ve yakın çekimleri tek tek inceliyor.

Bedeli: zaman ve token

Proje bunu saklamıyor: Anatomy bilerek yavaş. Sitedeki ölçeğe göre normal bir figür 30–90 dakika, daha büyük bir “hero” figür 2–4 saat, bütün bir aracı ya da tesisi çizen “epic” figür 6 saat ve üstü sürüyor. Epic işlere kullanıcı onay vermeden başlamıyor. Örneklerdeki Raptor motoru toplamda 10,5 saatten, turbofan 14 saatten fazla sürmüş. Better Stack videosu da kullandıkça ödediğin bir plandaysan buna ayrı bir token bütçesi ayırmanı öneriyor.

İki uyarı daha var. Sitede, Claude’un bu figürleri kurmakta çok iyi olduğu ama onları görmekte her zaman o kadar iyi olmadığı yazıyor. İlk çıktıyı taslak say. İkinci uyarı videoda: Otomatik kontroller çizimin düzgün olduğunu kanıtlıyor, benzetmenin doğru olduğunu değil. Bir kavramı kilitle anlatmak, ancak o benzetme kadar doğru. Ayrıca Anatomy bir grafik kütüphanesi değil. Eksen, seri, veri grafiği yok. İnsan ya da harita da çizmiyor.

Kimin işine yarar?

Teknik doküman, blog yazısı ya da ders materyali hazırlıyorsan, veya bir açılış sayfasında ürününün nasıl çalıştığını göstermek istiyorsan denemeye değer. Normal boyutlu bir figürle başla ve çizime güvenmeden önce benzetmeyi oku. Sadece bir mimariyi hızlıca belgelemek istiyorsan Mermaid gibi araçlar hâlâ çok daha hızlı ve ucuz.

Düşün

• En son anlatmakta zorlandığın teknik kavram neydi? Onu hangi makineye benzetirdin?
• Bir benzetme yanlış bir şey öğretiyorsa, bunu okurdan önce kim fark eder?

Kendi cümlelerimizle yazılmış bir özettir, çeviri değildir. Tüm kaynaklar yukarıda.