> LARAVEL 13.x DOCS

Giao diện

Laravel Boost ​

Giới thiệu (Introduction) ​

Laravel Boost tăng tốc phát triển với AI bằng cách cung cấp các guideline và agent skill thiết yếu giúp AI agent viết ứng dụng Laravel chất lượng cao, tuân thủ best practices.

Boost cũng cung cấp Documentation API mạnh mẽ — kết hợp MCP tool tích hợp với kho kiến thức chứa hơn 17.000 mẩu thông tin Laravel, tất cả được tăng cường bằng semantic search với embedding cho kết quả chính xác, phù hợp ngữ cảnh.

Cài đặt (Installation) ​

Cài đặt qua Composer:

bash
composer require laravel/boost --dev

Cài đặt MCP server và coding guidelines:

bash
php artisan boost:install

Lệnh boost:install sẽ tạo các file guideline và skill phù hợp cho các coding agent bạn chọn trong quá trình cài đặt.

Sau khi cài xong, bạn sẵn sàng code với Cursor, Claude Code, hoặc AI agent bất kỳ.

GỢI Ý

Có thể thêm các file .mcp.json, CLAUDE.md, AGENTS.md, boost.json vào .gitignore vì chúng tự động được tạo lại khi chạy boost:install và boost:update.

Thiết lập Agent (Set Up Your Agents) ​

Cursor ​

  1. Mở command palette (Cmd+Shift+P hoặc Ctrl+Shift+P)
  2. Nhấn enter trên "/open MCP Settings"
  3. Bật toggle cho laravel-boost

Claude Code ​

Hỗ trợ thường được bật tự động. Nếu không, chạy:

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

Codex ​

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

Gemini CLI ​

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

GitHub Copilot ​

  1. Mở command palette (Cmd+Shift+P hoặc Ctrl+Shift+P)
  2. Nhấn enter trên "MCP: List Servers"
  3. Chọn laravel-boost → "Start server"

JetBrains IDE (Junie) ​

  1. Nhấn Shift 2 lần để mở command palette
  2. Tìm "MCP Settings" → enter
  3. Check box bên cạnh laravel-boost
  4. Click "Apply"

Giữ Boost cập nhật (Keeping Boost Resources Updated) ​

Cập nhật guidelines và skills khi cần:

bash
php artisan boost:update

MCP Server ​

Laravel Boost cung cấp MCP server expose các tool cho AI agent tương tác với ứng dụng: kiểm tra cấu trúc, truy vấn database, thực thi code, v.v.

Các MCP Tools có sẵn ​

Boost cung cấp hơn 15 tool chuyên biệt bao gồm:

  • Application introspection (phiên bản, cấu hình, package)
  • Database schema inspection
  • Route listing
  • Artisan command discovery
  • Log analysis
  • Browser console logs
  • Tinker integration
  • Documentation search

Đăng ký MCP Server thủ công ​

Nếu cần đăng ký thủ công:

  • Command: php
  • Arguments: artisan boost:mcp

JSON configuration:

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

AI Guidelines ​

AI guidelines là các file hướng dẫn composable (kết hợp được) được load ngay khi AI agent khởi động, cung cấp ngữ cảnh thiết yếu về các package hệ sinh thái Laravel. Chúng chứa quy ước cốt lõi, best practices và pattern đặc thù framework.

Các AI Guidelines có sẵn ​

Laravel Boost bao gồm guidelines cho nhiều package và framework. Guidelines core cung cấp lời khuyên chung, tổng quát áp dụng cho mọi phiên bản.

Thêm Custom AI Guidelines ​

Thêm file .blade.php hoặc .md vào thư mục .ai/guidelines/*. Chúng sẽ tự động được bao gồm khi chạy boost:install:

.ai/guidelines/my-custom-rule.md

Override Boost AI Guidelines ​

Tạo custom guideline với đường dẫn file trùng khớp. Ví dụ, override guideline "Inertia React v2 Form Guidance":

.ai/guidelines/inertia-react/2/forms.blade.php

Khi chạy boost:install, Boost sẽ dùng bản custom thay vì mặc định.

Third-Party Package AI Guidelines ​

Nếu bạn duy trì package bên thứ ba, thêm file resources/boost/guidelines/core.blade.php vào package. Khi user chạy php artisan boost:install, Boost tự động load guidelines.

Ví dụ cấu trúc guidelines:

markdown
## Package Name

Package này cung cấp [mô tả ngắn gọn].

### Features

- Feature 1: [mô tả rõ ràng & ngắn gọn].
- Feature 2: [mô tả rõ ràng & ngắn gọn].

Agent Skills ​

Agent Skills là các module kiến thức nhẹ, kích hoạt theo yêu cầu khi agent làm việc trên domain cụ thể. Khác với guidelines (load ngay), skills chỉ load khi liên quan — giảm context bloat, cải thiện chất lượng code.

Khi chạy boost:install và chọn skills, chúng được cài tự động dựa trên package trong composer.json. Ví dụ: nếu project có livewire/livewire, skill livewire-development sẽ được cài.

Các Skills có sẵn ​

Boost cung cấp skills cho Livewire, Inertia, Tailwind CSS, Pest, v.v.

Custom Skills ​

Tạo skill tùy chỉnh bằng cách thêm file SKILL.md vào .ai/skills/{skill-name}/:

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

Khi chạy boost:update, custom skills sẽ được cài cùng built-in skills.

Override Skills ​

Tạo custom skill với tên trùng khớp. Ví dụ, override skill livewire-development:

.ai/skills/livewire-development/SKILL.md

Third-Party Package Skills ​

Package bên thứ ba cũng có thể cung cấp skills cho Boost.

Guidelines vs. Skills ​

GuidelinesSkills
Thời điểm loadNgay khi agent khởi độngKhi cần (on-demand)
Mục đíchQuy ước chung, best practices tổng quátPattern chi tiết cho domain cụ thể
Ưu điểmLuôn sẵn sàngGiảm context bloat, code chính xác hơn

Documentation API ​

Laravel Boost bao gồm Documentation API cung cấp hơn 17.000 mẩu kiến thức Laravel. API sử dụng semantic search với embedding để trả kết quả chính xác.

MCP tool Search Docs cho phép agent truy vấn API để lấy tài liệu phù hợp với phiên bản package đang cài đặt. AI guidelines và skills của Boost tự động hướng dẫn coding agent sử dụng API này.

Mở rộng Boost (Extending Boost) ​

Boost hoạt động với nhiều IDE và AI agent phổ biến. Nếu coding tool chưa được hỗ trợ, bạn có thể tự tạo agent và tích hợp.

Hỗ trợ IDE / AI Agents khác ​

Bạn có thể mở rộng Boost để hỗ trợ thêm IDE hoặc AI agent bằng cách implement interface phù hợp.