Package Boost Laravel Package

Product Decisions This Supports

• Accelerating Laravel/PHP package development: Reduces time-to-market for new packages by automating AI tooling setup (e.g., skills, guidelines) across 9+ agents (Claude, Copilot, Gemini, etc.). Enables teams to focus on core logic rather than boilerplate.
• Cross-version Laravel support: Simplifies maintaining packages compatible with multiple Laravel/PHP versions via built-in cross-version-laravel-support skills, reducing manual version guard work.
• CI/CD optimization: Diagnoses flaky CI matrix failures (e.g., prefer-lowest conflicts) via ci-matrix-troubleshooting, cutting debug time for dependency issues.
• Lean package design: Enforces best practices (e.g., lean-dist skill) for minimal, maintainable packages, aligning with modern Composer standards.
• AI-driven documentation: Automates READMEs, release notes, and UPGRADING.md files with Laravel-specific templates, ensuring consistency and reducing manual effort.
• Build vs. Buy: Buy for teams lacking in-house AI tooling expertise or needing rapid setup. Build only if requiring custom agent integrations beyond the 9+ supported.
• Roadmap prioritization: Justify investment in AI-assisted dev workflows by quantifying time saved (e.g., "30% faster package onboarding").

When to Consider This Package

• Adopt if:

  • Developing Laravel-specific or framework-agnostic Composer packages.
  • Using Testbench for testing (or willing to adopt it as a dev dependency).
  • Targeting multiple Laravel/PHP versions and need automated version guards.
  • Prioritizing AI tooling integration (e.g., Copilot, Claude) for dev workflows.
  • Seeking to standardize documentation (READMEs, release notes) with minimal effort.

• Look elsewhere if:

  • Not using Composer: Package is non-PHP (e.g., Node.js, Python).
  • No Testbench: Package lacks testing harnesses; alternative tools like Pest or PHPUnit require custom integration.
  • Custom AI agents: Need support for agents beyond the 9+ included (e.g., proprietary tools).
  • Legacy codebases: Existing packages lack .ai/ directory structure or GitHub Actions CI.
  • Framework-specific constraints: Non-Laravel PHP frameworks (e.g., Symfony) may need tailored alternatives.

How to Pitch It (Stakeholders)

For Executives: "Package Boost cuts Laravel/PHP package development time by 30%+ through AI-driven tooling. It automates setup for 9+ agents (Copilot, Claude, Gemini), standardizes documentation, and diagnoses CI issues—freeing engineers to focus on innovation. Low-risk MIT-licensed tool with zero runtime overhead (dev-only dependency). ROI: Faster releases, fewer dependency bugs, and consistent package quality."

For Engineering: *"This replaces manual AI skill/guideline setup with a single composer require and testbench package-boost:sync. Key wins:

• Skills: Pre-built templates for Laravel cross-version support, CI troubleshooting, and lean distributions.
• Guidelines: Syncs .ai/ to agent-specific files (e.g., CLAUDE.md, .cursor/skills) in one command.
• CI Safety: --check flag catches sync drifts before merges.
• Testbench Agnostic: Works for any Composer package, even non-Laravel ones. No learning curve—just run package-boost:install and start coding."