Login
netresearch/php-modernization-skill(MIT AND CC-BY-SA-4.0)36 files

Php Modernization

Use when modernizing PHP code: PHP 8.1-8.5 features, PSR/PHP-FIG/PER-CS compliance, PHPStan/Rector/PHP-CS-Fixer/PHPat tooling, DTOs/enums/readonly/property hooks, type safety. Triggers: PHP modernization, type safety, PHPStan, Rector, PHP-CS-Fixer, enum, DTO, readonly, strict_types, property hooks, PHP 8.4, PHP 8.5.

Use this skillView repositoryView on skills.sh
Specification
Skill ID
netresearch/php-modernization-skill/php-modernization
Publisher
netresearch
Repository
php-modernization-skill
Installs
0
Files
36
License
(MIT AND CC-BY-SA-4.0)
Requires
Requires php 8.1+, composer.
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

netresearch/php-modernization-skill/php-modernizationInstalls these files
  • SKILL.md
  • checkpoints.yaml
  • references/adapter-registry-pattern.md
  • references/api-platform-edges.md
  • references/composer-package-metadata.md
  • references/contracts-and-invariants.md
  • references/core-rules.md
  • references/doctrine-modernization-edges.md
  • references/immutability-boundaries.md
  • references/lexing-php-across-versions.md
  • references/migration-strategies.md
  • references/multi-agent-pitfalls.md
  • references/multi-version-adapters.md
  • references/mutation-testing.md
  • references/php-8.4.md
  • references/php-8.5.md
  • references/php-cs-fixer-deprecations.md
  • references/php8-features.md
  • references/phpstan-compliance.md
  • references/phpunit-modernization.md
  • references/psr-per-compliance.md
  • references/psr15-middleware-architecture.md
  • references/public-api-inventory.md
  • references/reading-php-config-safely.md
  • references/request-dtos.md
  • references/static-analysis-tools.md
  • references/symfony-patterns.md
  • references/type-safety.md
  • scripts/_common.py
  • scripts/introspect.py
  • scripts/modernize_loop.py
  • scripts/verify-php-project.sh
  • scripts/verify_php_project.py
  • templates/README.md
  • templates/composer-scripts.json
  • templates/github-actions/php-modernization.yml

What this skill tells the agent

PHP Modernization

Agent contract

  1. Discover: uv run ${CLAUDE_SKILL_DIR}/scripts/introspect.py (cheap), or verify_php_project.py --summary (full, with agent_actions[]).
  2. Drill: ... --check PM-XX per finding. Full output when triaging >3.
  3. Apply: uv run ${CLAUDE_SKILL_DIR}/scripts/modernize_loop.py --mode dry-run. Review transcript before applying.
  4. References: load on demand; do not pre-load.

Reference routing

NeedRead
PHP 8.0-8.3 baselinereferences/php8-features.md
PHP 8.4references/php-8.4.md
PHP 8.5references/php-8.5.md
PSR / PER-CSreferences/psr-per-compliance.md
PHPStan configreferences/phpstan-compliance.md
Static analysisreferences/static-analysis-tools.md
PHP-CS-Fixer deprecationsreferences/php-cs-fixer-deprecations.md
DTOs / VOs / inputsreferences/type-safety.md, references/request-dtos.md
Adapter / registryreferences/adapter-registry-pattern.md
Multi-version compatreferences/multi-version-adapters.md, references/composer-package-metadata.md
Symfony patternsreferences/symfony-patterns.md
PSR-15 middlewarereferences/psr15-middleware-architecture.md
Doctrine edgesreferences/doctrine-modernization-edges.md
API Platformreferences/api-platform-edges.md
Immutabilityreferences/immutability-boundaries.md
Contracts & invariantsreferences/contracts-and-invariants.md
Mutation testingreferences/mutation-testing.md
Lexing PHP as tokens, across versionsreferences/lexing-php-across-versions.md
Migration planningreferences/migration-strategies.md
Public API inventory vs consumersreferences/public-api-inventory.md
PHPUnit 12→13, mock vs stubreferences/phpunit-modernization.md
Multi-agent dispatch hazardsreferences/multi-agent-pitfalls.md
Reading a PHP config file without running itreferences/reading-php-config-safely.md

Hard guardrails

  • Never apply readonly to Doctrine entities or mapped-superclasses (embeddables: see references/doctrine-modernization-edges.md).
  • Never run Rector without --dry-run. Invoke vendor/bin/rector directly — composer script aliases can drop ---forwarded flags depending on configuration.
  • Never raise PHPStan level without regenerating + committing the baseline. Shrink, never delete.
  • Never apply blanket final to mock targets or extension points without confirmation.
  • Never edit @generated files or files under var/cache/, vendor/, node_modules/, .Build/.
  • Never git checkout -- files outside your scope in shared trees — use git stash / git diff.
  • Never trust a warm PHPStan cache after vendor change: rm -rf /tmp/phpstan-* var/cache/phpstan first.
  • Never mass-substitute createMock → createStub — promote to expects(...)->method(...)->with(...).

Migration checklist

  • [ ] declare(strict_types=1) everywhere
  • [ ] @PER-CS, no deprecated aliases
  • [ ] PHPStan ≥9 (treatPhpDocTypesAsCertain: false); 10 for new
  • [ ] PHPat for layer boundaries
  • [ ] Return + parameter types on all methods
  • [ ] DTOs over arrays; backed enums over constants
  • [ ] PSR interfaces in type-hints
  • [ ] #[Override] (8.3+), #[SensitiveParameter] (8.2+), typed constants (8.3+)
  • [ ] readonly on DTOs/VOs/events only
  • [ ] Property hooks (8.4); array_find/any/all (8.4); pipe |> (8.5)
  • [ ] PHPUnit 12+: stubs use createStub, mocks createMock + expects (no self::any() in 13)
  • [ ] Rector withComposerBased(symfony: true) (per-version SymfonySetList::SYMFONY_* are @deprecated)

More from netresearch

netresearch/agent-rules-skill

Agent Rules

Use when creating or updating AGENTS.md files, .github/copilot-instructions.md, or other AI agent rule files, onboarding AI agents to a project, standardizing agent documentation, or when anyone mentions AGENTS.md, agent rules, project onboarding, or codebase documentation for AI agents.

netresearch/context7-skill

Context7

Use when looking up library documentation, API references, framework patterns, or code examples for ANY library (React, Next.js, Vue, Django, Laravel, etc.) and the Context7 MCP server is unavailable or not configured. Fetches the same current docs directly via the Context7 REST API as a fallback. Triggers on: how to use library, API docs, framework pattern, import usage, library example.

netresearch/file-search-skill

File Search

Use when searching codebases (text, structural/AST, files by name, PDFs/archives, code stats) or building context before a task.

Use this skill in a project

Open any RiverX project, search the Skills panel for netresearch/php-modernization-skill/php-modernization, and install it in one click.

Use this skill