Cursor Rules — стандарты для AI

Rules задают контекст проекта для AI: стек технологий, код-стайл, паттерны, запреты. Они коммитятся в Git — вся команда работает по одним стандартам.

Расположение

.cursor/rules/
├── general.mdc       # стек, общие правила
├── api-routes.mdc    # конвенции API
├── components.mdc    # паттерны компонентов
└── testing.mdc       # структура тестов

Формат файла .mdc

---
description: Конвенции API маршрутов
globs: ["src/app/api/**/*.ts"]
alwaysApply: false
---

- Используй Next.js App Router
- Все ответы: { data, error, meta }
- Валидируй входные данные через zod

Типы применения

Тип	Поведение
Always	Подключается в каждый чат автоматически
Auto	AI сам решает, когда подключить, на основе description
Glob	Применяется при работе с файлами, соответствующими маске
Manual	Только при явном @-mention в чате

Примеры правил

Общее правило (Always)

---
description: Общие стандарты проекта
alwaysApply: true
---

- TypeScript strict mode, никакого `any`
- Server Components по умолчанию
- `'use client'` только при необходимости hooks/events

Правило для API (Glob)

---
description: Конвенции API маршрутов
globs: ["src/app/api/**/*.ts"]
---

- Всегда валидировать input через zod
- Формат ответа: { data, error, meta }
- Обработка ошибок через try/catch

Правило для компонентов (Auto)

---
description: Паттерны React компонентов
alwaysApply: false
---

- Использовать shadcn/ui компоненты
- Tailwind CSS для стилей
- Композиция вместо наследования

Рекомендации по токенам

• Правила с alwaysApply: true тратят токены в каждом чате
• Переводите правила на glob или auto где возможно
• Обзорные правила — до 50 строк
• Ссылайтесь на файлы-примеры вместо дублирования кода в правилах