> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# Laravel Boost
> Laravel Boost is een package die AI-ondersteunde ontwikkeling versnelt. Via een MCP-server, AI-richtlijnen en Agent Skills zorgt Boost ervoor dat AI-coding-agents jouw Laravel-applicatie diepgaand begrijpen.
## 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:
```shell theme={null}
composer require laravel/boost --dev
```
Installeer vervolgens de MCP-server en de coderingsrichtlijnen:
```shell theme={null}
php artisan boost:install
```
Het `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
1. Open het commandopalet (`Cmd+Shift+P` of `Ctrl+Shift+P`)
2. Selecteer "/open MCP Settings" en druk op `Enter`
3. Zet de toggle voor `laravel-boost` aan
Ondersteuning voor Claude Code wordt doorgaans automatisch ingeschakeld. Als dat niet het geval is, open dan een shell in je projectmap en voer het volgende commando uit:
```shell theme={null}
claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp
```
Ondersteuning voor Codex wordt doorgaans automatisch ingeschakeld. Als dat niet het geval is, open dan een shell in je projectmap en voer het volgende commando uit:
```shell theme={null}
codex mcp add laravel-boost -- php "artisan" "boost:mcp"
```
Ondersteuning voor Gemini CLI wordt doorgaans automatisch ingeschakeld. Als dat niet het geval is, open dan een shell in je projectmap en voer het volgende commando uit:
```shell theme={null}
gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp
```
1. Open het commandopalet (`Cmd+Shift+P` of `Ctrl+Shift+P`)
2. Selecteer "MCP: List Servers" en druk op `Enter`
3. Selecteer `laravel-boost` en druk op `Enter`
4. Selecteer "Start server"
1. Druk twee keer op `Shift` om het commandopalet te openen
2. Zoek naar "MCP Settings" en druk op `Enter`
3. Vink het selectievakje naast `laravel-boost` aan
4. Klik rechtsonder op "Apply"
### 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 het `boost:update` Artisan-commando:
```shell theme={null}
php artisan boost:update
```
Je kunt dit ook automatiseren door het toe te voegen aan het `post-update-cmd`-script van Composer:
```json theme={null}
{
"scripts": {
"post-update-cmd": [
"@php artisan boost:update --ansi"
]
}
}
```
Standaard werkt het `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:
```shell theme={null}
php artisan boost:update --discover
```
## 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
| Toolnaam | Beschrijving |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Application Info | Leest de PHP- en Laravel-versie, de database-engine, een lijst van ecosysteem-packages met versies en de Eloquent-models |
| Browser Logs | Leest logs en fouten uit de browser |
| Database Connections | Controleert de beschikbare databaseverbindingen, inclusief de standaardverbinding |
| Database Query | Voert query's uit op de database |
| Database Schema | Leest het databaseschema |
| Get Absolute URL | Zet relatieve URI's om naar absolute URL's, zodat agents geldige URL's kunnen genereren |
| Last Error | Leest de laatste fout uit het logbestand van de applicatie |
| Read Log Entries | Leest de laatste N logregels |
| Record Rule | Legt permanente [projectregels](#projectregels) vast in `.ai/rules`, zodat toekomstige agents ze kunnen overnemen |
| Search Docs | Bevraagt de gehoste documentatie-API van Laravel op basis van de geïnstalleerde packages |
### 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:
| Onderdeel | Waarde |
| ----------- | ------------------- |
| **Command** | `php` |
| **Args** | `artisan boost:mcp` |
Voorbeeld in JSON-formaat:
```json theme={null}
{
"mcpServers": {
"laravel-boost": {
"command": "php",
"args": ["artisan", "boost:mcp"]
}
}
}
```
## 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. De `core`-richtlijnen bieden algemeen advies dat van toepassing is ongeacht de versie.
| Package | Ondersteunde versies |
| ----------------- | ---------------------- |
| 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 |
Zie [Boost-resources bijwerken](#boost-resources-bijwerken) om de AI-richtlijnen up-to-date te houden.
### 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 een `resources/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.
```php theme={null}
## Package Name
This package provides [brief description of functionality].
### Features
- Feature 1: [clear & short description].
- Feature 2: [clear & short description]. Example usage:
@verbatim
$result = PackageName::featureTwo($param1, $param2);
@endverbatim
```
## Agent Skills
[Agent Skills](https://agentskills.io/home) 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 je `boost: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
| Skill | Package |
| -------------------------- | -------------- |
| fluxui-development | Flux UI |
| folio-routing | Folio |
| infer-conventions | Boost |
| 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 |
Zie [Boost-resources bijwerken](#boost-resources-bijwerken) om skills up-to-date te houden.
### Eigen skills maken
Om je eigen skill te maken, voeg je een `SKILL.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:
```
.ai/skills/creating-invoices/SKILL.md
```
### 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 de `livewire-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 een `resources/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.
```markdown theme={null}
---
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);
```
## 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.
| Aspect | Richtlijnen | Skills |
| ---------------------- | -------------------------------- | ------------------------------------ |
| **Moment van inladen** | Vooraf, altijd aanwezig | On demand, alleen wanneer relevant |
| **Scope** | Breed, fundamenteel | Gericht, taakspecifiek |
| **Doel** | Kernconventies en best practices | Gedetailleerde implementatiepatronen |
Richtlijnen en skills bieden kennis over het Laravel-ecosysteem. Om applicatiespecifieke conventies aan AI-agents door te geven, gebruik je [projectregels](#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
Regels worden als Markdown-bestanden opgeslagen in de `.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:
```markdown theme={null}
---
paths:
- app/Http/Controllers/**
---
# Http Controllers
## Erf van BaseController voor tenant-scoping
Alle controllers erven van `App\Http\Controllers\BaseController`.
Deze klasse past de queryscope van de huidige tenant toe.
Rechtstreeks erven van de base controller van Laravel lekt data tussen tenants.
```
Boost beheert ook een `.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.
```markdown theme={null}
# Project Rules Index
Zoek vóór het plannen of bewerken de rij met de glob die overeenkomt met het bestandspad en laad dat regelbestand in.
| Van toepassing op | Regelbestand |
| --- | --- |
| app/Http/Controllers/** | .ai/rules/controllers.md |
| app/Models/** | .ai/rules/models.md |
```
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:
```text theme={null}
Sla alle geldbedragen op als hele centen (integers), niet als floating-point-getallen.
```
De agent roept de `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. De `infer-conventions`-skill maakt regels op basis van de code die al geschreven is. Je start door de agent bijvoorbeeld het volgende te vragen:
```text theme={null}
Gebruik de infer-conventions skill
```
Deze skill onderzoekt aan de hand van een checklist conventies rond validation, controllers, authorization, models, architecture, testing, frontend, database en console, en verkent daarnaast in vrije vorm patronen zoals basisklassen, gedeelde traits en modulestructuur.
De skill legt vast wat de code werkelijk doet, niet hoe het "idealiter zou moeten". Alleen eigen conventies met voldoende onderbouwing worden vastgelegd; framework-defaults en zaken die Pint of Rector al afdwingen worden uitgesloten. Als patronen gemengd zijn, wordt dat feit gerapporteerd zonder er geforceerd een regel van te maken. Voordat regels worden weggeschreven, presenteert de skill de gevonden conventies met onderbouwing en vraagt om goedkeuring. Wil je dat alle conventies zonder bevestiging worden vastgelegd, dan kun je "yolo" opgeven.
### Projectregels uitschakelen
Projectregels zijn standaard ingeschakeld. Om ze volledig uit te schakelen, definieer je de volgende omgevingsvariabele. De `record-rule` MCP-tool wordt verwijderd en Boost stopt met het beheren van de `.ai/rules`-map.
```ini theme={null}
BOOST_RULES_ENABLED=false
```
## 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 de `Search 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.
| Package | Ondersteunde versies |
| ----------------- | -------------------- |
| 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 |
## 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 die `Laravel\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 toe
* `Laravel\Boost\Contracts\SupportsMcp` — voegt ondersteuning voor MCP toe
* `Laravel\Boost\Contracts\SupportsSkills` — voegt ondersteuning voor Agent Skills toe
#### De agent implementeren
```php theme={null}