ombulabs/claude-code_rails-upgrade-skill / rails-upgrade
rails-upgrade
VerifiedAnalyzes 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.
workflows/00-verify-latest-patch-workflow.md
View on GitHub# Workflow 00: Verify Latest Patch
**Purpose:** Ensure the app is on the latest patch of its current Rails series before any minor/major hop. Patch releases contain security fixes, bug fixes, and additional deprecation warnings. Starting the version hop on the latest patch is safer (the security fixes are already in production) and easier to debug (the new deprecation warnings surface issues that would otherwise show up mid-upgrade).
**When to use:** MANDATORY PRE-STEP. THIS STEP IS REQUIRED BEFORE ANY OTHER WORK. For multi-hop upgrades this check applies at the START and again after each hop.
## Inputs
- `Gemfile.lock`
## Outputs
- Exact current Rails version (e.g., 3.2.19)
- Latest patch for that series
## Gates (must be true before the next workflow that runs)
- Current version == latest patch of its series. Do NOT proceed to next minor/major until on latest patch.
## Step 1: Read the exact current version
Read Gemfile.lock to find exact current Rails version (e.g., 3.2.19)
## Step 2: Compare against the latest patch for that series
- Series listed in the End-of-Life table of `references/multi-hop-strategy-reference.md`: use that table
- Any other series: query RubyGems API (see `references/multi-hop-strategy-reference.md` for commands)
## Step 3: If current version < latest patch
- INFORM user: "Your app is on Rails X.Y.Z but the latest patch is X.Y.W"
- Guide through Gemfile update and bundle update rails
- Run test suite after patch upgrade
- Deploy patch upgrade before proceeding
- Do NOT proceed to next minor/major until on latest patch
## Step 4: If current version == latest patch
Proceed to Workflow 01 (`workflows/01-run-test-suite-workflow.md`)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 119k | Updated | Claude CodeCodex | Verified | Install |
| 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: 118k | Updated | Claude CodeCodex | Verified | Install |
| 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: 108k | Updated | Claude CodeCodex | Verified | Install |
| 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: 108k | Updated | Claude CodeCodex | Verified | Install |