Skip to content

ombulabs/claude-code_rails-upgrade-skill / rails-upgrade

rails-upgrade

Verified

Analyzes Rails applications and generates comprehensive upgrade reports with breaking changes, deprecations, and step-by-step migration guides for Rails 2.3 through 8.1. Use when upgrading Rails applications, planning multi-hop upgrades, querying version-specific changes, or answering what stands between the app and the next Rails version. Based on FastRuby.io methodology and "The Complete Guide to Upgrade Rails" ebook.

FileKindSize
SKILL.mdskill md11.0 KB
detection-scripts/gem_limits.rbscript6.0 KB
detection-scripts/hop.rbscript2.2 KB
detection-scripts/patterns/rails-40-patterns.expectations.ymlconfig43.8 KB
detection-scripts/patterns/rails-40-patterns.ymlconfig96.5 KB
detection-scripts/patterns/rails-41-patterns.expectations.ymlconfig25.6 KB
detection-scripts/patterns/rails-41-patterns.ymlconfig59.8 KB
detection-scripts/patterns/rails-42-patterns.expectations.ymlconfig27.5 KB
detection-scripts/patterns/rails-42-patterns.ymlconfig48.7 KB
detection-scripts/patterns/rails-50-patterns.expectations.ymlconfig1.9 KB
detection-scripts/patterns/rails-50-patterns.ymlconfig8.1 KB
detection-scripts/patterns/rails-51-patterns.expectations.ymlconfig4.2 KB
detection-scripts/patterns/rails-51-patterns.ymlconfig15.0 KB
detection-scripts/patterns/rails-52-patterns.expectations.ymlconfig5.0 KB
detection-scripts/patterns/rails-52-patterns.ymlconfig14.7 KB
detection-scripts/patterns/rails-60-patterns.expectations.ymlconfig1007 B
detection-scripts/patterns/rails-60-patterns.ymlconfig14.2 KB
detection-scripts/patterns/rails-70-patterns.expectations.ymlconfig4.0 KB
detection-scripts/patterns/rails-70-patterns.ymlconfig11.2 KB
detection-scripts/patterns/rails-71-patterns.expectations.ymlconfig3.1 KB
detection-scripts/patterns/rails-71-patterns.ymlconfig9.5 KB
detection-scripts/patterns/rails-72-patterns.expectations.ymlconfig1.2 KB
detection-scripts/patterns/rails-72-patterns.ymlconfig6.1 KB
detection-scripts/patterns/rails-80-patterns.expectations.ymlconfig6.6 KB
detection-scripts/patterns/rails-80-patterns.ymlconfig21.2 KB
detection-scripts/patterns/rails-81-patterns.expectations.ymlconfig4.3 KB
detection-scripts/patterns/rails-81-patterns.ymlconfig13.2 KB
detection-scripts/scan_patterns.rbscript42.8 KB
examples/multi-hop-upgrade.mdmarkdown18.9 KB
examples/simple-upgrade.mdmarkdown4.0 KB
references/breaking-changes-by-version-reference.mdmarkdown3.9 KB
references/deprecation-warnings-reference.mdmarkdown10.7 KB
references/gem-compatibility-reference.mdmarkdown8.2 KB
references/js-compressor-sprockets-mismatch-reference.mdmarkdown4.7 KB
references/multi-hop-strategy-reference.mdmarkdown8.8 KB
references/next-hop-readiness-reference.mdmarkdown2.1 KB
references/no-test-suite-smoke-reference.mdmarkdown4.7 KB
references/request-patterns-reference.mdmarkdown3.7 KB
references/sequential-strategy-reference.mdmarkdown2.1 KB
references/staying-current-reference.mdmarkdown7.8 KB
references/testing-checklist-reference.mdmarkdown6.3 KB
templates/app-update-preview-template.mdmarkdown4.3 KB
templates/upgrade-report-template.mdmarkdown10.2 KB
version-guides/upgrade-3.2-to-4.0.mdmarkdown68.0 KB
version-guides/upgrade-4.0-to-4.1.mdmarkdown66.7 KB
version-guides/upgrade-4.1-to-4.2.mdmarkdown60.7 KB
version-guides/upgrade-4.2-to-5.0.mdmarkdown9.7 KB
version-guides/upgrade-5.0-to-5.1.mdmarkdown19.1 KB
version-guides/upgrade-5.1-to-5.2.mdmarkdown17.7 KB
version-guides/upgrade-5.2-to-6.0.mdmarkdown6.4 KB
version-guides/upgrade-6.0-to-6.1.mdmarkdown6.8 KB
version-guides/upgrade-6.1-to-7.0.mdmarkdown14.7 KB
version-guides/upgrade-7.0-to-7.1.mdmarkdown13.2 KB
version-guides/upgrade-7.1-to-7.2.mdmarkdown11.2 KB
version-guides/upgrade-7.2-to-8.0.mdmarkdown23.1 KB
version-guides/upgrade-8.0-to-8.1.mdmarkdown14.0 KB
workflows/00-verify-latest-patch-workflow.mdmarkdown1.7 KB
workflows/01-run-test-suite-workflow.mdmarkdown12.7 KB
workflows/02-resolve-deprecation-warnings-workflow.mdmarkdown6.3 KB
workflows/03-validate-upgrade-path-workflow.mdmarkdown1.8 KB
workflows/04-setup-next-rails-workflow.mdmarkdown1.5 KB
workflows/05-detect-breaking-changes-workflow.mdmarkdown20.0 KB
workflows/06-check-gem-compatibility-workflow.mdmarkdown11.1 KB
workflows/07-boot-smoke-test-workflow.mdmarkdown7.3 KB
workflows/08-generate-upgrade-report-workflow.mdmarkdown12.7 KB
workflows/09-generate-app-update-preview-workflow.mdmarkdown7.3 KB
workflows/10-implement-and-upgrade-workflow.mdmarkdown2.5 KB
workflows/11-sync-ci-workflow.mdmarkdown8.6 KB
workflows/12-align-load-defaults-workflow.mdmarkdown952 B
workflows/13-mention-cleanup-workflow.mdmarkdown1.3 KB

