Cursor Rules для Laravel: готовый laravel.mdc
FormRequest, Policy, транзакции, миграции и тесты — правила, которые агент не обходит
Какую задачу решает
Заставить агента соблюдать конвенции Laravel
Что будет на выходе
Правила Cursor для Laravel
- Кому подойдёт
Вайбкодер в Cursor, которому нужны правила агента для темы «Laravel»
- Тема
- Агенты и Claude Code
- Инструменты
- Cursor
В Laravel агент быстро получает работающий результат и так же быстро обходит всё, ради чего фреймворк придуман: валидирует данные прямо в контроллере, сохраняет модель через $request->all(), забывает проверить, что заказ принадлежит текущему пользователю, и запускает три запроса к базе в цикле. Работает на демо, ломается на первых живых данных.
Файл laravel.mdc записывает, как в твоём проекте принято: где валидация, где проверка прав, когда нужна транзакция, как писать миграции и какие тесты обязательны. Агент читает его, когда трогает PHP-файлы проекта.
Даёшь ИИ composer.json, список моделей и один типичный контроллер. Получаешь laravel.mdc с правилами про FormRequest, Policy, транзакции, миграции и тесты. Агент перестаёт писать «быстро, но мимо конвенций».
Что внутри правила
- Валидация — только в FormRequest, в контроллер приходят
$request->validated(). - Права — Policy на каждую модель, которую пользователь может читать или менять, и
authorizeв каждом действии. - Транзакции — когда несколько записей должны сохраниться вместе или не сохраниться вовсе.
- Запросы — жадная загрузка связей через
with(), никаких запросов в цикле и в Blade-шаблонах. - Миграции — новые изменения только новой миграцией, старые не редактируются.
- Тесты — на каждую новую ручку: успешный сценарий, чужой пользователь, невалидные данные.
Как использовать
- 1Собери факты
composer.json (версии PHP и Laravel, Livewire или Inertia, Pest или PHPUnit), список моделей из app/Models и один типичный контроллер целиком.
- 2Запусти промпт
Лучше в Cursor внутри проекта: агент сам откроет файлы. В обычном чате вставь их в квадратные скобки.
- 3Сохрани laravel.mdc
Положи ответ целиком в .cursor/rules/laravel.mdc, шапку между --- не удаляй.
- 4Проверь на новой ручке
Попроси агента добавить редактирование одной сущности, например заметки клиента. Смотри: есть FormRequest, Policy, тест на чужого пользователя.
Если миграция уже применена на сервере, её правка ничего не изменит в рабочей базе, а у коллеги с чистой базой схема разъедется с твоей. Поэтому в правиле это прямой запрет.
Рядом по теме: Cursor Rules для базы данных: database.mdc без потерь, Cursor Rules для архитектуры: готовый architecture.mdc, статья «Cursor или Claude Code» и 12 модов Claude Code для вайбкодера (490 ₽).
Дальше — для участников
Регистрация бесплатная и занимает минуту. Часть закрытых материалов откроется сразу, без карты.
Что дальше
Laravel-правило хорошо работает в паре с правилами безопасности и правилами для тестов. Если работаешь в Claude Code, возьми готовый CLAUDE.md для Laravel и Livewire. Пример целого проекта на этом стеке — мини-CRM для заявок на Laravel и Livewire, а матрицу ролей до релиза проверь по гайду «Матрица ролей и прав для SaaS».
