03 / 06 · Продвинутый

🚀 Laravel Boost — продвинутые лайфхаки

Как выжать максимум из laravel-boost MCP, его Skills и Documentation API при работе с CC: инспекция приложения вместо ручных описаний, контекст под задачу, точная документация под версию.

💡

Базовая настройка Laravel + Claude Code — на странице Laravel. Здесь — продвинутые приёмы поверх.

🚀 Главный принцип

Дай Boost инспектировать приложение через MCP — не описывай схему БД, роуты и модели вручную в промпте. Claude сам запросит нужные данные структурированным вызовом, а не будет читать десятки PHP-файлов или гадать по твоему пересказу. Это точнее, дешевле по токенам и не устаревает вместе с кодом.

15+ инструментов laravel-boost

Boost — MCP-сервер, который запускается внутри приложения и отдаёт Claude его реальное состояние: схему, роуты, данные, логи, окружение.

Инструмент	Что даёт	Когда полезен
Database schema	Реальную структуру таблиц: колонки, типы, индексы, связи	Перед миграцией или новой моделью — без ручного описания схемы в промпте
List routes	Все роуты приложения: метод, URI, контроллер, middleware	Проверить конфликт роутов, найти нужный контроллер, спроектировать новый эндпоинт
Query data	Выполняет чтение реальных данных из БД	Проверить гипотезу о данных, найти edge case, воспроизвести баг на реальной записи
Check logs	Читает `laravel.log` и последние исключения	Отладка ошибки — без копирования трейсов вручную в чат
Run Artisan	Запускает Artisan-команды в контексте приложения	`route:list`, `model:show`, безопасные проверки конфигурации
Search docs	Семантический поиск по Documentation API (см. ниже)	Точный синтаксис под установленную версию Laravel
Execute code	Выполняет PHP-код в среде приложения (tinker-подобно)	Быстрая проверка поведения метода или связи без отдельного скрипта
Inspect application	Общая структура: сервис-провайдеры, конфиг, события, зарегистрированные биндинги	Первое знакомство агента с незнакомым проектом

AI Guidelines vs Skills

Boost разделяет контекст на два уровня — это ключ к тому, почему он не раздувает промпт.

	AI Guidelines	Skills
Когда грузятся	Upfront — сразу в начале сессии	On-demand — только когда задача их касается
Что содержат	Core conventions, best practices, паттерны экосистемы Laravel	Детальные паттерны конкретного домена (например, pest-testing, livewire)
Зачем	Консистентный качественный код с первого запроса	Меньше context bloat — контекст не засорён тем, что не относится к задаче
Пример триггера	Загружаются всегда при работе с проектом	«Напиши Pest-тест для billing-контроллера» → активирует skill pest-testing

Documentation API

Boost даёт доступ к 17 000+ единицам Laravel-документации через семантический поиск по эмбеддингам — это не просто текстовый grep, а поиск по смыслу запроса. Главное отличие от обычного знания модели: API version-aware — отвечает точно под установленную у тебя версию Laravel (12.x или 13.x), а не по усреднённому знанию из тренировочных данных.

✅

Практический эффект: Claude не подставит синтаксис Laravel 9 в проект на Laravel 12 — Documentation API проверяет актуальность API под твою версию перед тем, как предложить решение.

Как это выглядит на практике

Разница в подходе — не абстрактная. Сравни два способа поставить Claude задачу на новую фичу.

❌ Без Boost

Ты вручную пересказываешь структуру таблицы payments: колонки, типы, индексы
Копируешь список роутов из routes/api.php в промпт
Claude читает десятки файлов, чтобы восстановить связи Eloquent — расходует контекст
Если схема изменилась вчера, а пересказ устарел — Claude работает по неверным данным

✅ С Boost

Claude сам запрашивает Database schema — получает актуальную структуру одним вызовом
List routes отдаёт реальный список эндпоинтов, а не то, что ты вспомнил
Query data позволяет проверить гипотезу на живых данных, а не гадать
Данные всегда синхронны с текущим состоянием приложения — не могут устареть

✅

Итог: чем меньше в промпте ручных пересказов структуры проекта — тем меньше шанс, что Claude работает по устаревшим или неточным данным. MCP-инструменты Boost всегда возвращают текущее состояние.

Чек-лист: настрой Laravel Boost

☐ Выполнил php artisan boost:install — генерирует guideline- и skill-файлы под выбранных агентов
☐ Проверил, что .mcp.json содержит секцию laravel-boost
☐ Убедился, что guideline-файлы появились в проекте после установки
☐ Если Claude Code не подключил MCP автоматически — добавил вручную командой ниже
☐ Проверил, что boost:mcp отвечает (Claude видит роуты/модели при первом запросе)

