Rails Upgrade

Detecteert Rails breaking changes en genereert versie-hop upgrade rapporten voor Rails 2.3-8.1

Door ombulabs · ombulabs/claude-code_rails-upgrade-skill

Getest · Werkt ★ 8.8/10

Rails Upgrade — Detecteert Rails breaking changes en genereert versie-hop upgrade rapporten voor Rails 2.3-8.1

Wat het doet

Analyseert een Rails codebase tegen versie-specifieke grep pattern files om breaking changes, deprecations en migratie-items te vinden, en compileert deze vervolgens in een gebundeld upgrade rapport met per-bevinding fixes voor elke sequentiële hop van Rails 2.3 naar 8.1. Activeert wanneer de gebruiker vraagt om een Rails app te upgraden, een multi-hop upgrade te plannen, of breaking changes in een specifieke Rails versie op te vragen. Dwingt sequentiële (no-skip) upgrades af en delegeert dual-boot en load_defaults werk aan companion skills.

Testrapport

SKILL.md gevonden op rails-upgrade/SKILL.md (repo heeft twee skills; slug komt overeen met deze dir). Frontmatter parset met name+description; steekproefsgewijs 3 body-gerefereerde bestanden gecontroleerd (direct-detection-workflow.md, rails-70-patterns.yml, upgrade-report-template.md), allemaal HTTP 200; geen security smells. Voor de output bouwde ik een fixture Rails 6.1 app (Gemfile met webpacker/spring/turbolinks/ruby 2.6.5, een form_with local:true view, Rails.application.secrets in een controller, een enum model) en voerde de direct-detection-workflow van de skill uit door elk patroon in rails-70-patterns.yml te greppen: alle 7 patronen kwamen overeen met exacte file:line. Basislijn (mijn eigen Rails kennis, geen skill) ving de hoofdcategorieën op, maar gaf geen bestandsankering en liet de secrets.yml en enum bevindingen weg die de skill met regels en versie-accurate nuance (bijv. secrets werkt op 7.0 maar is deprecated op 7.1) naar boven bracht.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/ombulabs/claude-code_rails-upgrade-skill.git /tmp/rails-upgrade-src
mkdir -p ~/.claude/skills
cp -R /tmp/rails-upgrade-src/rails-upgrade ~/.claude/skills/rails-upgrade
# SKILL.md lands at ~/.claude/skills/rails-upgrade/SKILL.md
# Optional companion skills for the full end-to-end workflow (not needed for detection/report):
#   dual-boot skill        -> github.com/ombulabs/claude-code_dual-boot-skill (Step 2)
#   rails-load-defaults    -> github.com/ombulabs/claude-code_rails-load-defaults-skill (Step 7)
#   upgrade-cleanup plugin -> shipped in /tmp/rails-upgrade-src/upgrade-cleanup (Step 8)
# Full upgrade execution also needs the target Rails app checked out with a runnable test suite.

Commando's en voorbeeldprompts

/rails-upgradeDetecteert Rails breaking changes en genereert versie-hop upgrade rapporten voor Rails 2.3-8.1

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

Plan our upgrade from Rails 6 to Rails 7
What breaks when we upgrade to Rails 7.1
Generate a migration guide for this Rails hop

Volledig rapport (Engels) →