Introductie
Laravel Boost is een package die AI-ondersteunde ontwikkeling versnelt door AI-agents de richtlijnen en Agent Skills te geven die ze nodig hebben om hoogwaardige Laravel-applicaties te schrijven volgens de best practices van Laravel. Boost biedt daarnaast een krachtige documentatie-API voor het Laravel-ecosysteem, die een kennisbank met meer dan 17.000 Laravel-specifieke items combineert met semantisch zoeken op basis van embeddings. Boost instrueert AI-agents zoals Claude Code en Cursor om deze API te gebruiken om de nieuwste Laravel-features en best practices te leren.Installatie
Je installeert Laravel Boost met Composer:boost:install-commando genereert de relevante richtlijnen- en skill-bestanden voor de coding-agents die je tijdens de installatie selecteert.
Zodra de installatie is voltooid, kun je beginnen met coderen met Cursor, Claude Code of jouw favoriete AI-agent.
Je mag het gegenereerde MCP-configuratiebestand (
.mcp.json), de richtlijnenbestanden (CLAUDE.md, AGENTS.md, junie/, enzovoort) en het boost.json-configuratiebestand toevoegen aan de .gitignore van je applicatie. Deze bestanden worden automatisch opnieuw gegenereerd wanneer je boost:install of boost:update uitvoert.Agents configureren
- Cursor
- Claude Code
- Codex
- Gemini CLI
- GitHub Copilot (VS Code)
- Junie
- Open het commandopalet (
Cmd+Shift+PofCtrl+Shift+P) - Selecteer “/open MCP Settings” en druk op
Enter - Zet de toggle voor
laravel-boostaan
Boost-resources bijwerken
We raden aan om je lokale Boost-resources (AI-richtlijnen en skills) regelmatig bij te werken, zodat ze de nieuwste versies van de geïnstalleerde Laravel-ecosysteem-packages weerspiegelen. Gebruik hiervoor hetboost:update Artisan-commando:
post-update-cmd-script van Composer:
boost:update-commando alleen de Boost-resources bij die al in je applicatie zijn gepubliceerd. Wil je dat nieuw geïnstalleerde packages worden gedetecteerd en dat je wordt gevraagd om hun richtlijnen en skills te publiceren, gebruik dan de --discover-optie:
MCP-server
Laravel Boost biedt een MCP-server (Model Context Protocol) die tools beschikbaar maakt waarmee AI-agents met je Laravel-applicatie kunnen communiceren. Met deze tools kunnen agents de structuur van je applicatie onderzoeken, de database bevragen en code uitvoeren.Beschikbare MCP-tools
MCP-server handmatig registreren
Afhankelijk van je editor moet je de Laravel Boost MCP-server mogelijk handmatig registreren. Registreer de MCP-server met de volgende gegevens:
Voorbeeld in JSON-formaat:
AI-richtlijnen
AI-richtlijnen zijn instructiebestanden die vooraf worden ingeladen om AI-agents belangrijke context te geven over packages uit het Laravel-ecosysteem. Deze richtlijnen bevatten kernconventies, best practices en framework-specifieke patronen, en helpen agents om consistente, hoogwaardige code te genereren.Beschikbare richtlijnen
Laravel Boost bevat AI-richtlijnen voor de volgende packages en frameworks. Decore-richtlijnen bieden algemeen advies dat van toepassing is ongeacht de versie.
Eigen richtlijnen toevoegen
Om je eigen AI-richtlijnen aan Laravel Boost toe te voegen, plaats je.blade.php- of .md-bestanden in de .ai/guidelines/*-map van je applicatie. Deze bestanden worden automatisch gecombineerd met de richtlijnen van Laravel Boost wanneer je boost:install uitvoert.
Richtlijnen van Boost overschrijven
Je kunt de ingebouwde richtlijnen van Boost overschrijven door een eigen richtlijn te maken met een overeenkomend bestandspad. Als je een eigen richtlijn aanmaakt op een pad dat overeenkomt met een bestaande Boost-richtlijn, gebruikt Boost jouw versie in plaats van de ingebouwde richtlijn. Om bijvoorbeeld de “Inertia React v2 Form Guidance”-richtlijn van Boost te overschrijven, maak je een bestand aan op.ai/guidelines/inertia-react/2/forms.blade.php. Wanneer je boost:install uitvoert, gebruikt Boost jouw richtlijn in plaats van de standaardrichtlijn.
Richtlijnen voor third-party packages
Onderhoud je een third-party package en wil je dat Boost AI-richtlijnen voor die package bevat, voeg dan eenresources/boost/guidelines/core.blade.php-bestand toe aan je package. Wanneer gebruikers van je package php artisan boost:install uitvoeren, laadt Boost die richtlijnen automatisch in.
Beschrijf in de AI-richtlijnen een overzicht van de package, de vereiste bestandsstructuur en conventies, en hoe je de belangrijkste features aanmaakt en gebruikt (inclusief voorbeeldcommando’s en codesnippets). Houd de inhoud beknopt en actiegericht, en focus op best practices, zodat de AI correcte code voor je gebruikers kan genereren.
Agent Skills
Agent Skills zijn lichtgewicht, gerichte kennismodules die agents on demand kunnen activeren wanneer ze in een specifiek domein werken. In tegenstelling tot richtlijnen, die vooraf worden ingeladen, laden skills gedetailleerde patronen en best practices alleen in wanneer ze relevant zijn. Dat beperkt het opblazen van de context en verhoogt de kwaliteit van AI-gegenereerde code. Wanneer jeboost:install uitvoert en skills als feature selecteert, worden skills automatisch geïnstalleerd op basis van de packages die in je composer.json worden gedetecteerd. Bevat je project bijvoorbeeld livewire/livewire, dan wordt de livewire-development-skill automatisch geïnstalleerd. Skills die bij Boost worden geleverd, zoals infer-conventions, worden geïnstalleerd ongeacht welke packages je gebruikt.
Beschikbare skills
Eigen skills maken
Om je eigen skill te maken, voeg je eenSKILL.md-bestand toe aan de .ai/skills/{skill-name}/-map van je applicatie. Wanneer je boost:update uitvoert, worden je eigen skills samen met de ingebouwde skills van Boost geïnstalleerd.
Om bijvoorbeeld een eigen skill te maken voor applicatiespecifieke domeinlogica:
Skills overschrijven
Je kunt de ingebouwde skills van Boost overschrijven door een eigen skill te maken met een overeenkomende naam. Als je een eigen skill aanmaakt met een naam die overeenkomt met een bestaande Boost-skill, gebruikt Boost jouw versie in plaats van de ingebouwde skill. Om bijvoorbeeld delivewire-development-skill van Boost te overschrijven, maak je een bestand aan op .ai/skills/livewire-development/SKILL.md. Wanneer je boost:update uitvoert, gebruikt Boost jouw skill in plaats van de standaardskill.
Skills voor third-party packages
Onderhoud je een third-party package en wil je dat Boost skills voor die package bevat, voeg dan eenresources/boost/skills/{skill-name}/SKILL.md-bestand toe aan je package. Wanneer gebruikers van je package php artisan boost:install uitvoeren, installeert Boost de skills automatisch als de gebruiker dat wenst.
De skills van Boost ondersteunen het Agent Skills-formaat en moeten worden opgezet als een map met daarin een SKILL.md-bestand met YAML-frontmatter en Markdown-instructies. Het SKILL.md-bestand moet de verplichte frontmatter (name en description) bevatten en kan optioneel scripts, templates en referentiemateriaal bevatten.
Richtlijnen versus skills
Laravel Boost biedt twee verschillende manieren om AI-agents context over je applicatie te geven: richtlijnen en skills. Richtlijnen worden vooraf ingeladen wanneer de AI-agent start en bieden belangrijke context over Laravel-conventies en best practices die breed van toepassing zijn op je hele codebase. Skills worden on demand geactiveerd wanneer er aan een specifieke taak wordt gewerkt en bevatten gedetailleerde patronen voor een specifiek domein (zoals Livewire-componenten of Pest-tests). Door skills alleen in te laden wanneer dat nodig is, wordt het opblazen van de context beperkt en de codekwaliteit verbeterd.
Richtlijnen en skills bieden kennis over het Laravel-ecosysteem. Om applicatiespecifieke conventies aan AI-agents door te geven, gebruik je projectregels.
Projectregels
Waar richtlijnen en skills leren hoe je Laravel-code schrijft, leren projectregels hoe je code voor jouw applicatie schrijft. Regels zijn de dingen die je anders bij elke nieuwe sessie opnieuw zou moeten uitleggen, zoals:- Ontwerpbeslissingen die jij, de agent of je teamleden hebben genomen
- Stijlgidsen of voorkeuren waar agents zich moeilijk aan houden
- Beperkingen en valkuilen die niet uit de omliggende code af te leiden zijn
.ai/rules-map van je applicatie en gecommit naar versiebeheer. In tegenstelling tot het persoonlijke, sessiegebonden geheugen van een agent worden regels gedeeld door je team en alle agents die aan de applicatie werken.
In de frontmatter van elk regelbestand definieer je de bestandsglobs waarop de regel van toepassing is:
.ai/rules/index.md-bestand, dat de koppeling tussen globs en regelbestanden vastlegt. Agents worden geïnstrueerd om deze index te raadplegen voordat ze bestanden plannen of bewerken, zodat alleen de relevante regels worden ingeladen.
In tegenstelling tot
.mcp.json en de gegenereerde richtlijnenbestanden commit je de .ai/rules-map naar versiebeheer om de regels met je team te delen.Regels vastleggen
Je kunt een regel vastleggen door de agent simpelweg te vragen iets te onthouden:record-rule MCP-tool van Boost aan met een glob, een korte title en een note. Boost legt de regel vast in het juiste gebied, maakt indien nodig een regelbestand aan en werkt de index bij.
Maak regelbestanden niet handmatig aan, maar leg ze altijd vast via de record-rule-tool. Boost genereert .ai/rules/index.md opnieuw wanneer een regel wordt vastgelegd. Agents vinden de toepasselijke regels via deze index, dus handmatig toegevoegde regelbestanden worden pas gevonden nadat de index opnieuw is gegenereerd.
Applicatieconventies afleiden
Bestaande applicaties hebben conventies die in de loop der jaren zijn opgebouwd. Deinfer-conventions-skill maakt regels op basis van de code die al geschreven is. Je start door de agent bijvoorbeeld het volgende te vragen:
Projectregels uitschakelen
Projectregels zijn standaard ingeschakeld. Om ze volledig uit te schakelen, definieer je de volgende omgevingsvariabele. Derecord-rule MCP-tool wordt verwijderd en Boost stopt met het beheren van de .ai/rules-map.
Documentatie-API
Laravel Boost bevat een documentatie-API die AI-agents toegang geeft tot een kennisbank met meer dan 17.000 Laravel-specifieke items. Deze API gebruikt semantisch zoeken op basis van embeddings om nauwkeurige, contextbewuste resultaten te leveren. Met deSearch Docs MCP-tool kunnen agents de gehoste documentatie-API van Laravel bevragen op basis van de geïnstalleerde packages. De AI-richtlijnen en skills van Boost instrueren coding-agents automatisch om deze API te gebruiken.
Boost uitbreiden
Boost werkt out of the box met veel populaire IDE’s en AI-agents. Wordt jouw coding-tool nog niet ondersteund, dan kun je een eigen agent maken en die met Boost integreren.Ondersteuning toevoegen voor andere IDE’s/AI-agents
Om ondersteuning voor een nieuwe IDE of AI-agent toe te voegen, maak je een klasse dieLaravel\Boost\Install\Agents\Agent extend en implementeer je naar behoefte een of meer van de volgende contracts:
Laravel\Boost\Contracts\SupportsGuidelines— voegt ondersteuning voor AI-richtlijnen toeLaravel\Boost\Contracts\SupportsMcp— voegt ondersteuning voor MCP toeLaravel\Boost\Contracts\SupportsSkills— voegt ondersteuning voor Agent Skills toe
De agent implementeren
De agent registreren
Registreer je eigen agent in deboot-methode van de App\Providers\AppServiceProvider van je applicatie:
php artisan boost:install uitvoert.