references/breaking-changes-by-version-reference.md

View on GitHub
# Breaking Changes by Version - Quick Reference

**Complete comparison table for Rails 5.0 → 8.1**

---

## Summary Statistics

| Version | Total Changes | HIGH | MEDIUM | LOW | Difficulty | Ruby Requirement |
|---------|--------------|------|--------|-----|------------|------------------|
| **5.0 → 5.1** | 8 | 2 | 4 | 2 | ⭐ Easy | 2.2.2+ |
| **5.1 → 5.2** | 10 | 3 | 5 | 2 | ⭐⭐ Medium | 2.2.2+ |
| **5.2 → 6.0** | 15 | 5 | 6 | 4 | ⭐⭐⭐ Hard | 2.5.0+ |
| **6.0 → 6.1** | 12 | 3 | 6 | 3 | ⭐⭐ Medium | 2.5.0+ |
| **6.1 → 7.0** | 18 | 5 | 8 | 5 | ⭐⭐⭐ Hard | 2.7.0+ |
| **7.0 → 7.1** | 12 | 5 | 4 | 3 | ⭐⭐ Medium | 2.7.0+ |
| **7.1 → 7.2** | 15 | 5 | 7 | 3 | ⭐⭐ Medium | 3.1.0+ |
| **7.2 → 8.0** | 13 | 5 | 5 | 3 | ⭐⭐⭐⭐ Very Hard | 3.2.0+ |
| **8.0 → 8.1** | 8 | 3 | 3 | 2 | ⭐ Easy | 3.2.0+ |

---

## Rails 5.2 → 6.0 (HIGH Impact)

| Change | Impact | Fix |
|--------|--------|-----|
| Zeitwerk autoloader | ALL apps | Remove require_dependency, fix naming |
| Ruby 2.5+ required | ALL apps | Upgrade Ruby first |
| belongs_to required | Models | Add optional: true where needed |
| update_attributes deprecated (removed in 6.1) | ALL apps | Change to update |
| protect_from_forgery default | Controllers | Review CSRF settings |

---

## Rails 6.1 → 7.0 (HIGH Impact)

| Change | Impact | Fix |
|--------|--------|-----|
| Ruby 2.7+ required | ALL apps | Upgrade Ruby first |
| Webpacker → Import Maps | Frontend | Migrate JS bundling strategy |
| Turbolinks → Turbo | Frontend | Update event listeners |
| rails-ujs removed | Forms | Use Turbo for remote forms |
| secrets → credentials | Config | Migrate secrets to credentials |

---

## Rails 7.1 → 7.2 (HIGH Impact)

| Change | Impact | Fix |
|--------|--------|-----|
| Transaction-aware jobs | Models with jobs | Test job timing in transactions |
| show_exceptions symbols | ALL envs | true → :all, false → :none |
| params comparison | Controllers | Use params.to_h == hash |
| AR.connection deprecated | Database code | Use with_connection block |
| secrets removed | ALL apps | Migrate to credentials |

---

## Rails 7.2 → 8.0 (HIGH Impact)

| Change | Impact | Fix |
|--------|--------|-----|
| Sprockets → Propshaft | ALL apps | Migrate asset pipeline |
| Solid gems defaults | Optional | Keep Redis or migrate |
| assume_ssl setting | Production | Add to production.rb |
| Multi-database config | Database | Restructure database.yml |
| Docker/Kamal | Deployment | Review deployment config |

---

## Rails 8.0 → 8.1 (HIGH Impact)

| Change | Impact | Fix |
|--------|--------|-----|
| SSL commented out | Production | Uncomment if not using Kamal |
| pool → max_connections | Database | Update database.yml |
| bundler-audit required | Security | Add gem and script |

---

## Most Impactful Changes (All Versions)

1. **Zeitwerk autoloader** (6.0) - Fundamental change to code loading
2. **Propshaft asset pipeline** (8.0) - Complete asset system replacement
3. **Webpacker → Import Maps** (7.0) - JavaScript bundling overhaul
4. **Transaction-aware jobs** (7.2) - Behavior change in job timing
5. **Ruby version jumps** - Required at 6.0, 7.0, 7.2

---

## Pre-Upgrade Checklist

Before ANY upgrade:

- [ ] Ruby version meets minimum requirement
- [ ] Test coverage is adequate (aim for 70%+)
- [ ] All current tests pass
- [ ] Database is backed up
- [ ] Git branch created for upgrade
- [ ] Bundle outdated reviewed
- [ ] Deprecation warnings addressed

---

## Quick Decision Matrix

| Scenario | Recommendation |
|----------|----------------|
| 5.2 app, active development | Upgrade through all versions to 8.x |
| 6.0 app, moderate changes | Upgrade to 7.x minimum |
| 7.0 app, light maintenance | Upgrade to 7.2 |
| 7.2 app, ready for change | Upgrade to 8.0/8.1 |
| Any app, no test coverage | Add tests before upgrading |

---

**For detailed information, see version-specific guides in `version-guides/`**
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall