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/testing-checklist-reference.md

View on GitHub
# Testing Checklist for Rails Upgrades

**Comprehensive testing checklist based on FastRuby.io methodology**

---

## Pre-Upgrade Testing

### 1. Current State Verification

- [ ] All existing tests pass
- [ ] Run with deprecation warnings enabled:
  ```bash
  RUBYOPT="-W:deprecated" bundle exec rspec
  ```
- [ ] Note current test coverage percentage
- [ ] Document any known failing tests

### 2. Establish Baseline

- [ ] Record current boot time
- [ ] Record average request time
- [ ] Record memory usage
- [ ] Capture current error rate
- [ ] Screenshot key pages

---

## During Upgrade Testing

### 1. After Each Change

- [ ] Application boots without errors
- [ ] Run quick smoke test (5 critical flows)
- [ ] No new deprecation warnings introduced

### 2. After bundle update rails

- [ ] `rails console` works
- [ ] `rails server` starts
- [ ] Basic route works (hit homepage)

### 3. After rails app:update

- [ ] Review each config change
- [ ] Application still boots
- [ ] Run test suite

---

## Post-Upgrade Testing

### Automated Tests

#### Unit Tests
- [ ] Model tests pass
- [ ] Service object tests pass
- [ ] Library tests pass
- [ ] Concern tests pass

#### Controller Tests
- [ ] Index actions work
- [ ] Show actions work
- [ ] Create actions work
- [ ] Update actions work
- [ ] Delete actions work
- [ ] API endpoints work

#### Integration Tests
- [ ] Multi-step workflows pass
- [ ] Authentication flows work
- [ ] Authorization checks work

#### System/Feature Tests
- [ ] JavaScript interactions work
- [ ] Form submissions work
- [ ] File uploads work
- [ ] Navigation flows work

---

### Manual Testing Checklist

#### Authentication & Authorization
- [ ] User can sign up
- [ ] User can log in
- [ ] User can log out
- [ ] Password reset works
- [ ] OAuth login works (if applicable)
- [ ] Session timeout works
- [ ] Remember me works
- [ ] Role-based access works

#### Core Features
- [ ] Main dashboard loads
- [ ] Search functionality works
- [ ] Filtering works
- [ ] Sorting works
- [ ] Pagination works
- [ ] CRUD operations work

#### File Handling
- [ ] File upload works
- [ ] Image upload works
- [ ] File download works
- [ ] Image processing works (variants)
- [ ] Direct uploads work (if using)

#### Email
- [ ] Emails are sent
- [ ] Email templates render correctly
- [ ] Links in emails work
- [ ] Attachments work
- [ ] Mailer previews work

#### Background Jobs
- [ ] Jobs enqueue correctly
- [ ] Jobs process correctly
- [ ] Failed jobs retry
- [ ] Job callbacks fire
- [ ] Scheduled jobs run

#### Real-time Features (if applicable)
- [ ] ActionCable connections work
- [ ] WebSocket messages deliver
- [ ] Broadcast works
- [ ] Subscriptions work

#### API (if applicable)
- [ ] Authentication works
- [ ] JSON responses correct
- [ ] Status codes correct
- [ ] Rate limiting works
- [ ] CORS works

#### Assets
- [ ] CSS loads correctly
- [ ] JavaScript loads correctly
- [ ] Images load correctly
- [ ] Fonts load correctly
- [ ] Asset fingerprinting works
- [ ] Asset compilation works

#### Forms
- [ ] Simple forms submit
- [ ] Nested forms work
- [ ] File upload forms work
- [ ] Remote forms work (Turbo)
- [ ] Form validation displays
- [ ] CSRF protection works

#### Caching
- [ ] Page caching works (if used)
- [ ] Fragment caching works
- [ ] Russian doll caching works
- [ ] Cache invalidation works
- [ ] Session storage works

#### Database
- [ ] Queries execute correctly
- [ ] Transactions work
- [ ] Connection pooling works
- [ ] Multi-database works (if used)

---

### Performance Testing

- [ ] Boot time is acceptable
- [ ] Request times similar to baseline
- [ ] Memory usage similar to baseline
- [ ] No N+1 queries introduced
- [ ] Database query times acceptable

---

### Browser Testing

- [ ] Chrome works
- [ ] Firefox works
- [ ] Safari works
- [ ] Mobile responsive works
- [ ] No JavaScript console errors

---

### Security Testing

- [ ] CSRF protection enabled
- [ ] XSS protection works
- [ ] SQL injection protected
- [ ] Strong parameters work
- [ ] Secrets/credentials accessible
- [ ] SSL/HTTPS works

---

## Staging Deployment Checklist

- [ ] Deployment succeeds
- [ ] Database migrations run
- [ ] Asset compilation works
- [ ] Background workers start
- [ ] Application boots in production mode
- [ ] Environment variables correct
- [ ] External service connections work
- [ ] Error tracking works (Sentry, etc.)
- [ ] Logging works
- [ ] Monitoring dashboards show data

---

## Production Deployment Checklist

### Before Deploy
- [ ] Staging tests complete
- [ ] Rollback plan documented
- [ ] Team notified of deployment
- [ ] Low-traffic window chosen
- [ ] Database backup taken

### During Deploy
- [ ] Monitor deployment progress
- [ ] Watch for deployment errors
- [ ] Verify workers restart

### After Deploy (First 15 minutes)
- [ ] Application responds
- [ ] Check error tracking for spikes
- [ ] Verify key user flows work
- [ ] Monitor response times
- [ ] Check background jobs processing

### After Deploy (First hour)
- [ ] Error rate normal
- [ ] Performance metrics stable
- [ ] No user complaints
- [ ] Jobs backlog clearing

### After Deploy (First day)
- [ ] Review all errors
- [ ] Check for edge cases
- [ ] Monitor resource usage
- [ ] Gather user feedback

---

## Rollback Triggers

Rollback immediately if:

- [ ] Error rate > 2x normal
- [ ] Response time > 3x normal
- [ ] Critical feature broken
- [ ] Data integrity issues
- [ ] Security vulnerability discovered
- [ ] External service integration broken

---

## Test Environment Setup

```bash
# Run tests with Rails next version
BUNDLE_GEMFILE=Gemfile.next bundle exec rspec

# Run with verbose deprecation warnings
RUBYOPT="-W:deprecated" bundle exec rspec

# Run specific test file
bundle exec rspec spec/models/user_spec.rb

# Run with coverage
COVERAGE=true bundle exec rspec
```

---

## Common Test Fixes

### 1. Time-dependent tests
```ruby
# Use travel_to instead of fixed times
travel_to Time.zone.local(2024, 1, 1) do
  # test code
end
```

### 2. Database cleanup
```ruby
# Ensure proper cleanup between tests
RSpec.configure do |config|
  config.use_transactional_fixtures = true
end
```

### 3. Asset pipeline tests
```ruby
# Stub asset methods if needed
allow(helper).to receive(:asset_path).and_return("/assets/test.png")
```

---

**Keep this checklist visible throughout the upgrade process!**
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