Bir ajana komut vermeden önce, tek sayılı tek bir hedef yazın.

29 Eylül 2026’da sadakat uygulamam Dot’taki kasa ekranı yavaştı. Yoğun bir kasadaki kasiyer yeni bir talep başlatmak, tutar alanına dokunmak, ülke seçiciyi açmak, ülkeyi seçmek, telefon alanına dokunmak ve Oluştur’a basmak zorundaydı. Altı dokunuş artı yazma ve ekran açıldığında hiçbir alan odakta değildi.

O gün saat 17:50’de depoya bir tasarım şartnamesi düştü. İçinde çok şey vardı: sekiz ekran durumu, her hata için metin, pikseline kadar yerleşim. Önemli olan tablo dört satırlıktı ve sade bir başlığı vardı: “Dokunuş bütçesi”. Telefon numarası veren geri dönen bir müşteri için iki sütunu vardı. Bugün: altı dokunuş artı yazma. Yeni: iki dokunuş artı yazma.

Şartnamenin geri kalanı o hücreden çıktı. İki dokunuş, kasiyerin bir alandan ötekine dokunarak geçemeyeceği anlamına geliyordu. iOS telefon tuş takımlarında Return ya da Next tuşu yoktur; bu dokunuşu atlamanın tek yolu odağı otomatik taşımaktır ve bunu yalnızca uzunluğu belli bir alandan yapabilirsiniz. Telefon numarasının uzunluğu belli. Tutarınki değil. Bu yüzden şartname telefonu öne aldı ve son rakam girildiğinde odak kendiliğinden tutara atlıyor.

Saat 19:13’te Claude’un birlikte yazdığı yapı commit’i düştü: “önce telefon, geri dönen müşteri için iki dokunuş”. Bir dakika sonra yine Claude ile birlikte yazılan test commit’i geldi. Sayacı 375 piksellik bir telefonda, Arapça ve İngilizce açıyor, geri dönen bir müşterinin numarasını ve tutarı yazıyor, Puan ekle’ye dokunuyor, Sıradaki müşteri’ye dokunuyor ve sayacın yeniden boş olduğunu, imlecin telefon alanına döndüğünü doğruluyor. Testin adı “geri dönen müşteriyi boştan başarıya iki dokunuşta götürür”. Çekme isteği 19:44’te birleşti.

Şartnameden birleştirmeye iki saatten kısa. Kodu ve testi Claude birlikte yazdı. Sayı, ikisine de bitmişin ne demek olduğunu söyledi.

Temel çıkarımlar

• Bir yapay zeka ajanına komut vermeden önce içinde tek sayı olan tek bir hedef yazın. “Geri dönen müşteriler iki dokunuşta puan kazanır” bir hedeftir. “Kasa akışını hızlandır” bir dilek.
• GV’nin tasarım sprinti de aynı şekilde açılır: Pazartesi sabahı ekip sondan başlar ve uzun vadeli bir hedefte anlaşır. Çarşamba günü çözümler arasında seçim yapmak için o hedefi kullanır.
• Bir ajanın sayıya bir ekipten daha çok ihtiyacı vardır. Anthropic’in kendi Claude Code rehberi, Claude’un iş bitmiş göründüğünde durduğunu söylüyor ve çalıştırabileceği bir kontrol yoksa bitmiş görünmek elindeki tek sinyaldir.
• Sayıyı üç yere koyun: komutun ilk satırına, sayı tutana kadar başarısız olan bir teste ve incelemeye.
• Tek başına bir sayı, oyunlaştırmaya davetiye çıkarır. Oraya giderken neyin bozulmaması gerektiğini yazın; Dot şartnamesinin, sessiz bir geç puan eklemesini riske atmak yerine bir dokunuştan vazgeçmesi gibi.
• Plan modu ölmüş olabilir. Hedef ölmedi. Plan sayfalardır. Hedef tek satırdır ve her yineleme turundan sağ çıkar.

Bir tasarım sprintinde “sondan başlamak” ne demek?

