Laravel Boost
업데이트됨번역일: 2026년 9월 17일
이 페이지는 원문이 업데이트되어 번역이 갱신되었습니다.
- 원문 수정
- 2026년 9월 17일
- 번역 갱신
- 2026년 9월 17일
Laravel Boost
소개
Laravel Boost는 AI 에이전트가 Laravel 모범 사례를 준수하는 고품질 애플리케이션을 작성하도록 돕는 필수 가이드라인과 에이전트 스킬을 제공하여, AI 기반 개발을 가속화합니다.
또한 Boost는 강력한 Laravel 생태계 문서 API를 제공합니다. 이 API는 내장 MCP 도구와 17,000개가 넘는 Laravel 관련 정보를 담은 방대한 지식 베이스를 결합하고 있으며, 임베딩 기반 시맨틱 검색을 활용해 정확하고 문맥에 맞는 검색 결과를 제공합니다. Boost는 Claude Code, Cursor 같은 AI 에이전트가 이 API를 활용해 최신 Laravel 기능과 모범 사례를 학습하도록 안내합니다.
NOTE
Boost를 "AI가 대신 코딩해주는 도구"로 오해하기 쉽지만, 정확히는 AI 에이전트에게 "Laravel다운 코드"를 작성하는 방법을 알려주는 지식 계층에 가깝습니다. 실제 코드 작성은 여러분이 사용하는 Cursor, Claude Code 같은 에이전트가 담당합니다.
설치
Laravel Boost는 Composer를 통해 설치할 수 있습니다.
composer require laravel/boost --dev다음으로 MCP 서버와 코딩 가이드라인을 설치합니다.
php artisan boost:installboost:install 명령어는 설치 과정에서 선택한 코딩 에이전트에 맞는 에이전트 가이드라인 및 스킬 파일을 생성합니다.
Laravel Boost 설치가 끝나면, 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:mcpCodex
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:mcpGitHub 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:updateComposer의 post-update-cmd 스크립트에 추가해서 이 과정을 자동화할 수도 있습니다.
{
"scripts": {
"post-update-cmd": [
"@php artisan boost:update --ansi"
]
}
}기본적으로 boost:update 명령어는 애플리케이션에 이미 게시된 기존 Boost 리소스만 업데이트합니다. 애플리케이션에서 새로 설치된 패키지를 스캔해 해당 패키지의 가이드라인과 스킬을 게시할지 물어보게 하려면 --discover 옵션을 사용하세요.
php artisan boost:update --discoverMCP 서버
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을 생성하도록 돕습니다 |
| Last Error | 애플리케이션 로그 파일에서 가장 최근의 에러를 읽어옵니다 |
| Read Log Entries | 최근 N개의 로그 항목을 읽어옵니다 |
| Record Rule | 프로젝트 규칙을 .ai/rules에 영구적으로 기록해 이후 에이전트도 이를 이어받도록 합니다 |
| 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, 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 | 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가 사용자를 위해 정확한 코드를 생성할 수 있도록, 간결하고 실행 가능하며 모범 사례에 집중한 내용으로 작성하세요. 예시는 다음과 같습니다.
## 패키지 이름
이 패키지는 [기능에 대한 간단한 설명]을 제공합니다.
### 기능
- 기능 1: [명확하고 짧은 설명].
- 기능 2: [명확하고 짧은 설명]. 사용 예시:
@verbatim
<code-snippet name="기능 2 사용 방법" lang="php">
$result = PackageName::featureTwo($param1, $param2);
</code-snippet>
@endverbatim에이전트 스킬
에이전트 스킬(Agent Skills)은 에이전트가 특정 작업 영역에서 필요할 때만 활성화하는, 가볍고 목적이 명확한 지식 모듈입니다. 처음부터 전부 로드되는 가이드라인과 달리, 스킬은 관련이 있을 때만 상세한 패턴과 모범 사례를 불러오므로 불필요한 컨텍스트를 줄이고 AI가 생성하는 코드의 관련성을 높여줍니다.
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를 실행하면 커스텀 스킬이 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 파일에는 필수 프론트매터(name, description)가 반드시 포함되어야 하며, 선택적으로 스크립트, 템플릿, 참고 자료를 추가할 수 있습니다.
스킬에는 필요한 파일 구조나 컨벤션을 명시하고, 주요 기능을 생성하거나 사용하는 방법(예시 명령어나 코드 스니펫 포함)을 설명해야 합니다. AI가 사용자를 위해 정확한 코드를 생성할 수 있도록, 간결하고 실행 가능하며 모범 사례에 집중한 내용으로 작성하세요.
---
name: package-name-development
description: PackageName의 컴포넌트와 워크플로우 등 관련 기능을 구현하고 다룰 때 사용합니다.
---
# 패키지 이름 개발 가이드
## 언제 이 스킬을 사용하나요
PackageName 관련 기능을 작업할 때 이 스킬을 사용하세요...
## 기능
- 기능 1: [명확하고 짧은 설명].
- 기능 2: [명확하고 짧은 설명]. 사용 예시:
$result = PackageName::featureTwo($param1, $param2);가이드라인 vs. 스킬
Laravel Boost는 AI 에이전트에게 애플리케이션에 대한 문맥을 제공하는 두 가지 방식, 즉 가이드라인과 스킬을 제공합니다.
가이드라인은 AI 에이전트가 시작할 때 미리 로드되며, 코드베이스 전반에 폭넓게 적용되는 Laravel 컨벤션과 모범 사례에 대한 필수 문맥을 제공합니다.
스킬은 특정 작업을 수행할 때만 활성화되며, Livewire 컴포넌트나 Pest 테스트 작성처럼 특정 영역에 대한 상세한 패턴을 담고 있습니다. 필요할 때만 스킬을 로드하기 때문에 불필요한 컨텍스트를 줄이고 코드 품질을 높일 수 있습니다.
| 구분 | 가이드라인 | 스킬 |
|---|---|---|
| 로드 시점 | 시작 시 항상 로드됨 | 필요할 때만 로드됨 |
| 범위 | 넓고 기초적인 범위 | 특정 작업에 집중된 범위 |
| 목적 | 핵심 컨벤션 및 모범 사례 | 상세한 구현 패턴 |
가이드라인과 스킬 모두 Laravel 생태계 자체를 설명하는 자료입니다. 반면 여러분의 애플리케이션이 가진 고유한 컨벤션을 담아내려면 프로젝트 규칙을 사용해야 합니다.
프로젝트 규칙
가이드라인과 스킬이 에이전트에게 "Laravel을 어떻게 작성하는지"를 가르쳐준다면, 프로젝트 규칙은 "여러분의 애플리케이션을 어떻게 작성하는지"를 가르쳐줍니다. 규칙이란 새로운 세션이 시작될 때마다 매번 다시 설명해야 했던 모든 것을 의미합니다.
- 여러분, 에이전트, 혹은 팀원이 진행하면서 내린 결정 사항.
- 에이전트가 지키게 만들기 어려운 스타일 가이드나 선호 사항.
- 주변 코드만 봐서는 유추할 수 없는 함정이나 제약 조건.
규칙은 애플리케이션의 .ai/rules 디렉터리 안에 Markdown 파일로 저장되며, 소스 관리에 커밋되어야 합니다. 개인적이고 세션에 한정된 에이전트의 자체 메모리와 달리, 규칙은 팀 전체 그리고 애플리케이션을 작업하는 모든 에이전트와 공유됩니다.
각 규칙 파일은 프론트매터에 자신이 적용되는 파일 글롭(glob) 패턴을 선언합니다.
---
paths:
- app/Http/Controllers/**
---
# Http 컨트롤러
## 테넌트 스코핑을 위해 BaseController를 상속하세요
모든 컨트롤러는 현재 테넌트의 쿼리 스코프를 적용하는 `App\Http\Controllers\BaseController`를
상속해야 합니다. Laravel의 기본 컨트롤러를 직접 상속하면 테넌트 간 데이터가 유출될 수 있습니다.이와 함께 Boost는 글롭 패턴과 규칙 파일을 매핑한 .ai/rules/index.md 파일을 관리합니다. 에이전트는 파일을 계획하거나 수정하기 전에 반드시 이 인덱스를 참고하도록 안내받으며, 이 덕분에 관련 있는 규칙만 로드됩니다.
# 프로젝트 규칙 인덱스
계획을 세우거나 파일을 수정하기 전에, 해당 파일 경로와 일치하는 글롭 패턴의 행을 찾아 해당 규칙 파일을 읽으세요.
| 적용 대상 | 규칙 파일 |
| --- | --- |
| app/Http/Controllers/** | .ai/rules/controllers.md |
| app/Models/** | .ai/rules/models.md |NOTE
.mcp.json이나 자동 생성되는 가이드라인 파일과 달리, .ai/rules 디렉터리는 팀과 규칙을 공유할 수 있도록 소스 관리에 커밋해야 합니다.
규칙 기록하기
규칙을 기록하려면 에이전트에게 그냥 기억해 달라고 요청하면 됩니다.
금액 값은 항상 정수형 센트 단위로 저장하고, 절대 float으로 저장하지 않는다는 걸 기억해줘.그러면 에이전트는 glob, 짧은 title, note를 담아 Boost의 record-rule MCP 도구를 호출합니다. Boost는 이 규칙을 해당하는 영역의 규칙 파일에 저장하고(필요하면 새 파일을 생성), 인덱스를 갱신합니다.
규칙 파일을 직접 손으로 만드는 대신, 항상 record-rule 도구를 통해 규칙을 기록해야 합니다. Boost는 규칙을 기록할 때마다 .ai/rules/index.md를 다시 생성하며, 에이전트는 이 인덱스를 참고해 자신이 작업 중인 파일에 어떤 규칙이 적용되는지 찾습니다. 수동으로 추가한 규칙 파일은 인덱스가 다음번에 다시 생성되기 전까지는 발견되지 않습니다.
애플리케이션의 컨벤션 추론하기
앞으로는 규칙을 하나씩 기록해 나가면 되지만, 이미 몇 년간 운영된 기존 애플리케이션에는 이미 축적된 컨벤션이 많습니다. infer-conventions 스킬은 여러분이 이미 작성해 둔 코드를 바탕으로 규칙 초안을 자동으로 만들어 줍니다. 시작하려면 에이전트에게 이 스킬을 사용하도록 요청하세요.
infer-conventions 스킬을 사용해줘이 스킬은 유효성 검증, 컨트롤러, 인가, 모델, 아키텍처, 테스트, 프론트엔드, 데이터베이스, 콘솔 등 Laravel 컨벤션의 여러 영역에 대한 체크리스트를 기준으로 애플리케이션 전체를 훑어본 다음, 베이스 클래스나 공유 트레이트, 모듈 구조 같은 패턴을 찾기 위한 개방형 탐색을 이어갑니다.
이 스킬은 코드가 "어떻게 되어야 하는지"가 아니라 "실제로 어떻게 동작하는지"를 문서화합니다. 충분한 근거가 있고 기본값과 다른 컨벤션만 기록하며, 프레임워크 기본값이나 Pint·Rector가 이미 강제하는 규칙은 건너뜁니다. 그리고 정말로 일관성 없이 뒤섞인 패턴이 발견되면 규칙으로 기록하는 대신 그 사실을 보고합니다. 규칙을 작성하기 전에 이 스킬은 발견한 각 컨벤션을 근거 자료와 함께 제시하고 여러분의 승인을 받습니다. 확인 절차 없이 발견된 모든 컨벤션을 바로 기록하게 하고 싶다면 "yolo"라고 말하면 됩니다.
프로젝트 규칙 비활성화하기
프로젝트 규칙 기능은 기본적으로 활성화되어 있습니다. 완전히 비활성화하려면 다음 환경 변수를 정의하세요. 이렇게 하면 record-rule MCP 도구가 제거되고 Boost가 .ai/rules 디렉터리를 관리하지 않습니다.
BOOST_RULES_ENABLED=false문서 API
Laravel Boost는 17,000개가 넘는 Laravel 관련 정보를 담은 방대한 지식 베이스에 AI 에이전트가 접근할 수 있도록 문서 API를 제공합니다. 이 API는 임베딩 기반 시맨틱 검색을 사용해 정확하고 문맥에 맞는 결과를 제공합니다.
Search Docs MCP 도구를 사용하면 에이전트가 설치된 패키지를 기준으로 Laravel 호스팅 문서 API 서비스에서 문서를 조회할 수 있습니다. Boost의 AI 가이드라인과 스킬은 코딩 에이전트가 이 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 에이전트를 기본적으로 지원합니다. 만약 사용 중인 코딩 도구가 아직 지원되지 않는다면, 직접 에이전트를 만들어 Boost와 통합할 수 있습니다.
다른 IDE / AI 에이전트 지원 추가하기
새로운 IDE나 AI 에이전트를 지원하려면, Laravel\Boost\Install\Agents\Agent를 상속하는 클래스를 만들고 필요에 따라 다음 계약(contract) 중 하나 이상을 구현하세요.
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 실행 시 목록에서 여러분의 에이전트를 선택할 수 있습니다.