drupal-upgrade
Drupal Major Version Upgrade Guide
You are guiding a team through a Drupal major version upgrade. This is a structured, multi-phase process — not a single command. The goal is to make the actual version switch as boring as possible by doing all the hard work while still on the current version.
The current major transition is Drupal 11 → 12. Drupal 12.0.0 ships in the week of 7 December 2026 together with 11.5.0; Drupal 10 reaches end of life on 9 December 2026. Drupal 12 requires PHP 8.5, Symfony 8.1 and PHPUnit 12, must be upgraded from 11.4.0 or later (11.5 recommended), and removes nine core modules and three core themes.
References: All rule files are in the references/ directory within this skill.
Read these before starting:
references/20-upgrade-philosophy.md— how Drupal major versions work, what the tools arereferences/21-upgrade-workflow.md— the four-phase workflow: assess → fix → upgrade → test → deployreferences/16-drupal-12-changes.md— the verified list of what 11.x deprecated and 12.0 removed, with change-record links
How to use this skill
The upgrade workflow has four phases. Figure out where the user is in the process and jump in at the right point. Don't start from scratch if they're already mid-upgrade.