PHPackages mohamed-ashraf-elsaed/claude-kit - 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. [Testing & Quality](/categories/testing) 4. / 5. mohamed-ashraf-elsaed/claude-kit ActiveLibrary[Testing & Quality](/categories/testing) mohamed-ashraf-elsaed/claude-kit ================================ One command sets up Claude Code (and any AI coding agent) on a Laravel project: engineering rules, a quality gate (PHPStan, Pint, Pest), skills, git hooks, and stack-aware frontend tooling. v0.2.2(3d ago)198↑971.4%MITPHP ^8.2 Since Jul 5Compare [ Source](https://github.com/mohamed-ashraf-elsaed/claude-kit)[ Packagist](https://packagist.org/packages/mohamed-ashraf-elsaed/claude-kit)[ Docs](https://github.com/mohamed-ashraf-elsaed/claude-kit)[ RSS](/packages/mohamed-ashraf-elsaed-claude-kit/feed)WikiDiscussions Synced today READMEChangelog (4)Dependencies (10)Versions (5)Used By (0) [![claude-kit — one command sets up Claude Code and a quality gate for Laravel](https://raw.githubusercontent.com/mohamed-ashraf-elsaed/claude-kit/main/.github/banner.svg)](https://raw.githubusercontent.com/mohamed-ashraf-elsaed/claude-kit/main/.github/banner.svg) claude-kit ========== [](#claude-kit) **Set up [Claude Code](https://claude.com/claude-code) — and any AI coding agent — on a Laravel project in one command.** Engineering rules, a quality gate (PHPStan · Pint · Pest), skills, feature-doc scaffolding, and stack-aware frontend tooling. [![Latest version](https://camo.githubusercontent.com/daa7fd0ad6c9149c596f8dae39e2b6ff1e590d5225be983b735aac7f108bb5e4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6f68616d65642d6173687261662d656c736165642f636c617564652d6b69742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mohamed-ashraf-elsaed/claude-kit) [![Tests](https://camo.githubusercontent.com/509bf17f579546a75cdca201c14c2eb0682153cfd42a6113f0ed254642d14160/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d6f68616d65642d6173687261662d656c736165642f636c617564652d6b69742f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/mohamed-ashraf-elsaed/claude-kit/actions/workflows/tests.yml) [![Lint](https://camo.githubusercontent.com/63f1775b397f5011f4caeaaf99e613f5308bba0e41987e191ecb3148dcbb4460/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d6f68616d65642d6173687261662d656c736165642f636c617564652d6b69742f6c696e742e796d6c3f6272616e63683d6d61696e266c6162656c3d6c696e74267374796c653d666c61742d737175617265)](https://github.com/mohamed-ashraf-elsaed/claude-kit/actions/workflows/lint.yml) [![PHP version](https://camo.githubusercontent.com/3937f9bd83d7c0a3ca764bea156310ae9264ae8f235dd49d745e19e7eac0e8bf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6d6f68616d65642d6173687261662d656c736165642f636c617564652d6b69743f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mohamed-ashraf-elsaed/claude-kit) [![Downloads](https://camo.githubusercontent.com/cc7cdb36756f2a67409cee22173942b3842a8763286cac7e61e75a6aff0a039c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6f68616d65642d6173687261662d656c736165642f636c617564652d6b69742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mohamed-ashraf-elsaed/claude-kit) [![License](https://camo.githubusercontent.com/e4dbdd47838b9d01b4b605e30fea3538cc0ed56a164abeee397604dd407286eb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6f68616d65642d6173687261662d656c736165642f636c617564652d6b69743f7374796c653d666c61742d737175617265)](LICENSE) --- `claude-kit` packages a battle-tested setup so every Laravel project — and every developer — gets the same guardrails instead of hand-copying config between repos: a Stop-hook + pre-commit **quality gate**, reusable Claude Code **skills**, PHPStan level 7 + strict-rules, Pint, Pest with an 80% coverage gate, an architecture test suite, feature-doc scaffolding, and **stack-aware frontend tooling** (Vue, React, Blade, or none). ### Who it's for [](#who-its-for) - Teams putting **Claude Code**, **Cursor**, or **GitHub Copilot** to work on a **Laravel** codebase and wanting consistent, enforced conventions. - Anyone who wants **one command** for PHPStan + Pint + Pest + git hooks instead of wiring them by hand. - Projects that need **AI coding guardrails** an agent can't skip — the same gate runs at commit time, at the end of every Claude turn, and in CI. Table of contents ----------------- [](#table-of-contents) - [Requirements](#requirements) - [Installation](#installation) - [What it installs](#what-it-installs) - [Choosing what to install](#choosing-what-to-install) - [The hybrid update model](#the-hybrid-update-model) - [The quality gate](#the-quality-gate) - [Documentation](#documentation) - [Contributing](#contributing) - [Security](#security) - [License](#license) Requirements ------------ [](#requirements) - PHP **8.2+** - Laravel **11, 12, or 13** - [Claude Code](https://claude.com/claude-code) (to use the rules, hooks, and skills) - A coverage driver (`pcov` or Xdebug) to enforce the 80% coverage gate Installation ------------ [](#installation) ``` composer require --dev mohamed-ashraf-elsaed/claude-kit php artisan claude-kit:install ``` The installer detects your frontend stack (Inertia + Vue, Inertia + React, Blade/Livewire, or API-only), asks which parts to scaffold, and writes them into your project. Then: ``` composer install # installs the dev tooling and wires the git pre-commit hook npm install # only if a frontend stack was set up ``` Not published to Packagist yet? Install straight from GitHub by adding this to your `composer.json` and running `composer require --dev mohamed-ashraf-elsaed/claude-kit:dev-main`: ``` { "repositories": [ { "type": "vcs", "url": "https://github.com/mohamed-ashraf-elsaed/claude-kit" } ] } ``` What it installs ---------------- [](#what-it-installs) PartWhat lands in your project**.claude core**`.claude/settings.json` (Stop-hook wiring + permission allowlist), the reusable skills for your stack, and `.mcp.json` (Laravel Boost).**CLAUDE.md**Generic engineering rules (architecture layers, hard typing, hygiene, testing) with `TODO` placeholders for your product/integrations/deployment.**Quality gate**`phpstan.neon` (level 7 + strict-rules via the vendored base), `pint.json`, `tests/Arch/ArchTest.php`, `.githooks/pre-commit`, and merged composer scripts.**Frontend**Stack-matching `eslint.config.js` / `.prettierrc` / `tsconfig.json`, plus merged `package.json` scripts and devDependencies. Skipped for API-only projects.**Docs**`features/_TEMPLATE/` + `features/README.md`, `.editorconfig`, `.gitattributes`.**CI**Generic GitHub Actions `tests.yml` and `lint.yml`.Existing files are never clobbered — the installer skips them unless you pass `--force`. `composer.json` and `package.json` are merged, preserving your entries. Choosing what to install ------------------------ [](#choosing-what-to-install) `claude-kit:install` is a **fully interactive configurator** — it asks what you want rather than assuming: - **Code style:** Pint on/off - **Static analysis:** PHPStan on/off → level (0–9) → strict-rules on/off - **Tests:** on/off → runner (Pest / PHPUnit) → coverage minimum → architecture tests - **Hooks:** Claude Stop hook, git pre-commit hook, feature-doc requirement - **Skills:** which bundled skills to install — plus optional search & install of more via [skills.sh](https://www.skills.sh) (`npx skills find` / `add`) - **Extras:** CLAUDE.md rules, feature-doc templates, `.editorconfig`, MCP, CI Your answers are recorded in `.claude-kit.json`, which the quality gate reads. ``` php artisan claude-kit:install # interactive (recommended) php artisan claude-kit:install --stack=inertia-react # preselect the stack php artisan claude-kit:install --no-interaction # accept sensible defaults php artisan claude-kit:install --force # overwrite existing files ``` - **Stacks:** `inertia-vue`, `inertia-react`, `blade`, `none` The hybrid update model ----------------------- [](#the-hybrid-update-model) - **Machinery** — `quality-checks.sh` and the Stop hook — lives in `vendor/mohamed-ashraf-elsaed/claude-kit/runtime/` and is *referenced*, so `composer update` propagates fixes to every project automatically. - **Content you own** — `CLAUDE.md`, the skills, the feature templates, the linter configs, and the generated `phpstan.neon` — is written into your repo so you can customise it freely. The quality gate ---------------- [](#the-quality-gate) `vendor/mohamed-ashraf-elsaed/claude-kit/runtime/quality-checks.sh` is the single source of truth. It runs Pint, PHPStan (level 7 + strict-rules), and Pest (+80% coverage), then the frontend checks your `package.json` actually defines. The same script backs the git pre-commit hook, Claude's Stop hook, and CI — so the gate is identical everywhere. - Coverage needs the `pcov` or Xdebug extension; without it, the gate warns instead of blocking on coverage only. - Disable the feature-doc requirement with `CLAUDE_KIT_FEATURE_DOCS=0`. Documentation ------------- [](#documentation) Full guides live in the [wiki](https://github.com/mohamed-ashraf-elsaed/claude-kit/wiki)and the [`docs/`](docs/) directory: - [Installation](docs/Installation.md) - [Usage](docs/Usage.md) - [Configuration](docs/Configuration.md) - [Frontend stacks](docs/Frontend-Stacks.md) - [Quality gate](docs/Quality-Gate.md) - [Skills](docs/Skills.md) - [Architecture](docs/Architecture.md) - [Publishing to Packagist](docs/Publishing.md) - [Upgrading](docs/Upgrading.md) - [FAQ](docs/FAQ.md) Contributing ------------ [](#contributing) Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) and the [Code of Conduct](CODE_OF_CONDUCT.md). Releases follow [SemVer](https://semver.org); see [RELEASING.md](RELEASING.md). Security -------- [](#security) Please report vulnerabilities privately — see [SECURITY.md](SECURITY.md). License ------- [](#license) The MIT License. See [LICENSE](LICENSE). ### Health Score 42 — FairBetter than 88% of packages Maintenance99 Actively maintained with recent releases Popularity16 Limited adoption so far Community2 Small or concentrated contributor base Maturity39 Early-stage or recently created project 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 ~0 days Total 4 Last Release 3d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/cc554f2d0e27d196758e968c9aca637d84850c4bad1b4f490f9edfe38877862e?d=identicon)[MohamedAshrafElsaed](/maintainers/MohamedAshrafElsaed) --- Tags pestPHPStanlaravelstatic analysisCode stylescaffoldingmcpaicode qualitylarastancursorclaudellmanthropiccoding-standardsdeveloper-toolsclaude-codePintai-agentsgithub-copilotgit-hooksconventionsdeveloper-experiencequality-gate ### Embed Badge ![Health badge](/badges/mohamed-ashraf-elsaed-claude-kit/health.svg) ``` [![Health](https://phpackages.com/badges/mohamed-ashraf-elsaed-claude-kit/health.svg)](https://phpackages.com/packages/mohamed-ashraf-elsaed-claude-kit) ``` ### Alternatives [laravel/ai The official AI SDK for Laravel. 1.0k3.2M205](/packages/laravel-ai)[larastan/larastan Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel 6.5k55.4M8.7k](/packages/larastan-larastan)[laravel/boost Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code. 3.5k21.5M615](/packages/laravel-boost)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9762.4M133](/packages/roots-acorn)[erag/laravel-lang-sync-inertia A powerful Laravel package for syncing and managing language translations across backend and Inertia.js (Vue/React/Svelte) frontends, offering effortless localization, auto-sync features, and smooth multi-language support for modern Laravel applications. 4925.3k](/packages/erag-laravel-lang-sync-inertia)[calebdw/larastan Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel 15118.7k4](/packages/calebdw-larastan) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)