Laravel Boost

번역일: 2026년 6월 25일

Laravel Boost

소개
설치
- Boost 리소스 최신 상태 유지
- 에이전트 설정
MCP 서버
- 사용 가능한 MCP 도구
- MCP 서버 수동 등록
AI 가이드라인
에이전트 스킬
가이드라인 vs. 스킬
문서 API
Boost 확장
- 다른 IDE / AI 에이전트 지원 추가

소개

Laravel Boost는 AI 보조 개발을 가속화하는 패키지입니다. AI 에이전트가 Laravel 모범 사례에 부합하는 고품질 코드를 작성할 수 있도록 필수 가이드라인과 에이전트 스킬을 제공합니다.

Boost는 강력한 Laravel 생태계 문서 API도 함께 제공합니다. 이 API는 내장 MCP 도구와 17,000개 이상의 Laravel 특화 정보로 구성된 방대한 지식 베이스를 결합하며, 임베딩 기반 시맨틱 검색으로 정확하고 맥락에 맞는 결과를 제공합니다. Boost는 Claude Code, Cursor 같은 AI 에이전트가 이 API를 활용해 최신 Laravel 기능과 모범 사례를 학습하도록 안내합니다.

설치

Composer를 통해 Laravel Boost를 설치합니다:

composer require laravel/boost --dev

이어서 MCP 서버와 코딩 가이드라인을 설치합니다:

php artisan boost:install

boost:install 명령은 설치 과정에서 선택한 코딩 에이전트에 맞는 가이드라인 및 스킬 파일을 생성합니다.

설치가 완료되면 Cursor, Claude Code, 또는 원하는 AI 에이전트와 함께 개발을 시작할 수 있습니다.

NOTE

생성된 MCP 설정 파일(.mcp.json), 가이드라인 파일(CLAUDE.md, AGENTS.md, junie/ 등), boost.json 설정 파일은 .gitignore에 추가해도 무방합니다. 이 파일들은 boost:install 및 boost:update 실행 시 자동으로 재생성됩니다.

에이전트 설정

Cursor

1. 커맨드 팔레트를 엽니다 (`Cmd+Shift+P` 또는 `Ctrl+Shift+P`)
2. "/open MCP Settings"를 검색한 뒤 `Enter`를 누릅니다
3. `laravel-boost` 항목의 토글을 켭니다

Claude Code

Claude Code는 일반적으로 자동으로 활성화됩니다. 활성화되지 않은 경우 프로젝트 디렉터리에서 셸을 열고 다음 명령을 실행하세요:

claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp

Codex

Codex는 일반적으로 자동으로 활성화됩니다. 활성화되지 않은 경우 프로젝트 디렉터리에서 셸을 열고 다음 명령을 실행하세요:

codex mcp add laravel-boost -- php "artisan" "boost:mcp"

Gemini CLI

Gemini CLI는 일반적으로 자동으로 활성화됩니다. 활성화되지 않은 경우 프로젝트 디렉터리에서 셸을 열고 다음 명령을 실행하세요:

gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp

GitHub Copilot (VS Code)

1. 커맨드 팔레트를 엽니다 (`Cmd+Shift+P` 또는 `Ctrl+Shift+P`)
2. "MCP: List Servers"를 검색한 뒤 `Enter`를 누릅니다
3. `laravel-boost`로 이동한 뒤 `Enter`를 누릅니다
4. "Start server"를 선택합니다

Junie

1. `Shift`를 두 번 눌러 커맨드 팔레트를 엽니다
2. "MCP Settings"를 검색한 뒤 `Enter`를 누릅니다
3. `laravel-boost` 옆의 체크박스를 선택합니다
4. 오른쪽 하단의 "Apply"를 클릭합니다

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 서버

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	상대 경로 URI를 절대 URL로 변환하여 에이전트가 유효한 URL을 생성하도록 지원
Last Error	애플리케이션 로그 파일에서 마지막 오류 읽기
Read Log Entries	마지막 N개의 로그 항목 읽기
Search Docs	설치된 패키지를 기반으로 Laravel 공식 문서 API를 조회하여 관련 문서 검색

MCP 서버 수동 등록

경우에 따라 사용하는 에디터에 Laravel Boost MCP 서버를 수동으로 등록해야 할 수 있습니다. 다음 정보를 사용하여 MCP 서버를 등록하세요:

Command	`php`
Args	`artisan boost:mcp`

JSON 예시:

{
    "mcpServers": {
        "laravel-boost": {
            "command": "php",
            "args": ["artisan", "boost:mcp"]
        }
    }
}

AI 가이드라인

AI 가이드라인은 조합 가능한 명령 파일로, AI 에이전트가 시작될 때 미리 로드되어 Laravel 생태계 패키지에 대한 핵심 맥락을 제공합니다. 이 가이드라인에는 핵심 관례, 모범 사례, 프레임워크별 패턴이 담겨 있어 에이전트가 일관되고 품질 높은 코드를 생성하도록 돕습니다.

사용 가능한 AI 가이드라인

Laravel Boost는 다음 패키지 및 프레임워크에 대한 AI 가이드라인을 제공합니다. core 가이드라인은 해당 패키지의 모든 버전에 적용되는 일반적인 지침을 제공합니다.

패키지	지원 버전
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

참고: AI 가이드라인을 최신 상태로 유지하는 방법은 Boost 리소스 최신 상태 유지 섹션을 참고하세요.

커스텀 AI 가이드라인 추가

