AI Guidelines: как писать идиоматичный Laravel
AI Guidelines — это набор правил, которые Boost загружает в AI-ассистент сразу при старте.
Зачем нужны Guidelines
AI-ассистент без Guidelines может написать рабочий код, но не идиоматичный. Например:
- Использовать
DB::table()вместо Eloquent - Писать вручную валидацию вместо Form Request
- Не использовать Resource для API
Guidelines учат ассистента писать так, как пишут Laravel-разработчики.
Что внутри
Boost содержит Guidelines для:
- Laravel — конвенции фреймворка
- Livewire (2.x, 3.x, 4.x)
- Inertia.js (React, Svelte, Vue)
- Tailwind CSS (3.x, 4.x)
- Filament (3.x, 4.x)
- PHPUnit
- Pest PHP
- Laravel Pint
- и другие пакеты
Как работают
При boost:install Boost:
- Сканирует
composer.json - Определяет, какие пакеты установлены
- Собирает релевантные Guidelines
- Записывает их в
CLAUDE.mdилиAGENTS.md
Ассистент читает этот файл при старте и применяет правила.
Guidelines vs Skills
Guidelines — загружаются всегда. Широкий контекст, применяется ко всему проекту.
Skills — активируются по необходимости. Точечные знания для конкретной задачи (например, работа с Livewire).
Таблица различий:
| Guidelines | Skills | |
|---|---|---|
| Загрузка | Всегда | По необходимости |
| Охват | Широкий | Узкий |
| Контекст | Базовый | Детальный |
Пример Guideline
Для Livewire Guideline объясняет:
- Как создавать компоненты
- Как работать с состоянием
- Как использовать
wire:model - Как тестировать
Ассистент, прочитав это, будет писать правильный Livewire-код.
Обновление
php artisan boost:update
После composer update запускай boost:update, чтобы Guidelines соответствовали новым версиям пакетов .
Итоги
- Guidelines загружаются сразу
- Учат идиоматичному коду
- Автоматически подбираются по
composer.json - Обновляются через
boost:update - Дополняются Skills