메인 콘텐츠로 건너뛰기

시작하기

Laravel Boost는 AI 에이전트가 고품질 Laravel 애플리케이션을 Laravel 모범 사례에 따라 작성할 수 있도록 필요한 가이드라인과 Agent Skills를 제공하여 AI 지원 개발을 가속화하는 패키지입니다. Boost는 또한 1만 7,000건 이상의 Laravel 고유 정보를 포함한 지식 베이스와 임베딩을 이용한 의미적 검색을 조합한 강력한 Laravel 에코시스템 문서 API를 제공합니다. Boost는 Claude Code나 Cursor 등의 AI 에이전트에 대해 이 API를 활용해 최신 Laravel 기능이나 모범 사례를 학습하도록 지시합니다.

설치

Laravel Boost는 Composer로 설치합니다.
composer require laravel/boost --dev
다음으로 MCP 서버와 코딩 가이드라인을 설치합니다.
php artisan boost:install
boost:install 명령어는 설치 시 선택한 코딩 에이전트용의 관련 가이드라인과 스킬 파일을 생성합니다. 설치 완료 후에는 Cursor, Claude Code, 또는 선호하는 AI 에이전트를 사용해 코딩을 시작할 수 있습니다.
생성된 MCP 설정 파일(.mcp.json), 가이드라인 파일(CLAUDE.md, AGENTS.md, junie/ 등), 그리고 boost.json 설정 파일은 애플리케이션의 .gitignore에 추가해도 상관없습니다. 이 파일들은 boost:install이나 boost:update를 실행할 때 자동으로 재생성됩니다.

에이전트 설정

  1. 명령 팔레트를 엽니다(Cmd+Shift+P 또는 Ctrl+Shift+P)
  2. “/open MCP Settings”를 선택하고 Enter를 누릅니다
  3. laravel-boost의 토글을 켭니다

Boost 리소스 업데이트

설치되어 있는 Laravel 에코시스템 패키지의 최신 버전을 반영시키기 위해, 로컬의 Boost 리소스(AI 가이드라인과 스킬)를 정기적으로 업데이트하는 것을 권장합니다. boost:update Artisan 명령어를 사용하십시오.
php artisan boost:update
Composer의 post-update-cmd 스크립트에 추가해 자동화할 수도 있습니다.
{
  "scripts": {
    "post-update-cmd": [
      "@php artisan boost:update --ansi"
    ]
  }
}
기본적으로 boost:update 명령어는 애플리케이션 내에 이미 공개되어 있는 Boost 리소스만 업데이트합니다. 새로 설치된 패키지를 검출해 그 가이드라인과 스킬을 공개하도록 촉구하고 싶은 경우 --discover 옵션을 사용합니다.
php artisan boost:update --discover

MCP 서버

Laravel Boost는 MCP(Model Context Protocol) 서버를 제공하며, AI 에이전트가 Laravel 애플리케이션과 대화하기 위한 도구를 공개합니다. 이 도구들에 의해 에이전트는 애플리케이션의 구조를 조사하거나 데이터베이스에 질의하거나 코드를 실행할 수 있습니다.

사용 가능한 MCP 도구

도구 이름설명
Application InfoPHP와 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 서버를 등록하십시오.
항목
Commandphp
Argsartisan boost:mcp
JSON 형식의 기술 예시:
{
    "mcpServers": {
        "laravel-boost": {
            "command": "php",
            "args": ["artisan", "boost:mcp"]
        }
    }
}

AI 가이드라인

AI 가이드라인은 AI 에이전트에 Laravel 에코시스템 패키지에 관한 중요한 컨텍스트를 제공하기 위해 미리 읽어 들여지는 명령 파일입니다. 이 가이드라인에는 핵심 규약, 모범 사례, 프레임워크 고유의 패턴이 포함되어 있어 에이전트가 일관되게 고품질의 코드를 생성하는 데 도움이 됩니다.

사용 가능한 가이드라인

Laravel Boost에는 다음 패키지와 프레임워크용의 AI 가이드라인이 포함되어 있습니다. core 가이드라인은 버전에 관계없이 적용되는 범용적인 조언을 제공합니다.
패키지대응 버전
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
AI 가이드라인을 최신 상태로 유지하려면 Boost 리소스 업데이트를 참조하십시오.