나만의 AI 가이드라인을 추가하려면 애플리케이션의 .ai/guidelines/* 디렉터리에 .blade.php 또는 .md 파일을 추가하세요. 이 파일들은 boost:install 실행 시 Boost의 기본 가이드라인과 함께 자동으로 포함됩니다.

Boost AI 가이드라인 재정의

동일한 파일 경로를 가진 커스텀 가이드라인을 생성하면 Boost의 내장 가이드라인을 재정의할 수 있습니다. 커스텀 가이드라인의 경로가 기존 Boost 가이드라인 경로와 일치하면, Boost는 내장 버전 대신 커스텀 버전을 사용합니다.

예를 들어 Boost의 "Inertia React v2 Form Guidance" 가이드라인을 재정의하려면 .ai/guidelines/inertia-react/2/forms.blade.php 파일을 생성하세요. boost:install 실행 시 Boost가 기본 가이드라인 대신 커스텀 가이드라인을 포함합니다.

서드파티 패키지 AI 가이드라인

서드파티 패키지를 관리하는 경우 패키지에 resources/boost/guidelines/core.blade.php 파일을 추가하면 Boost가 해당 가이드라인을 자동으로 포함합니다. 패키지 사용자가 php artisan boost:install을 실행하면 Boost가 이 가이드라인을 자동으로 로드합니다.

AI 가이드라인에는 패키지 기능에 대한 간략한 개요, 필요한 파일 구조나 관례, 주요 기능의 생성 및 사용 방법(명령 또는 코드 예시 포함)을 담아야 합니다. AI가 올바른 코드를 생성할 수 있도록 간결하고 실용적으로 작성하고 모범 사례에 집중하세요. 예시는 다음과 같습니다:

## 패키지 이름

이 패키지는 [기능에 대한 간략한 설명]을 제공합니다.

### 기능

- 기능 1: [간결하고 명확한 설명].
- 기능 2: [간결하고 명확한 설명]. 사용 예시:

@verbatim
<code-snippet name="기능 2 사용 방법" lang="php">
$result = PackageName::featureTwo($param1, $param2);
</code-snippet>
@endverbatim

에이전트 스킬

에이전트 스킬은 특정 도메인 작업 시 에이전트가 필요에 따라 활성화할 수 있는 가볍고 목적에 맞는 지식 모듈입니다. 가이드라인이 처음부터 모두 로드되는 것과 달리, 스킬은 관련 작업을 수행할 때만 로드되므로 컨텍스트 비대화를 방지하고 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가 기본 스킬 대신 커스텀 스킬을 포함합니다.

서드파티 패키지 스킬

서드파티 패키지를 관리하는 경우 패키지에 resources/boost/skills/{skill-name}/SKILL.md 파일을 추가하면 Boost가 해당 스킬을 자동으로 포함합니다. 패키지 사용자가 php artisan boost:install을 실행하면 사용자 선택에 따라 스킬이 자동으로 설치됩니다.

Boost 스킬은 Agent Skills 형식을 따르며, YAML 프런트매터와 Markdown 지침이 담긴 SKILL.md 파일을 포함하는 폴더 구조로 작성해야 합니다. SKILL.md 파일에는 필수 프런트매터(name, description)가 반드시 포함되어야 하며, 스크립트, 템플릿, 참고 자료를 선택적으로 추가할 수 있습니다.

스킬에는 필요한 파일 구조나 관례, 주요 기능의 생성 및 사용 방법(명령 또는 코드 예시 포함)을 담아야 합니다. AI가 올바른 코드를 생성할 수 있도록 간결하고 실용적으로 작성하고 모범 사례에 집중하세요:

---
name: package-name-development
description: PackageName의 컴포넌트 및 워크플로우를 포함한 기능을 빌드하고 활용합니다.
---

# Package Name Development

## 이 스킬을 사용하는 경우
PackageName 기능 작업 시 이 스킬을 사용하세요...

## 기능

- 기능 1: [간결하고 명확한 설명].
- 기능 2: [간결하고 명확한 설명]. 사용 예시:

$result = PackageName::featureTwo($param1, $param2);

가이드라인 vs. 스킬

Laravel Boost는 AI 에이전트에게 컨텍스트를 제공하는 두 가지 방식인 가이드라인과 스킬을 제공합니다.

가이드라인은 AI 에이전트가 시작될 때 미리 로드되어, 코드베이스 전반에 걸쳐 폭넓게 적용되는 Laravel 관례와 모범 사례에 대한 핵심 컨텍스트를 제공합니다.

스킬은 특정 작업을 수행할 때 필요에 따라 활성화되며, Livewire 컴포넌트나 Pest 테스트 같은 특정 도메인에 대한 세부 패턴을 담고 있습니다. 관련 작업 시에만 스킬을 로드하므로 컨텍스트 비대화를 막고 코드 품질을 높일 수 있습니다.

항목	가이드라인	스킬
로드 시점	시작 시 항상 로드	필요할 때 온디맨드 로드
범위	광범위하고 기초적	집중적이고 작업 특화적
목적	핵심 관례 및 모범 사례	세부 구현 패턴

문서 API

Laravel Boost는 AI 에이전트가 17,000개 이상의 Laravel 특화 정보로 구성된 방대한 지식 베이스에 접근할 수 있는 문서 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 확장

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 - 에이전트 스킬 지원 추가

에이전트 작성

<?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
{
    // 구현 내용을 작성하세요...
}

구현 예시는 ClaudeCode.php를 참고하세요.

에이전트 등록

애플리케이션의 App\Providers\AppServiceProvider의 boot 메서드에서 커스텀 에이전트를 등록합니다:

use Laravel\Boost\Boost;

public function boot(): void
{
    Boost::registerAgent('customagent', CustomAgent::class);
}

등록이 완료되면 php artisan boost:install 실행 시 해당 에이전트를 선택할 수 있습니다.