Introduzione
Laravel Boost accelera lo sviluppo con AI fornendo guideline e Agent Skill agli agenti perché generino codice Laravel di alta qualità e in linea con le best practice.
Boost espone anche una potente API sulla documentazione dell’ecosistema Laravel: knowledge base di oltre 17.000 elementi Laravel-specifici con ricerca semantica basata su embedding. Boost istruisce gli agenti (Claude Code, Cursor, ecc.) a usare quest’API per apprendere le funzionalità e le best practice più recenti.
Installazione
composer require laravel/boost --dev
Poi installa server MCP e coding guideline.
php artisan boost:install
boost:install genera guideline e skill per l’agente scelto.
Dopo l’installazione puoi iniziare a lavorare con Cursor, Claude Code o altri.
I file generati (.mcp.json, CLAUDE.md, AGENTS.md, junie/, boost.json) possono essere aggiunti al .gitignore dell’app: boost:install / boost:update li rigenerano.
Configurazione degli agenti
Cursor
Claude Code
Codex
Gemini CLI
GitHub Copilot (VS Code)
Junie
- Apri la command palette (
Cmd+Shift+P / Ctrl+Shift+P)
- “/open MCP Settings” e Invio
- Attiva il toggle di
laravel-boost
Di solito automatico. Se no:claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp
Di solito automatico. Se no:codex mcp add laravel-boost -- php "artisan" "boost:mcp"
Di solito automatico. Se no:gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp
- Command palette (
Cmd+Shift+P / Ctrl+Shift+P)
- “MCP: List Servers” e Invio
- Seleziona
laravel-boost e Invio
- “Start server”
- Premi
Shift due volte
- Cerca “MCP Settings” e Invio
- Seleziona
laravel-boost
- In basso a destra “Apply”
Aggiornare le risorse di Boost
Aggiorna periodicamente guideline e skill locali con boost:update.
Automatizzalo nello script post-update-cmd di Composer:
{
"scripts": {
"post-update-cmd": [
"@php artisan boost:update --ansi"
]
}
}
Di default aggiorna solo le risorse già pubblicate. Per pubblicare quelle di pacchetti appena installati:
php artisan boost:update --discover
Server MCP
Espone tool con cui l’agente esamina l’app Laravel, esegue query DB o codice, ecc.
| Tool | Descrizione |
|---|
| Application Info | Legge versione PHP/Laravel, engine DB, pacchetti versionati, modelli Eloquent |
| Browser Logs | Legge log ed errori dal browser |
| Database Connections | Elenca le connessioni disponibili |
| Database Query | Esegue query |
| Database Schema | Legge lo schema |
| Get Absolute URL | Converte path relativo in URL assoluto |
| Last Error | Legge l’ultimo errore dai log |
| Read Log Entries | Legge le ultime N righe di log |
| Search Docs | Interroga l’API della documentazione ospitata Laravel |
Registrazione manuale dell’MCP server
| Voce | Valore |
|---|
| Command | php |
| Args | artisan boost:mcp |
JSON:
{
"mcpServers": {
"laravel-boost": {
"command": "php",
"args": ["artisan", "boost:mcp"]
}
}
}
AI guideline
Sono file di istruzioni caricati in anticipo che forniscono contesto sull’ecosistema Laravel: convenzioni, best practice, pattern del framework.
Guideline disponibili
| Pacchetto | Versioni |
|---|
| Core & Boost | core |
| Laravel Framework | core, 10.x, 11.x, 12.x |
| Livewire | core, 2.x, 3.x, 4.x |
| Flux UI | core, free, pro |
| Folio | core |
| Herd | core |
| Inertia Laravel | core, 1.x, 2.x, 3.x |
| Inertia React | core, 1.x, 2.x, 3.x |
| Inertia Vue | core, 1.x, 2.x, 3.x |
| Inertia Svelte | core, 1.x, 2.x, 3.x |
| MCP | core |
| Pennant | core |
| Pest | core, 3.x, 4.x |
| PHPUnit | core |
| Pint | core |
| Sail | core |
| Tailwind CSS | core, 3.x, 4.x |
| Livewire Volt | core |
| Wayfinder | core |
| Enforce Tests | conditional |
Guideline personalizzate
Aggiungi file .blade.php o .md in .ai/guidelines/*. Vengono unite alle guideline di Boost quando esegui boost:install.
Sovrascrittura
Crea guideline personalizzata con lo stesso path per sovrascrivere quelle di Boost.
Esempio: .ai/guidelines/inertia-react/2/forms.blade.php per sovrascrivere “Inertia React v2 Form Guidance”.
Guideline in pacchetti di terze parti
Aggiungi resources/boost/guidelines/core.blade.php al pacchetto. Con php artisan boost:install, Boost la carica automaticamente.
## Package Name
This package provides [brief description of functionality].
### Features
- Feature 1: [clear & short description].
- Feature 2: [clear & short description]. Example usage:
@verbatim
<code-snippet name="How to use Feature 2" lang="php">
$result = PackageName::featureTwo($param1, $param2);
</code-snippet>
@endverbatim
Agent Skills
Gli Agent Skills sono moduli di conoscenza on-demand attivati quando l’agente lavora in un dominio specifico. A differenza delle guideline pre-caricate, evitano di gonfiare il contesto.
Con boost:install seleziona le skill: vengono installate automaticamente in base ai pacchetti in composer.json.
Skill disponibili
| Skill | Pacchetto |
|---|
| fluxui-development | Flux UI |
| folio-routing | Folio |
| inertia-react-development | Inertia React |
| inertia-svelte-development | Inertia Svelte |
| inertia-vue-development | Inertia Vue |
| livewire-development | Livewire |
| mcp-development | MCP |
| pennant-development | Pennant |
| pest-testing | Pest |
| tailwindcss-development | Tailwind CSS |
| volt-development | Volt |
| wayfinder-development | Wayfinder |
Skill personalizzate
Crea SKILL.md in .ai/skills/{skill-name}/. boost:update la installerà con le altre.
Esempio:
.ai/skills/creating-invoices/SKILL.md
Sovrascrittura
Con nome corrispondente. Esempio: .ai/skills/livewire-development/SKILL.md per sovrascrivere livewire-development.
Skill in pacchetti di terze parti
Aggiungi resources/boost/skills/{skill-name}/SKILL.md. Boost la installa quando l’utente esegue php artisan boost:install.
Boost supporta il formato Agent Skills con YAML front matter e istruzioni Markdown. Richiesti name e description.
---
name: package-name-development
description: Build and work with PackageName features, including components and workflows.
---
# Package Name Development
## When to use this skill
Use this skill when working with PackageName features...
## Features
- Feature 1: [clear & short description].
- Feature 2: [clear & short description]. Example usage:
$result = PackageName::featureTwo($param1, $param2);
Guideline vs Skill
Laravel Boost dà due strumenti agli agenti:
Guideline — pre-caricate, per convenzioni Laravel di base valide sull’intera codebase.
Skill — on-demand, per pattern dettagliati di specifici domini (Livewire, Pest, ecc.).
| Aspetto | Guideline | Skill |
|---|
| Caricamento | Pre-caricate, sempre presenti | On-demand |
| Ambito | Ampio, fondativo | Focalizzato per task |
| Scopo | Convenzioni e best practice | Pattern implementativi dettagliati |
API della documentazione
Boost include un’API con oltre 17.000 elementi Laravel-specifici. Usa ricerca semantica per risultati precisi e contestuali.
Il tool MCP Search Docs permette all’agente di interrogare l’API in base ai pacchetti installati. Le guideline e le skill di Boost istruiscono automaticamente l’agente a usarla.
| Pacchetto | Versioni |
|---|
| Laravel Framework | 10.x, 11.x, 12.x |
| Filament | 2.x, 3.x, 4.x, 5.x |
| Flux UI | 2.x Free, 2.x Pro |
| Inertia | 1.x, 2.x |
| Livewire | 1.x, 2.x, 3.x, 4.x |
| Nova | 4.x, 5.x |
| Pest | 3.x, 4.x |
| Tailwind CSS | 3.x, 4.x |
Estendere Boost
Se il tuo strumento non è ancora supportato, crea un agente personalizzato.
Aggiungere il supporto per un IDE/agente
Estendi Laravel\Boost\Install\Agents\Agent e implementa i contract necessari:
Laravel\Boost\Contracts\SupportsGuidelines
Laravel\Boost\Contracts\SupportsMcp
Laravel\Boost\Contracts\SupportsSkills
Implementazione
<?php
declare(strict_types=1);
namespace App;
use Laravel\Boost\Contracts\SupportsGuidelines;
use Laravel\Boost\Contracts\SupportsMcp;
use Laravel\Boost\Contracts\SupportsSkills;
use Laravel\Boost\Install\Agents\Agent;
class CustomAgent extends Agent implements SupportsGuidelines, SupportsMcp, SupportsSkills
{
// La tua implementazione...
}
Come riferimento vedi ClaudeCode.php.
Registrazione
use Laravel\Boost\Boost;
public function boot(): void
{
Boost::registerAgent('customagent', CustomAgent::class);
}
L’agente comparirà nelle scelte durante php artisan boost:install.