GV’nin tasarım sprinti, kritik iş sorularını tasarım, prototipleme ve fikirleri müşterilerle test ederek yanıtlamak için beş günlük bir süreçtir. Jake Knapp sprintleri 2010’da Google’da yürütmeye başladı ve 2012’de GV’ye getirdi. Pazartesi sorunu haritalar, Salı eskiz çizilir, Çarşamba karar verilir, Perşembe prototip kurulur, Cuma gerçek insanlarla test edilir.

Önce Pazartesi sabahı gelir ve GV’nin kendi tarifi kısadır: sondan başlar ve uzun vadeli bir hedefte anlaşırsınız. Sonra meydan okumanın haritasını çıkarır, şirketteki uzmanlara bildiklerini sorar ve bir hedef seçersiniz; sorunun bir haftada çözülebilecek kadar küçük bir parçası.

Hedef Çarşamba günü geri gelir. O zamana kadar ekibin elinde bir yığın eskiz çözüm vardır ve yalnızca birini prototipleyebilir; her birini eleştirir ve hangilerinin uzun vadeli hedefe ulaşma şansı en yüksekse onlara karar verir. Pazartesi yazılan hedef, Çarşamba kullanılan cetveldir. O olmazsa Çarşamba bir zevk oylamasına döner.

GV, yöntemin bu bölümünü John Zeratsky’ye bağlıyor. Onların sözleriyle, sondan başlamalarına ve her işin temel metrikleriyle sonuçları ölçmeye odaklanmalarına yardım etti. Son önce gelir ve son, ölçebileceğiniz bir şeydir.

Tasarım süreci rehberim aynı adımı empati kurma aşamasının en başına, herhangi bir görüşmeden önce koyuyor: projenin neyi değiştirmesi gerektiğine ve bunu yaptığını nasıl anlayacağınıza dair, onu kanıtlayacak tek sayıyla birlikte bir cümle. Bir ekipte o cümle, bir odadaki insanları aynı yöne bakar tutar. Bir ajanla ise ikinci bir iş görür.

Bir sprint hedefinin sayısı olmalı mı?

Çoğu rehber hayır diyor ya da şart değil diyor. Bu soru için en üstteki sonuçlardan biri olan Design Thinking Toolkit’in uzun vadeli hedef sayfası, hedefi üç parçadan kuruyor: bir zaman dilimi, belirli bir iddialı başarı ve isteğe bağlı olarak işaretlenmiş bir metrik. Örnekleri yıllar sonrasına bakıyor ve ”… için bir numaralı tercih olacağız” gibi okunuyor. Bugün aynı soruyu ChatGPT’ye ya da Perplexity’ye sorarsanız aynı tavsiyeyi alırsınız; sayılar hedeften çıkıp ayrı başarı ölçütlerine taşınmış olarak.

Bir sprint odası için bu tavsiye geçerli. Bir ekip beş gün birlikte geçirir, bağlamı kafasında taşır ve Cuma günü gerçek müşterilerle test eder. Ölçümü odadaki insanlar yapar.

Ajanı olan tek başına bir geliştiricinin odası yok. Bir ajan ay yolculuğu gibi bir hedefe bağlanamaz, çünkü o hiçbir zaman geçti ya da kaldı döndürmez. “Kasiyerlerin sevdiği sayaç” inanılacak güzel bir şey. Ajan ancak “iki dokunuş”a doğru çalışabilir.

O yüzden ikisini de tutun ve iki satıra yazın. Size ve ekibinize yardımı oluyorsa üstte iddia. Hemen altında sayı; çünkü ajanın, testin ve inceleyenin gerçekten kullanacağı satır o. GV’nin Zeratsky’ye verdiği pay ikisini zaten birleştiriyor: sondan başla, sonra sonuçları ölç.

Bir ajanın sayıya bir ekipten daha çok ihtiyacı neden var?

Bir ekip karşılık verir. Beş kişiye belirsiz bir hedef verirseniz biri “daha hızlı” ne demek diye sorar. Bir ajan işin makul bir sürümünü yapar ve durur.

