symfony-upgrade

Installation
SKILL.md

Symfony Framework Upgrade

Symfony's upgrade model is built on one core insight: a new major version is identical to the last minor version of the previous branch, minus deprecated code. Fix all deprecations first, then the major upgrade is trivial.

Core Principles

Principle Meaning
Changelog first Before any upgrade, search the web for the actual UPGRADE-X.Y.md file or ask the user for the changelog -- never rely on static knowledge alone
Deprecation-first Fix every deprecation on the current version before upgrading to the next major -- Symfony 8.0 is 7.4 minus deprecations
Incremental minor upgrades Upgrade 6.2 -> 6.3 -> 6.4, never skip minors -- each surfaces new deprecations
Recipes keep config current Run composer recipes:update after every upgrade to sync configuration files
Test deprecation count Use SYMFONY_DEPRECATIONS_HELPER to fail builds when direct deprecations appear
Update bundles first Third-party bundles are the most common blocker -- update them before bumping Symfony

Critical First Step: Read the Changelog

Related skills

More from krzysztofsurdy/code-virtuoso

Installs
95
GitHub Stars
17
First Seen
Mar 7, 2026