Get claude-kit into a Laravel project and run it for the first time.
| PHP | 8.2+ |
| Laravel | 11, 12, or 13 |
| Claude Code | to use the rules, hooks, and skills |
| Node.js | only if you want a frontend stack or the skills.sh finder |
| pcov / Xdebug | optional, only if you ask the gate to enforce coverage |
flowchart TD
A[composer require --dev<br/>mohamed-ashraf-elsaed/claude-kit] --> B[php artisan claude-kit:install]
B --> C[Answer the prompts]
C --> D[composer require --dev …<br/>the installer offers it]
D --> E[composer install<br/>wires the git hook]
D --> E{Frontend stack?}
E -- yes --> F[npm install]
E -- no --> G[Fill CLAUDE.md TODOs]
F --> G
G --> H([Done — gate is live])
classDef k fill:#22c55e,stroke:#15803d,color:#fff;
class A,H k;
composer require --dev mohamed-ashraf-elsaed/claude-kit
php artisan claude-kit:install
composer install # wires the pre-commit hook (the installer offers the tooling itself)
npm install # only if a frontend stack was set upShow the VCS repository setup
Add a repository entry to your project's composer.json, then require the branch:
{
"repositories": [
{ "type": "vcs", "url": "https://github.com/mohamed-ashraf-elsaed/claude-kit" }
]
}composer require --dev mohamed-ashraf-elsaed/claude-kit:dev-main
php artisan claude-kit:install- Detects your frontend stack and asks you to confirm it.
- Walks you through every choice (see Usage).
- Writes the files, asking about any that already exist and differ (use
--forceto replace them) and mergingcomposer.json/package.json. - Works out the
composer require --dev …line your answers need, leaves out anything already installed, and offers to run it. - Wires the git hooks path if the project is a git repo.
# Run the gate manually
vendor/mohamed-ashraf-elsaed/claude-kit/runtime/quality-checks.shOpen Claude Code in the project, make a small change, and confirm the Stop hook runs the gate.
Tip
Coverage is not enforced unless you type a threshold at install time. If you do, it needs a driver — on Debian/Ubuntu: sudo apt install -y php8.4-pcov. Without one, tests still run and coverage is only warned.
- the offered
composer require --dev …ran (or you ran it yourself) -
composer installcompleted -
npm install(if a frontend stack was chosen) - Filled the
TODOplaceholders inCLAUDE.md - Coverage driver installed (optional)