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

examples/simple-upgrade.md

View on GitHub
# Example: Simple Single-Hop Upgrade

**Scenario:** Upgrading from Rails 7.1 to Rails 7.2

---

## User Request

"I want to upgrade my Rails app from 7.1 to 7.2"

---

### Claude Response

I'll help you upgrade from Rails 7.1 to 7.2. Let me find any breaking changes in your codebase.

## Detection Results

# Rails 7.1 → 7.2 Upgrade Report

**Generated:** January 30, 2025
**Project:** my-blog
**Current Version:** 7.1.x
**Target Version:** 7.2.x

## Summary

- **Total Issues Found:** 5
- **High Priority:** 5
- **Medium Priority:** 0
- **Estimated Effort:** 2-3 hours

---

## Breaking Changes Analysis

### šŸ”“ Transaction-aware job enqueuing

**Priority:** HIGH
**Found:** 3 occurrences
**Affected Files:**
- app/models/article.rb
- app/controllers/comments_controller.rb

#### What Changed
Rails 7.2 now defers job enqueuing until after the current database transaction commits. This ensures data consistency but changes timing behavior.

#### Your Code (Before)
```ruby
# app/models/article.rb
class Article < ApplicationRecord
  after_create :notify_subscribers

  def notify_subscribers
    NotifySubscribersJob.perform_later(self)
  end
end
```

#### Required Change (After)
```ruby
# app/models/article.rb
class Article < ApplicationRecord
  after_create_commit :notify_subscribers  # Use after_create_commit instead

  def notify_subscribers
    NotifySubscribersJob.perform_later(self)
  end
end
```

āš ļø **Custom Code Warning:** Your `article.rb` enqueues jobs inside model callbacks. Test that the job receives valid (persisted) data after the transaction commits.

---

### šŸ”“ show_exceptions configuration

**Priority:** HIGH
**Found:** 2 occurrences
**Affected Files:**
- config/environments/development.rb
- config/environments/test.rb

#### What Changed
Rails 7.2 requires symbol values (`:all`, `:rescuable`, `:none`) instead of boolean values.

#### Your Code (Before)
```ruby
# config/environments/development.rb
config.consider_all_requests_local = true
config.action_dispatch.show_exceptions = true

# config/environments/test.rb
config.consider_all_requests_local = true
config.action_dispatch.show_exceptions = false
```

#### Required Change (After)
```ruby
# config/environments/development.rb
config.consider_all_requests_local = true
config.action_dispatch.show_exceptions = :all

# config/environments/test.rb
config.consider_all_requests_local = true
config.action_dispatch.show_exceptions = :rescuable
```

---

## Step-by-Step Migration Plan

### Phase 1: Preparation (30 min)
- [ ] Backup database
- [ ] Create upgrade branch: `git checkout -b rails-72-upgrade`
- [ ] Run current test suite (ensure passing)

### Phase 2: Dependency Updates (30 min)
- [ ] Update Gemfile:
  ```ruby
  gem 'rails', '~> 7.2.0'
  ```
- [ ] Run `bundle update rails`

### Phase 3: Fix Breaking Changes (1-2 hours)
- [ ] Update `config/environments/development.rb`
- [ ] Update `config/environments/test.rb`
- [ ] Review job callbacks in `app/models/article.rb`
- [ ] Review job calls in `app/controllers/comments_controller.rb`

### Phase 4: Configuration (30 min)
- [ ] Run `rails app:update`
- [ ] Update `config.load_defaults` to 7.2

### Phase 5: Testing (1 hour)
- [ ] Run full test suite
- [ ] Test article creation (verify job timing)
- [ ] Test comment creation

---

## Testing Checklist

- [ ] All existing tests pass
- [ ] Article creation triggers notification job (after commit)
- [ ] Comment features work correctly
- [ ] Error pages display correctly in development
- [ ] Test environment shows proper error handling

---

## app:update Preview

### Files that will change:

| File | Change | Impact |
|------|--------|--------|
| config/environments/development.rb | show_exceptions update | MEDIUM |
| config/environments/test.rb | show_exceptions update | MEDIUM |
| config/application.rb | load_defaults 7.2 | LOW |

---

## Next Steps

1. Start with the configuration changes (quick wins)
2. Test the transaction-aware job behavior thoroughly
3. Run `rails app:update` and review changes
4. Let me know if you need help with any specific change!
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