PHPackages edstevo/standards - 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. [PSR & Standards](/categories/psr-standards) 4. / 5. edstevo/standards ActiveLibrary[PSR & Standards](/categories/psr-standards) edstevo/standards ================= Coding standards, conventions, and best practices for EdStevo Laravel projects with AI Boost integration v1.0.19(2mo ago)023MITBladePHP ^8.4CI failing Since Feb 11Pushed 2mo agoCompare [ Source](https://github.com/edstevo/standards)[ Packagist](https://packagist.org/packages/edstevo/standards)[ Docs](https://github.com/edstevo/standards)[ RSS](/packages/edstevo-standards/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (5)Versions (21)Used By (0) EdStevo Standards ================= [](#edstevo-standards) A Laravel package that provides opinionated coding standards, conventions, and best practices with seamless Laravel Boost integration. This package delivers AI-powered guidelines to help maintain consistency across all EdStevo Laravel projects. Why EdStevo Standards? ---------------------- [](#why-edstevo-standards) When working with AI assistants like Claude Code or Cursor, having a consistent set of coding standards is crucial. EdStevo Standards packages these standards into a reusable Laravel package that automatically integrates with [Laravel Boost](https://github.com/laravel/boost), ensuring every project follows the same conventions. Features -------- [](#features) - ๐Ÿค– **Laravel Boost Integration** - Automatically discovered by Laravel Boost - ๐Ÿ“ **Project Structure Guidelines** - Domain-based organization and naming conventions - โœจ **Code Quality Standards** - Actions, DTOs, Services, and best practices - ๐Ÿงช **Testing Standards** - Pest PHP patterns and coverage guidelines - ๐Ÿ“ฆ **Zero Configuration** - Install and forget - ๐Ÿ”„ **Auto-updating** - Stay in sync with your coding standards Requirements ------------ [](#requirements) - PHP 8.4+ - Laravel 11.x or 12.x - Laravel Boost Installation ------------ [](#installation) Install via Composer in your Laravel project: ``` composer require edstevo/protocol --dev ``` That's it! If you have Laravel Boost installed, the guidelines will be automatically discovered. Usage with Laravel Boost ------------------------ [](#usage-with-laravel-boost) ### First Time Setup [](#first-time-setup) If Laravel Boost is installed in your project, run: ``` php artisan boost:install ``` The EdStevo Standards guidelines will be automatically included when Boost generates your AI configuration files. Your AI agent will now understand and follow your coding standards. ### Keeping Guidelines Updated [](#keeping-guidelines-updated) After updating dependencies, refresh your AI guidelines: ``` php artisan boost:update ``` Or automate it by adding to your `composer.json`: ``` { "scripts": { "post-update-cmd": [ "@php artisan boost:update --ansi" ] } } ``` What's Included --------------- [](#whats-included) EdStevo Standards provides comprehensive guidelines covering: ### Project Structure Conventions [](#project-structure-conventions) - **Directory Organization**: Actions, DTOs, Enums, Services, ValueObjects - **Naming Conventions**: Controllers, Models, Actions, Services, Traits - **Domain-Based Structure**: Organize by feature/domain, not by layer Example structure the AI will understand: ``` app/ โ”œโ”€โ”€ Actions/User/ โ”‚ โ”œโ”€โ”€ CreateUser.php โ”‚ โ””โ”€โ”€ UpdateUserProfile.php โ”œโ”€โ”€ DataTransferObjects/User/ โ”‚ โ””โ”€โ”€ CreateUserData.php โ”œโ”€โ”€ Services/ โ”‚ โ””โ”€โ”€ UserService.php โ””โ”€โ”€ Http/Controllers/User/ โ””โ”€โ”€ UserController.php ``` ### Code Style & Best Practices [](#code-style--best-practices) - **Action Classes**: Use `lorisleiva/laravel-actions` for one-class-one-task business actions, typically called via `::run()` - **DTOs**: Immutable data transfer objects with validation - **Service Classes**: Coordinate multiple actions and domain logic - **Jobs and Queues**: Use native Laravel jobs and queues for queued or asynchronous work - **Native Enums**: Type-safe backed enums for fixed values - **Thin Controllers**: Delegate to actions and services - **Query Optimization**: Eager loading, indexes, select only needed columns - **Security**: Input validation, mass assignment protection, XSS prevention ### Testing Standards [](#testing-standards) - **Pest PHP**: Modern testing syntax with descriptive names - **Test Organization**: Unit tests in `tests/Unit/`, features in `tests/Feature/` - **Coverage Guidelines**: High coverage of critical business logic - **Database Testing**: In-memory SQLite, proper seeding, RefreshDatabase trait Examples -------- [](#examples) When you ask your AI to create a new feature, it will follow these patterns: Without Laravel Boost --------------------- [](#without-laravel-boost) You can manually reference the guidelines in your AI configuration: **Claude Code (`CLAUDE.md`):** ``` @include('vendor/edstevo/protocol/resources/boost/guidelines/core.blade.php') ``` **Cursor (`.cursorrules`):** ``` Include guidelines from vendor/edstevo/protocol/resources/boost/guidelines/core.blade.php ``` Verifying Installation ---------------------- [](#verifying-installation) Check that the protocol is active: ``` php artisan protocol:info ``` You should see: ``` EdStevo Standards is active! AI Boost guidelines are available for this project. ``` ### Overriding [](#overriding) To override a specific guideline, create a file with the same path structure in your project's `.ai/guidelines/` directory. Your custom version takes precedence. Configuration ------------- [](#configuration) Publish the config file if you need to customize behavior: ``` php artisan vendor:publish --tag="standards-config" ``` Development ----------- [](#development) ### Running Tests [](#running-tests) ``` composer test ``` ### Code Style [](#code-style) ``` composer format ``` How It Works ------------ [](#how-it-works) 1. **Discovery**: Laravel Boost scans installed packages for `resources/boost/guidelines/` directories 2. **Loading**: Found guidelines are automatically included when running `boost:install` or `boost:update` 3. **Context**: AI agents receive these guidelines in their system prompts 4. **Consistency**: All code generated follows the same patterns across projects Philosophy ---------- [](#philosophy) This package embodies the principle that **consistency is more valuable than perfection**. By standardizing patterns across all EdStevo projects: - **Onboarding is faster** - New team members see familiar patterns - **AI assistance is better** - Claude knows exactly how to structure code - **Maintenance is easier** - Predictable structure across all projects - **Code reviews are quicker** - Everyone follows the same conventions Roadmap ------- [](#roadmap) - Add Agent Skills for specific domains - Include Blade component patterns - Add API documentation standards - Database design conventions - Queue job patterns Changelog --------- [](#changelog) See [CHANGELOG.md](CHANGELOG.md) for recent changes. License ------- [](#license) The MIT License (MIT). See [LICENSE.md](LICENSE.md) for details. --- Built with โค๏ธ by [EdStevo](https://github.com/edstevo) for consistent Laravel development. ### Health Score 46 โ€” FairBetter than 93% of packages Maintenance88 Actively maintained with recent releases Popularity9 Limited adoption so far Community19 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 57.9% of commits โ€” single point of failure How is this calculated?**Maintenance (25%)** โ€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** โ€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** โ€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** โ€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~2 days Total 20 Last Release 61d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/9676607?v=4)[Ed Stephenson](/maintainers/edstevo)[@edstevo](https://github.com/edstevo) --- Top Contributors [![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (378 commits)")[![mvdnbrk](https://avatars.githubusercontent.com/u/802681?v=4)](https://github.com/mvdnbrk "mvdnbrk (46 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (31 commits)")[![edstevo](https://avatars.githubusercontent.com/u/9676607?v=4)](https://github.com/edstevo "edstevo (25 commits)")[![Nielsvanpach](https://avatars.githubusercontent.com/u/10651054?v=4)](https://github.com/Nielsvanpach "Nielsvanpach (23 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (20 commits)")[![pforret](https://avatars.githubusercontent.com/u/474312?v=4)](https://github.com/pforret "pforret (16 commits)")[![sebastiandedeyne](https://avatars.githubusercontent.com/u/1561079?v=4)](https://github.com/sebastiandedeyne "sebastiandedeyne (14 commits)")[![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (12 commits)")[![riasvdv](https://avatars.githubusercontent.com/u/3626559?v=4)](https://github.com/riasvdv "riasvdv (10 commits)")[![patinthehat](https://avatars.githubusercontent.com/u/5508707?v=4)](https://github.com/patinthehat "patinthehat (10 commits)")[![crynobone](https://avatars.githubusercontent.com/u/172966?v=4)](https://github.com/crynobone "crynobone (8 commits)")[![AdrianMrn](https://avatars.githubusercontent.com/u/12762044?v=4)](https://github.com/AdrianMrn "AdrianMrn (8 commits)")[![irfanm96](https://avatars.githubusercontent.com/u/42065936?v=4)](https://github.com/irfanm96 "irfanm96 (5 commits)")[![thecaliskan](https://avatars.githubusercontent.com/u/13554944?v=4)](https://github.com/thecaliskan "thecaliskan (5 commits)")[![IGedeon](https://avatars.githubusercontent.com/u/694313?v=4)](https://github.com/IGedeon "IGedeon (4 commits)")[![abenerd](https://avatars.githubusercontent.com/u/7523903?v=4)](https://github.com/abenerd "abenerd (3 commits)")[![jessarcher](https://avatars.githubusercontent.com/u/4977161?v=4)](https://github.com/jessarcher "jessarcher (3 commits)")[![koossaayy](https://avatars.githubusercontent.com/u/6431084?v=4)](https://github.com/koossaayy "koossaayy (3 commits)")[![lloricode](https://avatars.githubusercontent.com/u/8251344?v=4)](https://github.com/lloricode "lloricode (3 commits)") --- Tags laravelprotocolcoding-standardsboostedstevoai-guidelines ### Code Quality Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/edstevo-standards/health.svg) ``` [![Health](https://phpackages.com/badges/edstevo-standards/health.svg)](https://phpackages.com/packages/edstevo-standards) ``` ### Alternatives [vormkracht10/laravel-mails Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app. 24149.7k](/packages/vormkracht10-laravel-mails)[spatie/laravel-prometheus Export Laravel metrics to Prometheus 2651.3M6](/packages/spatie-laravel-prometheus)[hydrat/filament-table-layout-toggle Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts. 6292.3k1](/packages/hydrat-filament-table-layout-toggle)[scalar/laravel Render your OpenAPI-based API reference 6183.9k2](/packages/scalar-laravel)[ralphjsmit/laravel-helpers A package containing handy helpers for your Laravel-application. 13704.6k2](/packages/ralphjsmit-laravel-helpers)[musahmusah/laravel-multipayment-gateways A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless 852.2k1](/packages/musahmusah-laravel-multipayment-gateways) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)