PHPackages                             nowo-tech/claude-php-setup - 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. [Parsing &amp; Serialization](/categories/parsing)
4. /
5. nowo-tech/claude-php-setup

ActiveComposer-plugin[Parsing &amp; Serialization](/categories/parsing)

nowo-tech/claude-php-setup
==========================

Interactive CLI that generates customized Claude Code markdown files (CLAUDE.md, commands, agents) for PHP projects with Symfony, Laravel, Rector, PHPStan, PHP-CS-Fixer, GrumPHP and more.

v1.1.4(3mo ago)1863MITPHPPHP &gt;=8.1 &lt;8.6CI passing

Since Apr 8Pushed 3mo agoCompare

[ Source](https://github.com/nowo-tech/ClaudePhpSetup)[ Packagist](https://packagist.org/packages/nowo-tech/claude-php-setup)[ Docs](https://github.com/nowo-tech/ClaudePhpSetup)[ RSS](/packages/nowo-tech-claude-php-setup/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (5)Dependencies (8)Versions (6)Used By (0)

Claude PHP Setup
================

[](#claude-php-setup)

[![CI](https://github.com/nowo-tech/ClaudePhpSetup/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/ClaudePhpSetup/actions/workflows/ci.yml) [![Packagist Version](https://camo.githubusercontent.com/9af82cc837bf1c79e9abe8db8e689f165b53ba2fa7489113ab2ad52dcb78bbcf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f636c617564652d7068702d73657475702e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/claude-php-setup) [![Packagist Downloads](https://camo.githubusercontent.com/16e2f2d3f2bf6b522d03113131eb851b5b41f2bda1100bb29a538a18f558b6ea/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f636c617564652d7068702d73657475702e737667)](https://packagist.org/packages/nowo-tech/claude-php-setup) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) [![PHP](https://camo.githubusercontent.com/8e58b490725ac49cc8e463c473173681b324c9d92d7854275a785db013ca3de7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d3737374242343f6c6f676f3d706870)](https://php.net) [![Symfony](https://camo.githubusercontent.com/8fe7de83f11ab7ca74742794be56f9291632c8351a9ae5baea0bc1e9c4eb5a35/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d3625323025374325323037253230253743253230382d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com) [![GitHub stars](https://camo.githubusercontent.com/1063580c4bf51068924d48d38e5b48df5bf614e1ce45835f4a749aff689ba186/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f636c617564652d7068702d73657475702e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/ClaudePhpSetup) [![Coverage](https://camo.githubusercontent.com/cd0704b56f1d56def350b6d0164316307bb2f47834225fd85443b6fb0059bc73/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d3130302532352d627269676874677265656e)](#tests-and-coverage)

> ⭐ **Found this useful?** Install from [Packagist](https://packagist.org/packages/nowo-tech/claude-php-setup) and give the repo a [star on GitHub](https://github.com/nowo-tech/ClaudePhpSetup) if it helps you.

An interactive CLI wizard that generates **customised Claude Code markdown files** for PHP projects.

Answer a series of questions about your stack and the tool generates a `CLAUDE.md`, slash commands, sub-agents, optional **skills** (`.claude/skills/`) and **examples** (`examples/`) tailored to your exact setup — Symfony, Laravel, Rector, PHPStan, PHP-CS-Fixer, GrumPHP, PHPUnit, Pest, Twig, Doctrine, and more.

Installation
------------

[](#installation)

```
composer require --dev nowo-tech/claude-php-setup
```

Usage
-----

[](#usage)

```
vendor/bin/claude-php-setup
```

Re-run and overwrite existing files:

```
vendor/bin/claude-php-setup --overwrite
```

What it generates
-----------------

[](#what-it-generates)

### `CLAUDE.md`

[](#claudemd)

A comprehensive project-level instruction file for Claude Code, with sections tailored to your stack:

SectionIncluded whenStack overviewalwaysKey commands tableany QA tool configuredSymfony best practicesSymfony detectedLaravel best practicesLaravel detectedRector workflowRector installedPHPStan guidePHPStan installedPHP-CS-Fixer guidePHP-CS-Fixer installedGrumPHP guideGrumPHP installedPHPUnit testingPHPUnit installedPest testingPest installedDoctrine ORMDoctrine installedTwig templatesTwig installedPHP best practicesalwaysCode review guidelinesalwaysSymfony upgrade guideupgrading SymfonyOperational (API, Docker, CI, observability, MCP)when the wizard enables the matching options### `.claude/commands/` (slash commands)

[](#claudecommands-slash-commands)

CommandDescriptionRequires`/code-review`Review code for issues—`/qa-gate`Run full QA pipeline (style, analysis, tests)—`/rector-dry`Preview Rector changesRector`/rector-run`Apply Rector refactoringRector`/phpstan`Run PHPStan analysisPHPStan`/cs-fix`Fix code stylePHP-CS-Fixer`/test-run`Run test suitePHPUnit/Pest`/test-write`Write tests for a classPHPUnit/Pest`/twig-review`Review a Twig templateTwig`/make-entity`Scaffold a Doctrine entityDoctrine`/make-repository`Scaffold a repositoryDoctrine`/make-service`Create a Symfony serviceSymfony`/make-command`Create a Symfony commandSymfony`/symfony-upgrade`Step-by-step upgrade guideUpgrading`/grumphp-check`Run GrumPHP manuallyGrumPHP`/docker-exec`Run commands in Docker/ComposeDocker (wizard)`/migration-review`Review Doctrine migrationsDoctrine`/api-security-review`Review API securityHTTP API (wizard)### `.claude/agents/` (sub-agents)

[](#claudeagents-sub-agents)

AgentDescription`php-architect`Architecture &amp; design decisions`test-writer`Write comprehensive tests`refactor-agent`Automated code refactoring with Rector`symfony-upgrader`Guide Symfony upgrades step by step`doctrine-expert`Doctrine ORM, DQL, migrations`laravel-expert`Laravel conventions and structure`security-auditor`Security review checklist (OWASP-minded)`performance-php`Performance profiling and optimisation### `.claude/skills/` (optional)

[](#claudeskills-optional)

YAML-frontmatter skills used by Claude Code workflows — generated only if selected in the wizard (e.g. `php-quality`, `php-testing`, `rector-workflow`, `api-security`, `doctrine-data`, `docker-dev`, `ci-pipeline`, `observability`, `mcp-tools`).

### `examples/` (optional)

[](#examples-optional)

Sample workflows and prompts under `examples/` (README, workflows, prompts) when that generation step is enabled.

### `CLAUDE-USAGE.md` (optional)

[](#claude-usagemd-optional)

Repository-specific usage manual for team onboarding:

- requirements to run Claude in the project
- initialization checklist
- how to run generated slash commands, agents, and skills

Question Tree
-------------

[](#question-tree)

The wizard auto-detects your stack from `composer.json` and pre-fills answers. You confirm or adjust each one:

```
── Project Settings ──
  ? PHP version: [8.3]
  ? Framework: [symfony]
  ? Current Symfony version: [8.0]
  ? Are you upgrading Symfony? [N]

── Quality Tools ──
  ? Rector: [Y]
    ? Rector version: [version 2]
  ? PHPStan: [Y]
    ? PHPStan level: [level 8]
  ? PHP-CS-Fixer: [Y]
  ? GrumPHP: [N]

── Testing ──
  ? Testing framework: [phpunit]

── Architecture & Stack ──
  ? Twig templates: [Y]
  ? Doctrine ORM: [Y]
  ? Architecture style: [standard]
  ? Has REST / GraphQL API?: [N]
  ? Command runner for QA: [composer]

── Files to Generate ──
  ? Generate CLAUDE.md: [Y]
  ? Generate .claude/commands/: [Y]
    ? Select commands: (all)
  ? Generate .claude/agents/: [N]
  ? Generate CLAUDE-USAGE.md manual: [N]

```

Auto-detection
--------------

[](#auto-detection)

The wizard reads your `composer.json` and detects:

- **PHP version** from the `require.php` constraint
- **Framework** (Symfony, Laravel, Slim, Yii) from installed packages
- **Framework version** from the version constraint
- **Quality tools**: Rector, PHPStan, PHP-CS-Fixer, GrumPHP, Twig-CS-Fixer
- **Testing**: PHPUnit, Pest
- **Doctrine, Twig, API Platform** from installed packages
- **Rector version** (1.x vs 2.x)
- **PHPStan level** from `phpstan.neon`
- **Makefile** presence for command runner detection

Prompt navigation
-----------------

[](#prompt-navigation)

- Single-choice prompts support both:
    - arrow keys (`↑` / `↓`) + `Enter` in interactive terminals
    - numeric input (`1`, `2`, `3`, ...)

Related packages
----------------

[](#related-packages)

- [nowo-tech/php-quality-tools](https://packagist.org/packages/nowo-tech/php-quality-tools) — Pre-configured Rector, PHP-CS-Fixer and Twig-CS-Fixer
- [nowo-tech/code-review-guardian](https://packagist.org/packages/nowo-tech/code-review-guardian) — AI-powered automated code review

Documentation
-------------

[](#documentation)

- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [Contributing](docs/CONTRIBUTING.md)
- [Changelog](docs/CHANGELOG.md)
- [Upgrading](docs/UPGRADING.md)
- [Release](docs/RELEASE.md)
- [Security](docs/SECURITY.md)
- [Engram](docs/ENGRAM.md)

Tests and coverage
------------------

[](#tests-and-coverage)

- **Tests:** PHPUnit (`tests/Unit`, `tests/Integration`).
- **PHP (lines):** **100%** on covered `src/` paths (refresh with `make test-coverage`; the Makefile prints **Global PHP coverage (Lines)** at the end).
- **TS/JS:** N/A
- **Python:** N/A

Coverage configuration excludes interactive wizard orchestration files listed in `phpunit.xml.dist` (see file comments there).

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance80

Actively maintained with recent releases

Popularity21

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 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

Every ~0 days

Total

5

Last Release

107d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7947bfc3f2ce9574a18a2c60f3d95b5d1b0740e65dc929332c92f1df21f75ab?d=identicon)[HecFranco](/maintainers/HecFranco)

---

Top Contributors

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

---

Tags

phpsymfonyPHPStanlaravelaimarkdowncode qualityagentsclauderectordeveloper-toolsclaude-codephp-cs-fixergrumphp

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nowo-tech-claude-php-setup/health.svg)

```
[![Health](https://phpackages.com/badges/nowo-tech-claude-php-setup/health.svg)](https://phpackages.com/packages/nowo-tech-claude-php-setup)
```

###  Alternatives

[rumenx/php-sitemap

Framework-agnostic Sitemap generator for PHP, Laravel, and Symfony.

1.3k26.9k1](/packages/rumenx-php-sitemap)[event4u/data-helpers

Framework-agnostic PHP library for data mapping, DTOs and utilities. Includes DataMapper, SimpleDto/LiteDto, DataAccessor/Mutator/Filter and helper classes (MathHelper, EnvHelper, etc.). Works with Laravel, Symfony/Doctrine or standalone PHP.

1431.1k](/packages/event4u-data-helpers)[sci3ma/symfony-grumphp

Configured GrumPHP with bunch of tools for static code analysis Symfony Framework

196.8k](/packages/sci3ma-symfony-grumphp)

PHPackages © 2026

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