Laravel Boost

업데이트됨

번역일: 2026년 10월 18일

이 페이지는 원문이 업데이트되어 번역이 갱신되었습니다.

원문 수정: 2026년 10월 13일
번역 갱신: 2026년 10월 18일

Laravel Boost

소개
설치
- 에이전트 설정
- Boost 리소스 최신 상태 유지
MCP 서버
- 사용 가능한 MCP 도구
- MCP 서버 수동 등록
AI 가이드라인
에이전트 스킬
가이드라인과 스킬의 차이
프로젝트 규칙
문서 API
Boost 확장
- 다른 IDE 및 AI 에이전트 지원 추가

소개

Laravel Boost는 AI 에이전트가 Laravel 모범 사례를 따르는 고품질 애플리케이션을 작성하도록 핵심 가이드라인과 에이전트 스킬을 제공하여 AI 기반 개발을 빠르게 합니다.

또한 내장 MCP 도구와 17,000건 이상의 Laravel 관련 정보를 담은 지식 기반을 결합한 Laravel 생태계 문서 API를 제공합니다. 임베딩을 이용한 의미 기반 검색으로 맥락에 맞는 정확한 결과를 제공합니다. Boost는 Claude Code, Cursor 같은 AI 에이전트가 이 API로 최신 Laravel 기능과 모범 사례를 학습하도록 안내합니다.

설치

Composer로 Laravel Boost를 설치할 수 있습니다:

composer require laravel/boost --dev

이어서 MCP 서버와 코딩 가이드라인을 설치하세요:

php artisan boost:install

boost:install은 설치 과정에서 선택한 코딩 에이전트를 위한 가이드라인과 스킬 파일을 생성합니다. CLAUDE.md나 AGENTS.md 같은 가이드라인 파일이 이미 있다면 <laravel-boost-guidelines> 블록 안의 내용만 교체하므로 블록 밖에 작성한 내용은 유지됩니다.

설치가 완료되면 Cursor, Claude Code 또는 원하는 AI 에이전트로 코딩을 시작할 수 있습니다.

NOTE

생성된 MCP 설정 파일(.mcp.json), 가이드라인 파일(CLAUDE.md, AGENTS.md, junie/ 등), boost.json 설정 파일은 애플리케이션의 .gitignore에 추가해도 됩니다. boost:install과 boost:update를 실행하면 자동으로 다시 생성됩니다.

에이전트 설정

Cursor

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

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

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"

GitHub Copilot (VS Code)

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"

Junie

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"
    ]
  }
}

기본적으로 boost:update는 새로 설치한 패키지를 검색하고 해당 가이드라인과 스킬을 게시할지 묻습니다. Composer 스크립트처럼 비대화형으로 실행하면 이 질문을 생략합니다. 이미 애플리케이션에 게시된 기존 Boost 리소스만 업데이트하려면 --no-discover를 사용하세요:

php artisan boost:update --no-discover

MCP 서버

Laravel Boost는 AI 에이전트가 Laravel 애플리케이션과 상호작용할 도구를 제공하는 MCP(Model Context Protocol) 서버를 제공합니다. 애플리케이션 구조 확인, 데이터베이스 쿼리, 코드 실행 등을 수행할 수 있습니다.

사용 가능한 MCP 도구

이름	설명
Application Info	PHP·Laravel 버전, DB 엔진, 생태계 패키지와 버전 목록, Eloquent 모델 조회
Browser Logs	브라우저 로그와 오류 조회
Database Connections	기본 연결을 포함한 사용 가능한 DB 연결 확인
Database Query	데이터베이스에 쿼리 실행
Database Schema	데이터베이스 스키마 조회
Get Absolute URL	에이전트가 유효한 URL을 생성하도록 상대 경로 URI를 절대 URI로 변환
Last Error	애플리케이션 로그 파일의 마지막 오류 조회
Read Log Entries	최근 N개의 로그 항목 조회
Record Rule	이후 에이전트가 이어받도록 지속적인 프로젝트 규칙을 `.ai/rules`에 기록
Search Docs	설치된 패키지에 맞는 문서를 가져오도록 Laravel 호스팅 문서 API에 질의

MCP 서버 수동 등록

사용하는 편집기에 Laravel Boost MCP 서버를 직접 등록해야 할 수도 있습니다. 다음 정보를 사용하세요:

명령	`php`
인수	`artisan boost:mcp`

JSON 예제:

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

AI 가이드라인

AI 가이드라인은 AI 에이전트에 Laravel 생태계 패키지의 핵심 맥락을 제공하기 위해 처음부터 불러오는, 조합 가능한 지침 파일입니다. 핵심 관례, 모범 사례, 프레임워크별 패턴을 담아 에이전트가 일관된 고품질 코드를 생성하도록 돕습니다.

