Salvor'u iki gerçek projeye kurmak

Kurulum benim yanlış bildiğim bir şeyi yakaladı

Kurulumun bir parçası, projenin gerçekte nasıl çalıştığını yazmak: nerede yayında olduğu, canlıdaki uygulamanın hangi dosya olduğu. Arka uç için bunu doldururken, gerçekte yayında olan uygulamanın hem notlarımda hem de herkese açık bir yazımda anlattığım dosyadan farklı olduğunu fark ettim. Kurulum adımı bu soruyu sormamı sağladı, ikisini de düzelttim.

Bir hafıza sistemi, içine giren bilgi kadar iyidir. Altyapıyı açıkça yazmaya zorlanmak tek başına buna değdi.

Daha hiçbir şey yazılmadan yakalanan bir güvenlik açığı

Statik site, repo web sunucusuna kopyalanarak yayına alınıyor. Kurulumdan önce bunun ne anlama geldiğine baktım: reponun README.md dosyası canlı sitede herkes tarafından okunabiliyordu. Kurulumdan sonra hafıza klasörü, kurallar dosyası ve sunucu notları da bir sonraki yüklemede aynı şekilde yayınlanacaktı.

Hiçbir dosya oluşturmadan önce bunları bir sunucu kuralıyla engelledim:

.salvor/     -> 403
*.md         -> 403
tools/       -> 403

Projenin zaten bildiklerini içeri almak

İki projede de dersler vardı, yalnızca Salvor'un biçiminde değildi. Arka ucun ayrı bir dosyada 13 öğrenilmiş hatalık bir listesi vardı. Sitenin dersleri ise kendi notlarıma ve düzeltme commit'lerine dağılmıştı. Kurulum bunları tek tek içeri almayı önerdi: arka uç için 13, site için 12 madde.

Salvor'un kuralı, her bilginin tek bir sahibi olması. Bu yüzden doğru kaynağın eski liste mi yoksa yeni hafıza mı olacağına karar vermem gerekti. Her şeyi Salvor'a taşıdım, eski dosyaları da yalnızca yönlendirme olarak bıraktım. O günden beri her oturum tek bir yeri okuyor.

Kuralları şablona uymayan projelere uydurmak

• Derleme adımı yok. Salvor'un sürüm kuralı, sürüm numarasını basan bir derleme adımı varsayıyor. Sitede derleme yok. Sürümü, sitenin service worker dosyasındaki önbellek adına bağladım. O ad zaten her yüklemede değişmek zorundaydı, kendiliğinden oturdu.
• Kendi klasörü olmayan bir bileşen. Arka uç projesinin web sitesi kök dizine, bir articles/ klasörüne, bir tr/ klasörüne ve assets/ klasörüne dağılmış durumda. Not dosyası için belirgin bir yer yoktu. articles/ içine tüm siteyi kapsayan tek bir not koydum.
• Birbirine bağlı kurallar. Arka uçta her zaman birlikte değişmesi gereken üç motor var. Kurulumda bunları eşli yollar olarak belirttim, ama sonra katı varsayılanlara "hayır" dedim ve bu, eşli yolları kontrol eden kuralın ta kendisini sessizce kapattı. O tek kuralı elle yeniden açtım.

İlk gerçek görev: bilinen kalıplar dakikalar içinde tanındı

İlk gün bir ajandan canlı sitede "sorun varsa düzelt" işini istedim. Telefonda yapılan bir kontrol iki hata buldu: İngilizce ana sayfa bir oyun kartı grubunu tamamen kaybediyordu ve dört İngilizce kart Türkçe sayfalara gidiyordu.

İki hata da tür olarak yeni değildi. İkisi de hafızada zaten kayıtlı olan öğrenilmiş hatalarla örtüşüyordu, yalnızca başka yerlerde ortaya çıkmışlardı. Kalıbın bir adı olduğu için ajan bunları sıfırdan araştırmak yerine dakikalar içinde tanıyıp düzeltti.

Ajanların yazdıklarını gözden geçirmek

Geçici kayıt modunda ajanlar, onayımı bekleyen yeni dersler yazıyor. İlk inceleme turu olması gerektiği gibi geçti: üç madde, her biri kanıtıyla birlikte ayrı ayrı gösterildi ve her birini ayrı yanıtladım. Üzerlerindeki "geçici" işareti, ben onaylayana kadar sonraki her düzenlemede korundu.

Kurulum farklıydı. Onaylanacak 12 ve 13 madde olunca, iki seferde de hepsini tek bir talimatla onayladım. Bu gözü kapalı onay vermek demek ve sorumlusu benim. Ama bir şey de söylüyor: soruları küçük gruplar hâlinde, en önemlisinden başlayarak ve "gerisine sonra karar ver" seçeneğiyle sormak daha iyi.

Durum ve sağlık kontrolleri

Salvor'un Claude Code eklentisinde bir durum komutu ve bir sağlık kontrolü var. Durum komutu ilk denemede doğru ve kısa bir özet verdi. Sağlık kontrolü 11 başarılı, 2 uyarı ve 0 başarısız sonuç verdi ve benim yol açtığım gerçek sapmaları buldu. Bunu diğer Salvor testleri yazısında daha ayrıntılı anlattım.

Kendiniz kuracaksanız

• Altyapıyı dürüstçe yazın. Yanlış bildiğiniz bir şeyi gösterebilir.
• Hafıza dosyalarını eklemeden önce reponuzun webde yayınlanıp yayınlanmadığına bakın.
• Mevcut dersleri içeri alın ve her biri için tek bir sahip belirleyin.
• Küçük gruplar hâlinde onaylayın. Uzun bir listenin incelemeyi formaliteye çevirmesine izin vermeyin.