Claude Code, terminalde çalışan bir yapay zekâ kodlama ajanıdır; bir web sitesinin tasarımını, kodunu, testini ve yayınını tek oturumda yürütmeyi mümkün kılar ve bu, küçük bir ajansın iş akışını belirgin biçimde hızlandırır. Bizde hız, işi ajana bırakmaktan değil; kuralları yazılı hâle getirip her adımı insanın denetlemesinden geliyor. Aşağıda Vinci Studio'nun bu iş akışını, yaşadığımız hataları da saklamadan anlatıyoruz.
Claude Code nedir, bir ajansa ne katar?
Claude Code, proje klasörünüzü okuyan, dosyaları düzenleyen, komut çalıştıran ve sonucu kendisi kontrol eden bir araçtır. Sohbet penceresinden farkı şudur: kodu kopyalayıp yapıştırmazsınız; ajan projenin içinde çalışır. Küçük bir ajansta bu, tasarımcı, yazılımcı ve test eden kişi arasındaki el değiştirmelerin azalması demek. İki kişilik bir ekip için asıl kazanç da burada: bekleme süresi kısalıyor.
Aynı oturumda tasarım, kod, test ve yayın
Geleneksel akışta tasarım bir araçta, kod başka bir yerde, test ayrı bir aşamada ilerler. Bizde çoğu proje tek oturumda dönüyor:
- Tasarım: Sayfa yapısı ve bileşenler doğrudan kodla kurulur; tarayıcıda görülüp aynı oturumda düzeltilir.
- Kod: Bileşenler, içerik yapısı ve sayfalar yazılır.
- Test: Tip denetimi ve lint çalıştırılır, ardından sayfalar gerçek tarayıcıda açılıp bakılır. "Derleme geçti" bizim için "bitti" demek değildir.
- Yayın: Değişiklik depoya gönderilir, yayın otomatik başlar, canlı sayfa ayrıca kontrol edilir.
Bu akışla bir yapım ajansı için 22 sayfalık bir site önizlemesi hazırladık; mobil PageSpeed ölçümünde 95-96 aldı. Bu tek bir ölçüm; PageSpeed laboratuvar skorları ölçümden ölçüme oynayabildiği için bunu bir söz değil, bir veri noktası olarak okumanızı öneririz.
Ajanlarla paralel çalışma
Claude Code, belirli bir iş için yardımcı ajanlar (subagent) çalıştırabiliyor. Biz bunu birbirinden bağımsız işler için kullanıyoruz: biri bir sayfanın içeriğini yazarken diğeri başka bir sayfanın bileşenlerini kuruyor, üçüncüsü mevcut sayfaları denetliyor. Ana oturum hedefi ve kararları elinde tutuyor, yardımcılar sonuç getiriyor. Paralel çalışmanın bedeli koordinasyon; bunu aşağıda bir hata örneğiyle göstereceğiz.
Kurallar dosyası: CLAUDE.md
Ajanın her oturumda sıfırdan başlamaması için proje kökünde bir CLAUDE.md dosyası tutuyoruz. İçinde şunlar var: kullandığımız teknolojiler, tasarım kuralları, yapılmaması gerekenler ve geçmişte yaşanan hataların kısa notları. Örneğin "ekranın üst kısmındaki hiçbir elemana giriş animasyonu verme" gibi bir kural orada yazılı. Dosya, yeni gelen birine verilecek bir devir notu gibi çalışıyor; ajan da insan da aynı bilgiyle başlıyor. Tek şart güncel tutmak; eski bilgi, bilgisizlikten daha tehlikeli.
İnsan denetimi nerede devreye giriyor?
- Karar noktaları: Fiyat, vaat, müşteriye gidecek metin ve yayın kararı insanın.
- Gözle kontrol: Ekran görüntüsü ve gerçek tarayıcıda bakmadan "tamam" demiyoruz.
- İçerik doğruluğu: Rakam ve mevzuat iddiaları yayından önce kaynaktan doğrulanır.
Ajan hızlı, ama neyin önemli olduğunu bilmiyor; bunu ona biz söylüyoruz.
Yaşadığımız üç hata
- Fold üstü animasyon LCP'yi bozdu. Ana sayfada giriş animasyonu JavaScript tabanlıydı; sunucu çıktısında eleman görünmez (opacity 0) geliyordu ve sayfa yüklenme sürecinin ana içeriği geç boyandı. Giriş animasyonunu saf CSS'e taşıdık, kuralı
CLAUDE.md'ye yazdık.
- Renk token'ında alfa desteği sessizce çalışmadı. Bir renk değişkeni üzerinden saydamlık vermeye çalıştık; yapı bunu desteklemiyordu ve hata vermeden normal rengi gösterdi. Derleme geçti, ekranda ise yanlış renk vardı. Bu yüzden gözle kontrolü bırakmıyoruz.
- Ajanlar aynı anda build çalıştırınca kilit çakışması oldu. İki ajan aynı klasörde derleme başlatınca ikincisi kilitten dolayı hata verdi. Çözüm basit: derlemeyi sıraya koymak ve paralel işleri ayrı dosyalara bölmek.
Üçünün ortak dersi şu: ajan hatayı sessizce üretebilir ve araç da hatayı sessizce yutabilir. Bu yüzden her hatadan sonra önce nedenini anlıyor, ardından aynı hatayı yakalayacak bir kural veya kontrol ekliyoruz. Kurallar dosyası zamanla bir hata arşivine dönüşüyor ve her yeni projede bize zaman kazandırıyor.
Hız nereden geliyor, nereden gelmiyor?
Kazandığımız zaman çoğunlukla üretimden geliyor: tekrar eden bileşenler, benzer sayfa şablonları, tip hataları ve küçük düzeltmeler dakikalar içinde hallediliyor. Kazanmadığımız yer ise düşünme kısmı. Bir sayfanın müşteriye ne anlatacağı, hangi sorunun cevaplanacağı, hangi iddianın yazılmayacağı hâlâ insan işi ve hâlâ zaman alıyor. Küçük işletme siteleri için bu denge iyi çalışıyor; çünkü müşteri çoğu zaman karar verenin kendisi, geri bildirim hızlı geliyor ve aynı gün ikinci sürümü gösterebiliyoruz.
Bir de görünmeyen bir kazanç var: ajan yorulmuyor ve sıkıcı kontrolleri atlamıyor. Her sayfada başlık yapısı, bağlantılar, görsel boyutları ve meta bilgisi aynı titizlikle denetlenebiliyor. Bu kontrolleri kurallar dosyasına yazdığımız için sonuç, günün hangi saatinde çalıştığımıza bağlı olmuyor.
Bu iş akışı sizin için ne anlama geliyor?
Hız tek başına bir değer değil; hızlı üretilmiş ama denetlenmemiş site, geç ama doğru üretilmişten pahalıya patlar. Biz hızı, daha çok tur atabilmek için kullanıyoruz: deneyip ölçmek, düzeltmek, tekrar ölçmek. Siteniz için çalışmayı konuşmak isterseniz web tasarım hizmetimize bakabilir, yayından sonra aranabilirlik ve yapay zekâ aramalarında görünürlük için SEO·GEO·AEO hizmetimizi inceleyebilirsiniz.