사용 가능한 AI 가이드라인

Laravel Boost에는 다음 패키지와 프레임워크를 위한 AI 가이드라인이 포함됩니다. core 가이드라인은 해당 패키지의 모든 버전에 적용되는 일반적인 조언을 AI에 제공합니다.

패키지	지원 버전
Core & Boost	core
Laravel Framework	core, 10.x, 11.x, 12.x, 13.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	조건부

참고: 가이드라인을 최신 상태로 유지하려면 Boost 리소스 최신 상태 유지를 참고하세요.

사용자 정의 AI 가이드라인 추가

애플리케이션의 .ai/guidelines/* 디렉터리에 .blade.php 또는 .md 파일을 추가하면 사용자 정의 AI 가이드라인으로 Boost를 보완할 수 있습니다. boost:install을 실행하면 Boost 가이드라인에 자동으로 포함됩니다.

Boost AI 가이드라인 재정의

내장 가이드라인과 같은 파일 경로에 사용자 정의 가이드라인을 생성하면 내장 버전 대신 사용자 정의 버전을 사용합니다.

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

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

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

가이드라인에는 패키지의 역할을 짧게 소개하고 필요한 파일 구조와 관례를 정리하며 주요 기능을 만들거나 사용하는 방법을 명령이나 코드 예제와 함께 설명하세요. 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는 특정 분야의 작업을 할 때 필요에 따라 활성화하는 가볍고 목적이 명확한 지식 모듈입니다. 처음부터 불러오는 가이드라인과 달리, 관련이 있을 때만 상세 패턴과 모범 사례를 불러와 컨텍스트의 불필요한 증가를 줄이고 생성 코드의 관련성을 높입니다.

boost:install 실행 시 스킬 기능을 선택하면 composer.json에서 감지된 패키지를 기준으로 스킬이 자동 설치됩니다. 예를 들어 livewire/livewire가 있으면 livewire-development가 설치됩니다. infer-conventions처럼 Boost 자체에 포함된 스킬은 설치된 패키지와 관계없이 설치됩니다.

사용 가능한 스킬

스킬	패키지
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

참고: 스킬을 최신 상태로 유지하려면 Boost 리소스 최신 상태 유지를 참고하세요.

사용자 정의 스킬

애플리케이션의 .ai/skills/{skill-name}/에 SKILL.md를 추가하면 사용자 정의 스킬을 만들 수 있습니다. boost:update를 실행하면 내장 스킬과 함께 설치됩니다.

예를 들어 애플리케이션의 도메인 로직용 스킬은 다음 위치에 만들 수 있습니다:

.ai/skills/creating-invoices/SKILL.md

스킬 재정의

내장 스킬과 같은 이름으로 사용자 정의 스킬을 생성하면 내장 버전 대신 사용자 정의 버전을 사용합니다.

예를 들어 livewire-development를 재정의하려면 .ai/skills/livewire-development/SKILL.md를 생성하세요. boost:update를 실행하면 기본 스킬 대신 사용자 정의 스킬이 포함됩니다.

서드파티 패키지 스킬

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

Boost 스킬은 Agent Skills 형식을 지원합니다. YAML 프런트매터와 Markdown 지침이 있는 SKILL.md를 포함하는 폴더로 구성하세요. 필수 프런트매터 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);

가이드라인과 스킬의 차이

Laravel Boost는 애플리케이션의 맥락을 AI 에이전트에 전달하는 가이드라인과 스킬 두 가지 방식을 제공합니다.

가이드라인은 AI 에이전트 시작 시 처음부터 불러와 코드베이스 전반에 적용되는 Laravel 관례와 모범 사례의 핵심 맥락을 제공합니다.

스킬은 Livewire 컴포넌트나 Pest 테스트 같은 특정 작업에 필요한 상세 패턴을 담고 있으며 필요할 때 활성화됩니다. 관련이 있을 때만 불러오므로 컨텍스트의 불필요한 증가를 줄이고 코드 품질을 높입니다.

항목	가이드라인	스킬
로딩	처음부터 항상 포함	관련 작업 시 필요에 따라
범위	폭넓은 기본 사항	특정 작업에 집중
목적	핵심 관례와 모범 사례	상세 구현 패턴

가이드라인과 스킬은 모두 Laravel 생태계를 설명합니다. 애플리케이션 자체의 관례는 프로젝트 규칙으로 기록하세요.

프로젝트 규칙

가이드라인과 스킬이 Laravel 작성법을 가르친다면 프로젝트 규칙은 해당 애플리케이션의 작성법을 알려줍니다. 매 세션마다 다시 설명해야 할 다음과 같은 내용을 규칙으로 만들 수 있습니다:

개발 중 사용자, 에이전트, 팀원이 내린 결정
에이전트가 따르기 어려워하는 스타일 가이드와 선호 사항
주변 코드만으로 추론할 수 없는 함정과 제약

규칙은 애플리케이션의 .ai/rules에 Markdown 파일로 저장하며 소스 관리에 커밋해야 합니다. 개인적이고 세션 범위에 한정된 에이전트 자체 메모리와 달리 팀과 애플리케이션에서 작업하는 모든 에이전트가 공유합니다.

각 규칙 파일의 프런트매터에는 적용할 파일 glob을 선언합니다:

---
paths:
  - app/Http/Controllers/**
---

# Http Controllers

## Extend BaseController for tenant scoping

All controllers must extend `App\Http\Controllers\BaseController`, which applies the
current tenant's query scope. Extending Laravel's base controller directly will leak
data across tenants.

Boost는 glob과 규칙 파일을 연결하는 .ai/rules/index.md도 관리합니다. 에이전트는 파일을 계획하거나 수정하기 전에 이 인덱스를 확인하도록 안내받으므로 관련 규칙만 불러옵니다:

# Project Rules Index

Before planning or editing, find the row whose globs match the file's path and read that rule file.

| Applies to | Rule file |
| --- | --- |
| app/Http/Controllers/** | .ai/rules/controllers.md |
| app/Models/** | .ai/rules/models.md |

NOTE

.mcp.json 및 생성된 가이드라인 파일과 달리 .ai/rules는 팀과 규칙을 공유하도록 소스 관리에 커밋해야 합니다.

규칙 기록

에이전트에 기억해 달라고 요청하면 규칙을 기록할 수 있습니다:

Remember that all money values are stored as integer cents, never as floats.

에이전트는 glob, 짧은 title, note를 담아 Boost의 record-rule MCP 도구를 호출합니다. Boost는 해당 영역에 규칙을 기록하고, 필요하면 규칙 파일을 생성한 뒤 인덱스를 갱신합니다.

규칙 파일을 직접 만들기보다 항상 record-rule 도구로 기록하세요. Boost는 규칙을 기록할 때 .ai/rules/index.md를 다시 생성하며, 에이전트는 이 인덱스로 작업 파일에 적용되는 규칙을 찾습니다. 직접 추가한 파일은 인덱스가 다음에 다시 생성될 때까지 발견되지 않습니다.

애플리케이션 관례 추론

앞으로 생기는 규칙은 하나씩 기록하면 되지만 기존 애플리케이션에는 이미 오랜 관례가 쌓여 있습니다. infer-conventions 스킬은 작성된 코드를 바탕으로 규칙을 초기 구성합니다. 에이전트에 해당 스킬 사용을 요청하세요:

Use the infer-conventions skill

스킬은 검증, 컨트롤러, 인가, 모델, 아키텍처, 테스트, 프런트엔드, 데이터베이스, 콘솔 등 Laravel 관례 체크리스트를 따라 애플리케이션을 살펴봅니다. 이후 기본 클래스, 공용 트레이트, 모듈 구조 같은 패턴을 추가로 탐색합니다.

코드가 해야 할 일이 아니라 실제 하는 일을 문서화합니다. 충분한 근거가 있는 비기본 관례만 기록하고 프레임워크 기본값이나 Pint·Rector가 이미 강제하는 내용은 제외하며, 혼재된 패턴은 규칙으로 기록하지 않고 보고합니다. 규칙을 쓰기 전에 발견한 관례와 근거를 제시하여 승인을 받습니다. 확인 없이 모든 관례를 기록하도록 하려면 스킬에 "yolo"라고 지시할 수 있습니다.

프로젝트 규칙 비활성화

프로젝트 규칙은 기본 활성화됩니다. 완전히 비활성화하려면 다음 환경 변수를 정의하세요. record-rule MCP 도구가 제거되고 Boost가 .ai/rules를 관리하지 않게 됩니다:

BOOST_RULES_ENABLED=false

문서 API

Laravel Boost의 문서 API는 AI 에이전트가 17,000건 이상의 Laravel 관련 정보가 담긴 지식 기반에 접근하도록 합니다. 임베딩을 사용하는 의미 기반 검색으로 맥락에 맞는 정확한 결과를 제공합니다.

Search Docs MCP 도구는 설치된 패키지에 맞는 문서를 가져오도록 Laravel 호스팅 문서 API에 질의합니다. Boost의 가이드라인과 스킬이 코딩 에이전트에 이 API 사용을 자동 안내합니다.

패키지	지원 버전
Laravel Framework	10.x, 11.x, 12.x, 13.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 에이전트를 기본 지원합니다. 사용 중인 코딩 도구가 아직 지원되지 않는다면 직접 에이전트를 만들어 통합할 수 있습니다.

다른 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
{
    // 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 실행 시 선택할 수 있습니다.