README

AI agent skills for PHP application developers — any framework, or none. Two framework-agnostic skills plus a foundation guideline that frames the codebase as an application rather than a package. It rides the sandermuller/boost-core sync engine and ships no code of its own.

Documentation: https://sandermuller.github.io/boost-core/packages/project-boost-php/

laravel/boost is Laravel-only. This package covers Symfony, plain-PHP, and framework-agnostic applications. Building a Laravel app? Install sandermuller/project-boost-laravel instead — it coexists with laravel/boost rather than replacing it. Not sure which member fits? The picker decides it in two questions.

What you get

Two skills — universally applicable PHP practices, not tied to any architecture.

Skill	Triggers when
`dependency-injection`	Constructor injection, container hygiene, avoiding service locators
`legacy-coexistence`	Adding modern PHP (typed properties, readonly, enums) to a 7.x codebase incrementally

One guideline — foundation. Framework-agnostic application-developer framing: what an application codebase is, how its edges form its real contract, and how to work in it. Always shipped, no tag required.

Want architecture-specific guidance (DDD layering, repositories, domain modeling)? Those shipped through 0.x but were dropped at 1.0 to keep the default framework-agnostic. Copy any you want into your own .ai/skills/<name>/SKILL.md (host copies shadow vendor skills), or exclude a shipped skill with ->withExcludedSkills(['sandermuller/project-boost-php:<name>']).

Install

composer require --dev sandermuller/project-boost-php
vendor/bin/boost install   # pick agents and allowlist vendors; writes boost.php
vendor/bin/boost sync      # fan the skills + guideline out

PHP 8.3+. Pulls in sandermuller/boost-core transitively.

Minimal boost.php:

use SanderMuller\BoostCore\Config\BoostConfig;
use SanderMuller\BoostCore\Enums\Agent;

return BoostConfig::configure()
    ->withAgents([Agent::CLAUDE_CODE, Agent::CURSOR, Agent::CODEX])
    ->withAllowedVendors(['sandermuller/project-boost-php']);

withAllowedVendors() is explicit on purpose: an installed dependency's skills sync only when its package name is listed.

Documentation

Topic	Page
What this package ships, and how it compares to `laravel/boost`	Overview
Install and first run	Install
`boost.php`, skill sources, coexistence, auto-sync	Configuration
Tags, skill dependencies, remote skills, conventions, file ownership	Guide
Every command and exit code	CLI reference

The semver-protected surface is in PUBLIC_API.md.

Testing

composer test

Pest suite — sanity tests on the shipped skill and guideline set: skills parse with a name matching the filename and a non-empty description; guidelines are frontmatter-free and open with a Markdown heading.

License

MIT. See LICENSE.

sandermuller / project-boost-php

Maintainers

Package info

Statistics

Security