ViraStack AI
Cursor, Claude Code ve diğer LLM tabanlı ajanların projede tutarlı kod üretmesini sağlayan AI-native mimari kit. AGENTS.md, CLAUDE.md ve framework’e özel Cursor kurallarıyla ajanları mimarinize bağlar.
Yeni bir proje açıyorsan ViraStack Start kullan; AI kuralları kurulumla birlikte gelir.
Kurallar fark yaratır
Aynı sohbet, farklı kural paketleri. Ajan kestirmeyi reddeder, ViraStack kalıbını önerir.
Ne enjekte edilir?
Tek komutla AGENTS.md, CLAUDE.md ve .cursor/rules dosyaları projene gelir.
Mimari
core-principles.mdc
Feature-Sliced sınırlar, isimlendirme kuralları ve import alias kuralları. Ajan uydurma klasör açmaz.
Data & State
query · zustand · api
Sunucu verisi için TanStack Query, istemci state için Zustand ve hata mesajları için ortak bir ApiError standardı.
UI & Forms
ui · forms · i18n
Bileşen katmanı, form + Zod doğrulama ve i18n kalıpları, kurulu stack’e göre uyarlanır.
Kalite
typescript · testing
Strict TypeScript, branded types ve test beklentileri ajan çıktısına gömülür.
Performans
performance.mdc
Core Web Vitals odaklı kurallar. Ajan hızlı ve ölçülebilir arayüzler üretir.
Framework izolasyonu
nextjs · tanstack
Yalnızca tespit edilen framework’ün kuralları yazılır; çapraz framework halüsinasyonu engellenir.
Nasıl çalışır?
Üç adım: tespit et, yaz, kullan. ViraStack Start ile yeni proje kurarken otomatik eklenir.
Framework tespit
package.json otomatik okunur; Next.js veya TanStack Start seçilir.
Kuralları yaz
Projeye uygun mimari kurallar yazılır.
Ajan hazır
Cursor, Claude Code ve diğer ajanlar aynı mimariyi izler. Geliştirmeye başlayabilirsin.
Kurulum
Mevcut bir projeye ViraStack AI kurallarını ekle.
$ pnpm dlx @virastack/ai init--force, -f — Mevcut kural dosyalarının üzerine yaz; onay sorma.
--framework — Framework’ü açıkça ayarla (nextjs veya tanstack).
--tr — CLI mesajlarını Türkçe göster.
Yeni bir proje mi kuruyorsun?
ViraStack Start tek komutla üretime hazır bir Next.js veya TanStack projesi kurar. Feature-Sliced mimari, tip güvenliği ve bu AI kuralları dahil gelir.