"Yapay zekanın yazıları o kadar uzun ki düzgün okuyamıyorum 😅"
"Claude Code'a ayda 15.000 yen'den fazla para ödüyorum ama karşılığını aldığımı düşünmüyorum."
Birçok insan sadece yapay zeka kullandığı için memnun, ancak çok azı bunu gerçekten sonuçlara dönüştürebiliyor. Bu, "kullanmış gibi hissetme" halidir.
Claude Code ile bu deneyimleri yaşadınız mı?
- Pazartesi sabahı "geçen haftaki rakip trendlerini özetle" diyorsunuz ve size uzun bir rapor döndürüyor. Bir göz atıp okumadan bırakıyorsunuz.
- Yapay zeka tarafından üretilen materyalleri siz düzgün okumuyorsanız, ekip arkadaşlarınızın da okumadığından şüpheleniyorsunuz.
- Claude Code'a aylık 3.000 yen'den fazla ödüyorsunuz, ancak çıktılar hiçbir toplantıda veya teklifte kullanılmadı.
- ChatGPT ve Claude.ai çıktıları güzel görünüyor, ama neden Claude Code sadece Markdown çıktısı veriyor ve okuması bu kadar yorucu?
Bu makale tam da bu kişiler için.
Okumayı bitirdiğinizde, hem sizin hem de başkalarının gerçekten okuyacağı materyalleri Claude Code'dan doğal bir şekilde üretebileceksiniz.
Ayrıca, "hangi formatta çıktı verdiğinizin", kullanıcı yargısında "Claude Code'a ne yaptırdığınızdan" çok daha büyük bir faktör olduğu perspektifini de kazanacaksınız.
Claude Code'u fiilen geliştiren Anthropic'teki geliştirici Thariq Shihipar (@trq212), X'te şirket içinde yayılan bir zihniyet hakkında yazdı ve bu, Claude Code topluluğunda en çok kaydedilen ve paylaşılan gönderilerden biri haline geldi.
Yayınlandığı anda büyük yankı uyandırdı.
Bu, yapay zeka meraklıları için küçük bir ipucu değil; aracı yapan kişinin, yapay zeka endüstrisinin örtük standardı haline gelen Markdown'a meydan okuyarak "artık böyle değil" dediği bir hikaye.
Bunun önemli olduğunu düşündüm ve hemen Japonca açıklamaya karar verdim.
Okumaya başlamadan önce iki şey:
- Bunu yer imlerine ekleyin. Sadece bu hafta için, HTML çıktısı almayı denemek için biraz zaman ayırın.
- Claude Code kullanan ekip arkadaşlarınız varsa, bunu onlarla paylaşın. Haftalık raporlarınızın ve PR incelemelerinizin "okunma" şekli önümüzdeki haftadan itibaren gözle görülür şekilde değişecek.
İçeriği, Japon iş dünyasında nasıl işlediğine çevirerek adım adım açıklayacağım 👇
Orijinal gönderi burada:
https://x.com/trq212/status/2052809885763747935
Anthropic Geliştiricisinin Kendisi Artık Markdown Kullanmıyor
Başlangıç noktası burası. Orijinal gönderiyi yazan Thariq Shihipar (@trq212), Anthropic'te Claude Code'u geliştiren geliştiricidir. Claude'un "plan modunda" gereksinimleri iyileştirmek için kullanıcıya geri soru sorma davranışı, onun bizzat uyguladığı bir özellikti.
Yaptığı araçtan artık Markdown kabul etmediğini söylüyor. Kendi deyimiyle Markdown, onun için kısıtlayıcı bir format haline geldi.
Bu sadece kişisel bir tercih değil. Thariq, HTML benimsemesinin Claude Code ekibinin kendi içinde yayıldığından bahsediyor. Aracı yapan insanlar, ürettiği Markdown'u terk edip HTML'ye geçiyor.
Ve kanıtı elle tutulur. https://thariqs.github.io/html-effectiveness/ adresindeki demo sitesinde, 20 adet kendi kendine yeten HTML örneği bulunuyor. Gecikmeli aramaya üç yaklaşımın karşılaştırması, görev tamamlama için başarı hissi yaratan mikro etkileşimler, tasarım sistemi token listeleri, kod örnekleri için sekmeli açıklamalar ve kenar boşluklarında sözlük bulunan okuma materyali. Bunların hepsi, "sadece göz attığınız belgeleri" "sonuna kadar okunan belgelere" dönüştürmenin gerçek örnekleri. Hemen şimdi tarayıcınızda açabilirsiniz.
Bunu okurken bir şeyin farkına varmalısınız. Genellikle ChatGPT veya Claude.ai'de aldığınız Artifact'ler—"sekmeli arayüzler", "renkli diyagramlar" ve "etkileşimli düğmeler"—aslında HTML olarak çıktılanıyor. Buradaki farkına varış şu: "Bu kadar iyi görünmelerinin sebebi formatın kendisindeki farktı." Şimdi aynı dünyayı Claude Code ile parmaklarınızın ucuna getirebilirsiniz.
Şimdiye kadar, yapay zeka tarafından üretilen metin neredeyse tamamen Markdown'dı. Onu yapan kişi sessizce itiraz etmeye başlıyor, "artık değil" diyor. Haberin özü bu. Ancak her gün yapay zeka ile çalışan sizin için bu, Pazartesi sabahından itibaren etkili olacak bir hikaye.
Markdown, Yapay Zeka Endüstrisinin Örtük Standardıydı
Kanıksadığımız varsayımları doğrulayalım. Bu olmadan, HTML'ye geçiş sadece bir zevk meselesi gibi görünebilir.
Şimdiye kadar Markdown, yapay zeka çıktısı için fiili standarttı. Her gün gördüğünüz metinleri düşünün:
- Proje kökündeki CLAUDE.md, ajan tanımları için *.md, Skills için SKILL.md.
- Anthropic'in resmi dokümantasyonu, Claude.ai Yardım ve çeşitli Claude Code kılavuzları.
- Rakip yapay zeka geliştirme araçları, Cursor kuralları, GitHub Copilot talimatları ve Cline talimatlarının tümü .md tabanlıdır.
- Dahili Wikiler, GitHub README'leri, Notion'dan dışa aktarılan metinler ve Slack'e yapıştırılan toplantı notları.
- ChatGPT sohbetlerinden kopyalanan özet metinler.
Her şey Markdown varsayımı üzerine inşa edildi. Yapay zeka ile uğraşırken karşılaştığınız metin bilgilerinde Markdown dışında bir format bulmak daha zordur.
Karpathy'nin CLAUDE.md deseninin GitHub'da 80.000'den fazla yıldız toplaması, tam da Markdown'un endüstrinin ortak dili olması nedeniyleydi.
Thariq'in sözleriyle, Markdown ajanlar için ana akım format haline geldi. Kendisi uzun süredir Markdown varsayımı üzerine araçlar inşa eden biridir.
Şimdi o kişi açıkça belirtti: Markdown benim için kısıtlayıcı bir format haline geldi. Bu, bir Anthropic içeriden öğreneninin tüm endüstrinin üzerinde gittiği varsayıma taş attığı an.
Basitçe söylemek gerekirse: Claude Code'dan aldığınız Markdown, Cursor'un okuduğu kurallar ve dahili Wiki'nizdeki yapay zeka çıktılarının tümü aynı "Markdown iyidir" akışının parçasıydı. Bunu yaratan kişi farklı bir kanal çizmeye başladı.
Buradan itibaren, Markdown'un neden insanlara ulaşmadığı ve onun yerine ne konulacağı konusunun ayrıntılarına gireceğiz.
Markdown'un Okunmamasının 5 Nedeni
Markdown'un sınırlamalarını düzenleyelim. Bu, teknik özelliklerle ilgili değil; Pazartesi'den Cuma'ya kadar olan günlük deneyiminizle ilgili. Orijinal makaledeki HTML'nin faydalarını, Markdown'un zayıf yönlerini göstermek için tersine çevirerek listeledim.
① 100 satırı geçerse, siz bile okumazsınız
Thariq, bir Markdown dosyası 100 satırı geçtiğinde okumayı bıraktığını kendisi yazıyor.
Claude Code'dan "geçen haftaki rakip trendlerini özetle" diye istediğinizde, 120 satırlık yanıtı kaydırmadan kapatma deneyimini yaşamışsınızdır. Bunu üreten kişi okumazsa, ekipteki hiç kimse okumaz. Gerçek şu ki, sadece yazar değil, organizasyondaki diğer üyeler de sadece göz atıyor.
② Paylaşılsa bile tarayıcıda güzel açılmaz, bu yüzden kimse dokunmaz
Markdown, tarayıcılarda doğal olarak güzel bir şekilde işlenmez. Slack'te satır sonları bozulur, e-postalarda biçimlendirme kaybolur ve teklifler için PDF'ye dönüştürmek veya ekran görüntüsü almak zahmetlidir.
Her paylaştığınızda, birinin onu "okunabilir bir forma" dönüştürme işini yapması gerekir. Markdown, bağlantıların çoğu zaman tıklanmamasına varacak kadar, her paylaşıldığında sürtünme yaratan bir formattır.
③ Renk veya diyagram yok, bu yüzden sadece ana hat aktarılır
Sayılardaki bir farkı vurgulamak, kırmızıyla bir uyarı göstermek veya oklarla bir akış göstermek istersiniz. Bunu Markdown'da yapmak için, ASCII karakterlerle diyagramlar çizmek veya Unicode kutu çizim karakterleriyle renkleri ifade etmek zorunda kalırsınız.
Kimse bunu çözmek istemez ve yazan yorulur. Claude bir diyagram çizmek için çok uğraşsa bile, sonuçta üzerinden geçilir.
④ Dokunamaz veya hareket ettiremezsiniz, bu yüzden sadece okumakla kalır
Biraz daha sakin bir renk denemek, bir animasyonun hızını test etmek veya bir değeri 1,5 kat artırırsanız nasıl göründüğünü görmek istersiniz.
İş dünyasında, bir karar vermek için "denemek" gereken durumlar sık sık ortaya çıkar. Bunu Markdown ile yapamazsınız. Okursunuz, kafanızda simüle edersiniz ve ardından metin olarak talimatlar gönderirsiniz—verimsiz bir döngü.
⑤ Mobilde açıldığında bozulur
Hareket halindeyken Slack, e-posta veya Notion. Japon iş dünyasında, paylaşılan materyallerin yarısı ilk olarak mobilde açılır.
Markdown düzenleri ekran genişliğini takip etmez. Tablolar yatay olarak taşar, kod blokları garip bir şekilde sarılır ve başlık hiyerarşileri görünmez olur. Okuma isteği o anda kaybolur.
Buna bir isim verelim. Her okunmaz Markdown ürettiğinizde, gönderen ve alıcı için açmadan önce bile yorgunluk birikir. 100 satırı kaydırmanın, Slack'te satır sonlarını düzeltmenin, diyagram ve renk eksikliğinden kaynaklanan iletişim başarısızlığının, etkileşim kuramadığınız için geciken kararın ve mobilde bozulmanın maliyeti.
Bunların hepsi her gün ödenen gizli ücretlerdir. Bu makalede buna "Format Vergisi" diyoruz.
Bu küçük bir vergi değil. Claude Code'un değerinin yarısından fazlası, çıktının içeriğine göre değil, "kime ulaştığına ve ne kadar ileri gittiğine" göre belirlenir. İnsanlara ulaşmayan bir formatta çıktı vererek, aboneliğinizin yarısını çöpe atmış oluyorsunuz.
Nasıl Geçilir: Sadece "HTML dosyası olarak çıktıla" Ekleyin
Bunu fazla düşünmenize gerek yok. Yapmanız gereken, düşündüğünüzden çok daha az.
Her zamanki Claude Code isteğinizin sonuna sadece bir satır ekleyin. Aşağıdaki üçü aynı anlama gelir:
- "HTML dosyası olarak çıktıla"
- "Tek sayfalık HTML olarak çıktıla"
- "Okuyucunun doğrudan açabilmesi için HTML yap"
İngilizce yazmak size daha rahat geliyorsa, "make a HTML file" veya "make a HTML artifact" da iyidir. Sonuç aynıdır.
Claude Code, MCP, tarayıcı, git ve dosya sisteminden bağlam çekebilir. Claude Code'un gücü, çok daha geniş bilgi kaynaklarını ChatGPT veya Claude.ai'nin web sohbet sürümlerinden daha fazla tek bir HTML'de birleştirebilmesidir.
Bu, daha önce tartıştığımız konuya bağlanıyor. ChatGPT veya Claude.ai'de aldığınız ve "güzel" olduğunu düşündüğünüz Artifact'ler HTML olarak çıktılanıyordu.
Artık aynı dünyayı Claude Code tarafında alabilirsiniz. Zor bir teknik hikaye değil; sorma şeklinizdeki bir satırı değiştirerek, insanlara gerçekten ulaşan materyaller ortaya çıkacak.
Thariq makalesinde bir noktayı vurguluyor: "Bunun henüz bir /html Skill'i haline getirilmesini istemiyorum; insanların önce prompt'larla alışmasını istiyorum." Bu, Skills üreten Claude Code ekibinde bir geliştirici olmasına rağmen böyle.
Bunu bir Skill haline getirmeyi reddetmiyor. "Kullanım oturup yerleşmeden paketlerseniz, gerçekten etkili olan kısımları kaçırırsınız" diyor.
Anthropic içinde, sıklaşan HTML çıktıları Playground eklentileri gibi şeylerle bileşenleştirilmeye başlanıyor. Baştan bitmiş bir ürün beklemek yerine, önce tek satırlık bir prompt ile deneyerek işinize uyan deseni bulun. Ancak bu noktaya geldikten sonra bir Skill haline getirmeye geçin.
Her prompt'ta "HTML olarak çıktıla" yazmak bir görev gibi görünebilir, ancak formatı seçmek bir görev değildir. Claude'un Markdown çıktısı vermesinden, Claude'un HTML çıktısı vermesine geçtiğiniz anda, "önceden tasarlanmış bir Skill'i beklemek yerine çıktıyı tasarlayan" kişi olmaya yarım adım yaklaştınız.
Sadece HTML'ye Geçerek Değişen 5 İş Senaryosu
Bu bölüm, Pazartesi'den Cuma'ya kadar olan gerçek işler için etkilidir. Orijinal makaledeki beş kullanım durumunu Japon iş dünyasındaki sıklık sırasına göre yeniden sıraladım: Haftalık Raporlar/Araştırma Özetleri, Tekliflerin Paralel Karşılaştırması, Tasarım İyileştirmeleri, Karar Verme Düzenleme Ekranları ve PR/Spec İncelemeleri.
Her senaryo, mevcut sorun, Önce/Sonra ve son olarak Claude Code'a verilecek örnek bir talimatla özetlenmiştir.
[Senaryo 1] Haftalık Raporları ve Araştırma Özetlerini Diyagramlarla Sunmak
Japon iş dünyasında sık görülen bir durum. Pazartesi sabahı patronunuz "Geçen haftanın trendlerini özetle" der.
Önce: 120 satırlık Markdown'u Slack'e yapıştırırsınız. Satır sonları bozulur. Patronunuz açmaz. Yönetim toplantısı materyallerine dahil edilmez. "Claude'a yaptırdım" diyerek sözlü olarak açıklamak zorunda kalırsınız.
Sonra: Slack günlüklerini, Linear veya Notion bilet geçmişini, git günlüklerini ve dahili belgeleri içeren tek bir HTML sayfasında özetlersiniz. SVG kullanarak basit bir iş akış diyagramı eklersiniz ve üç kilit noktayı altta renkli bloklara koyarsınız.
Bunu dahili depolamaya koyup URL'yi paylaşırsanız, patronunuz işe giderken telefonunda açabilir, yönetim alıntı yapabilir ve toplantı notlarına yapıştırılabilir.
Buradaki kilit nokta, Claude Code'un MCP, tarayıcı, git ve dosya sisteminden bağlam çekebilmesidir. Bir web sohbetine "HTML yap" deseniz bile, bu kadar çok bilgi kaynağını tek bir dosyada birleştirmek zordur. Bu, sadece Claude Code'un oluşturabileceği bir haftalık rapordur.
Thariq, makaleleri için diyagramları, Claude Code'a kod klasöründeki tüm HTML'leri okutup tek bir sayfada özetleterek yaptığını yazdı. "Okunan bir haftalık rapor" ile "okunan bir açıklama makalesi için diyagram" yapısal olarak aynıdır.
▼ Örnek Talimat:
"Geçen haftaki tüm Slack etkileşimlerini, Linear bilet tamamlamalarını ve git günlüklerini oku ve patronumun 1 dakikada kavrayabileceği tek bir HTML sayfası olarak haftalık rapor çıktıla. SVG'de basit bir iş akış diyagramı ve altta renkli bloklarda üç kilit nokta ekle. Akıllı telefonda açıldığında bozulmadığından emin ol."
[Senaryo 2] 6 Teklif/Araştırma Seçeneğini Yan Yana Göstermek
Gelecek haftaki teklif için hangi yöne gitmeliyiz? Planlama, satış ve kurumsal planlamada birden çok seçeneğin oluşturulduğu ve karar vericilerle uyumun sağlandığı yaygın bir senaryo.
Önce: Altı seçeneği altı ayrı Markdown dosyasında gönderirsiniz. Müşteri tek tek açıp karşılaştıramaz. "En çok hangisini önerirsiniz?" diye sorarlar ve siz de kendinizin tam olarak karşılaştırmadığını fark edersiniz.
Sonra: Altı seçeneği farklı tonlar, yoğunluklar ve hedef kitlelerle tek bir HTML sayfasında bir ızgaraya yerleştirirsiniz. Her seçeneğin altına tek satırlık bir ödünleşim eklersiniz. Karar verici hepsini tek ekranda karşılaştırır ve hemen "Bunu ve bunu karıştırmak istiyorum" veya "#3'ün hedefini #1'in yoğunluğuyla kullan" diye yanıt verir. Paralel olarak gösterdiğiniz anda tartışmanın çözümü değişir.
Bir karar verici için, altı dosya almak ile altı seçeneğin tek ekranda sıralanması arasında yargılama süresi açısından dağlar kadar fark vardır. Bu, "okumalarını sağlamak"tan çok, "karar vermelerini sağlamak"la ilgilidir.
▼ Örnek Talimat:
"Gelecek haftaki sunum için farklı tonlar, yoğunluklar ve hedef kitlelerle 6 teklif seçeneği oluştur ve bunları tek bir HTML sayfasında bir ızgaraya yerleştir. Her seçeneğin altına tek satırlık bir ödünleşim yaz. Ayrıca, karar verildikten sonra sonucu Markdown olarak kopyalamak için altta bir düğme ekle."
[Senaryo 3] Tasarımlara ve Prototiplere Dokunarak Karar Vermek
Renklere, boyutlara veya hareketlere karar verirken, metin üzerinden uyum sağlamaktan vazgeçmelisiniz. Bu, pazarlama, halkla ilişkiler ve planlamanın teşekkür e-postaları veya açılış sayfası düğmeleri üzerinde birçok kez ileri geri gittiği bir senaryodur.
Önce: "Biraz daha sakin bir mavi" veya "hareketi daha yumuşak yap" gibi kelimelerle iletişim kurarsınız. Alıcının imajı her seferinde sapar. Bir tur sonra gelen versiyona bakarak daha fazla kelime eklersiniz: "Hayır, o tür bir sakinlik değil."
Sonra: Claude Code'a renk ve animasyon hızı için kaydırıcıların bulunduğu bir HTML oluşturmasını söylersiniz. Teşekkür e-postası düğmeleri veya LP CTA düğmeleri için prototipleri tek HTML sayfaları olarak oluşturur ve URL'yi paydaşlara gönderirsiniz. Herkes dokunur, en iyi değerlere karar verir ve bu değerleri Claude'a geri kopyalar. Metin alışverişi azalır ve anlaşma süresi kısalır.
Bununla ilgili olarak Anthropic Labs, bu "dokunarak karar ver ve işlemi Claude'a geri kopyala" konseptini bir Playground eklentisi olarak resmileştirmeye başlıyor. HTML çıktısı sadece küçük bir numara değil; Anthropic'in bir desen olarak beslediği bir yöndür.
▼ Örnek Talimat:
"Teşekkür e-postasındaki düğmenin rengine ve animasyon hızına üç tür kaydırıcı kullanarak karar verebileceğim bir HTML oluştur. Kararlaştırılan değerleri kopyalamak için altta bir düğme ekle."
[Senaryo 4] 3 Dakikada Karar Ekranı Yapmak
Gelecek dönem için hangi önlemler Şimdi, Sonra, Daha Sonra veya İptal olarak atanmalı? 30 biletin önceliklerini sıralamak, PdM'ler, planlamacılar ve kurumsal planlama için tipik bir "karar verme görevidir".
Önce: 30 maddeyi bir e-tabloda sıralar ve öncelik sütununu tek tek manuel olarak doldurursunuz. Sıralar, yeniden düşünür, başka bir sayfaya taşır ve geri taşırsınız. Bazı günler 30 dakika harcar ve yine de bir sonuca varamazsınız.
Sonra: Claude Code'dan "maddeleri dört sütuna (Şimdi, Sonra, Daha Sonra, İptal) sürükleyip bırakabileceğim bir HTML yap" diye istersiniz. 3 dakikada özel bir düzenleme ekranı hazır olur. 30 kartı sürüklersiniz ve bitirdiğinizde sonuçları kopyalarsınız. Karar verme görevlerinin süresi bir büyüklük sırası kadar kısalır.
Burada kolayca gözden kaçan ancak oldukça etkili bir tasarım ilkesi vardır. Thariq'in "Her zaman bir dışa aktarma ile bitirin" yazdığı cümledir. Bir düzenleme ekranı yaparken, her zaman "JSON Olarak Kopyala", "Prompt Olarak Kopyala" veya "Markdown Olarak Kopyala" düğmelerini ekleyin.
Bu olmadan, sıralama sonuçlarınızı Claude'a geri döndüremezsiniz ve sadece bir görev aracı olarak kalır. Bir düzenleme ekranı, yalnızca HTML'de yargılama yapıp ardından yapılandırılmış metin sonucunu Claude'a geri döndüren bir döngü oluşturduğunuzda bir karar verme aracı haline gelir.
Aynı fikir, özellik bayraklarını düzenlemek, yan yana sistem prompt düzenleyicileri veya veri kümesi onaylama/reddetme/etiketleme için de kullanılabilir. "3 dakikada özel, tek kullanımlık bir kullanıcı arayüzü oluşturmak", Claude Code'un gerçek değerinin en açık şekilde ortaya çıktığı yerdir.
▼ Örnek Talimat:
"Gelecek dönem için 30 önlemi dört sütuna (Şimdi, Sonra, Daha Sonra, İptal) sürükleyip bırakabileceğim bir HTML oluştur. Sonunda, sıralama sonuçlarını her satır için gerekçeleriyle birlikte çıktılayabilmem için bir 'Markdown Olarak Kopyala' düğmesi yerleştir."
[Senaryo 5] PR İncelemelerini ve Spec Paylaşımını Renk Kodlu Farklarla Devretmek
Son olarak, mühendislerle işbirliği yapmak için bir senaryo. Kod okumasanız bile, bir PdM, yönetici veya editör olarak PR incelemelerine veya spec onaylarına çağrılabilirsiniz.
Önce: GitHub fark ekranını açmanız istenir. Farkın hangi bölümünün önemli olduğunu ve hangisinin göz ardı edilebileceğini sadece bakarak söyleyemezsiniz. Hikayeyi takip etmek için yorumları okumak zorunda kalırsınız. Kod okumayan kişiler genellikle "bir şey olursa haber ver" deyip kapatır.
Sonra: Claude Code'dan "bu PR'ı, kod okumayan birinin 30 saniyede kavrayabileceği bir HTML inceleme belgesine dönüştür" diye istersiniz. Farkların yanına yorumlar eklenir, etki alanı renk kodlu olarak gösterilir ve sonunda üç endişenin bir özeti sunulur. Bunu dahili depolamaya yükleyip URL'yi paylaşırsanız, PdM'ler ve yöneticiler tek bir düğmeyle geri bildirim sağlayabilir. Mühendislerle işbirliği yapanlar nihayet incelemelere katılabilir.
HTML, mühendisler için bir dil değildir; bir hikaye sunmak için bir araçtır. Farkın anlamı, riskler ve etki alanı—bu "çözülmesi gereken bilgi"—açıklamalar, renk ve düzen ile sunulur. HTML dönüşümünün anlamı budur.
▼ Örnek Talimat:
"Bu PR'ı, kod okumayan birinin 30 saniyede kavrayabileceği bir HTML inceleme belgesine dönüştür. Farkların yanına yorumlar ekle, etki alanını renk kodlamasıyla göster ve sonunda üç endişeyi özetle."
Siz bu beş senaryo için Markdown'da çıktı vermeye devam ederken, format vergisi sessizce ama her gün birikiyor. Bunu fark ettiğiniz anda durdurup durdurmayacağınız, önümüzdeki haftadan itibaren farkı yaratacak.
Geçiş Yaparken Ortaya Çıkan 6 Soru
Bunu okurken aklınıza birkaç soru gelmesi muhtemeldir. Orijinal makaledeki SSS bölümünü, Japon iş dünyası okuyucularının karşılaşma olasılığı en yüksek sıraya göre yeniden düzenledim.
■ Daha fazla token kullanır mı?
Evet, kullanır. Orijinal makale, Markdown'dan 2-4 kat daha uzun sürede oluşturulduğunu belirtiyor. Ancak Opus 4.7'nin 1 milyon token bağlamı var, bu nedenle HTML döndürmenin bağlam sınırları nedeniyle konuşmaların bozulma riski neredeyse yok.
Thariq'in sonucu: "Sayılar artıyor, ancak okunan sonucu seçerseniz, toplam iş için karşılığını verir." Bu, aylık 3.000+ yen'lik sözleşmenizi 1.000 satırlık okunmamış Markdown için mi yoksa açılan bir sayfalık HTML için mi kullanacağınız arasında bir seçimdir.
■ Tasarım çirkin olmaz mı?
Bu geçerli bir endişe, ancak önlemler var.
Biri, Claude Code'un ön uç tasarım eklentilerini kullanmaktır. Diğeri, Claude'a şirketinizin sitesinden veya mevcut materyallerden bir HTML örneği sağlamaktır. Bir referans dosyası sağlayıp "bu tonda" veya "bu yazı tipi ve paletle" derseniz, Claude şirketinizin görünümüne uygun HTML çıktısı verecektir. Kod tabanınızda design-system.html gibi bir dosya bulundurmak, her seferinde ona başvurmanızı sağlar.
■ HTML düzenlemek zahmetli değil mi?
Kendiniz düzenlemeniz gerekmez.
Thariq, HTML'e doğrudan dokunmadığını kendisi yazıyor. Claude'a "Bu rengi biraz sakinleştir" veya "Üçüncü bölümü biraz küçült" derseniz, sizin için düzeltir. Spec'ler, beyin fırtınası veya referans materyalleri için kullandığınız sürece, tüm düzenlemeyi Claude'a bırakabilirsiniz.
■ Nasıl açarım? Nasıl paylaşırım?
Açması kolay. Claude Code'un ürettiği HTML dosyasını yerel olarak tarayıcınızda açmanız yeterli.
Hatta Claude'dan "bu dosyayı aç" diye isteyebilirsiniz, o da sizin için tarayıcınızda açabilir. Paylaşırken en kolay yol, onu dahili depolamaya veya S3'e yükleyip URL'yi sağlamaktır. Bağlantıyı Slack veya e-postaya yapıştırırsanız, alıcı tarayıcısında açabilir. Markdown'u PDF'ye dönüştürme ekstra adımı tamamen ortadan kalkar.
■ Versiyon kontrolü ne olacak?
Dürüst olmak gerekirse, HTML Git diff yönetimi için pek uygun değildir. Bir satırı düzeltmek, biçimlendirici ayarları nedeniyle farkları başka yerlere taşıyabilir. Thariq, HTML'in versiyon kontrolünün en büyük zayıflığı olduğunu kendisi yazıyor.
Bu nedenle pratik çözüm şudur: "İnsanlar için teslimatlar" HTML'dir ve "geçmişini saklamak istediğiniz spec'ler veya kayıtlar" Markdown'dur. Amaç Markdown'u kaldırmak değil, çıktının amacına göre formatı seçme zihniyetine geçmektir.
■ Markdown'u tamamen kullanmayı bırakabilir miyim?
Hayır. Kayıtlar, değişiklik geçmişleri ve depoda tutmak istediğiniz yapılandırılmış metinler Markdown olarak kalmalıdır.
CLAUDE.md ve SKILL.md, Markdown olarak kalırlarsa yönetilmesi ve diff'lerin takip edilmesi daha kolaydır. HTML, "insanlara teslim etmek", "insanların dokunmasına izin vermek", "birden çok seçeneği yan yana dizmek" ve "insanların renklerle yargılamasına izin vermek" için uygundur. Bunu genel olarak "AI ile etkileşim için Markdown, insanlara dağıtım için HTML" olarak anlarsanız, kaybolmazsınız.
Artık ilk şüpheleriniz giderilmiş olmalı. Dezavantajları da içeren bir makale daha güvenilirdir—bu, bir yazar olarak benim inancımdır.
Format Vergisini Ödemeye Devam mı Edeceksiniz Yoksa Tasarım Tarafına mı Geçeceksiniz?
Son olarak, kapanış yapmak için perspektifimizi yükseltelim.
Daha önce "Prompt Vergisi"nden bahsetmiştik—Claude'a aynı önermeleri yeniden yazmanın maliyeti. Ardından, .claude klasörüyle tasarım katmanına geçiş hikâyesi geldi. Bu "Format Vergisi", o serinin üçüncü teması. Sohbet katmanı ve tasarım katmanından sonra şimdi de çıktı katmanını ele aldık.
"Format Vergisi"ni okuyucularla paylaşabileceğimiz bir şey olarak tanımlayalım:
Okunmayan çıktı biçimlerini seçmeye devam ederseniz, hem sizde hem de başkalarında daha açmadan yorgunluk birikir. Claude Code için ayda 3.000 yen'den fazla ödüyorsunuz, ama teslim ettikleriniz toplantılarda asla kullanılmıyor. Bu his, biçim seçiminde bir yargıda bulunmamaktan geliyor. İşte bu Format Vergisi'dir.
Markdown'da çıktı almak bir görevdir. HTML seçmek bir yargıdır. Aynı Claude Code'u kullanıyor olsanız bile, biçim seçiminde yapacağınız tek bir yargı, teslim ettiklerinizin ulaştığı mesafeyi önemli ölçüde değiştirir.
Ve HTML, mühendislere özgü bir dil değildir. Okunan materyaller oluşturmak için bir araçtır. Bir anlığına web sitesi kurma fikrini bir kenara bırakın. Sadece bu hafta yazdığınız haftalık raporu, teklifi veya inceleme belgesini HTML olarak çıktılamayı deneyin. Bu yeterli.
Daha büyük resimden konuşalım.
Markdown'ın AI endüstrisinin örtük standardı olduğu dönem, Anthropic içinde sessizce sona eriyor. CLAUDE.md, SKILL.md ve Cursor kurallarının tümü Markdown temelinde inşa edilmiş olsa da, çıktı biçimi ilk önce değişmeye başlıyor. Standardın değiştiği ana tanıklık eden okuyucular, yarım adım öne geçebilir.
Elbette, "Bunu her hafta yapıyorum"u fark ettiğinizde, bunu bir Skill'e dönüştürmeyi seçebilirsiniz.
Anthropic içinde, tasarımla ilgili Playground'lar gibi HTML çıktısının sık kullanıldığı desenler yavaş yavaş bileşenler olarak olgunlaştırılıyor. Ancak ilk hafta için tek satırlık bir komut yeterlidir. Bu gece, sadece bir haftalık raporu HTML olarak çıktılamayı deneyin. Gelecek hafta, altı teklif seçeneğini tek bir ızgarada sıralamayı deneyin. Oradan başlayın, format vergisi sessizce azalmaya başlayacak.
Thariq, makalesinin sonunda şöyle yazıyor: "Markdown'ı derinlemesine okumayı bırakıp tüm yargıları Claude'a bırakma korkum vardı. HTML'e geçtikten sonra kendimi Claude'la döngüye geri dönmüş gibi hissediyorum ve her şeyden önce, oluşturmak gerçekten eğlenceli."
Bir biçim seçmek, AI ile çalışırken inisiyatifi yeniden ele geçirmek için bir anahtardır ve aynı zamanda günlük işlerinize biraz sıcaklık getirmek için bir anahtardır.
Okunmayan Markdown üretmeye devam mı edeceksiniz, yoksa biçimi seçen tarafta mı yer alacaksınız? Önümüzdeki hafta sınır olacak.
Özet
- Anthropic'te Claude Code'u geliştiren geliştirici, artık Markdown kullanmadığını açıkladı. HTML benimsemesi dahili ekip içinde yayılıyor.
- Şimdiye kadar Markdown, Claude Code ve Cursor'dan GitHub Copilot, Cline, dahili Wiki'ler ve ChatGPT çıktılarına kadar AI için örtük standarttı. Yaratıcı şimdi bu endüstri standardına meydan okudu.
- Markdown'ın okunmamasının 5 nedeni var: 100 satırda tekrar okunamaz / paylaşıldığında bozulur / renk veya diyagram yok / dokunarak yargılanamaz / mobilde bozulur. Bu gizli maliyetler "Format Vergisi"dir.
- Geçiş yapmak için tek bir satır eklemeniz yeterli: "Çıktıyı HTML dosyası olarak ver." Bunu bir Skill haline getirmek, kullanım oturana kadar bekleyebilir.
- 5 iş senaryosu—haftalık raporlar, paralel teklifler, tasarım düzeltmeleri, yargılama ekranları ve PR incelemeleri—sadece HTML'e geçerek açılan, yargılanan ve geri dönen materyallere dönüşür.
- Bir biçim seçmek bir yargıdır, bir görev değil. Markdown'da çıktı almak bir görevdir; HTML seçmek bir yargıdır. Claude Code kullanıcıları arasındaki fark burada açılır.
Bu makaleyi faydalı bulanlar için:
Tokyo Üniversitesi Claude Code Laboratuvarı (@ClaudeCode_UT), UT'li öğrencilerden oluşan bir ekip tarafından ciddiyetle yürütülen bir hesaptır. Ayrıca büyük şirketlerle ortak Claude Code iş geliştirme çalışmaları yapıyoruz ve yalnızca sahada gerçekten işe yarayan tasarımları ve know-how'ı paylaşıyoruz.
Her gün pratik işlere özel "gerçekten faydalı" bilgi ve know-how sunuyoruz 👇
■ Pratikte kullanılabilen Claude Code becerilerinin ücretsiz yayını
■ Birincil yurtdışı AI bilgilerinin Japon iş bağlamına çevirisi ve yeniden yapılandırılması
■ UT ekibi tarafından ciddiyetle geliştirilen ve "gerçekten faydalı" olan beceri ve araçları ücretsiz alabileceğiniz tek yer ❗️
İlgileniyorsanız, lütfen takip edin ve göz atın.
LINE burada ⇩