Anthropic bunu Claude Code en iyi uygulamalarında açıkça söylüyor: Claude iş bitmiş göründüğünde durur. Çalıştırabileceği bir kontrol yoksa, “bitmiş görünmek” elindeki tek sinyaldir ve doğrulama döngüsü siz olursunuz. Her hata, sizin fark etmenizi bekler. Rehberin çözümü, Claude’a geçti ya da kaldı üreten bir şey vermek; böylece döngü kendiliğinden kapanır: Claude işi yapar, kontrolü çalıştırır, sonucu okur ve kontrol geçene kadar devam eder.

Bu, ajanın tarafından bakılan sayılı bir hedeftir. “Geri dönen müşteri için iki dokunuş” geçebilir ya da kalabilir. “Daha akıcı bir ödeme” olmaz.

Sayı olmadan ne olduğunu Mayıs’ta gördük. Geliştirdiğim tasarım motoru ux-skill’i kendi ana sayfa brief’iyle çalıştırdığımızda, brief baştan sona sıfattı: editoryal, kendinden emin, sakin, sinematik. Motor her kelimeye uydu ve neredeyse tam olarak claude.ai açılış sayfasını, kategorideki en olası yanıtı döndürdü. Bu hikâyeyi yapay zeka kullanıcı araştırmasının yerini alabilir mi yazısında anlattım. Sıfatlar bir ortalamayı işaret eder. Sayı bir yeri işaret eder.

Anthropic’in daha yeni /goal komutu aynı noktayı ürün hâlinde söylüyor. Bir tamamlanma koşulu yazarsınız ve her turdan sonra ayrı bir model bunun tutup tutmadığını kontrol eder. Tutmuyorsa Claude çalışmaya devam eder. Belgeler, birçok turda ayakta kalan bir koşulun genellikle üç parçası olduğunu söylüyor: ölçülebilir tek bir bitiş durumu, onu kanıtlayan belirtilmiş bir kontrol ve yolda önemli olan kısıtlar. Örnekleri “test/auth altındaki tüm testler geçiyor ve lint adımı temiz”. Sayısı doldurulmuş bir sprint hedefi gibi okunuyor.

Tek sayılı tek bir hedefi nasıl yazarsınız?

Ajanı açmadan önce yazın. Bir cümle, beş parça.

Nasıl uygulanır

1. Kişi. Bu kimin için, gerçek bir anda. “Bir elinde telefon, öbüründe bardak olan, yoğun bir kasadaki yorgun kasiyer” bir kişidir. “Kullanıcılar” değildir.
2. Sonuç. Neyi başarıyorlar. Sayaç için: geri dönen müşteri puan kazanır.
3. Sayı. Çalıştığını nasıl anlayacaksınız. Dokunuş, saniye, adım, hata, bitirenlerin yüzdesi. Birini seçin.
4. Bugünkü değer. Hedefi yazmadan önce mevcut üründe sayın. Altı dokunuş, sayacın o günkü hâliydi. Başlangıç değeri olmayan hedef, ondalık noktalı bir tahmindir.
5. Nasıl ölçüleceği. Onu kim ya da ne, nerede kontrol edecek. Sayaçta bu, 375 piksellik bir telefonda, iki dilde çalışan bir tarayıcı testiydi.

Hepsini birleştirince: “Geri dönen müşteri, altıdan düşerek iki dokunuş artı yazma ile puan kazanır; 375 piksellik bir telefonda Arapça ve İngilizce ölçülür.”

Henüz var olmayan bir ürün için de aynı örüntü işler. Ücretsiz şablonlarımın tamamında kullandığım Bunn örneğinde sorun tanımı şöyle: Rana, 10:00 toplantısı zamanında başlayacağı için üç kişilik kahveyi bir dakikanın altında sipariş etmeli. Bir dakikanın altı, sayıdır. Bunn hayalî, ama biçim gerçek işlerde kullandığım biçim.

Elinizde kalan: bir süzgeç. Ajanın önerdiği her özellik ya sayıyı oynatır ya da bekler. Her inceleme yorumu ya sayıyı korur ya da bir tercihtir.

