ViraStack AI
An AI-native architecture kit that helps Cursor, Claude Code, and other LLM agents write consistent code in your project. It ships AGENTS.md, CLAUDE.md, and framework-aware Cursor rules so agents follow your architecture.
Starting a new project? Use ViraStack Start; AI rules come with setup.
Rules change the outcome
Same chat, different rule packs. The agent rejects the shortcut and ships the ViraStack pattern instead.
What gets injected?
One command drops AGENTS.md, CLAUDE.md, and .cursor/rules into your project.
Architecture
core-principles.mdc
Feature-Sliced boundaries, naming conventions, and import aliases. Agents don’t invent folders.
Data & State
query · zustand · api
TanStack Query for server data, Zustand for client state, and a shared ApiError standard for errors.
UI & Forms
ui · forms · i18n
Component layer, form + Zod validation, and i18n patterns, adapted to your installed stack.
Quality
typescript · testing
Strict TypeScript, branded types, and testing expectations baked into agent output.
Performance
performance.mdc
Core Web Vitals–minded rules. Agents ship fast, measurable interfaces.
Framework isolation
nextjs · tanstack
Only the detected framework’s rules are written; no cross-framework hallucinations.
How it works
Three steps: detect, write, ship. Added automatically when you create a project with ViraStack Start.
Detect framework
Reads package.json automatically; picks Next.js or TanStack Start.
Write the rules
Writes the matching architecture rules into your project.
Agent ready
Cursor, Claude Code, and other agents follow the same architecture. Start building.
Install
Add ViraStack AI rules to an existing project.
$ pnpm dlx @virastack/ai init--force, -f — Overwrite existing rule files without prompting.
--framework — Explicitly set the framework (nextjs or tanstack).
--tr — Run the CLI with Turkish prompts and messages.
Starting a new project?
ViraStack Start scaffolds a production-ready Next.js or TanStack project in one command — Feature-Sliced architecture, type safety, and these AI rules included.