Rails Claude Code Plugins
A collection of Claude Code plugins for Ruby on Rails development.
Installation
# Add the marketplace
/plugin marketplace add maquina-app/rails-claude-code
# Install individual plugins
/plugin install rails-simplifier@maquina
/plugin install rails-upgrade-assistant@maquina
/plugin install maquina-ui-standards@maquina
/plugin install recuerd0@maquina
/plugin install mvp-creator@maquina
/plugin install better-stimulus@maquina
/plugin install spec-driven-development@maquina
Plugins
1. rails-simplifier
A code simplification agent that refines Ruby on Rails code following 37signals patterns and the One Person Framework philosophy.
Philosophy
The One Person Framework (DHH, December 2021):
"A toolkit so powerful that it allows a single individual to create modern applications upon which they might build a competitive business."
Conceptual Compression (RailsConf 2018):
"Like a video codec that throws away irrelevant details such that you might download the film in real-time."
Vanilla Rails is Plenty (Jorge Manrubia, 37signals):
"If you have the luxury of starting a new Rails app today, go vanilla."
What It Does
| Pattern | Simplification |
|---|
| Service objects | Rich model methods + concerns |
| Custom controller actions | CRUD resources |
| Boolean state columns | State records (has_one :closure) |
| Fat controllers | Thin controllers, model methods |
Time.now | Time.current |
| Hardcoded strings | I18n keys |
| N+1 queries | includes / preload |
Date tests without travel_to | Freeze time to fixture |
Usage
> Review recent changes using the rails-simplifier agent
> Use rails-simplifier to review the bookings controller
Resources
2. rails-upgrade-assistant
A unified, intelligent Rails upgrade skill that helps you upgrade Ruby on Rails applications through any version from 6.0 to 8.1.1. Built on official Rails CHANGELOGs and integrated with MCP tools for automatic project analysis.
What It Does
- Analyzes your Rails project automatically using Rails MCP tools
- Detects your current version and target version
- Plans single-hop or multi-hop upgrade paths
- Identifies breaking changes specific to YOUR code
- Preserves your custom configurations with warnings
- Generates comprehensive upgrade reports (50+ pages)
- Based on official Rails CHANGELOGs from GitHub
Supported Upgrade Paths
| From | To | Breaking Changes | Difficulty |
|---|
| 8.0.x | 8.1.1 | 8 changes | Easy |
| 7.2.x | 8.0.4 | 13 changes | Hard |
| 7.1.x | 7.2.3 | 38 changes | Medium |
| 7.0.x | 7.1.6 | 12 changes | Medium |
| 6.1.x | 7.0.0 | 17 changes | Hard |
| 6.0.x | 6.1.0 | 18 changes | Medium |
| 6.0.x | 8.1.1 | All 106 changes | Very Hard |
** Important:** Rails upgrades MUST be sequential. No version skipping!
Usage
> Upgrade my Rails app to 8.1
> Help me upgrade from Rails 7.2 to 8.0
> Generate a detection script for Rails 8.0 upgrade
> What breaking changes are in Rails 8.1?
> Assess upgrade impact from 7.0 to 8.1
Workflow
- Claude generates detection script tailored to your specific upgrade
- You run the script in your project directory
- Script outputs findings with file:line references
- Share findings with Claude
- Claude generates comprehensive report with OLD→NEW code examples
Benefits
- Accuracy in finding breaking changes
- Clear file:line references for every issue
- Faster upgrades overall
Package Contents
