PHPackages                             sandermuller/package-boost-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. sandermuller/package-boost-laravel

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

sandermuller/package-boost-laravel
==================================

AI agent skills for Laravel package authors. Adds Laravel-flavored skills + .mcp.json emission on top of package-boost-php.

0.11.1(1w ago)11662MITPHPPHP ^8.3CI passing

Since May 18Pushed 4d agoCompare

[ Source](https://github.com/SanderMuller/package-boost-laravel)[ Packagist](https://packagist.org/packages/sandermuller/package-boost-laravel)[ Docs](https://github.com/sandermuller/package-boost-laravel)[ RSS](/packages/sandermuller-package-boost-laravel/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (78)Versions (17)Used By (2)

package-boost-laravel
=====================

[](#package-boost-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/7b3cc87b10d01194f9acd20a601c91f75a9ed9efd09ffa5401045126ee78130e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73616e6465726d756c6c65722f7061636b6167652d626f6f73742d6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sandermuller/package-boost-laravel)[![GitHub Tests Action Status](https://camo.githubusercontent.com/4b65b6ec681f8ad0f8ccabbbc7858c2c8e79de3019cc8cec47e29466506eb8e6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f73616e6465726d756c6c65722f7061636b6167652d626f6f73742d6c61726176656c2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/sandermuller/package-boost-laravel/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/5f765ea0e35b2b1a98ef7b132a0ded98e5a3d42c6415f477d4d2d86415af494a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73616e6465726d756c6c65722f7061636b6167652d626f6f73742d6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sandermuller/package-boost-laravel)[![License](https://camo.githubusercontent.com/c8e32d62c053a0014b5741f5e760ca2c53f0a681e23c57fa37c5ec75b395acae/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f73616e6465726d756c6c65722f7061636b6167652d626f6f73742d6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Laravel Boost](https://camo.githubusercontent.com/90f2604136cf241bd1fa46f5c025c7dad12d8cdc1b66e7662c12003c7f79abf8/68747470733a2f2f62616467652e6c61726176656c2e636c6f75642f626f6f73742d62616467652e7376673f7374796c653d666c61742d737175617265)](https://github.com/laravel/boost)

AI agent skills, guidelines, and `.mcp.json` emission for Laravel-package authors. Inherits the framework-agnostic package-author toolkit from [`sandermuller/package-boost-php`](https://github.com/sandermuller/package-boost-php) and layers on Laravel-specific context: Testbench conventions, cross-version Laravel support, CI matrix diagnostics, and the `McpJsonEmitter` that wires `laravel/boost`'s MCP server into Claude Code during `boost sync`.

[![overview image](overview.png)](overview.png)

> Where [`laravel/boost`](https://github.com/laravel/boost) targets Laravel **application** developers, `package-boost-laravel` targets the people building Laravel **packages** — the dev-time codebase where `app/`, `bootstrap/`, and `.env` don't exist and `php artisan` doesn't apply. Coexists cleanly with `laravel/boost` if you also dogfood it from inside your package's test app.

Which package fits your role?
-----------------------------

[](#which-package-fits-your-role)

You're buildingInstallShipsA PHP application (not a package)[`sandermuller/project-boost`](https://github.com/sandermuller/project-boost)App-dev skills: DDD layering, repository pattern, DI, domain modeling, legacy coexistenceA Laravel application[`sandermuller/project-boost-laravel`](https://github.com/sandermuller/project-boost-laravel)`laravel/boost` MCP coexistence + nine-agent fanout + tag filter + remote skillsA framework-agnostic Composer package[`sandermuller/package-boost-php`](https://github.com/sandermuller/package-boost-php)Package-author skills + `lean` / `gitattributes` commands**A Laravel package****[`sandermuller/package-boost-laravel`](https://github.com/sandermuller/package-boost-laravel)****Laravel-package skills + `McpJsonEmitter` ← you are here**Your own skill bundle, or custom tooling[`sandermuller/boost-core`](https://github.com/sandermuller/boost-core)The sync engine. You supply the skills.What you get
------------

[](#what-you-get)

**`McpJsonEmitter`** — the zero-overlap claim against `laravel/boost`. Writes `.mcp.json` on every `boost sync`, idempotent, with the command pointed at `vendor/bin/testbench boost:mcp` (not `php artisan`) so the MCP server actually boots in a package codebase. `laravel/boost` writes `.mcp.json` once at install time against `php artisan`, which doesn't exist here. The emitter fires only when all three conditions hold: `laravel/boost` is in your dev dependencies, `orchestra/testbench` is in your dev dependencies, and `Agent::CLAUDE_CODE` is in your active agents. Otherwise it returns null and skips silently.

**Three Laravel-flavored skills** — on-demand workflows for Laravel-package authorship. All three are untagged, so they ship whenever this package is installed.

SkillWhen it loadsTag`package-development`Testbench conventions: `vendor/bin/testbench` vs `php artisan`, service-provider registration in `testbench.yaml`, `workbench/` layout for fixtures, migrations, routes, factories.—`cross-version-laravel-support`Supporting multiple Laravel majors in one release: `^12.0||^13.0` constraint patterns, version-specific API shims, CI matrix shape including `prefer-lowest`.—`ci-matrix-troubleshooting`Debugging "fails on prefer-lowest" / "fails on Laravel 13 but not 12" type matrix failures.—**One Laravel guideline** — pinned context for AI agents working in a Laravel-package codebase.

GuidelineScopeTag`laravel-packages`Detection rule (`require.illuminate/*` or `require.laravel/framework`), Testbench context, artisan-substitution table, cross-version compatibility pointer. Composes with the framework-agnostic `foundation` guideline inherited from `package-boost-php`.—Inherits everything `package-boost-php` ships — `foundation` guideline, `lean` / `gitattributes` CLI commands, the `lean-dist` skill, and the release-flow content skills (`readme`, `release-notes`, `upgrading`) from `sandermuller/boost-skills` under the `release-automation` tag. The `skill-authoring` + `writing-file-emitter` skills ship too but are gated behind the `boost-extension` tag — declare it if your package extends the engine with a custom `FileEmitter` (this package does, for `McpJsonEmitter`).

Install
-------

[](#install)

```
composer require --dev sandermuller/package-boost-laravel
```

PHP 8.3+ and Laravel 12 or 13. `sandermuller/package-boost-php`, `sandermuller/boost-core`, and `stolt/lean-package-validator` all come in transitively — do **not** require any of them separately, they resolve through this umbrella. A Laravel-package author requires only `sandermuller/package-boost-laravel` and gets the whole stack. (Internally this package pins `sandermuller/boost-core` directly so its `McpJsonEmitter` is guaranteed the iterable `FileEmitter` contract — boost-core ≥ 0.21 — an implementation floor, not something you declare.)

First run
---------

[](#first-run)

```
vendor/bin/boost install   # interactive: pick agents, allowlist vendors (writes boost.php)
vendor/bin/boost sync      # fan out skills + guidelines to selected agents
```

If `laravel/boost` + `orchestra/testbench` are in your dev deps and Claude Code is one of your active agents, `boost sync` writes `.mcp.json` automatically. Generated agent dirs (`.claude/`, `.cursor/`, etc.) are added to `.gitignore`; edit `.ai/` only, then re-run `vendor/bin/boost sync`.

`boost.php` config
------------------

[](#boostphp-config)

```
