Tüm kurallar kendi resmi dokümanıyla karşılaştırıldı ve sıfırdan kurulan projelerde denendi; CLI artık proje dışındaki dosyaları silemiyor ve kullanıcı metnini kaybetmiyor.
Ne değişti
Veri kaybı: Manifest'te kural klasörleri dışındaki kayıtlar yok sayılıyor. Dengesiz AGENTS.md işaretleri çalışmayı durduruyor, dosyaya dokunmuyor.
AGENTS.md: Persona ve guardrail bölümleri kalktı. Artık komutlar (kurulum ve tek dosya testi dahil), öncelik ve kural haritası var.
Barrel: Kurallar uygulama kodunda barrel dosyalarını yasaklıyor ve tek @/* alias kullanıyor. Yeni suffix *.action.ts, mesajlar src/messages/ altında.
Yükleme: Server Action dosyaları nextjs, server function dosyaları tanstack-start, route'lar i18n kuralını alıyor. State kuralları component'lere ulaşsın diye react içine taşındı.
i18n: Kural artık kelime kelime çeviri yerine localization istiyor ve dile duyarlı büyük-küçük harf ve sıralama API'lerini gösteriyor.
Cursor: Çıktı dokümana uygun globs kullanıyor; kural kaynakları GitHub'da okunabilsin diye .md oldu.
CLI: Üzerine yazma ve silme ayrı soruluyor, symlink'ler korunuyor. Yalnızca @tanstack/react-router olan proje TanStack Start sayılmıyor, Yarn 1 npx kullanıyor, lockfile repo köküne kadar aranıyor.
Neden
Klonlanan repo tehlikeliydi: Manifest commit'lenen bir dosya. İçindeki ../outside.txt kaydı, init ve remove ile proje dışındaki dosyayı soru sormadan siliyordu; tek başına kalan bir işaret de kullanıcı metnini siliyordu. İkisini de testle ürettik.
Persona: Bir agent'ı gerçek repoda rol satırıyla ve onsuz karşılaştıran kontrollü çalışma bulamadık, yani etkisi bilinmiyor. Tek çağrılı çalışmalarda doğrulukta tutarlı bir kazanç görülmedi. Claude dokümanı bu dosyanın yalnızca koddan çıkarılamayanı taşımasını öneriyor. Anthropic rolü system prompt için öneriyor; bu dosya o kategoride değil.
Yanlış yükleme: Action güvenlik kuralları action yazılırken context'te değildi, state kuralları component yazılırken yüklenmiyordu.
Yanlış içerik:startTransition fonksiyonu hemen çalıştırır, ağır işi hızlandırmaz. ensureQueryData ve prefetchQuery kaldırılacak. nuqs TanStack Start'ı kapsamıyor. font-display: swap kendi şablonumuzda CLS 0.207'ye yol açıyordu; fallback ile 0.001'e indi.
Örnekler:forms örneği Server Component'ten render edilince build'i kırıyordu, api örneğindeki göreli URL server'da hata veriyordu, nextjs örneği yeni create-next-app projelerinde build'i kırıyordu.
Sınırlar: Sıfırdan kurulan Next.js ve TanStack Start projelerinde Claude ile görev başına kurallı ve kuralsız ikişer koşu yaptık. Kurallı koşuların hepsi tip, lint, build ve sayfa kontrolünden geçti; kuralsız TanStack koşuları eski .inputValidator yazıp 500 verdi. Bu az koşulu bir kontrol, kod kalitesi artışı iddiası değil. Cursor çıktısı dokümana göre yazıldı, Cursor'da çalıştırılmadı.
Komutu çalıştır, elle taşınacak bir şey yok. Değiştirmediğin kurallar güncellenir, değiştirdiklerin korunur ve listelenir. Mevcut barrel dosyaları ve alias'lar hata sayılmaz; toplu refactor gerekmez, yeni kod yeni kurallara uyar. Yalnızca @tanstack/react-router kullanıyorsan --framework vermen gerekir.
