Rails Upgrade Guide — Internal Reference

This skill is an internal reference for the ruby-upgrade-toolkit plugin. It is loaded by the audit and fix skills when they need version-specific Rails guidance. Do not activate this skill directly in response to user requests.

Version Reference Files

Load the appropriate file from $CLAUDE_PLUGIN_ROOT/skills/rails-upgrade-guide/references/ for the upgrade path being processed:

• Rails 5 → 6: references/rails-5-to-6.md
• Rails 6 → 7: references/rails-6-to-7.md
• Rails 7 → 8: references/rails-7-to-8.md

Supporting Reference Files

• Fix patterns: references/fix-patterns.md — safe vs. guided deprecation fixes by Rails version
• Compatibility matrix: references/compatibility-matrix.md — minimum gem versions per Rails version
• Risky migration patterns: references/risky-patterns.md — database migration safety guidance
• Turbo/Stimulus migration: references/turbo-stimulus-guide.md — Turbolinks → Turbo migration for Rails 7+