Файл .cursorrules (Правила проекта для ИИ)

1. Обзор концепции и системная проблема

Когда вы работаете над проектом вместе с искусственным интеллектом, вы быстро заметите его неприятные привычки:

• Он вдруг решает установить устаревшую версию библиотеки, которую перестали поддерживать три года назад.
• Он пишет код на JavaScript вместо строгого TypeScript.
• Он придумывает собственную структуру папок, ломая архитектуру вашего сайта.

Файл .cursorrules — это закон вашего проекта. Это краткий свод правил в формате простого текста или Markdown, который вы один раз кладете в корень проекта. Каждый раз, когда ИИ пытается написать или изменить хоть одну строку кода, он обязан сверяться с этим файлом.

Ключевой инженерный принцип: самый простой способ поддерживать код в чистоте и порядке без ежедневных скучных наставлений модели.

2. Архитектурная таксономия и ментальная модель

Вот готовый шаблон, который можно скопировать в свой проект прямо сейчас:

# Стек технологий и стандарты проекта
- Язык: TypeScript (строгий режим strict: true)
- Фреймворк: Next.js (App Router)
- Стили: Tailwind CSS (никаких инлайн-стилей или обычного CSS)
- База данных: Drizzle ORM + PostgreSQL / SQLite

# Правила для агента:
1. Всегда пиши полные реализации файлов. Никогда не оставляй ленивых комментариев типа "// ... здесь остальной код".
2. Все пользовательские тексты и кнопки должны быть на украинском языке.
3. Перед созданием нового npm-пакета проверь, нет ли уже установленного аналога в package.json.
4. Если видишь ошибку в архитектуре — сначала объясни риск, а потом предлагай изменения.

3. Четыре вещи, которые обязательно нужно запретить

1. Запрет ленивых комментариев: Худшее, когда модель стирает середину вашего рабочего кода и пишет // ... keep existing code. Запишите прямой запрет это делать.
2. Фиксация версий библиотек: Укажите, например: «Используй только Lucide-React для иконок», чтобы модель не импортировала одновременно FontAwesome и HeroIcons.
3. Правила нейминга компонентов: Укажите: «Названия компонентов пишутся в PascalCase, названия утилит — в camelCase».
4. Требования к типам: Запретите использовать тип any в TypeScript.

4. Практические инженерные сценарии в продакшене

01. Автоматизация соблюдения стандартов

С помощью .cursorrules модель с первой же секунды чувствует себя как опытный разработчик вашей команды, который досконально знает корпоративные стандарты. Вы получаете код, который компилируется с первого раза без синтаксических конфликтов!

02. Устранение ошибок на этапе разработки

Файл .cursorrules позволяет избежать распространенных ошибок, связанных с несоответствием стандартам, что значительно сокращает время на отладку и исправление кода.

03. Обеспечение качества кода

Использование .cursorrules гарантирует, что все разработчики следуют одним и тем же правилам, что улучшает качество кода и упрощает его поддержку.

5. Подводные камни, типовые ошибки и безопасность

При использовании .cursorrules важно следить за тем, чтобы файл всегда был актуальным и содержал все необходимые правила. Не забывайте обновлять его при изменении стандартов проекта, чтобы избежать несоответствий и ошибок в коде.