Yaygın hata: bir çözümü adlandıran hedef. “Bir sadakat uygulaması geliştir” ve “QR tarayıcı ekle” görevlerdir. Hedef, görevin ne için olduğudur. Sayaç şartnamesi bir tarama düğmesi ekledi, ama tarama yolunun dokunuş bütçesinde kendi satırı var, üç dokunuş artı tutar; yani o da yerini bir sayıya karşı hak etmek zorundaydı.

İkinci hata: beş sayılı bir hedef. Süre, dokunuş, hata, memnuniyet ve dönüşümü tek satıra koyarsanız ajan her zaman oynayan birine işaret edebilir. Kimse ürününüzü istemiyor yazısının savunduğu gibi, kişinin sonucunu izleyen sayıyı seçin ve diğerlerini kısıtlara koyun.

Sayı nereden gelir?

Kişiden ve bugünkü üründen, bu sırayla.

2023’te Wfrah için yazdıklarıma bakın. On yetiştirici görüşmesinden sonra hedef, geleneksel yetiştiricilerin ihtiyaçlarını karşılarken modern araçlara güveni eğiten ve kuran bir kullanıcı deneyimiydi. İyi bir yön ve her kelimesi araştırmadan geldi. Şimdi okuyunca içinde sayı yok. Hangi yöne yürüyeceğimizi söyleyebilirdi. Vardığımızı ne zaman anlayacağımızı söyleyemezdi.

Güvenebileceğiniz bir sayıyı üç kaynak verir.

Mevcut ürünü sayın. Altı dokunuş eski sayacın o günkü hâliydi; şartnamenin “bugün” sütununa hedefin yanına yazılmıştı. Bunu hedeften önce yapın, çünkü hedef ancak başlangıç değerinin yanında bir anlam taşır. Analitiği olan bir üründe başlangıç değeri, yukarıdaki Bysooq gibi bir panoda zaten vardır. Yeni bir üründe, insanların bugün kullandıkları şeyle ne kadar zaman harcadığıdır.

Kişinin anından alın. İki dokunuş, kasiyerden ve tuş takımından geldi. Bir el bardakta, sıra bekliyor, geceleri ışık kötü ve telefon tuş takımında Next tuşu yok. Anın içinden gelen bir sayı, biri neden dört değil de iki olduğunu sorduğunda savunması kolay olandır.

Zaten yaptığınız araştırmadan alın. Görüşmeler, ücret geç göründüğünde insanların siparişi bıraktığını söylüyorsa sayı, kaç kişinin onu bitirdiğidir. Bir kullanılabilirlik testinde insanlar bir görevde başarısız oluyorsa sayı, kaç kişinin geçtiğidir.

Ters gittiğinde: ölçmesi en kolay sayıyı seçersiniz. Tıklamalar ve sayfa görüntülemeleri kolaydır. Kasiyerin müşteriyi yürütüp yürütemediği ise önemli olandır.

Ajanı sayıya nasıl bağlarsınız?

Sayıyı üç yere yazın ve üçünün de uyuştuğunu kontrol edin.

Bir: komutun ilk satırı. Bağlamdan, dosyalardan, stil kurallarından önce. Hedefle açılan ve kontrolle biten bir brief ikisini de görüş alanında tutar. Sayaç için kullanacağım biçim, örnek olarak şöyle:

Goal: a returning customer earns points in 2 taps plus typing, down from 6.
Check: a browser test on a 375px phone, in Arabic and English, that fails
if the flow takes more than 2 taps. Run it and show me the output.
Constraints: never clear what the cashier typed. A retry never awards twice.
No auto-submit when the connection comes back.
Spec: the counter spec, section 1.

İki: sayı tutana kadar başarısız olan bir test. Hedefi bir tasmaya çeviren kısım bu. Sayaçta test commit’i yapı commit’inden bir dakika sonra geldi ve adı hedefin kendisi. Anthropic’in rehberi seçenekleri en gevşekten en sıkıya sıralıyor: Claude’dan aynı komutta kontrolü çalıştırmasını istemek, onu bir oturum boyunca /goal koşulu olarak ayarlamak ya da kontrol geçene kadar turun bitmesini engelleyen bir betik olan Stop hook yapmak. Her adımda kurulum artar, dikkat azalır.

