Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<div align="center"> <img src="./public/ai.jpg" alt="Vira Stack AI" /> </div>
<br />
<div align="center"> <a href="https://www.npmjs.com/package/@virastack/ai-rules"> <img src="https://img.shields.io/npm/v/@virastack/ai-rules" alt="npm version" /> </a> <a href="https://www.npmjs.com/package/@virastack/ai-rules"> <img src="https://img.shields.io/npm/dt/@virastack/ai-rules" alt="npm downloads" /> </a> <a href="https://bundlephobia.com/package/@virastack/ai-rules"> <img src="https://img.shields.io/bundlephobia/minzip/@virastack/ai-rules" alt="bundle size" /> </a> </div>
<br />
ViraStack AI Rules
AI-native architecture kit for modern React. High-discipline protocols for autonomous agents.
- 🤖 Elite AI Persona: Transforms your LLM into a highly disciplined, specialized coding assistant.
- 🏗️ Feature-Driven Design: Enforces strict domain-based organization for maximum scalability.
- 🛡️ Zod-First Type Safety: Ensures end-to-end type safety derived from schemas.
- ⚡ Performance-First: Built-in rules for LCP optimization, CLS prevention, and maximum efficiency.
- 🌐 LLM Agnostic: Works seamlessly with Cursor, Windsurf, Claude Code, and other agentic tools.
Read the docs →
Protocol Coverage
| Protocol | Focus Areas |
|---|---|
| UI & UX | Atomic design, A11y SSOT, AI-Aesthetic bans, Skeleton states. |
| API Layer | Zod-validation, SSR Safety, Error normalization, Branded types. |
| Performance | Core Web Vitals targets, Bundle budgets, Image priority. |
| State | Zustand selectors, Hydration safety, TanStack Query integration. |
| Frameworks | Next.js 16 (RSC/Actions) & TanStack Start (Loaders/ServerFn). |
Quick Start
Initialize the elite protocols in your project with a single command:
npx @virastack/ai-rules initHow it Works
- Install: Run
npx @virastack/ai-rules init. - Context: The CLI injects specialized
.mdcfiles into your.cursor/rulesdirectory. - Reasoning: Agent (Cursor/Claude) automatically detects these rules based on your file activity.
- Execution: Your AI assistant starts writing code according to the ViraStack High-Discipline protocols.
Explore the ViraStack Ecosystem
Projects
- Next.js Boilerplate - Production-ready Next.js 16+ starter template built with Tailwind CSS 4 and TypeScript.
- AI Rules - AI-native architecture kit and high-discipline protocols for modern React applications.
- Input Mask - Lightweight, zero-dependency input masking library optimized for React Hook Form.
- Password Toggle - Fully accessible and highly customizable password visibility hook for React.
- Modern Web in 3 Minutes - Master modern web development standards in just 3 minutes.
🚧 Coming Soon
- Start (CLI) - Automated scaffolding tool to initialize and scale high-discipline ViraStack architectures.
- TanStack Boilerplate - Production-ready TanStack Start starter template built with Tailwind CSS 4 and TypeScript.
- Standards - A unified suite of ESLint, Prettier, and architectural rules to enforce absolute code integrity.
- Error Guard - Pro-grade error handling and smart recovery protocols for zero-friction React environments.
... and more at virastack.com
License
Licensed under the <a href="https://github.com/virastack/ai-rules/blob/main/LICENSE">MIT License</a>.
Maintainer
A project by Ömer Gülçiçek
