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
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
Aggiornare le risorse di Boost
Aggiorna periodicamente guideline e skill locali conboost:update.
post-update-cmd di Composer:
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
Aggiungiresources/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. Conboost: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
CreaSKILL.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
Aggiungiresources/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
.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.
.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.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 skillinfer-conventions crea regole a partire dal codice già scritto. Inizia chiedendo all’agente:
Disattivare le regole di progetto
Le regole di progetto sono attive di default. Per disattivarle completamente, definisci questa variabile d’ambiente. Il tool MCPrecord-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 MCPSearch 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
EstendiLaravel\Boost\Install\Agents\Agent e implementa i contract necessari:
Laravel\Boost\Contracts\SupportsGuidelinesLaravel\Boost\Contracts\SupportsMcpLaravel\Boost\Contracts\SupportsSkills
Implementazione
Registrazione
php artisan boost:install.