커스텀 가이드라인 추가

독자적인 커스텀 AI 가이드라인을 Laravel Boost에 추가하려면 .blade.php 또는 .md 파일을 애플리케이션의 .ai/guidelines/* 디렉터리에 추가합니다. 이 파일들은 boost:install을 실행할 때 Laravel Boost의 가이드라인과 자동으로 결합됩니다.

Boost의 가이드라인 오버라이드

파일 경로가 일치하는 커스텀 가이드라인을 작성함으로써 Boost의 내장 가이드라인을 오버라이드할 수 있습니다. 기존의 Boost 가이드라인과 일치하는 경로에 커스텀 가이드라인을 작성하면, Boost는 내장 가이드라인 대신 커스텀 버전을 사용합니다. 예를 들어 Boost의 “Inertia React v2 Form Guidance” 가이드라인을 오버라이드하려면 .ai/guidelines/inertia-react/2/forms.blade.php에 파일을 작성합니다. boost:install을 실행하면 Boost는 기본 가이드라인 대신 커스텀 가이드라인을 사용합니다.

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

서드파티 패키지를 관리하고 있고 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-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
스킬을 최신 상태로 유지하려면 Boost 리소스 업데이트를 참조하십시오.

커스텀 스킬 작성

독자적인 커스텀 스킬을 작성하려면 SKILL.md 파일을 애플리케이션의 .ai/skills/{skill-name}/ 디렉터리에 추가합니다. 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의 스킬은 Agent Skills 포맷을 지원하며, YAML 프론트매터와 Markdown 지시를 포함하는 SKILL.md 파일을 저장한 폴더로서 구성되어야 합니다. SKILL.md 파일에는 필수 프론트매터(namedescription)를 포함시키고, 스크립트, 템플릿, 참조 자료를 옵션으로 포함시킬 수 있습니다.
---
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);

가이드라인과 스킬의 비교

Laravel Boost는 AI 에이전트에 애플리케이션에 관한 컨텍스트를 제공하기 위한 2가지의 서로 다른 방법을 제공합니다: 가이드라인스킬입니다. 가이드라인은 AI 에이전트 기동 시에 미리 읽혀지며, 코드베이스 전체에 널리 적용되는 Laravel의 규약과 모범 사례에 관한 중요한 컨텍스트를 제공합니다. 스킬은 특정 태스크에서 작업할 때 온디맨드로 활성화되며, 특정 도메인(Livewire 컴포넌트나 Pest 테스트 등)의 상세한 패턴을 포함합니다. 필요한 경우에만 스킬을 읽어 들임으로써 컨텍스트의 비대화를 억제하고 코드 품질을 향상시킵니다.
관점가이드라인스킬
읽기 타이밍미리, 항상 존재온디맨드, 관련 있는 경우만
스코프광범위, 기반적초점을 좁힌, 태스크 고유
목적핵심 규약과 모범 사례상세한 구현 패턴

문서 API

Laravel Boost에는 1만 7,000건 이상의 Laravel 고유 정보를 포함한 지식 베이스에의 접근을 AI 에이전트에 제공하는 문서 API가 포함되어 있습니다. 이 API는 임베딩을 사용한 의미적 검색을 사용해 정밀도 높은 컨텍스트 대응 결과를 제공합니다. Search Docs MCP 도구에 의해 에이전트는 설치된 패키지를 기반으로 Laravel의 호스트형 문서 API 서비스에 질의할 수 있습니다. Boost의 AI 가이드라인과 스킬이 코딩 에이전트에게 이 API를 사용하도록 자동으로 지시합니다.
패키지대응 버전
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 확장

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\AppServiceProviderboot 메서드에 등록합니다.
use Laravel\Boost\Boost;

public function boot(): void
{
    Boost::registerAgent('customagent', CustomAgent::class);
}
등록 후 php artisan boost:install을 실행할 때 에이전트가 선택지로 표시됩니다.
마지막 수정일 2026년 7월 13일