Vai al contenuto principale

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

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

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

ToolDescrizione
Application InfoLegge versione PHP/Laravel, engine DB, pacchetti versionati, modelli Eloquent
Browser LogsLegge log ed errori dal browser
Database ConnectionsElenca le connessioni disponibili
Database QueryEsegue query
Database SchemaLegge lo schema
Get Absolute URLConverte path relativo in URL assoluto
Last ErrorLegge l’ultimo errore dai log
Read Log EntriesLegge le ultime N righe di log
Search DocsInterroga l’API della documentazione ospitata Laravel

Registrazione manuale dell’MCP server

VoceValore
Commandphp
Argsartisan 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

PacchettoVersioni
Core & Boostcore
Laravel Frameworkcore, 10.x, 11.x, 12.x
Livewirecore, 2.x, 3.x, 4.x
Flux UIcore, free, pro
Foliocore
Herdcore
Inertia Laravelcore, 1.x, 2.x, 3.x
Inertia Reactcore, 1.x, 2.x, 3.x
Inertia Vuecore, 1.x, 2.x, 3.x
Inertia Sveltecore, 1.x, 2.x, 3.x
MCPcore
Pennantcore
Pestcore, 3.x, 4.x
PHPUnitcore
Pintcore
Sailcore
Tailwind CSScore, 3.x, 4.x
Livewire Voltcore
Wayfindercore
Enforce Testsconditional

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

SkillPacchetto
fluxui-developmentFlux UI
folio-routingFolio
inertia-react-developmentInertia React
inertia-svelte-developmentInertia Svelte
inertia-vue-developmentInertia Vue
livewire-developmentLivewire
mcp-developmentMCP
pennant-developmentPennant
pest-testingPest
tailwindcss-developmentTailwind CSS
volt-developmentVolt
wayfinder-developmentWayfinder

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.).
AspettoGuidelineSkill
CaricamentoPre-caricate, sempre presentiOn-demand
AmbitoAmpio, fondativoFocalizzato per task
ScopoConvenzioni e best practicePattern 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.
PacchettoVersioni
Laravel Framework10.x, 11.x, 12.x
Filament2.x, 3.x, 4.x, 5.x
Flux UI2.x Free, 2.x Pro
Inertia1.x, 2.x
Livewire1.x, 2.x, 3.x, 4.x
Nova4.x, 5.x
Pest3.x, 4.x
Tailwind CSS3.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.
Ultima modifica il 13 luglio 2026