PHPackages                             sandermuller/package-boost-php - 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-php

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

sandermuller/package-boost-php
==============================

AI agent skills for framework-agnostic Composer package authors. Pairs with sandermuller/boost-core for sync to nine AI agents.

0.16.2(1w ago)1655↓31.8%5MITPHPPHP ^8.3CI passing

Since May 18Pushed 4d agoCompare

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

READMEChangelog (10)Dependencies (67)Versions (27)Used By (5)

package-boost-php
=================

[](#package-boost-php)

[![Latest Version on Packagist](https://camo.githubusercontent.com/cc0d9bbef71f2f5a95285adde1867a6c20c9c5a77cb1a1f28e557538c05755e3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73616e6465726d756c6c65722f7061636b6167652d626f6f73742d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sandermuller/package-boost-php)[![GitHub Tests Action Status](https://camo.githubusercontent.com/76774119acb72bfbb2c4ec52e986952124a9d11b2ce176893aff739a5b1a6e89/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f73616e6465726d756c6c65722f7061636b6167652d626f6f73742d7068702f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/sandermuller/package-boost-php/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/18f1027bc4cff7b0ebc4ca990722e944f09554e7f41393fd2a8e1017ebef91c8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73616e6465726d756c6c65722f7061636b6167652d626f6f73742d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sandermuller/package-boost-php)[![License](https://camo.githubusercontent.com/6e3e219d2a9dbc902ee148c92237de22d5ffdf97d5e20b59a6cce626bf81d1b8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f73616e6465726d756c6c65722f7061636b6167652d626f6f73742d7068702e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Laravel Boost](https://camo.githubusercontent.com/90f2604136cf241bd1fa46f5c025c7dad12d8cdc1b66e7662c12003c7f79abf8/68747470733a2f2f62616467652e6c61726176656c2e636c6f75642f626f6f73742d62616467652e7376673f7374796c653d666c61742d737175617265)](https://github.com/laravel/boost)

AI agent skills, guidelines, and `.gitattributes` commands for framework-agnostic Composer package authors. Sibling of [`sandermuller/package-boost-laravel`](https://github.com/sandermuller/package-boost-laravel) (Laravel-package flavor); both ride the [`sandermuller/boost-core`](https://github.com/sandermuller/boost-core) sync engine.

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

> Where [`laravel/boost`](https://github.com/laravel/boost) ships Laravel application guidelines, `package-boost-php` ships package-author CLI infrastructure (`vendor/bin/package-boost-php lean` + `gitattributes`) and skill-authoring tooling for the boost ecosystem. Framework-agnostic, no Laravel dependency. The release-flow content skills (`readme`, `release-notes`, `upgrading`) ship from [`sandermuller/boost-skills`](https://github.com/sandermuller/boost-skills) under the `release-automation` tag.

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 skills**A framework-agnostic Composer package****[`sandermuller/package-boost-php`](https://github.com/sandermuller/package-boost-php)****Package-author skills + `lean` / `gitattributes` commands ← you are here**A Laravel package[`sandermuller/package-boost-laravel`](https://github.com/sandermuller/package-boost-laravel)Laravel-package skills + `McpJsonEmitter`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)

**Two CLI commands** — zero-overlap with `laravel/boost`. Both target `.gitattributes`, the file that controls what ends up in the Composer archive.

CommandPurpose`vendor/bin/package-boost-php lean`Validate `.gitattributes` excludes non-shipping paths (tests, fixtures, CI configs, `.ai/`). Wraps `stolt/lean-package-validator`.`vendor/bin/package-boost-php gitattributes`Maintain the `# >>> package-boost (managed) >>>` block. Preserves foreign lines added by other tools.**Two guidelines** — pinned context for AI agents working in a package codebase.

GuidelineScopeTag`foundation`Package-not-an-app rules: no `app/` / `.env`, public API is semver-governed, tests are the spec.—`release-automation`CHANGELOG-via-CI + release-notes-in-`internal/` conventions.`release-automation`**Three skills** — on-demand workflows for package development.

SkillWhen it loadsTag`lean-dist`Keeping the Composer archive lean via `.gitattributes` export-ignore.—`skill-authoring`Authoring or editing AI skills for the boost family.`boost-extension``writing-file-emitter`Implementing a custom `FileEmitter` for boost-core (`.mcp.json` etc.).`boost-extension`The `readme`, `release-notes`, and `upgrading` skills moved to [`sandermuller/boost-skills`](https://github.com/sandermuller/boost-skills) under the `release-automation` tag. See [UPGRADING](UPGRADING.md) for the migration note.

Install
-------

[](#install)

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

PHP 8.3+ required. `sandermuller/boost-core` (the sync engine) and `stolt/lean-package-validator` (the `lean` command's checker) come in transitively — do not `require sandermuller/boost-core` separately, it resolves through this package. One package is the whole install; the auto-sync callback (below) lives under this package's own namespace so your `composer.json` never names the transitive dependency.

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
vendor/bin/package-boost-php gitattributes   # write or refresh the managed .gitattributes block
vendor/bin/package-boost-php lean            # confirm the archive is lean
```

Generated agent dirs (`.claude/`, `.cursor/`, `.codex/`, etc.) are added to `.gitignore` automatically; root-level agent files (`AGENTS.md`, `CLAUDE.md`) are tracked, not gitignored, per boost-core's tracking model. Edit `.ai/` only, then re-run `vendor/bin/boost sync`.

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

[](#boostphp-config)

The canonical example is this repo's own dogfood config (kept at `.config/boost.php`; root `boost.php` works too):

```
