/ Diretório / Playground / claude-code_rails-upgrade-skill
← Todos os servidores ↗ GitHub
● Comunidade ombulabs ⚡ Instantâneo

claude-code_rails-upgrade-skill

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

Claude Code skill that methodically upgrades Rails — from audit through deprecation fixes to bundle update — without breaking everything.

Rails Upgrade Skill (by OmbuLabs) walks Claude through the standard Rails upgrade playbook: audit the codebase, fix deprecations, apply framework defaults, handle gem incompatibilities, and verify on the new version. Based on OmbuLabs' production experience upgrading Rails apps. Good for going N → N+1, or catching up from older versions.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

claude-code-rails-upgrade-skill.replay ▶ pronto
0/0

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

Casos de uso

Usos do mundo real: claude-code_rails-upgrade-skill

How to plan a Rails upgrade before touching code

👤 Rails devs facing a multi-version jump ⏱ ~60 min intermediate

Quando usar: You're on Rails 6.1 and need to get to 7.2. You want a plan, not a prayer.

Fluxo
  1. Audit current state
    Audit this Rails app: current version, Ruby version, gems, deprecation warnings from a test run.✓ Copiado
    → Baseline report
  2. Build the path
    Plan the upgrade to Rails 7.2. Go version-by-version (6.1 → 7.0 → 7.1 → 7.2), each with milestone criteria.✓ Copiado
    → Multi-stage plan
  3. Identify blockers
    Which gems don't have a 7.2-compatible version? Proposals for each (upgrade/replace/fork).✓ Copiado
    → Per-gem blocker list

Resultado: A realistic upgrade plan with staged milestones.

Armadilhas
  • Jumping two major versions at once — Skill enforces one minor/major at a time — don't override

Sweep and fix deprecation warnings

👤 Rails devs mid-upgrade ⏱ ~90 min intermediate

Quando usar: You're between versions and the test run is a wall of deprecation warnings.

Fluxo
  1. Collect
    Run tests, collect all unique deprecation warnings.✓ Copiado
    → Deduped list with file:line occurrences
  2. Group + fix
    Group by cause. Propose minimal fixes with diffs for each group.✓ Copiado
    → Grouped fix diffs

Resultado: A clean test run ready for the next version bump.

Apply new framework defaults safely

👤 Rails devs navigating rails app:update ⏱ ~60 min advanced

Quando usar: You've bumped the Gemfile and ran rails app:update; now you have a bunch of new initializers.

Fluxo
  1. Review diff
    Review the diff from rails app:update. Flag any default change that could break our app (strict_loading, zeitwerk mode, etc.).✓ Copiado
    → Per-change risk annotation
  2. Staged enable
    For each risky default, produce a staged rollout: enable behind env flag, validate on staging, then flip.✓ Copiado
    → Staged plan per default

Resultado: Defaults enabled without surprise regressions.

Armadilhas
  • Enabling all load_defaults at once — Use new_framework_defaults_X.Y.rb to ramp individually

Combinações

Combine com outros MCPs para 10× de alavancagem

claude-code-rails-upgrade-skill + claude-code-owasp-skill

Security review on the upgraded code

After upgrade to Rails 7.2, run OWASP review on the auth and params handling.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
Audit repo Start of every upgrade Claude tokens
Plan upgrade path current, target After audit Claude tokens
Gem compat check Gemfile, target Rails Before bumping Claude tokens + RubyGems API
Deprecation sweep test log Between versions Claude tokens
Framework defaults migration diff from rails app:update After rails app:update Claude tokens

Custo e limites

O que custa rodar

Cota de API
None
Tokens por chamada
20-80k across an upgrade
Monetário
Free
Dica
Run deprecation sweeps on specific directories rather than the whole app at once.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: No credentials
Saída de dados: Code sent to Claude for inference

Solução de problemas

Erros comuns e correções

rails app:update produces uncommitted binary files

These are usually system files. Gitignore them and regenerate cleanly.

Tests pass locally, fail in CI after upgrade

Likely autoloading differences or eager_load in production mode. Run with RAILS_ENV=production locally.

Gem bundle resolution fails

Skill will suggest alternative gem versions; sometimes a fork or replacement is required.

Verificar: bundle update --conservative

Alternativas

claude-code_rails-upgrade-skill vs. outros

AlternativaQuando usarTroca
next_rails gemYou want a deterministic upgrade helperNo LLM-guided deprecation fixes

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills