v2’ye geçiş

Neler değişti

• Kurallar .cursor/rules/*.mdc yerine .cursor/rules/virastack/ içine taşındı. Claude Code kendi kopyasını .claude/rules/virastack/ içinde alır. Kurulan dosyalar sayfasına bakın.
• docs/architecture-guide.md her zaman yüklenen architecture kuralı oldu. docs/MEMORIES.md kaldırıldı.
• AGENTS.md artık baştan yazılmıyor. ViraStack sadece kendi virastack-ai bloğunu yazar.
• Next.js bloğunu (nextjs-agent-rules) artık ViraStack AI yazmıyor. Yeni projelerde onu Next.js ve ViraStack Start ekler. v1’in yazdığı kopya, düzenlenmediyse silinir.
• features/*/data/ klasörü constants/ oldu. Kurallar artık @/data alias’ını ve *.data.ts dosyalarını kullanmıyor.
• ApiError, ViraStack Start’ın src/lib/api.ts dosyasıyla aynı şekilde message, status ve data kullanır.

Yeniden adlandırılan kurallar

Adı aynı, içeriği yeniden yazıldı: api, forms, i18n, nextjs, performance, tanstack-start, testing, typescript.

Tek komut

Çalışmanızı commit edin veya stash’leyin, sonra proje kök dizininde çalıştırın:

$ pnpm dlx @virastack/ai@2 init

• Hiç düzenlemediğiniz v1 kural dosyaları ve docs/ dosyaları silinir.
• Düzenlediğiniz v1 dosyaları korunur ve listelenir. Değişikliklerinizi taşıyıp onları kendiniz silebilirsiniz.
• Düzenlenmemiş bir v1 AGENTS.md yeni blokla değiştirilir. Düzenlediyseniz içeriğiniz korunur, blok altına eklenir ve CLI sizi uyarır.
• v1 CLAUDE.md (@AGENTS.md) korunur.

  - .cursor/rules/core-principles.mdc (v1) · removed
  - docs/architecture-guide.md (v1) · removed
  - docs/MEMORIES.md (v1) · removed
  ! .cursor/rules/ui-components.mdc (v1) · kept: v1 file you changed; delete it yourself if no longer needed

(v1) ile işaretli satırlar taşımadır. Yazmadan önce görmek için --dry-run ekleyin.

Elle kontrol edin

• Korunan v1 kural dosyaları: değişikliklerinizi kendi kural dosyanıza taşıyın (özelleştirme sayfasına bakın), sonra eski dosyayı silin.
• Eski AGENTS.md içeriği: CLI uyardıysa bloğun üstündeki v1 kısmını silin. Böylece agent’lar tekrar eden talimat almaz.
• Doldurulmuş docs/MEMORIES.md: korunur. Hâlâ işe yarayanları AGENTS.md içinde bloğun dışına taşıyın, sonra dosyayı silin.
• Kodunuzda @/data: data/ klasörlerini constants/ olarak değiştirin ve alias’ı tsconfig.json dosyasından kaldırın. Yoksa agent’lar iki farklı deseni sürdürür.
• Sonucu .virastack/ai.json dahil commit edin.

Geri dönüş

v2’yi kaldırın, sonra v1’i tekrar kurun:

$ pnpm dlx @virastack/ai remove

$ pnpm dlx @virastack/ai@1 init

v1 dokümanı v1 arşivinde durur.