Laravel Boost (Laravel Boost)
소개 (Introduction)
Laravel Boost는 AI 에이전트가 Laravel 모범 사례를 따르는 고품질 Laravel 애플리케이션을 작성하도록 돕는 필수 가이드라인과 에이전트 스킬을 제공하여 AI 지원 개발 속도를 높입니다.
Boost는 강력한 Laravel 생태계 문서 API도 제공합니다. 이 API는 내장 MCP 도구와 17,000개가 넘는 Laravel 전용 정보를 담은 방대한 지식 베이스를 결합하며, 임베딩을 활용한 의미 기반 검색 기능으로 정확하고 문맥에 맞는 결과를 제공합니다. Boost는 Claude Code, Cursor 같은 AI 에이전트가 이 API를 사용해 최신 Laravel 기능과 모범 사례를 학습하도록 안내합니다.
설치 (Installation)
Laravel Boost는 Composer로 설치할 수 있습니다.
composer require laravel/boost --dev
다음으로 MCP 서버와 코딩 가이드라인을 설치합니다.
php artisan boost:install
boost:install 명령어는 설치 과정에서 선택한 코딩 에이전트에 맞는 에이전트 가이드라인 및 스킬 파일을 생성합니다.
Laravel Boost 설치가 완료되면 Cursor, Claude Code 또는 원하는 AI 에이전트로 바로 코딩을 시작할 수 있습니다.
생성된 MCP 설정 파일(
.mcp.json), 가이드라인 파일(CLAUDE.md,AGENTS.md,junie/등),boost.json설정 파일은 애플리케이션의.gitignore에 추가해도 됩니다. 이 파일들은boost:install과boost:update실행 시 자동으로 다시 생성됩니다.
에이전트 설정하기
1. Open the command palette (`Cmd+Shift+P` or `Ctrl+Shift+P`)
2. Press `enter` on "/open MCP Settings"
3. Turn the toggle on for `laravel-boost`
Claude Code support is typically enabled automatically. If you find it isn't, open a shell in the project's directory and run the following command:
claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp
Codex support is typically enabled automatically. If you find it isn't, open a shell in the project's directory and run the following command:
codex mcp add laravel-boost -- php "artisan" "boost:mcp"
Gemini CLI support is typically enabled automatically. If you find it isn't, open a shell in the project's directory and run the following command:
gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp
1. Open the command palette (`Cmd+Shift+P` or `Ctrl+Shift+P`)
2. Press `enter` on "MCP: List Servers"
3. Arrow to `laravel-boost` and press `enter`
4. Choose "Start server"
1. Press `shift` twice to open the command palette
2. Search "MCP Settings" and press `enter`
3. Check the box next to `laravel-boost`
4. Click "Apply" at the bottom right
Boost 리소스 최신 상태로 유지하기
설치된 Laravel 생태계 패키지의 최신 버전을 반영하도록 로컬 Boost 리소스(AI 가이드라인과 스킬)를 주기적으로 업데이트하고 싶을 수 있습니다. 이때 boost:update Artisan 명령어를 사용할 수 있습니다.
php artisan boost:update
이 과정을 Composer의 "post-update-cmd" 스크립트에 추가하여 자동화할 수도 있습니다.
{
"scripts": {
"post-update-cmd": [
"@php artisan boost:update --ansi"
]
}
}
MCP 서버 (MCP Server)
Laravel Boost는 AI 에이전트가 Laravel 애플리케이션과 상호작용할 수 있도록 도구를 노출하는 MCP(Model Context Protocol) 서버를 제공합니다. 이 도구들은 에이전트가 애플리케이션 구조를 검사하고, 데이터베이스를 조회하고, 코드를 실행하는 등 다양한 작업을 할 수 있게 해줍니다.
사용 가능한 MCP 도구
| 이름 | 비고 |
|---|---|
| Application Info | PHP 및 Laravel 버전, 데이터베이스 엔진, 버전이 포함된 생태계 패키지 목록, Eloquent 모델을 읽습니다 |
| Browser Logs | 브라우저의 로그와 오류를 읽습니다 |
| Database Connections | 기본 연결을 포함해 사용 가능한 데이터베이스 연결을 검사합니다 |
| Database Query | 데이터베이스에 쿼리를 실행합니다 |
| Database Schema | 데이터베이스 스키마를 읽습니다 |
| Get Absolute URL | 에이전트가 유효한 URL을 생성할 수 있도록 상대 경로 URI를 절대 경로로 변환합니다 |
| Get Config | "dot" 표기법을 사용해 설정 파일에서 값을 가져옵니다 |
| Last Error | 애플리케이션 로그 파일에서 마지막 오류를 읽습니다 |
| List Artisan Commands | 사용 가능한 Artisan 명령어를 검사합니다 |
| List Available Config Keys | 사용 가능한 설정 키를 검사합니다 |
| List Available Env Vars | 사용 가능한 환경 변수 키를 검사합니다 |
| List Routes | 애플리케이션의 라우트를 검사합니다 |
| Read Log Entries | 마지막 N개의 로그 항목을 읽습니다 |
| Search Docs | 설치된 패키지를 기준으로 문서를 가져오기 위해 Laravel 호스팅 문서 API 서비스를 조회합니다 |
| Tinker | 애플리케이션의 컨텍스트 안에서 임의의 코드를 실행합니다 |
MCP 서버 수동 등록하기
때로는 선택한 에디터에 Laravel Boost MCP 서버를 수동으로 등록해야 할 수 있습니다. MCP 서버는 다음 정보를 사용해 등록해야 합니다.
| 명령어 | php |
| 인수 | artisan boost:mcp |
JSON 예시:
{
"mcpServers": {
"laravel-boost": {
"command": "php",
"args": ["artisan", "boost:mcp"]
}
}
}
AI 가이드라인 (AI Guidelines)
AI 가이드라인은 Laravel 생태계 패키지에 대한 핵심 컨텍스트를 AI 에이전트에 미리 제공하기 위해 로드되는 조합 가능한 지침 파일입니다. 이 가이드라인에는 에이전트가 일관되고 고품질의 코드를 생성하도록 돕는 핵심 규칙, 모범 사례, 프레임워크별 패턴이 포함되어 있습니다.
사용 가능한 AI 가이드라인
Laravel Boost에는 다음 패키지와 프레임워크를 위한 AI 가이드라인이 포함되어 있습니다. core 가이드라인은 해당 패키지의 모든 버전에 적용할 수 있는 일반적이고 공통적인 조언을 AI에 제공합니다.
| 패키지 | 지원 버전 |
|---|---|
| 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 |
| Inertia React | core, 1.x, 2.x |
| Inertia Vue | core, 1.x, 2.x |
| Inertia Svelte | core, 1.x, 2.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 |
참고: AI 가이드라인을 최신 상태로 유지하려면 Boost 리소스 최신 상태로 유지하기 섹션을 참고하십시오.
커스텀 AI 가이드라인 추가하기
Laravel Boost에 직접 작성한 커스텀 AI 가이드라인을 추가하려면 애플리케이션의 .ai/guidelines/* 디렉터리에 .blade.php 또는 .md 파일을 추가하십시오. 이 파일들은 boost:install 실행 시 Laravel Boost의 가이드라인에 자동으로 포함됩니다.
Boost AI 가이드라인 재정의하기
동일한 파일 경로를 가진 커스텀 가이드라인을 만들어 Boost의 내장 AI 가이드라인을 재정의할 수 있습니다. 기존 Boost 가이드라인 경로와 일치하는 커스텀 가이드라인을 만들면 Boost는 내장 버전 대신 커스텀 버전을 사용합니다.
예를 들어 Boost의 "Inertia React v2 Form Guidance" 가이드라인을 재정의하려면 .ai/guidelines/inertia-react/2/forms.blade.php 파일을 생성하십시오. boost:install을 실행하면 Boost는 기본 가이드라인 대신 커스텀 가이드라인을 포함합니다.
서드파티 패키지 AI 가이드라인
서드파티 패키지를 유지보수하고 있고 Boost가 해당 패키지의 AI 가이드라인을 포함하도록 하고 싶다면, 패키지에 resources/boost/guidelines/core.blade.php 파일을 추가하면 됩니다. 패키지 사용자가 php artisan boost:install을 실행하면 Boost가 자동으로 해당 가이드라인을 로드합니다.
AI 가이드라인은 패키지가 무엇을 하는지에 대한 짧은 개요를 제공하고, 필요한 파일 구조나 규칙을 설명하며, 주요 기능을 생성하거나 사용하는 방법을 설명해야 합니다(예시 명령어나 코드 조각 포함). AI가 사용자를 위해 올바른 코드를 생성할 수 있도록 간결하고 실행 가능하며 모범 사례에 집중해서 작성하십시오. 예시는 다음과 같습니다.
## 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는 에이전트가 특정 도메인 작업을 할 때 필요에 따라 활성화할 수 있는 가볍고 목적이 분명한 지식 모듈입니다. 미리 로드되는 가이드라인과 달리, 스킬은 관련성이 있을 때만 세부 패턴과 모범 사례를 로드할 수 있게 하여 컨텍스트 팽창을 줄이고 AI가 생성하는 코드의 관련성을 높입니다.
boost:install을 실행하고 기능으로 스킬을 선택하면 composer.json에서 감지된 패키지를 기준으로 스킬이 자동 설치됩니다. 예를 들어 프로젝트에 livewire/livewire가 포함되어 있다면 livewire-development 스킬이 자동으로 설치됩니다.
사용 가능한 스킬
| 스킬 | 패키지 |
|---|---|
| fluxui-development | Flux UI |
| folio-routing | Folio |
| 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 |
참고: 스킬을 최신 상태로 유지하려면 Boost 리소스 최신 상태로 유지하기 섹션을 참고하십시오.
커스텀 스킬
직접 커스텀 스킬을 만들려면 애플리케이션의 .ai/skills/{skill-name}/ 디렉터리에 SKILL.md 파일을 추가하십시오. boost:update를 실행하면 커스텀 스킬이 Boost의 내장 스킬과 함께 설치됩니다.
예를 들어 애플리케이션의 도메인 로직을 위한 커스텀 스킬을 만들려면 다음 파일을 생성합니다.
.ai/skills/creating-invoices/SKILL.md
스킬 재정의하기
동일한 이름을 가진 커스텀 스킬을 만들어 Boost의 내장 스킬을 재정의할 수 있습니다. 기존 Boost 스킬 이름과 일치하는 커스텀 스킬을 만들면 Boost는 내장 버전 대신 커스텀 버전을 사용합니다.
예를 들어 Boost의 livewire-development 스킬을 재정의하려면 .ai/skills/livewire-development/SKILL.md 파일을 생성하십시오. boost:update를 실행하면 Boost는 기본 스킬 대신 커스텀 스킬을 포함합니다.
서드파티 패키지 스킬
서드파티 패키지를 유지보수하고 있고 Boost가 해당 패키지의 스킬을 포함하도록 하고 싶다면, 패키지에 resources/boost/skills/{skill-name}/SKILL.md 파일을 추가하면 됩니다. 패키지 사용자가 php artisan boost:install을 실행하면 Boost가 사용자 선택에 따라 스킬을 자동으로 설치합니다.
Boost Skills는 Agent Skills 형식을 지원하며, YAML frontmatter와 Markdown 지침을 포함한 SKILL.md 파일이 들어 있는 폴더 구조여야 합니다. SKILL.md 파일에는 필수 frontmatter(name과 description)가 포함되어야 하며, 선택적으로 스크립트, 템플릿, 참고 자료를 포함할 수 있습니다.
스킬은 필요한 파일 구조나 규칙을 설명하고, 주요 기능을 생성하거나 사용하는 방법을 설명해야 합니다(예시 명령어나 코드 조각 포함). AI가 사용자를 위해 올바른 코드를 생성할 수 있도록 간결하고 실행 가능하며 모범 사례에 집중해서 작성하십시오.
---
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);
가이드라인과 스킬 (Guidelines vs. Skills)
Laravel Boost는 AI 에이전트에 애플리케이션 컨텍스트를 제공하는 두 가지 방식을 제공합니다. 바로 가이드라인과 스킬입니다.
가이드라인은 AI 에이전트가 시작될 때 미리 로드되며, 코드베이스 전반에 넓게 적용되는 Laravel 규칙과 모범 사례에 대한 핵심 컨텍스트를 제공합니다.
스킬은 특정 작업을 할 때 필요에 따라 활성화되며, 특정 도메인(예: Livewire 컴포넌트 또는 Pest 테스트)에 대한 세부 패턴을 포함합니다. 관련성이 있을 때만 스킬을 로드하면 컨텍스트 팽창이 줄어들고 코드 품질이 향상됩니다.
| 항목 | 가이드라인 | 스킬 |
|---|---|---|
| 로드 방식 | 처음부터 로드되어 항상 존재 | 필요할 때 관련성이 있으면 로드 |
| 범위 | 넓고 기초적 | 집중적이고 작업 특화 |
| 목적 | 핵심 규칙과 모범 사례 | 세부 구현 패턴 |
문서 API (Documentation API)
Laravel Boost에는 17,000개가 넘는 Laravel 전용 정보를 담은 방대한 지식 베이스에 AI 에이전트가 접근할 수 있게 해주는 Documentation API가 포함되어 있습니다. 이 API는 임베딩을 활용한 의미 기반 검색을 사용해 정확하고 문맥에 맞는 결과를 제공합니다.
Search Docs MCP 도구를 사용하면 에이전트가 설치된 패키지를 기준으로 문서를 가져오기 위해 Laravel 호스팅 문서 API 서비스를 조회할 수 있습니다. Boost의 AI 가이드라인과 스킬은 코딩 에이전트가 이 API를 사용하도록 자동으로 안내합니다.
| 패키지 | 지원 버전 |
|---|---|
| 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 확장하기 (Extending Boost)
Boost는 여러 인기 IDE 및 AI 에이전트와 기본으로 함께 작동합니다. 사용하는 코딩 도구가 아직 지원되지 않는다면 직접 에이전트를 만들고 Boost와 통합할 수 있습니다.
다른 IDE / AI 에이전트 지원 추가하기
새 IDE 또는 AI 에이전트를 지원하려면 Laravel\Boost\Install\Agents\Agent를 확장하는 클래스를 만들고, 필요한 기능에 따라 다음 계약 중 하나 이상을 구현하십시오.
Laravel\Boost\Contracts\SupportsGuidelines- AI 가이드라인 지원을 추가합니다.Laravel\Boost\Contracts\SupportsMcp- MCP 지원을 추가합니다.Laravel\Boost\Contracts\SupportsSkills- Agent Skills 지원을 추가합니다.
에이전트 작성하기
<?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...
}
구현 예시는 ClaudeCode.php를 참고하십시오.
에이전트 등록하기
애플리케이션의 App\Providers\AppServiceProvider에 있는 boot 메서드에서 커스텀 에이전트를 등록하십시오.
use Laravel\Boost\Boost;
public function boot(): void
{
Boost::registerAgent('customagent', CustomAgent::class);
}
등록이 완료되면 php artisan boost:install 실행 시 해당 에이전트를 선택할 수 있습니다.