Giriş

ViraStack AI (@virastack/ai), Next.js veya TanStack Start projesine AI kodlama agent’ları için mimari kurallar yazar. Kurallar kodun nerede duracağını, hangi kütüphanenin nasıl kullanılacağını anlatır. Böylece agent’lar projenin geri kalanına uyan kod yazar.

Ne yapar

• 14 kuralı her aracın kendi biçiminde yazar: Claude Code için .claude/rules/virastack/, Cursor için .cursor/rules/virastack/.
• AGENTS.md dosyasına projenin komutlarını ve tüm kuralların haritasını içeren yönetilen bir blok ekler. Codex, Copilot ve diğer agent’lar da kuralları buradan bulur.
• package.json üzerinden Next.js veya TanStack Start’ı tespit eder ve sadece o framework’ün kurallarını kurar. i18n kuralı sadece next-intl veya Paraglide kuruluysa eklenir.
• Kurduğu her dosyayı .virastack/ai.json içine kaydeder. Güncellemeler sadece sizin değiştirmediğiniz kuralları yeniler.

Neden ViraStack AI?

• Tek standart, her araç: Claude Code ve Cursor’ı birlikte kullanan bir ekip, iki araçta da aynı kuralları alır.
• Güncel stack için yazıldı: Next.js 16, React 19.2, TanStack Start, TanStack Query 5, Zustand 5, Zod 4 ve Tailwind CSS 4. Her örnek kendi kurallarına uyar.
• Dosyalarınızı ezmez: kurallar kendi virastack/ klasörlerinde durur. AGENTS.md ve CLAUDE.md sadece küçük bir yönetilen blok veya import satırı alır.

Tek komut

Proje kök dizininde çalıştırın:

$ pnpm dlx @virastack/ai init

Yeni bir proje mi başlatıyorsunuz? ViraStack Start, bu kurallar kurulu halde Next.js veya TanStack Start projesi oluşturur.

Sonraki adımlar

• Kurulum: gereksinimler, AI aracı seçimi ve güncelleme.
• Kural kataloğu: her kuralın neyi kapsadığı ve ne zaman yüklendiği.
• v2’ye geçiş: v1 projesini yeni yapıya taşıma.