rails-upgrade-5-to-6

What problem does it solve?

Upgrading a Ruby on Rails application from 5.x to 6.x introduces high-risk breaking changes including the mandatory Zeitwerk autoloader transition, default Webpacker adoption, and credential system overhauls that can cause unexpected runtime errors and broken functionality if handled incorrectly.

Core Features & Use Cases

• Safe Version Hop Sequence: Guides teams through the recommended 5.0 → 5.1 → 5.2 → 6.0 → 6.1 upgrade path to minimize risk.
• Zeitwerk Migration Support: Provides step-by-step instructions for transitioning from the Classic autoloader, including check mode usage and inflection fixes for common naming mismatches.
• Informed Webpacker Decisions: Helps teams evaluate whether to adopt Webpacker, stick with Sprockets, or defer to Rails 7 importmap based on their actual JavaScript needs.
• Use Case: A team maintaining a Rails 5.2 e-commerce application can use this skill to plan and execute a smooth upgrade to Rails 6.1 without breaking existing autoloaded classes or asset pipelines.

Quick Start

Use the rails-upgrade-5-to-6 skill to create a safe, step-by-step upgrade plan for your Rails 5.x application to Rails 6.x, including Zeitwerk autoloader migration guidance and Webpacker adoption recommendations.