Zum Hauptinhalt springen

Einführung

Laravel Boost ist ein Paket, das KI-gestützte Entwicklung beschleunigt, indem es KI-Agenten die nötigen Richtlinien und Agent Skills an die Hand gibt, um hochwertige Laravel-Anwendungen im Einklang mit den Laravel-Best-Practices zu schreiben. Boost stellt zudem eine leistungsfähige Dokumentations-API für das Laravel-Ökosystem bereit, die eine Wissensbasis mit über 17.000 Laravel-spezifischen Informationen mit semantischer Suche über Embeddings kombiniert. Boost weist KI-Agenten wie Claude Code oder Cursor an, diese API zu nutzen, um sich über aktuelle Laravel-Funktionen und Best Practices zu informieren.

Installation

Laravel Boost wird über Composer installiert.
composer require laravel/boost --dev
Anschließend installieren Sie den MCP-Server und die Coding-Richtlinien.
php artisan boost:install
Der Befehl boost:install erzeugt die passenden Richtlinien- und Skill-Dateien für den bei der Installation ausgewählten Coding-Agenten. Nach abgeschlossener Installation können Sie mit Cursor, Claude Code oder einem beliebigen anderen KI-Agenten Ihrer Wahl mit dem Programmieren beginnen.
Die generierte MCP-Konfigurationsdatei (.mcp.json), die Richtliniendateien (CLAUDE.md, AGENTS.md, junie/ usw.) und die Konfigurationsdatei boost.json können Sie problemlos in die .gitignore Ihrer Anwendung aufnehmen. Diese Dateien werden bei jedem Aufruf von boost:install oder boost:update automatisch neu erzeugt.

Agent konfigurieren

  1. Öffnen Sie die Befehlspalette (Cmd+Shift+P oder Ctrl+Shift+P).
  2. Wählen Sie „/open MCP Settings” und drücken Sie Enter.
  3. Aktivieren Sie den Schalter neben laravel-boost.

Boost-Ressourcen aktualisieren

Damit die installierten Laravel-Ökosystem-Pakete stets in der aktuellen Version widergespiegelt werden, empfiehlt es sich, die lokalen Boost-Ressourcen (KI-Richtlinien und Skills) regelmäßig zu aktualisieren. Verwenden Sie hierfür den Artisan-Befehl boost:update.
php artisan boost:update
Sie können dies automatisieren, indem Sie den Befehl in das Composer-Skript post-update-cmd eintragen.
{
  "scripts": {
    "post-update-cmd": [
      "@php artisan boost:update --ansi"
    ]
  }
}
Standardmäßig aktualisiert boost:update nur die Boost-Ressourcen, die bereits in der Anwendung veröffentlicht sind. Wenn Sie neu installierte Pakete erkennen lassen und zur Veröffentlichung deren Richtlinien und Skills auffordern möchten, verwenden Sie die Option --discover.
php artisan boost:update --discover

MCP-Server

Laravel Boost bringt einen MCP-Server (Model Context Protocol) mit, der KI-Agenten Tools zur Interaktion mit Ihrer Laravel-Anwendung bereitstellt. Damit können Agenten die Struktur der Anwendung erkunden, die Datenbank abfragen oder Code ausführen.

Verfügbare MCP-Tools

ToolnameBeschreibung
Application InfoLiest die PHP- und Laravel-Version, die Datenbank-Engine, eine Liste der versionierten Ökosystem-Pakete sowie die Eloquent-Modelle aus
Browser LogsLiest Logs und Fehler aus dem Browser
Database ConnectionsErmittelt die verfügbaren Datenbankverbindungen, einschließlich der Standardverbindung
Database QueryFührt eine Abfrage gegen die Datenbank aus
Database SchemaLiest das Datenbankschema
Get Absolute URLWandelt eine relative Pfad-URI in eine absolute URL um, damit der Agent gültige URLs erzeugen kann
Last ErrorLiest den letzten Fehler aus der Log-Datei der Anwendung
Read Log EntriesLiest die letzten N Log-Einträge
Search DocsFragt den gehosteten Dokumentations-API-Dienst von Laravel basierend auf den installierten Paketen ab

MCP-Server manuell registrieren

