Skip to main content

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

Poi installa server MCP e coding guideline.
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.
Automatizzalo nello script post-update-cmd di Composer:
Di default aggiorna solo le risorse già pubblicate. Per pubblicare quelle di pacchetti appena installati:

Server MCP

Espone tool con cui l’agente esamina l’app Laravel, esegue query DB o codice, ecc.

Tool disponibili

Registrazione manuale dell’MCP server

JSON:

AI guideline

Sono file di istruzioni caricati in anticipo che forniscono contesto sull’ecosistema Laravel: convenzioni, best practice, pattern del framework.

Guideline disponibili

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.

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. Le skill incluse in Boost, come infer-conventions, vengono installate indipendentemente dai pacchetti presenti.

Skill disponibili

Skill personalizzate

Crea SKILL.md in .ai/skills/{skill-name}/. boost:update la installerà con le altre. Esempio:

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.

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.). Guideline e skill forniscono conoscenza sull’ecosistema Laravel. Per comunicare agli agenti AI convenzioni specifiche dell’applicazione, usa le regole di progetto.

Regole di progetto

Se guideline e skill insegnano come scrivere codice Laravel, le regole di progetto insegnano come scrivere il codice della tua applicazione. Le regole coprono aspetti che altrimenti dovresti rispiegare in ogni nuova sessione, come:
  • Decisioni di design prese da te, dagli agenti o dai membri del team
  • Style guide e preferenze difficili da imporre agli agenti
  • Vincoli e insidie che non si possono dedurre dal codice circostante
Le regole vengono salvate come file Markdown nella directory .ai/rules dell’applicazione e vengono committate nel version control. A differenza della memoria dell’agente, che è per utente e per sessione, le regole sono condivise nel team e da ogni agente che lavora sull’applicazione. Il front matter di ogni file di regola definisce i glob dei file a cui la regola si applica.
Boost mantiene anche un file .ai/rules/index.md che registra la mappatura tra glob e file di regole. Gli agenti sono istruiti a consultare questo indice prima di pianificare o modificare file, così vengono caricate solo le regole rilevanti.
A differenza di .mcp.json o dei file di guideline generati, la directory .ai/rules viene committata nel version control per condividere le regole nel team.

Registrare le regole

Puoi registrare una regola semplicemente chiedendo all’agente di ricordarla.
L’agente chiama il tool MCP record-rule di Boost con glob, un breve title e una note. Boost registra la regola nell’area appropriata e, se necessario, crea un file di regola e aggiorna l’indice. Non creare i file di regola a mano; registrali sempre tramite il tool record-rule. Quando una regola viene registrata, Boost rigenera .ai/rules/index.md. Gli agenti individuano le regole applicabili attraverso questo indice, quindi un file di regola aggiunto manualmente non viene scoperto finché l’indice non viene rigenerato.

Dedurre le convenzioni dell’applicazione

Le applicazioni esistenti hanno convenzioni accumulate negli anni. La skill infer-conventions crea regole a partire dal codice già scritto. Inizia chiedendo all’agente:
La skill investiga le convenzioni usando una checklist che copre validazione, controller, autorizzazione, modelli, architettura, testing, frontend, database e console, quindi analizza liberamente pattern come classi base, trait condivisi e struttura dei moduli. La skill registra ciò che il codice fa effettivamente, non ciò che dovrebbe fare in teoria. Registra solo convenzioni distintive con evidenze sufficienti ed esclude i default del framework e qualsiasi cosa già imposta da Pint e Rector. Quando i pattern sono misti, lo segnala anziché forzare una regola. Prima di scrivere qualsiasi regola, presenta le convenzioni scoperte e le relative evidenze per la tua approvazione. Per registrare tutte le convenzioni senza conferma, di’ “yolo”.

Disattivare le regole di progetto

Le regole di progetto sono attive di default. Per disattivarle completamente, definisci questa variabile d’ambiente. Il tool MCP record-rule viene rimosso e Boost smette di gestire la directory .ai/rules.

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.

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

Come riferimento vedi ClaudeCode.php.

Registrazione

L’agente comparirà nelle scelte durante php artisan boost:install.
Ultima modifica il 21 agosto 2026