php artisan boost:install

claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp

Чек-лист: продуктивная сессия Laravel + Claude Code

☐ CLAUDE.md содержит версии стека и точные команды (тесты, pint, миграции)
☐ Дал Boost инспектировать приложение вместо описания схемы/роутов в промпте
☐ Pest используется как feedback loop — тест до реализации, прогон после каждого шага
☐ Модель выбрана под сложность задачи, а не одна на всё
☐ Диф тестов прошёл ревью перед коммитом — агент не мог их ослабить незаметно

Выбор модели под Laravel-задачу

Модель	Тип задачи
Sonnet 5	Новые фичи, CRUD, обычные тесты — дефолт для 90% работы
Opus 4.8	Сложная бизнес-логика, архитектура миграций, security-критичные модули
Haiku 4.5	Рутина: factory, resource, boilerplate-классы
Fable 5	Крупный рефакторинг легаси-модуля, десятки взаимосвязанных файлов

Делай / Не делай

✅ Делай

Давай Boost инспектировать схему и роуты через MCP-вызовы
Полагайся на Documentation API вместо памяти модели по старым версиям
Позволяй Skills подключаться on-demand под конкретную задачу
Читай логи через check logs, а не копируй трейсы руками
Фиксируй в CLAUDE.md команды pint/test и запреты на миграции без спроса
Ревьюй диф тестов перед каждым коммитом

❌ Не делай

Не описывай схему БД и список роутов вручную в промпте
Не гоняй рутинные resource/factory на самой дорогой модели
Не позволяй агенту ослаблять Pest-тест «чтобы прошёл» без ревью
Не подставляй сам устаревший синтаксис — доверь это version-aware Documentation API
Не держи все guideline и skill файлы загруженными разом «на всякий случай»
Не пропускай проверку, что boost:mcp реально отвечает после установки

💡

Лайфхак: version-aware Documentation API избавляет от типичной беды — модель предлагает синтаксис Laravel 9 в проекте на 12-й версии. Boost проверяет актуальность API под твою реальную версию перед ответом.

💡

Лайфхак: Skills грузятся on-demand — не старайся заранее «подгрузить всё». Опиши задачу конкретно («напиши Pest-тест для billing») — нужный skill подключится сам, контекст останется чище.

💡

Лайфхак: при отладке проси Claude читать laravel.log через check logs вместо того, чтобы копировать трейс ошибки в чат вручную — быстрее и без потери контекста трейса.

💡

Лайфхак: комбо Boost (инспекция приложения) + Telescope/Horizon (рантайм-данные) + Pest (верификация изменений) даёт замкнутый цикл: агент видит структуру, видит поведение в рантайме и сразу проверяет правки тестами.

💡

Лайфхак: держи в CLAUDE.md точные команды — php artisan test, профиль Pint, запрет трогать миграции без явного разрешения. Конкретная команда работает надёжнее общей фразы «пиши тесты».

⚠️

Ловушка: агент может незаметно удалить или ослабить Pest-тест, чтобы прогон стал зелёным «любой ценой» — вместо того чтобы честно исправить код. Закрепи правило в CLAUDE.md («тесты не трогать без явного запроса») и всегда смотри диф тестов отдельно от диффа кода перед коммитом. Тот же принцип разбирается на странице Kent Beck.

Комбинация с остальным стеком

Boost закрывает слой «инспекция приложения», но продуктивная сессия обычно опирается ещё на два источника — они не конкурируют, а дополняют друг друга.

Источник	Слой	Роль в цикле
laravel-boost	Структура приложения	Схема, роуты, модели, конфиг, безопасный Artisan — «что есть»
Telescope / Horizon	Рантайм	Реальные запросы, очереди, исключения — «что происходит сейчас»
Pest	Верификация	Подтверждает, что изменение не сломало поведение — «что доказано»

Все три доступны Claude через MCP и Artisan без переключения окон — агент проходит цикл «посмотрел структуру → внёс правку → проверил тестом → при ошибке заглянул в логи рантайма» внутри одной сессии.

Частые вопросы

Boost работает только с MySQL/PostgreSQL или с любой БД?
Инструмент Database schema инспектирует ту БД, что подключена в проекте — конкретный драйвер не принципиален, Boost читает структуру через стандартные средства Laravel.

Нужно ли держать Boost и context7 одновременно?
Это разные источники: Documentation API у Boost — про сам Laravel и его версию, context7 — про сторонние библиотеки экосистемы (Filament, Livewire и т.п.). Обычно оба полезны вместе.

Skills можно отключить, если они мешают?
Да, они активируются только под релевантные задачи — если задача явно не про тестирование или Livewire, соответствующий skill просто не подключится, никакого ручного отключения не требуется.