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.
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.
Kurallar fark yaratır
Aynı prompt, kuralsız ajanın yapacağı hatayı ViraStack AI engeller. Feature sınırları bozulmaz.
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. Mevcut dosyalar için onay sorulur; --force ile üzerine yazılır.
Ajan hazır
Cursor, Claude Code ve diğer ajanlar aynı mimariyi izler. Yeni özellik planlatmaya başlayabilirsin.
Kurulum
Mevcut bir projeye ViraStack AI kurallarını ekle.
$ pnpm dlx @virastack/ai init| Bayrak | Açıklama |
|---|---|
| --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 proje mi kuruyorsun?
ViraStack Start bu kuralları yeni projene otomatik ekler.