PHPackages                             byjesper/laravel-coding-guidelines - 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 & Helpers](/categories/utility)
4. /
5. byjesper/laravel-coding-guidelines

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

byjesper/laravel-coding-guidelines
==================================

Shared AI coding guidelines for byjesper Laravel packages and apps, with a generator that builds CLAUDE.md and AGENTS.md from a single source.

v0.1.0(1mo ago)01302MITPHPPHP ^8.2CI passing

Since Jun 23Pushed 1mo agoCompare

[ Source](https://github.com/byjesper/laravel-coding-guidelines)[ Packagist](https://packagist.org/packages/byjesper/laravel-coding-guidelines)[ RSS](/packages/byjesper-laravel-coding-guidelines/feed)WikiDiscussions main Synced 2w ago

READMEChangelogDependenciesVersions (2)Used By (2)

Laravel Coding Guidelines
=========================

[](#laravel-coding-guidelines)

Single source of truth for `byjesper`'s shared AI coding guidelines, plus a zero-dependency tool that **publishes** them into a consuming repo's `.ai/guidelines/` and (for non-Boost repos) **composes** `CLAUDE.md` / `AGENTS.md`.

The shared fragments live here once. Each project pulls them in with one composer command — no copy/paste, and a `composer update` refreshes them everywhere.

How it works
------------

[](#how-it-works)

Two commands (`vendor/bin/byjesper-guidelines`, wrapped as composer scripts):

- **`sync --profile=apps|packages`** — copies this package's `common` + `` fragments into the consumer's **`.ai/guidelines/shared/`** (a *managed* directory — wiped and rewritten each run). Your own project-specific fragments live elsewhere under `.ai/guidelines/` and are **never touched**.
- **`build`** — composes every `.ai/guidelines/**/*.md` (shared + local), sorted by filename, into `CLAUDE.md` and `AGENTS.md`. For repos that do **not** use Laravel Boost.

Composition after `sync` depends on the repo:

Repo typeAfter `sync`Why**App** (uses Boost)`php artisan boost:update`Boost reads `.ai/guidelines/**` and composes**Library** (no Boost)`composer guidelines:build`small built-in composer; keeps Boost out of libraries`CLAUDE.md` / `AGENTS.md` and `.ai/guidelines/shared/` are **generated** — never edit them. Edit the fragments here (shared) or your local `.ai/guidelines/*.md`, then re-sync / re-build.

Use it in a library (no Boost)
------------------------------

[](#use-it-in-a-library-no-boost)

```
// composer.json — once this repo is public on Packagist
"require-dev": { "byjesper/laravel-coding-guidelines": "^0.1" },
"scripts": {
    "post-update-cmd": ["@guidelines:sync", "@guidelines:build"],
    "guidelines:sync": "byjesper-guidelines sync --profile=packages",
    "guidelines:build": "byjesper-guidelines build",
    "guidelines:check": "byjesper-guidelines build --check"
}
```

Wire `@guidelines:check` into your `test` script so CI fails on hand-edited `CLAUDE.md`/`AGENTS.md`. `post-update-cmd` auto-refreshes on every `composer update`.

Use it in an app (Boost)
------------------------

[](#use-it-in-an-app-boost)

```
"require-dev": { "byjesper/laravel-coding-guidelines": "^0.1" },
"scripts": {
    "post-update-cmd": ["@guidelines:sync"],
    "guidelines:sync": "byjesper-guidelines sync --profile=apps"
}
```

Then `php artisan boost:update` composes `.ai/guidelines/**` (shared + local) into `CLAUDE.md`/`AGENTS.md`.

Where project-specific guidance goes
------------------------------------

[](#where-project-specific-guidance-goes)

Anything unique to a project — most importantly its **git release-model**declaration — is a local fragment in `.ai/guidelines/` (e.g. `55-git-release-model.md`). `sync` only manages `.ai/guidelines/shared/`, so your local fragments are safe and compose alongside the shared ones (ordered by filename number).

Profiles
--------

[](#profiles)

ProfileGetsFor`packages`common + packagescomposer libraries`apps`common + appsLaravel applicationsAdd a profile by creating a new directory under `guidelines/`; `sync` discovers it automatically.

License
-------

[](#license)

The MIT License (MIT). See [LICENSE.md](LICENSE.md).

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance90

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

45d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7fe91059b591a5df0a6c3a69bd89e13875e03a2dcc0e046125181b6edd72b92a?d=identicon)[Yezper](/maintainers/Yezper)

---

Top Contributors

[![Yezper](https://avatars.githubusercontent.com/u/9988723?v=4)](https://github.com/Yezper "Yezper (4 commits)")

### Embed Badge

![Health badge](/badges/byjesper-laravel-coding-guidelines/health.svg)

```
[![Health](https://phpackages.com/badges/byjesper-laravel-coding-guidelines/health.svg)](https://phpackages.com/packages/byjesper-laravel-coding-guidelines)
```

###  Alternatives

[bcc/cron-manager-bundle

A cron table manager bundle for Symfony

166270.9k1](/packages/bcc-cron-manager-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)