Je nach Editor müssen Sie den Laravel-Boost-MCP-Server unter Umständen manuell registrieren. Verwenden Sie dazu die folgenden Angaben:
FeldWert
Commandphp
Argsartisan boost:mcp
Beispiel im JSON-Format:
{
    "mcpServers": {
        "laravel-boost": {
            "command": "php",
            "args": ["artisan", "boost:mcp"]
        }
    }
}

KI-Richtlinien

KI-Richtlinien sind Anweisungsdateien, die vorab geladen werden, um KI-Agenten wichtige Kontextinformationen zu den Paketen des Laravel-Ökosystems bereitzustellen. Sie enthalten zentrale Konventionen, Best Practices und Framework-spezifische Muster und helfen dem Agenten, konsistenten, hochwertigen Code zu erzeugen.

Verfügbare Richtlinien

Laravel Boost enthält KI-Richtlinien für die folgenden Pakete und Frameworks. Die core-Richtlinie enthält allgemeine, versionsunabhängige Empfehlungen.
PaketUnterstützte Versionen
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
Wie Sie die KI-Richtlinien aktuell halten, erfahren Sie unter Boost-Ressourcen aktualisieren.

Eigene Richtlinien ergänzen

Um eigene KI-Richtlinien zu Laravel Boost hinzuzufügen, legen Sie .blade.php- oder .md-Dateien im Verzeichnis .ai/guidelines/* Ihrer Anwendung ab. Diese Dateien werden bei boost:install automatisch mit den Boost-Richtlinien kombiniert.

Boost-Richtlinien überschreiben

Sie können in Boost integrierte Richtlinien überschreiben, indem Sie eine eigene Richtlinie mit übereinstimmendem Pfad anlegen. Existiert eine eigene Datei unter dem gleichen Pfad wie eine bestehende Boost-Richtlinie, verwendet Boost Ihre Version anstelle der Standardrichtlinie. Um zum Beispiel die Boost-Richtlinie „Inertia React v2 Form Guidance” zu überschreiben, legen Sie eine Datei unter .ai/guidelines/inertia-react/2/forms.blade.php an. Beim nächsten Aufruf von boost:install nutzt Boost dann Ihre eigene Richtlinie anstelle der Standardversion.

Richtlinien für Fremdpakete

Wenn Sie ein Fremdpaket pflegen und in Boost KI-Richtlinien für Ihr Paket bereitstellen möchten, fügen Sie Ihrem Paket eine Datei resources/boost/guidelines/core.blade.php hinzu. Wenn ein Nutzer des Pakets php artisan boost:install ausführt, lädt Boost Ihre Richtlinien automatisch mit. Beschreiben Sie in Ihren KI-Richtlinien eine Übersicht des Pakets, die erforderliche Dateistruktur bzw. Konventionen sowie die Vorgehensweise für zentrale Funktionen (inklusive Befehlen und Codebeispielen). Halten Sie sich kurz und aktionsorientiert und konzentrieren Sie sich auf Best Practices, damit die KI korrekten Code für Ihre Nutzerinnen und Nutzer generieren kann.
## 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

Agent Skills sind schlanke, fokussierte Wissensmodule, die Agenten bei Bedarf aktivieren können, wenn sie in einer bestimmten Domäne arbeiten. Anders als Richtlinien, die stets vorab geladen werden, laden Skills detaillierte Muster und Best Practices nur, wenn sie relevant sind. Dadurch bleiben Kontextfenster schlank, und die Qualität des von der KI erzeugten Codes steigt. Wenn Sie boost:install ausführen und Skills als Feature auswählen, werden Skills basierend auf den in der composer.json erkannten Paketen automatisch installiert. Enthält Ihr Projekt zum Beispiel livewire/livewire, wird der Skill livewire-development automatisch installiert.

Verfügbare Skills

SkillPaket
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
Wie Sie Skills aktuell halten, erfahren Sie unter Boost-Ressourcen aktualisieren.

Eigene Skills erstellen

Um einen eigenen Skill anzulegen, erstellen Sie eine Datei SKILL.md unter .ai/skills/{skill-name}/ in Ihrer Anwendung. Bei boost:update werden Ihre eigenen Skills zusammen mit den in Boost integrierten Skills installiert. Für einen Skill zu einer anwendungsspezifischen Domänenlogik könnte das etwa so aussehen:
.ai/skills/creating-invoices/SKILL.md

Skills überschreiben

Sie können in Boost integrierte Skills überschreiben, indem Sie einen eigenen Skill mit demselben Namen anlegen. Existiert ein eigener Skill mit dem gleichen Namen wie ein bestehender Boost-Skill, verwendet Boost Ihre Version anstelle des Standard-Skills. Um zum Beispiel den Boost-Skill livewire-development zu überschreiben, legen Sie eine Datei unter .ai/skills/livewire-development/SKILL.md an. Beim nächsten Aufruf von boost:update nutzt Boost dann Ihren eigenen Skill anstelle der Standardversion.

Skills für Fremdpakete

Wenn Sie ein Fremdpaket pflegen und in Boost Skills für Ihr Paket bereitstellen möchten, fügen Sie eine Datei resources/boost/skills/{skill-name}/SKILL.md zu Ihrem Paket hinzu. Führt ein Nutzer php artisan boost:install aus, installiert Boost den Skill auf Wunsch automatisch. Boost-Skills unterstützen das Agent-Skills-Format. Sie sind als Ordner mit einer SKILL.md-Datei aufgebaut, die YAML-Frontmatter und Markdown-Anweisungen enthält. Die SKILL.md-Datei muss die Pflicht-Frontmatter (name und description) enthalten und kann optional Skripte, Vorlagen und Referenzmaterial umfassen.
---
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);

Vergleich: Richtlinien und Skills

Laravel Boost bietet zwei unterschiedliche Wege, um KI-Agenten Kontext zu Ihrer Anwendung zu geben: Richtlinien und Skills. Richtlinien werden beim Start des KI-Agenten vorab geladen und liefern wichtigen, breit anwendbaren Kontext zu Laravel-Konventionen und Best Practices, die für die gesamte Codebasis relevant sind. Skills werden bei Bedarf aktiviert, wenn Sie an einer konkreten Aufgabe arbeiten, und enthalten detaillierte Muster für eine bestimmte Domäne (z. B. Livewire-Komponenten oder Pest-Tests). Weil Skills nur bei Bedarf geladen werden, bleibt der Kontext schlank und die Codequalität steigt.
AspektRichtlinieSkill
LadezeitpunktVorab, immer vorhandenBei Bedarf, nur wenn relevant
GeltungsbereichBreit, grundlegendFokussiert, aufgabenspezifisch
ZweckKernkonventionen und Best PracticesDetaillierte Implementierungsmuster

Dokumentations-API

Laravel Boost enthält eine Dokumentations-API, die KI-Agenten Zugriff auf eine Wissensbasis mit über 17.000 Laravel-spezifischen Informationen ermöglicht. Diese API nutzt semantische Suche über Embeddings, um besonders präzise und kontextbewusste Ergebnisse zu liefern. Über das MCP-Tool Search Docs können Agenten den gehosteten Dokumentations-API-Dienst von Laravel basierend auf den installierten Paketen abfragen. Boosts KI-Richtlinien und Skills weisen Coding-Agenten automatisch an, diese API zu verwenden.
PaketUnterstützte Versionen
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

Boost erweitern

Boost funktioniert mit vielen gängigen IDEs und KI-Agenten sofort. Falls Ihr Coding-Tool noch nicht unterstützt wird, können Sie einen eigenen Agenten erstellen und in Boost integrieren.

Unterstützung für weitere IDEs/KI-Agenten hinzufügen

Um Unterstützung für eine neue IDE oder einen neuen KI-Agenten hinzuzufügen, erstellen Sie eine Klasse, die von Laravel\Boost\Install\Agents\Agent erbt, und implementieren Sie je nach Bedarf eines oder mehrere der folgenden Contracts:
  • Laravel\Boost\Contracts\SupportsGuidelines — fügt Unterstützung für KI-Richtlinien hinzu
  • Laravel\Boost\Contracts\SupportsMcp — fügt MCP-Unterstützung hinzu
  • Laravel\Boost\Contracts\SupportsSkills — fügt Unterstützung für Agent Skills hinzu

Agenten implementieren

<?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
{
    // Your implementation...
}
Als Referenz für eine Implementierung dient ClaudeCode.php.

Agenten registrieren

Registrieren Sie Ihren eigenen Agenten in der boot-Methode von App\Providers\AppServiceProvider.
use Laravel\Boost\Boost;

public function boot(): void
{
    Boost::registerAgent('customagent', CustomAgent::class);
}
Nach der Registrierung erscheint Ihr Agent bei jedem Aufruf von php artisan boost:install als Auswahloption.
Zuletzt geändert am 13. Juli 2026