# ViraStack AI

> AI-native architecture kit for modern React. One command installs the same rules in Claude Code and Cursor native formats, plus an AGENTS.md map for every other agent. npm: `@virastack/ai` (v2).

Install: `npx @virastack/ai init`. Detects Next.js vs TanStack Start from `package.json` and writes only the relevant rules.

For the CLI, installed files and rule list inline, prefer [llms-full.txt](https://virastack.com/ai/llms-full.txt).

## Docs & pages

- [AI overview](https://virastack.com/ai): Product landing (how it works, installed rules, CLI)
- [AI docs](https://virastack.com/ai/docs): Current (v2) documentation
- [Upgrade to v2](https://virastack.com/ai/docs/upgrade): Migration from v1
- [llms-full.txt](https://virastack.com/ai/llms-full.txt): Full machine-readable AI guide
- [v1 llms.txt](https://virastack.com/ai/v1/llms.txt): Archived v1.3 guide
- [npm `@virastack/ai`](https://www.npmjs.com/package/@virastack/ai): Package registry
- [GitHub](https://github.com/virastack/ai): Source and rule templates

## What it writes

- `.claude/rules/virastack/*.md`: Claude Code rules (`--agent claude`)
- `.cursor/rules/virastack/*.mdc`: Cursor rules (`--agent cursor`)
- `.agents/rules/virastack/*.md`: plain Markdown rules for any agent (`--agent none`)
- `AGENTS.md`: managed `virastack-ai` block with persona, commands and rule map
- `CLAUDE.md`: gets an `@AGENTS.md` import line if missing
- `.virastack/ai.json`: manifest of installed files with hashes

## Related

- [ViraStack llms.txt](https://virastack.com/llms.txt): Ecosystem map
- [Start](https://virastack.com/start/llms.txt): Scaffolds that pre-install AI
- [Guide](https://virastack.com/guide/llms.txt): Interactive modern-web walkthrough