Üç: inceleme. Rehber, taze bir bağlamda çalışan ve yalnızca diff’i ve verdiğiniz ölçütleri gören, değişikliği doğuran gerekçeyi görmeyen bir inceleyici öneriyor. Ölçüt olarak ona hedefi verin. Yazarın unuttuğu tek soruyu soracaktır: bu gerçekten iki dokunuş mu sürüyor?

İddia yerine kanıt isteyin: test çıktısı, komut, ekran görüntüsü. Sayaç testleri, sayacın durumlarının on dört ekran görüntüsünü, Arapça ve İngilizce, ikisi koyu modda olmak üzere kaydediyor.

Sayı hedef olduğunda ne ters gider?

Ekonomist Charles Goodhart 1975’te, bir istatistiğin insanlar onu bir şeyi kontrol etmek için zorladığında çökme eğiliminde olduğunu fark etti. Antropolog Marilyn Strathern bunu sonradan çoğu insanın alıntıladığı biçime soktu: bir ölçü hedef olduğunda iyi bir ölçü olmaktan çıkar. Goodhart yasası ajanlara insanlardan daha çok uyar, çünkü ajan sayıya, sayının neden var olduğuna dair hiçbir fikri olmadan bastırır.

Bir ajana yalnızca “iki dokunuş” derseniz oraya varmanın ucuz yolları vardır. Bağlantı geri geldiğinde otomatik gönder. Onayı at. Geri almayı atla. Her biri bir dokunuşu kaldırır ve sayacı bozar.

Dot şartnamesi, reddettikleri için okunmaya değer. Bağlantı geri geldiğinde otomatik gönderim yok diyor: düğme geri gelir ve kasiyer yeniden dokunur, çünkü kasiyer başka işe geçmiş olabilir ve sessiz bir geç puan eklemesi bir dokunuştan daha kötüdür. Hata durumunda kasiyerin yazdığını asla silmeyin diyor. Her denemeye bir idempotency anahtarı veriyor; böylece tedirgin bir çift dokunuş puanı asla iki kez ekleyemez ve tam bunun için bir test var. Zorunlu bir gerekçeyle on dakikalık bir geri alma tutuyor. Bu kuralların her biri dokunuşa ya da koda mal oluyor ve her biri sayının yanına yazılmış.

Goodhart’a verilen yanıt bu. Hedefin bir sayısı var. Kısıtlar, sayının göremediği her şeyi taşır.

Kısıtlara ne yazılır

• Asla olmaması gerekenler. Kaybolan girdi, çift tahsilat, sessiz hata.
• Sayının takas etmesine izin verilmeyenler. Erişilebilirlik, geri alma, alanı ve çözümü söyleyen hata mesajı.
• Değişikliğin nerede durması gerektiği. Dokunulmayacak dosyalar, aynı kalması gereken davranış.

En az iki kısıt sıralayamıyorsanız, sayıyı bir ajana verecek kadar henüz anlamıyorsunuz.

Plan modu öldü mü?

24 Eylül 2026’da Ayman Nadeem Plan mode is dead yazısını yayımladı. Hacker News’te 591 puana ulaştı. Savı, plan modlarının modellerin elinden tutulması gereken dönemde anlamlı olduğu ve sohbet, şartname, inceleme, onay ve uygulama adımlarının artık yapay hissettirdiği. İnsanlar uzun üretilmiş şartnameleri okumuyor. Bunun yerine iş bir döngüde ilerliyor: anla, harekete geç, incele, netleştir, ayarla, yeniden harekete geç. Planlama hâlâ oluyor. Yalnızca plan denen bir belge olması gerekmiyor.

Planlar konusunda büyük ölçüde haklı. Anthropic’in kendi rehberi de diff’i bir cümleyle anlatabiliyorsanız planı atlayın diyor.

Argümanın neyi koruduğuna dikkat edin. Nadeem, ne inşa edileceğini, neden önemli olduğunu düşünmenin ve kararları değerlendirmenin önemini koruduğunu yazıyor. Hacker News başlığı da aynı çizgi boyunca bölündü. Yorumculardan thiht, plan modunun modelin aklınızdaki şeyi gerçekten yapacağından emin olmaya yardım ettiğini yazdı. Bir başkası, loeg, alternatifi anlattı: model makul seçimler yapar ve sonradan başkalarını yapmasını isteyebilirsiniz.

