Cursor Rules для рефакторинга: refactor.mdc без поломок
Готовый refactor.mdc: инварианты до правки, маленькие шаги с коммитами и тесты как доказательство
Какую задачу решает
Менять код с агентом без потери поведения
Что будет на выходе
Правила Cursor для безопасного рефакторинга
- Кому подойдёт
Вайбкодер в Cursor, которому нужны правила агента для темы «рефакторинг»
- Тема
- Агенты и Claude Code
- Инструменты
- Cursor
Просишь Cursor «навести порядок» в файле на 800 строк, и он охотно переписывает всё сразу: переименовывает функции, меняет структуру, заодно «исправляет» пару условий, которые показались ему лишними. Через день выясняется, что скидка для постоянных клиентов больше не считается, а в огромном изменении уже не найти, где её потеряли.
Рефакторинг — это смена устройства кода без смены поведения. Файл refactor.mdc в .cursor/rules/ заставляет агента работать так: сначала записать, что должно остаться как было, потом менять маленькими шагами и после каждого шага доказывать тестами, что ничего не сломалось.
Промпт собирает правило Cursor для рефакторинга: перед правкой агент выписывает инварианты и закрывает их тестами, меняет код шагами по одному коммиту и не смешивает рефакторинг с новыми функциями и исправлениями.
Что получишь
- 📌Инварианты до правки
Список того, что код обязан делать и после изменений: какие входы дают какие выходы, какие побочные эффекты остаются.
- 🪜Маленькие шаги
Одно действие за коммит: переименование, вынос функции, удаление дубля. Любой шаг можно откатить отдельно.
- 🧪Тесты как доказательство
Если на код нет тестов, сначала тесты на текущее поведение, потом правка. Шаг готов, только когда они проходят.
- 🚧Без «заодно»
Найденные баги и идеи агент записывает отдельным списком и не трогает до конца рефакторинга.
Как использовать
- 1Выбери кусок кода
Начни с одного модуля или файла, который мешает работать: длинный, запутанный, его боятся трогать. Не весь проект сразу.
- 2Запусти промпт в Cursor
Агент посмотрит, какие тесты есть в проекте и как они запускаются, и соберёт правило под твой стек.
- 3Сохрани файл
Попроси: «Сохрани это как .cursor/rules/refactor.mdc». Блок между строками --- в начале — настройки правила, сохраняй его тоже.
- 4Начинай задачу словом «рефакторинг»
«Рефакторинг файла X: вынеси расчёт скидки в отдельную функцию». Агент выбирает правило по его описанию, а там есть это слово. Можно и прямо сослаться на файл через @refactor.mdc.
Попроси агента сделать коммит текущего состояния или скопируй папку проекта. Если что-то пойдёт не так, ты вернёшься сюда одной командой.
Рядом по теме: Cursor Rules для тестов: готовый tests.mdc, Cursor Rules для Laravel: готовый laravel.mdc, Cursor Rules для безопасности: готовый security.mdc, статья «Cursor или Claude Code» и 12 модов Claude Code для вайбкодера (490 ₽).
Дальше — для участников
Регистрация бесплатная и занимает минуту. Часть закрытых материалов откроется сразу, без карты.
Что дальше
Готовый скилл с тем же подходом для Claude Code описан в материале Скилл Claude Code для безопасного рефакторинга. Как проверять результат работы агента без знания кода, разобрано в Как тестировать код, который написал агент, а если правка всё-таки что-то сломала, пригодится исправить ошибку и доказать, что она решена.
