claude-code_rails-upgrade-skill MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Version-aware playbooks (Rails 6 → 7, 7 → 7.1, 7.1 → 7.2, 7.2 → 8)
Deprecation warning sweep + fix suggestions
Framework defaults migration (rails app:update)
Gem compatibility checks against target Rails version
Spring cleaning (Spring removal in newer Rails)
Test-first upgrade: fix tests before cutover

Demo ao vivo

Como fica na prática

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

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-code-rails-upgrade-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-code-rails-upgrade-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
        "~/.claude/skills/claude-code_rails-upgrade-skill"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-code-rails-upgrade-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/ombulabs/claude-code_rails-upgrade-skill",
          "~/.claude/skills/claude-code_rails-upgrade-skill"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add claude-code-rails-upgrade-skill -- git clone https://github.com/ombulabs/claude-code_rails-upgrade-skill ~/.claude/skills/claude-code_rails-upgrade-skill

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

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.

Pré-requisitos

Skill installed — git clone https://github.com/ombulabs/claude-code_rails-upgrade-skill ~/.claude/skills/rails-upgrade-skill
Git-clean working tree — Always upgrade on a branch; commit current state

Fluxo

Audit current state

Audit this Rails app: current version, Ruby version, gems, deprecation warnings from a test run.✓ Copiado

→ Baseline report
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
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

Collect

Run tests, collect all unique deprecation warnings.✓ Copiado

→ Deduped list with file:line occurrences
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

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
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

Ferramenta	Entradas	Quando chamar	Custo
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

Always upgrade on a branch. Don't let Claude run destructive commands (db:migrate, bundle update) without explicit confirmation.

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

Alternativa	Quando usar	Troca
next_rails gem	You want a deterministic upgrade helper	No LLM-guided deprecation fixes

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills