Upgrade Plan

Generate a phased Ruby and Rails upgrade roadmap with estimates and task lists.

12|1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/dhruvasagar/ruby-upgrade-toolkit --skill upgrade-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Upgrade Plan
Source: https://github.com/dhruvasagar/ruby-upgrade-toolkit/tree/main/skills/plan
Command: npx skills add https://github.com/dhruvasagar/ruby-upgrade-toolkit --skill upgrade-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan and coordinate Ruby and Rails upgrades with a repeatable, project-aware roadmap that reduces surprises and downtime.

Core Features & Use Cases

  • Generate a phased upgrade roadmap tailored to your project.
  • Produce per-phase effort estimates, risks, and validation steps.
  • Create a TodoWrite task list that /fix next and /upgrade commands can consume.

Quick Start

Run /ruby-upgrade-toolkit:plan ruby:X.Y.Z [rails:X.Y] to generate a phased upgrade plan and a TodoWrite task list for subsequent steps.

Frequently Asked Questions about Upgrade Plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a Ruby on Rails upgrade across multiple versions?

You can create an upgrade plan by generating a phased roadmap that computes intermediate version hops, validates current project state, and outputs stepwise deliverables with effort estimates.

What is a phased roadmap for upgrading Ruby and Rails?

A phased upgrade roadmap breaks down version transitions into sequential steps, providing per-phase effort estimates, risk assessments, validation steps, and deliverables tailored to your target Ruby and Rails versions.

How do I generate a todo list for executing a Rails version upgrade?

Generating an upgrade todo list involves creating a TodoWrite task list from a phased roadmap, which subsequent fix and upgrade commands can consume to track and execute stepwise version migration tasks.

Can I upgrade Ruby and Rails independently using a single upgrade plan?

Yes, you can plan independent upgrades by passing target Ruby versions alongside optional Rails versions, allowing the roadmap to parse arguments and generate tailored intermediate hops and deliverables for each framework.

Does the Ruby upgrade plan support loading custom project rules?

Yes, the planning process optionally loads project rules to ensure the generated markdown plan and phased deliverables align with specific project constraints and existing validation requirements.

What are the limitations of planning Rails upgrades with intermediate version hops?

The planning tool requires explicit current version validation and accurate target version arguments to compute intermediate hops, meaning incomplete project state data will result in inaccurate effort estimates and deliverables.