Büyük bir isteği anlaşılır adımlara nasıl bölersiniz?

Claude'dan şunu istiyorsunuz: "Yerel ayarların listesini, aramayı ve ülke filtresini ekle, görünümü de yenile." Ajan birkaç dosyayı değiştirip işin bittiğini bildiriyor; sayfa ilk bakışta gayet iyi görünüyor. Ancak arama terimini yazınca aradığınız kayıt kayboluyor. Alanı temizliyorsunuz, kayıt geri gelmiyor.

Ne bozuldu? Arama mı, filtre mi, yoksa listenin kendisi mi? Her şey aynı anda eklendi; parçaların hiçbirinin tek başına çalıştığını henüz görmediniz. Aramanın düzeltilmesini istiyorsunuz, yeni değişiklikler geliyor ve tüm sayfayı yeniden kontrol ediyorsunuz. İş ilerliyor ama sonuca duyduğunuz güven giderek azalıyor.

Birkaç değişikliği aynı anda çözmeye çalışmamak için isteği küçük ve kontrol edilebilir adımlara bölün. Önce listeyi oluşturup kayıtları karşılaştırın. Sonra aramayı ekleyin ve bu liste üzerinde deneyin. Ardından filtreye geçin; görünüm değişikliğini ayrı bir adım olarak bırakın. Hatalar yine olabilir, ama elinizde kontrol edilmiş bir başlangıç durumu ve incelenecek son değişikliklerin net bir listesi olur. Gelin, bu adımları nasıl seçeceğinize ve ajana nasıl aktaracağınıza bakalım.

Solda tek seferde yapılan değişiklikler, sağda ise henüz belirli bir nedene işaret etmeyen ortak belirti yer alıyor. Parçaları sırayla kontrol ederseniz hatanın ortaya çıkışını son düzenlemeyle ilişkilendirmek kolaylaşır.

Bir sonraki sonucu seçin

Parçalara ayırma, bir işi daha küçük bölümlere bölmektir. Ajanla çalışırken her bölümün sonucunu ayrı ayrı kontrol edebileceğiniz adımlar seçmek işe yarar. Örneğin önce listeyi gösterin, sonra bu listeye arama ekleyin, ardından filtreyi koyun.

Liste zaten çalışıyorsa baştan yapmaya gerek yok. Eksik olan en yakın davranıştan başlayın. Çalışıp çalışmadığından emin değilseniz önce sayfayı açıp kontrol edin. Nereden başlayacağınız projenin durumuna bağlıdır, güzel görünen bir plana değil.

"Önce HTML'i, sonra JavaScript'i yaz" demek de işi böler, ama sonucu kontrol etmeyi her zaman kolaylaştırmaz. Çalışan bir arama için HTML'de bir giriş alanı ve JavaScript'te bir olay işleyici aynı anda gerekebilir. İki dosyaya dokunsa da bu, anlaşılır tek bir adımdır.

İsteği davranışlara göre bölün

Örnek yerel ayar kataloğunda dört kayıt var. Yerel ayar kodu, dil ve ülke aşağıda verilmiştir; bu verileri kontrol sırasında kullanacağız.

Artık her adım için beklenen sonucu ve nasıl kontrol edileceğini belirleyebiliriz:

Ok işareti, kontrolden sonra bir sonraki adıma geçildiğini gösterir. Arama ile filtrenin sırasını değiştirebilirsiniz, ama ikisi de listeye ihtiyaç duyar. Görünümü tamamen değiştirmeyi ayrı bir adım olarak bırakalım; temel işlevler çalıştıktan sonra sonucu değerlendirmek daha kolay olur.

Adımın sınırlarını belirleyin

Diyelim ki liste hazır. Claude'dan aramayı eklemesini isteyin ve bu aşamada nelerin korunması gerektiğini açıkça belirtin. Örnekte veriler ve sayfanın davranışı app.js dosyasında, işaretleme ise index.html dosyasında. Kendi projenizde gerçek yolları kullanın.

@index.html ve @app.js dosyalarını oku.
Dört yerel ayarın listesi zaten çalışıyor.
Yerel ayar koduna veya dil adına göre arama alanı ekle.

