Laravel Boost

Laravel Boost accelera lo sviluppo assistito da AI. Fornisce a Cursor, Claude Code e altri agenti server MCP, AI guideline e Agent Skills per capire in profondità la tua app Laravel.

​

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

1. Apri la command palette (Cmd+Shift+P / Ctrl+Shift+P)
2. “/open MCP Settings” e Invio
3. Attiva il toggle di laravel-boost

Claude Code

Di solito automatico. Se no:

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

Codex

Di solito automatico. Se no:

codex mcp add laravel-boost -- php "artisan" "boost:mcp"

Gemini CLI

Di solito automatico. Se no:

gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp

GitHub Copilot (VS Code)

1. Command palette (Cmd+Shift+P / Ctrl+Shift+P)
2. “MCP: List Servers” e Invio
3. Seleziona laravel-boost e Invio
4. “Start server”

Junie

1. Premi Shift due volte
2. Cerca “MCP Settings” e Invio
3. Seleziona laravel-boost
4. In basso a destra “Apply”

​

Aggiornare le risorse di Boost

Aggiorna periodicamente guideline e skill locali con boost:update.

php artisan 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 disponibili

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

Aggiorna con Aggiornare le risorse di Boost.

​

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

Aggiornale con Aggiornare le risorse di Boost.

​

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.