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

detection-scripts/patterns/rails-72-patterns.yml

View on GitHub
version: "7.2"
description: "Breaking change patterns for Rails 7.1 → 7.2 upgrade"

upgrade_findings:
  high_priority:
    - name: "Transaction-aware job enqueuing"
      kind: "migration"
      pattern: "perform_later|deliver_later"
      exclude: ""
      search_paths:
        - "app/models/"
        - "app/controllers/"
        - "app/services/"
      explanation: "Rails 7.2 defers job enqueuing until after transaction commits by default"
      fix: "Test jobs enqueued inside transactions. Jobs now wait for commit. Use perform_now for immediate execution."
      variable_name: "TRANSACTION_JOBS"

    - name: "show_exceptions configuration"
      kind: "breaking"
      pattern: "show_exceptions\\s*=\\s*(true|false)"
      exclude: ""
      search_paths:
        - "config/environments/"
      explanation: "Rails 7.2 requires symbol values instead of booleans for show_exceptions"
      fix: "Change true to :all, false to :none, or use :rescuable"
      variable_name: "SHOW_EXCEPTIONS"

    - name: "params comparison removed"
      kind: "breaking"
      pattern: "params\\s*==|==\\s*params"
      exclude: ""
      search_paths:
        - "app/controllers/"
        - "app/"
      explanation: "ActionController::Parameters no longer compares equal to Hash"
      fix: "Replace params == hash with params.to_h == hash"
      variable_name: "PARAMS_COMPARISON"

    - name: "ActiveRecord.connection deprecated"
      kind: "deprecation"
      pattern: "ActiveRecord::Base\\.connection(?!_pool)"
      exclude: "with_connection"
      search_paths:
        - "app/"
        - "lib/"
      explanation: "ActiveRecord::Base.connection is deprecated in Rails 7.2"
      fix: "Use with_connection block or lease_connection for connection pooling"
      variable_name: "AR_CONNECTION"

    - name: "Rails.application.secrets removed"
      kind: "breaking"
      pattern: "Rails\\.application\\.secrets"
      exclude: ""
      search_paths:
        - "app/"
        - "lib/"
        - "config/"
      explanation: "Rails.application.secrets is completely removed in Rails 7.2"
      fix: "Migrate all secrets to Rails.application.credentials"
      variable_name: "SECRETS_REMOVED"

    - name: "ActiveRecord::Migration.check_pending! removed"
      kind: "breaking"
      pattern: "Migration\\.check_pending!"
      exclude: ""
      search_paths:
        - "test/"
        - "spec/"
        - "config/"
        - "lib/"
      explanation: "ActiveRecord::Migration.check_pending! was deprecated in Rails 7.1 and is removed in Rails 7.2. Calling it raises NoMethodError. When invoked from test_helper.rb or rails_helper.rb it breaks test suite startup; when configured by a healthcheck gem (e.g. rails-healthcheck) it instead raises at runtime on the /healthcheck route in production."
      fix: "Replace ActiveRecord::Migration.check_pending! with ActiveRecord::Migration.check_all_pending!"
      variable_name: "MIGRATION_CHECK_PENDING_REMOVED"

    - name: "Ruby version"
      kind: "breaking"
      pattern: "^\\s*(?:ruby\\s*\\(?\\s*[\"'](?:=\\s*|~>\\s*(?=\\d+\\.\\d+\\.\\d))?|ruby-|ruby\\s+)?(?:2\\.\\d+|3\\.0)(?:\\.\\d+)*(?![\\d.])|^\\s*ruby\\s*\\(?\\s*[\"']~>\\s*2\\.\\d+(?![\\d.])"
      exclude: ""
      search_paths:
        - "Gemfile"
        - ".ruby-version"
        - ".tool-versions"
      explanation: "Rails 7.2 requires Ruby 3.1.0 or newer (required_ruby_version >= 3.1.0 in the rails 7.2 gemspec; 7.1 accepts >= 2.7.0), so Bundler refuses to install 7.2 on Ruby 3.0 or older. Flags a Ruby below 3.1 in .ruby-version or .tool-versions, and a Gemfile `ruby` line that rules out 3.1: an exact version (`3.0.6`), `~> 3.0.6` (below 3.1) or `~> 2.7` (below 3.0). A requirement that still allows 3.1, such as `~> 3.0` or `>= 2.7.0`, is not flagged: Bundler checks it against the Ruby that runs"
      fix: "Upgrade Ruby to 3.1 or newer while the app is still on Rails 7.1, as its own step before the Rails bump. See the \"Ruby Version Requirement\" entry in the 7.1 to 7.2 guide"
      variable_name: "RUBY_VERSION"

  medium_priority:
    - name: "serialize syntax change"
      kind: "breaking"
      pattern: "serialize\\s+:\\w+(?!.*(?:type:|coder:))"
      exclude: ""
      search_paths:
        - "app/models/"
      explanation: "serialize requires explicit type: or coder: parameter in Rails 7.2"
      fix: "Add type: YAML or type: JSON to serialize declarations"
      variable_name: "SERIALIZE_SYNTAX"

    - name: "fixture_path deprecated"
      kind: "deprecation"
      pattern: "fixture_path[^s]"
      exclude: "fixture_paths"
      search_paths:
        - "test/"
        - "spec/"
        - "config/"
      explanation: "fixture_path singular is deprecated in favor of fixture_paths plural"
      fix: "Change fixture_path to fixture_paths (array)"
      variable_name: "FIXTURE_PATH"
      prereqs:
        - gem: "rspec-rails"
          min_version: "6.1.0"
          reason: "config.fixture_paths= is forwarded from RSpec::Core::Configuration only on rspec-rails 6.1+. On 6.0.x the new setter raises NoMethodError."
          when: "rspec-rails is present in the bundle"

    - name: "query_constraints deprecated"
      kind: "deprecation"
      pattern: "query_constraints"
      exclude: ""
      search_paths:
        - "app/models/"
      explanation: "query_constraints is deprecated in Rails 7.2"
      fix: "Use foreign_key instead of query_constraints"
      variable_name: "QUERY_CONSTRAINTS"

    - name: "mailer test args syntax"
      kind: "deprecation"
      pattern: "args:\\s*\\["
      exclude: ""
      search_paths:
        - "test/mailers/"
        - "spec/mailers/"
      explanation: "Mailer test helper changes args: to params: in Rails 7.2"
      fix: "Replace args: with params: in mailer tests"
      variable_name: "MAILER_TEST_ARGS"

    - name: "autoload_lib syntax"
      kind: "optional"
      pattern: "autoload_lib.*%w\\("
      exclude: ""
      search_paths:
        - "config/application.rb"
      explanation: "autoload_lib syntax updated in Rails 7.2"
      fix: "Change %w() to %w[] for consistency"
      variable_name: "AUTOLOAD_LIB_SYNTAX"


dependencies:
  ruby:
    minimum: "3.1.0"
    recommended: "3.3.0"
    message: "Rails 7.2 requires Ruby 3.1+ (3.3 recommended)"
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