Что такое rules-файл?

Что такое rules-файл

Rules-файл — это текстовый файл в корне проекта с инструкциями для ИИ-редактора. Модель читает его при каждом запросе и учитывает при генерации кода.

В Cursor такой файл называется .cursorrules, в Windsurf — .windsurfrules.

Пример содержимого:

- Проект на Python 3.11, фреймворк FastAPI
- Стиль кода: PEP8, строки не длиннее 88 символов
- Для работы с БД используем SQLAlchemy async
- Тесты писать на pytest, покрытие не ниже 80%
- Комментарии и переменные — на английском
- Не использовать print(), только logging

Зачем нужен: без rules-файла модель не знает контекст проекта и каждый раз генерирует код в своём стиле. Rules-файл фиксирует соглашения раз и навсегда.

Что обычно описывают:

• стек и версии зависимостей
• соглашения по стилю кода
• архитектурные решения
• что нельзя использовать

Если коротко: rules-файл — это системный промпт для вашего проекта. Один раз написали — модель всегда в контексте.