Simon Späti’nin aynı haftaki yazısı the problem is not the AI code, plan tümüyle ortadan kalkınca nelerin kaybolduğunu adlandırıyor: ekipler, seçimlerin neden yapıldığının ardındaki niyeti bilmez hâle geliyor. Cümlesi keskin. Hiç planınız olmuyor.

Benim görüşüm ikisinin arasında. Sizi yavaşlatıyorsa planı bırakın. Hedefi tutun. Plan rotayı anlatır ve döngünün ilk dönüşünde eskir. Hedef varış noktasını anlatır, bu yüzden her dönüşte ayakta kalır. Anla, harekete geç, incele, ayarla: bu adımların her biri karşısında inceleyeceği bir şeye ihtiyaç duyar ve bu şey, içinde sayı olan tek satırdır. Dot şartnamesi 385 satıra uzanıyor. Yapıyı belirleyen kısım dört satırlık tabloydu.

Ne zaman sayı yazmamalısınız?

Soru hâlâ açıkken. Bazı işler keşiftir ve ona çok erken bir sayı dayatmak yanlış şeyi çok hassas ölçer.

Zevk. Bir haritanın bir yer gibi ya da bir markanın insanları gibi hissettirip hissettirmediği bir sayıma indirgenmez. Yine de bir çerçeve koyabilirsiniz: karşılaştırılacak üç yön, bir son tarih, karar verecek bir kişi. Yargı bir insanda kalır ve ajanın işi hızlıca seçenek üretmektir.

Keşif. Görüşmelerden önce çoğu zaman hangi sayının önemli olduğunu bilmezsiniz. Wfrah’ta, sorunun hesaplamanın kendisi olduğunu öğrenmeden önce “yetiştiriciler yemi bir dakikanın altında hesaplar” yazamazdık. O aşamada hedef bir sorudur ve yazdığınız sayı kaç kişiyle konuşacağınızdır.

Sayı sahte olacaksa. Bu üründe, bu sürümde ölçemiyorsanız süstür. Haftaya çıkacak bir özellik için “elde tutmayı yüzde 20 artır” ajana kontrol edebileceği hiçbir şey söylemez. Çalıştırabileceği bir şey seçin.

Ürün Arapça olduğunda ne değişir?

Arapça ya da sağdan sola ürünler için hedef belirleme üzerine bir yazı araması hiçbir şey çıkarmadı. Boşluk önemli, çünkü bir dilde kontrol edilen sayı ötekinde kontrol edilmiş olmaz.

Sayaç testi aynı iki dokunuşluk akışı iki kez çalıştırıyor, bir kez Arapça, bir kez İngilizce. Şartnamenin görsel kontrolleri, tek dilli bir testin kaçıracağı sağdan sola ayrıntıları içeriyor: telefon numarası satırı Arapça ekranda bile soldan sağa kalıyor, çünkü insanlar bir numarayı yüksek sesle böyle okur ve tutar sağa hizalanıyor. Arapça ve İngilizce satırlar nadiren aynı yerden kırılır; bu yüzden İngilizcede geçen bir yerleşim, Arapçada bir düğmeyi ekranın altına itebilir.

Dili hedefe yazın. “İki dokunuş, Arapça ve İngilizce” ile “iki dokunuş” farklı hedeflerdir ve ajan yazdığınızı test edecektir. Yatırım almış 179 MENA girişimini incelediğimizde yüzde 44’ünün hiç Arapça sitesi yoktu. Hedefin dışında bırakılan Arapça, ürünün de dışında kalma eğiliminde.

Hangi şablonlar yardımcı olur?

Her ücretsiz şablon Arapça ve İngilizce gelir ve tek bir çalışılmış örnek kullanır: Bunn.

Dördü de her biri için Claude komutlarıyla birlikte UX AI Kit Pro Max içinde yer alıyor.