Claude Fable 5 ile çalışmak bana eski bir dersi tekrar tekrar öğretiyor: harita, bölgenin kendisi değildir.
Harita, yapılacak işin bir temsilidir; benim prompt'larım, becerilerim ve bağlamımdır, Claude'a verdiğim şeydir. Bölge ise işin yapılması gereken yerdir; kod tabanı, gerçek dünya ve onun gerçek kısıtlamalarıdır.
Harita ile bölge arasındaki farka ben bilinmeyenler diyorum. Claude bir bilinmeyenle karşılaştığında, ne istediğime dair en iyi tahminine dayanarak bir karar vermesi gerekir. Ne kadar çok iş yapılırsa, Claude'un karşılaşabileceği bilinmeyen sayısı da o kadar artar.
Fable, işin kalitesinin, onun bilinmeyenlerini netleştirme becerim tarafından darboğaza uğratıldığını gördüğüm ilk model.
Önemli olan, sadece önceden plan yapmak her zaman yeterli olmaz. Uygulamanın derinliklerinde bilinmeyenler bulabilirsiniz veya bilinmeyenleriniz, aslında sorunu tamamen farklı bir şekilde çözmeniz gerektiği gerçeğine işaret edebilir.
Fable ile çalışmanın, bilinmeyenlerimi uygulama öncesinde, sırasında ve sonrasında keşfettiğim yinelemeli bir süreç olduğunu gördüm.
Bunun için burada bilinmeyenleri bulmaya yönelik örnek eserler hazırladım, ancak bunları ne zaman kullanacağınıza dair sezgiyi geliştirmek için geri dönmeyi unutmayın.
Bilinmeyenlerinizi Bilmek
Bilinmeyenleriniz neler? Claude'a bir problemle geldiğimde, bunu genellikle 4 şekilde ayırırım:
- Bildiğim Bildiklerim: Bu aslında prompt'umda olan şeydir. Ajana ne istediğimi söylerim?
- Bildiğim Bilinmeyenlerim: Henüz çözemediğim, ancak çözemediğimin farkında olduğum şeyler nelerdir?
- Bilmediğim Bildiklerim: O kadar bariz ki asla yazmayacağım, ancak görsem tanıyacağım şeyler nelerdir?
- Bilmediğim Bilinmeyenlerim: Hiç düşünmediğim şeyler nelerdir? Hangi bilgilerin farkında değilim? Bir şeyin ne kadar iyi olabileceğini biliyor muyum?
En iyi ajan kodlayıcılar, nispeten az sayıda bilinmeyene sahip olanlardır. Boris veya Jarred gibi birinin prompt yazışını izlerken, ne istediklerini ayrıntılı olarak bildikleri benim için açıktır. Hem kod tabanıyla hem de model davranışlarıyla derin bir uyum içindedirler.
Ama onlar da bilinmeyenleri varsayarlar. Birçok yönden, bilinmeyenlerinizi azaltmak ve onlar için plan yapmak, ajan kodlamanın becerisidir. Ancak neyse ki bu, Claude ile çalışarak geliştirebileceğiniz bir beceridir.
Claude'un Size Yardım Etmesine Yardım Edin
Claude'a talimat vermek hassas bir dengedir. Çok spesifik olursanız, bir yön değişikliği daha uygun olsa bile Claude talimatlarınızı takip eder. Çok belirsiz olursanız, Claude genellikle görevinize uygun olmayabilecek sektördeki en iyi uygulamalara dayalı seçimler ve varsayımlar yapar.
Bilinmeyenlerinizi hesaba katmadığınızda her iki şekilde de başarısız olursunuz. Yolun ne zaman engellerle dolu olacağını bilemezsiniz ve yolun ne zaman açık olacağını bilemezsiniz, ancak yine de Claude'un yön değiştirmesini istersiniz.
Claude, bilinmeyenlerinizi daha hızlı keşfetmenize yardımcı olabilir. Kod tabanınızda ve internette son derece hızlı bir şekilde arama yapabilir ve ortalama bir konu hakkında sizden çok daha fazlasını bilir. Ayrıca başarısızlıktan daha hızlı yineleme yapabilir.
Bu sürecin en önemli kısmı, Claude'a başlangıç noktanız hakkında bağlam vermektir. Örneğin, düşünce sürecinizde nerede olduğunuzu söyleyin; problem ve kod tabanıyla ilgili deneyiminizi açıklayın; ve sizinle bir düşünce ortağı gibi çalışmasına izin verin.
Daha önce HTML'i Claude ile kullanma hakkında yazmıştım, neredeyse tüm bu durumlarda, bir HTML eseri onu görselleştirmenin ve temsil etmenin en iyi yoludur.
Bu makalede, bu bilinmeyenleri ortaya çıkarmak için kullandığım bazı kalıpları detaylandırıyorum. Her seferinde her tekniği kullanmıyorum, ancak bu, sahip olunması gereken kullanışlı bir teknik koleksiyonudur.
Uygulama Öncesi
Kör Nokta Taraması
Bir işe başlarken yapabileceğiniz en faydalı şeylerden biri kör noktalarınızı anlamaktır. Örneğin, kod tabanının yeni bir bölümünde bir özellik yazıyorsanız veya bir tasarım üzerinde yineleme yapmak gibi alışılmadık bir işte size yardımcı olması için Claude'u kullanıyorsanız, muhtemelen çok sayıda bilmediğiniz bilinmeyene sahip olursunuz.
Hangi soruları soracağınızı, iyinin neye benzediğini, hangi geçmiş çalışmaların yapıldığını veya hangi tuzaklardan kaçınmanız gerektiğini bilmiyor olabilirsiniz.
Bunu yapmak için, Claude'dan bilmediğiniz bilinmeyenlerinizi bulmasını ve bunları size açıklamasını isteyebilirsiniz. "Kör nokta taraması" ve "bilmediğim bilinmeyenler" ifadelerini kelimesi kelimesine kullanmayı seviyorum. Kim olduğunuz ve ne bildiğiniz hakkında bağlam vermek genellikle önemlidir.
Örnek Prompt'lar:
- "Yeni bir kimlik doğrulama sağlayıcısı eklemek üzerinde çalışıyorum ancak bu kod tabanındaki kimlik doğrulama modülleri hakkında hiçbir şey bilmiyorum. İlgili bilmediğim bilinmeyenlerimi bulmama ve size daha iyi prompt yazmama yardımcı olmak için bir kör nokta taraması yapabilir misiniz?"
- "Renk düzeltmenin ne olduğunu bilmiyorum ama bu videoyu düzeltmem gerekiyor. Renk düzeltme hakkındaki bilmediğim bilinmeyenlerimi anlamam için bana öğretebilir misiniz, böylece daha iyi prompt yazabilirim?"
Beyin Fırtınaları ve Prototipler
Sadece gördüğümde tanımlayabildiğim kriterleri içeren çok sayıda bilmediğim bildiğimin olduğu bir alanda çalışırken, Claude'dan benimle beyin fırtınası yapmasını ve prototip oluşturmasını istemeyi severim.
Bilmediğiniz bildiklerinizi prototip oluşturma sırasında erken tespit etmek ve ifade etmek son derece değerlidir, çünkü bunları uygulama sırasında bulmak (nispeten) maliyetli olabilir. Bir özellik veya spesifikasyondaki küçük değişiklikler, kodda kökten farklı uygulamalara neden olabilir ve ajanınızın önceki değişiklikleri geri alması daha zor olabilir.
Örneğin, bir arka uç rotası bağlamak veya ön uçta ekstra durum yönetmek zorunda kalmadan bir çerçeveye eklenen bir düğmenin nasıl göründüğünü görmek isteyebilirsiniz.
Görsel tasarım benim için ifade etmesi zor bir şeydir, ancak ne istediğimi gördüğümde bilirim. Bu gibi durumlarda, bir eser için birkaç farklı tasarım yaklaşımı isterim.
Ayrıca neredeyse her kodlama oturumuma bir keşif veya beyin fırtınası aşamasıyla başlarım. Bu, projenin kapsamını tanımlama niyetiyle başlamama yardımcı olur. Claude genellikle kaçıracağım yüksek değerli yaklaşımlar bulur ve bazen ağaçlar yüzünden ormanı göremez. Beyin fırtınası, çok dar veya çok geniş bir kapsam belirlememi engeller.
Örnek prompt'lar:
- "Bu veriler için bir kontrol paneli istiyorum ama görsel zevkim yok ve neyin mümkün olduğunu bilmiyorum. Tepki verebilmem için bana 4 tamamen farklı tasarım yönü olan bir HTML sayfası yap."
- "Hiçbir şeyi bağlamadan önce, sahte verilerle yeni düzenleyici araç çubuğunu simüle eden tek bir HTML dosyası yap. Gerçek uygulamaya dokunmadan önce düzene tepki vermek istiyorum."
- "İşte kabaca sorunum: Kullanıcılar kayıt sürecinden sonra ayrılıyor. Kod tabanında ara ve müdahale edebileceğimiz, en ucuzdan en iddialıya 10 yer için beyin fırtınası yap. Hangilerinin uygun olduğunu söyleyeceğim."
Görüşmeler
Yeterli beyin fırtınası yaptıktan sonra, muhtemelen hala bilinmeyenlerim vardır.
Bu durumda, Claude'dan beni herhangi bir bilinmeyen veya belirsizlik hakkında sorgulamasını isterim. Claude'dan sizi sorgulamasını isterken, sorularını yönlendirmek için ona probleminiz hakkında bağlam vermeye çalışın. İşte bazı örnekler.
Örnek prompt'lar:
- "Belirsiz olan her şey hakkında beni tek seferde bir soru sorgula, cevabımın mimariyi değiştireceği sorulara öncelik ver."
Referanslar
Bazen ne istediğinizi ayrıntılı olarak tarif edemezsiniz. Örneğin, dili olmayabilir veya o kadar karmaşık olabilir ki oldukça uzun zamanınızı alabilir.
Bu durumda, en iyi cevap bir referanstır. Diyagramlar, dokümantasyon veya resimler ekleyebilseniz de, en iyi referans kaynak koddur.
Belirli bir şekilde bir şey uygulayan bir kütüphaneniz veya gerçekten beğendiğiniz bir tasarım bileşeniniz varsa, farklı bir dilde olsa bile, Fable'ı klasöre yönlendirin ve ne arayacağını söyleyin.
Claude Design da bu şekilde çalışır. Ona bir dosya vermek zorunda değilsiniz (her ne kadar bunu da yapabilirsiniz). Beğendiğiniz bir web sitesindeki bir modülü işaret edebilirsiniz ve o, yalnızca ekran görüntüsünü değil, altta yatan kodu okur. Bu, işaretleme, yapı ve bileşenin gerçekte nasıl oluşturulduğu hakkında çok daha zengin ayrıntı sağlar.
Örnek prompt'lar:
- "vendor/rate-limiter içindeki bu Rust kutusu, istediğim tam geri çekilme davranışını uyguluyor. Oku ve aynı semantiği bizim TypeScript API istemcimizde yeniden uygula."
Uygulama Planları
Uygulamaya hazır olduğumu düşündüğümde, Claude'dan incelemem için, değişme olasılığı en yüksek kısımlara odaklanan bir uygulama planı hazırlamasını isterim; örneğin veri modellerini, tip arayüzlerini veya kullanıcı deneyimi akışlarını gözden geçirmek. Bu, Claude'un aslında değiştirmem gerekebilecek şeyleri yüzeye çıkarmasını sağlar.
Örnek Prompt'lar:
- "Bir HTML uygulama planı yaz, ancak büyük olasılıkla değiştireceğim kararlarla başla: veri modeli değişiklikleri, yeni tip arayüzleri ve kullanıcıya yönelik her şey. Mekanik yeniden düzenlemeyi en alta göm, o kısımda sana güveniyorum."
Uygulama Sırasında
Uygulama Notları
Planımdan memnun kaldıktan sonra yeni bir oturum açar ve prompt'a herhangi bir eseri iletirim. Örneğin, bir spesifikasyon dosyası ve bir prototip iletebilir ve bir ajandan bunu uygulamasını isteyebilirim.
Ancak gerçek şu ki, ne kadar plan yaparsanız yapın, her zaman pusuda bekleyen bilinmeyen bilinmeyenler vardır. Ajan, çalışması sırasında kodda bulduğu bir uç durum nedeniyle farklı bir yol izlemesi gerektiğini görebilir.
Claude Code'dan, bir sonraki denememizden öğrenebilmemiz için aldığı kararları takip ettiği geçici bir 'implementation-notes.md' (veya .html) dosyası tutmasını isterim.
Örnek prompt'lar:
- "Bir implementation-notes.md dosyası tut. Planından sapmanı gerektiren bir uç durumla karşılaşırsan, muhafazakar seçeneği seç, 'Sapmalar' altında günlüğe kaydet ve devam et."
Uygulama Sonrası
Sunumlar ve Açıklamalar
Bir şeyi yayınlamanın en önemli kısımlarından biri, kabul ve onay almaktır. Nihai belgede sunum ve açıklama eserleri oluşturmak şunlara yardımcı olur:
- İnceleyenler sizinle aynı bilinmeyenlerle başladığında anlayışı hızlandırır
- Uzmanlar, bilinmeyenleri ve tahmin edecekleri yaygın başarısızlık noktalarını hesaba kattığınızı görmek istediklerinde onayları hızlandırır
Örnek prompt'lar:
- "Prototipi, spesifikasyonu ve uygulama notlarını, kabul almak için Slack'e atabileceğim tek bir belgede paketle. Demo GIF ile başla."
Quizler
Uzun bir çalışma oturumundan sonra Claude, fark ettiğimden çok daha fazlasını başarmış olabilir. Kod farklarını okumak bana olanlar hakkında yalnızca yüzeysel bir anlayış verebilir, çünkü davranışın çoğu mevcut kod yollarına bağlı olacaktır.
Claude'dan bana bir sürü bağlam verdikten sonra değişiklik hakkında beni sınamasını istemek, olanları anlamama yardımcı olur. Sınavı mükemmel bir şekilde geçtikten sonra birleştiririm.
Örnek prompt'lar:
- "Bu değişiklikte olan her şeyi anladığımdan emin olmak istiyorum. Bana değişiklikler hakkında bağlam, sezgi, ne yapıldığı vb. ile okuyup anlamam için bir HTML raporu ve en alta geçmem gereken bir sınav hazırla."
Bunun Bir Araya Gelişi: Fable'ı Başlatmak
Fable için lansman videosu tamamen Claude Code tarafından düzenlendi. Bu benim için yeni bir alandı ve kesinlikle bir uzman değilim.
Bu yüzden bildiğim şeyle başladım. Claude'un videoları düzenlemek ve metne dönüştürmek için kod kullanabileceğini biliyordum, ancak yeterince doğru olup olmadığından emin değildim. Daha sonra Claude'a Whisper gibi metne dönüştürmenin nasıl çalıştığını ve ffmpeg kullanarak "ııı" gibi şeyleri veya büyük duraklamaları doğru bir şekilde kesip kesemeyeceğimi açıklamasını istedim.
Claude'un söylediğim kelimelerle zamanlanmış bir kullanıcı arayüzü oluşturmasını istedim, ancak bunu yapıp yapamayacağından emin değildim, bu yüzden Claude'dan Remotion ve bir metin dökümü kullanarak bir prototip video oluşturmasını ve işe yarayıp yaramayacağını görmesini istedim.
Son olarak, videonun kendisi biraz soluk görünüyordu, bunun renk düzeltmenin sonucu olduğunu biliyordum ama renk düzeltmenin ne olduğunu gerçekten bilmiyordum. İlk denemem, seçmek için Claude'a birkaç varyasyon yaptırmaktı, ancak renk düzeltme söz konusu olduğunda "iyi"nin neye benzediğini bilmediğimi fark ettim. Bunun yerine, Claude'dan bana renk düzeltmeyi öğretmesini ve bilinmeyenlerimi keşfetmemi istedim.
Bununla ilgili daha ayrıntılı bir açıklamayı burada izleyebilirsiniz.
Haritayı ve Bölgeyi Eşleştirmek
Modeller ne kadar iyi olursa, doğru yaklaşımla o kadar çok şey başarabilirsiniz. Uzun vadeli bir görev yanlış geldiğinde, muhtemelen bilinmeyenlerinizi tanımlamak veya Claude'un bunlar arasında doğaçlama yapmasına izin veren bir uygulama planı oluşturmak için daha fazla zaman harcamanız gerekir.
Her açıklama, beyin fırtınası, görüşme, prototip ve referans, düzeltmesi pahalı hale gelmeden önce bilmediğiniz şeyleri bulmanın ucuz bir yoludur.
Bu yüzden bir sonraki projenize Claude'dan bilinmeyenlerinizi bulmanıza yardım etmesini isteyerek başlayın.