Mevcut kayıtları, alanlarını ve görünümü koru.
Arama için gereken öğeleri ekleyebilirsin.
Ülke filtresini şimdilik ekleme.

Kontrol: German ve de-DE, de-DE kaydını bulmalı;
zzz hiçbir kayıt bulmamalı; boş arama terimi dört kaydın hepsini göstermeli.

Önce neleri değiştireceğini açıkla. Dosyalarda henüz değişiklik yapma.

Yanıtı okuyun. Yeni veriler, tema değişikliği veya filtre önerilmişse uygulamaya geçmeden önce sınırları netleştirin. Her şey isteğinize uygunsa bu adımı yapmasını söyleyin. Sınırları açıkça belirtmek işi yönlendirir, ama bunlara uyulup uyulmadığını sonuçtan yine de kontrol etmeniz gerekir.

Eklenen her işlem gereksiz değildir. Arama için giriş alanı gerekir. Renkleri tamamen değiştirmek ise ayrı bir istektir. Şu soruyu sormak işe yarar: Bu düzenleme olmadan seçtiğiniz sonucu elde edebilir misiniz?

Nereden başlayacağınız belli değilse

Başkasının projesinde önce dosyaları okumanız gerekebilir. Kayıtların nereden geldiğini ve listeyi hangi dosyanın gösterdiğini henüz bilmiyorsanız arama eklenmesini istemeyin.

Sayfanın kayıtları nereden aldığını ve listeyi nerede gösterdiğini bul.
Yeterliyse iki ya da üç temel dosyayı oku.
Bulduğun yolları belirt ve küçük bir ilk adım öner.
Yeterli bilgi yoksa başka neleri okuman gerektiğini söyle.
Dosyalarda henüz değişiklik yapma.

Böyle bir adımın sonucu, bulunan dosyalar ve ne işe yaradıklarının açıklamasıdır. Yanıtı belirtilen kod parçalarıyla karşılaştırın. "İki ya da üç" başlangıç için bir öneridir; gereken kodu okumaya engel değildir.

Sonraki adımdan önce kontrol edin

"Arama hazır" mesajı tam olarak neyin kontrol edildiğini söylemez. Sayfayı açıp isteğinizdeki örnekleri deneyin: eşleşme, eşleşme olmaması ve alanı temizleme. Mevcut kayıtların ve alanlarının korunduğundan da emin olun.

Alanı temizledikten sonra yalnızca üç satır görünüyorsa arama adımında kalın. Ajana yaptığınız işlemi, beklediğiniz sonucu ve gerçekte ne olduğunu bildirin: "Alanı temizledim. Dört kayıt bekliyordum, üç tane görüyorum." Filtre eklemek şu anda nedeni bulmayı zorlaştırır.

Bazen adımı daha da küçültmek gerekir. Örneğin kayıtlar hiç görünmüyorsa önce listeyi geri getirin ve kontrol edin. Aklınıza sıralamayla ilgili yeni bir fikir gelirse, kaybolmaması ve mevcut düzenlemenin kapsamını genişletmemesi için onu ayrı bir madde olarak not edebilirsiniz.

Sol kol, aramanın davranışı isteğe uyana kadar sizi aramaya geri götürür. Sağ kol ise kontrol başarılı olduktan sonra açılır. Filtreyi eklediğinizde hem filtreyi hem de aramayla birlikte çalışmasını kontrol edin: yeni adım, önceden çalışan bir davranışı etkileyebilir.

Claude Code ile birlikte çalışırken

Her yeni düzenlemeden önce üç şeyi netleştirin: şimdi ne elde etmek istiyorsunuz, neler korunmalı ve sonucu nasıl göreceksiniz? Gerekli dosyaları ajana verin, sıradaki adım üzerinde anlaşın ve bu adımı yapmasını isteyin. Kontrol ettikten sonra devam edin ya da mevcut düzenlemeyi netleştirin.

Tek bir adım birkaç mesaj sürebilir. Önemli olan, istediğiniz anda şunu söyleyebilmeniz: "Şimdi aramayı ekliyoruz. Liste zaten kontrol edildi. Filtre şimdilik bekliyor."