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
/plugin install rails-security-auditor@maquina

Plugins

Plugin	Description	Version
rails-simplifier	Code quality following 37signals patterns	1.0.0
rails-upgrade-assistant	Rails 6.0→8.1 upgrade planning	1.1.0
maquina-ui-standards	UI components with maquina_components	0.4.4
recuerd0	Knowledge management from AI conversations	1.2.0
mvp-creator	MVP documentation for Rails applications	1.0.0
better-stimulus	StimulusJS best practices from betterstimulus.com	1.0.0
spec-driven-development	Spec-driven development workflow for Rails	1.2.0
rails-security-auditor	Security audit for Rails 8.0–8.2 configuration	1.0.0

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

rails-upgrade-assistant/
├── agents/rails-upgrade-assistant.md    # Main skill
├── version-guides/                       # Rails version details
│   ├── upgrade-6.0-to-6.1.md
│   ├── upgrade-6.1-to-7.0.md
│   ├── upgrade-7.0-to-7.1.md
│   ├── upgrade-7.1-to-7.2.md
│   ├── upgrade-7.2-to-8.0.md
│   └── upgrade-8.0-to-8.1.md
├── workflows/                            # How to generate deliverables
├── examples/                             # Real usage scenarios
├── reference/                            # Breaking changes, deprecations
├── templates/                            # Report templates
└── detection-scripts/                    # Pattern definitions

Requirements

Required: Rails MCP Server
Optional: Neovim MCP Server (for interactive file updates)

Resources

3. maquina-ui-standards

Build consistent, accessible UIs in Rails using maquina_components — ERB partials styled with Tailwind CSS 4 and data attributes, inspired by shadcn/ui.

What It Provides

Reference	Purpose
Component catalog	All 15+ components with ERB examples
Form patterns	Validation, error handling, inline layouts
Layout patterns	Sidebar navigation, page structure
Turbo integration	Frames, Streams, component updates
Spec checklist	Review criteria for UI quality

Usage

> Create the users index view with a table showing name, email, and status
> Implement the project form with name, description, and a framework combobox
> Review this view against the maquina UI standards and suggest improvements
> Build a dashboard layout with sidebar navigation

Component Example

<%# Partial components %>
<%= render "components/card" do %>
  <%= render "components/card/header" do %>
    <%= render "components/card/title", text: "Appointments" %>
    <%= render "components/card/description", text: "Manage your schedule" %>
  <% end %>
  <%= render "components/card/content" do %>
    <!-- Content here -->
  <% end %>
<% end %>

<%# Data-attribute components (forms) %>
<%= form.text_field :name, data: { field: true } %>

Package Contents

maquina-ui-standards/
├── agents/maquina-ui-standards.md    # Main skill
├── QUICKSTART.md                      # Quick reference
└── references/
    ├── component-catalog.md           # All available components
    ├── form-patterns.md               # Validation, error handling
    ├── layout-patterns.md             # Pages, dashboards
    ├── turbo-integration.md           # Frames, streams
    └── spec-checklist.md              # Accessibility, consistency

Requirements

maquina_components gem installed in your Rails app

Resources

4. recuerd0

A CLI skill for Recuerd0 — a command-line tool for preserving, versioning, and organizing knowledge from AI conversations.

What It Does

Feature	Description
Save session	Generate a transcript from the current conversation, infer title/tags/workspace, and save as a memory
Workspace management	Create, list, archive workspaces
Memory CRUD	Create, read, update, delete memories
Versioning	Create versions of existing memories
Full-text search	FTS5-backed search with AND/OR/NOT operators
Piped content	Read memory content from stdin

Usage

> Remember this session
> Save this conversation to my "Rails Patterns" workspace
> Search my memories for "error handling"
> Create a new workspace called "Rails Patterns"
> Version memory 42 with updated content

Save Session Workflow

When asked to save a session, the skill will:

Generate a structured transcript from the conversation context
Infer a title, tags, and workspace
Ask you to confirm or adjust before saving
Save via recuerd0 memory create piping content through stdin

If you provide a workspace name instead of an ID, it resolves the name automatically. If the workspace doesn't exist, it offers to create one.

Auto-Save Hooks

The plugin registers two Claude Code lifecycle hooks that automatically capture session state to a recuerd0 workspace — no manual /remember invocation required.

Hook	When it fires	What it does
`Stop`	After each assistant turn, at most once every 15 minutes	Saves a checkpoint memory tagged `claude-code,auto-save,stop`
`PreCompact`	Before Claude Code compresses the conversation	Saves an emergency snapshot tagged `claude-code,auto-save,precompact`

What happens on install: as soon as the plugin is installed, both hooks are live. The first time a Stop or PreCompact event fires in a session where you have the recuerd0 CLI installed and a workspace configured, a new memory appears in that workspace containing the last 200 lines of the transcript. The memory title is Claude Code checkpoint — <timestamp> (or pre-compact —), sourced as claude-code-session.

Nothing is captured if any of the following are true — so a fresh machine or a user who doesn't want this will see zero activity:

The recuerd0 CLI is not on PATH
No account is configured (recuerd0 account add … has not been run)
No workspace is resolvable (no RECUERD0_WORKSPACE env var, no .recuerd0.yaml in the project, no default workspace in ~/.config/recuerd0/config.yaml)
RECUERD0_HOOK_DISABLE=1 is set

The hooks never exit non-zero, so a misconfigured or offline recuerd0 setup will never interrupt your Claude Code session. Failures (when they happen) are appended to ~/.recuerd0/hook-errors.log.

Routing sessions to the right workspace: drop a .recuerd0.yaml file at the root of each project:

workspace: "12"

Every session started inside that directory will auto-save to workspace 12. The CLI walks parent directories, so nested subfolders inherit the config.

Tuning:

Env var	Default	Purpose
`RECUERD0_HOOK_DISABLE`	unset	Set to `1` to disable both hooks entirely
`RECUERD0_STOP_INTERVAL_MINUTES`	`15`	Minimum minutes between Stop saves
`RECUERD0_HOOK_TAIL_LINES`	`200`	Transcript lines captured per save

How to disable:

Temporarily — export RECUERD0_HOOK_DISABLE=1 in your shell before launching Claude Code, or unset RECUERD0_WORKSPACE and remove any .recuerd0.yaml so the hooks find nowhere to save.
Per project — omit .recuerd0.yaml from that project and don't set RECUERD0_WORKSPACE.
Just one hook — edit ${CLAUDE_PLUGIN_ROOT}/hooks/hooks.json and remove the Stop or PreCompact block.
Permanently — uninstall the plugin: /plugin uninstall recuerd0@maquina.

Package Contents

recuerd0/
├── agents/recuerd0.md              # Main skill
├── hooks/
│   ├── hooks.json                  # Stop + PreCompact registrations
│   ├── recuerd0_stop_hook.sh       # Rate-limited checkpoint hook
│   ├── recuerd0_precompact_hook.sh # Emergency save before compaction
│   └── recuerd0_hook_common.sh     # Shared helpers (sourced)
└── .claude-plugin/plugin.json      # Plugin metadata

Requirements

Recuerd0 CLI installed and configured with an account
A workspace selected via RECUERD0_WORKSPACE, .recuerd0.yaml, or the CLI's global config (required for auto-save hooks; the agent itself works without one)

5. mvp-creator

Create comprehensive MVP documentation for Rails applications through guided research and discovery.

What It Does

Produces 5 deliverables for a new Rails application:

Deliverable	Purpose
Research Report	Competitor analysis, market overview, feature comparison
MVP Business Plan	Vision, features, user flows, success metrics
Brand Guide	Logo, colors, typography, components, voice
Technical Guide	Architecture, patterns, data models, code style
Claude Setup	CLAUDE.md, .mcp.json, commands for Claude Desktop/Code

Usage

> I have an idea for a project management app
> Help me plan a SaaS for freelancers
> Research competitors for a booking system
> Create a business plan for my app idea
> Design a brand for my Rails project

Workflow

Topic/Idea → Research → Discovery Questions → Generate Deliverables → Handoff to SDD

Package Contents

mvp-creator/
├── agents/mvp-creator.md                        # Main skill
├── QUICKSTART.md                                 # Quick reference
├── scripts/init.sh                               # Project initialization
└── references/
    ├── rails-philosophy.md                       # 37signals patterns
    ├── rails-ui-patterns.md                      # UI conventions
    ├── rails-api-patterns.md                     # API patterns
    ├── rails-implementation-patterns.md          # Implementation guide
    └── deliverable-templates/                    # Output templates
        ├── research-report.md
        ├── mvp-business-plan.md
        ├── brand-guide.md
        ├── technical-guide.md
        └── claude-setup.md

6. better-stimulus

Apply opinionated StimulusJS best practices sourced from betterstimulus.com. Use when writing, reviewing, or refactoring Stimulus controllers.

What It Covers

Topic	Description
Architecture	Application controller, configurable controllers, late binding
State management	Values API, targets, outlets, avoiding global state
Lifecycle	Connect/disconnect patterns, lazy loading, cleanup
Composition	Mixins, use-hooks, controller communication
SOLID principles	Applied to Stimulus controllers
Cookbook	Common patterns for modals, forms, validation, etc.

Usage

> Write a Stimulus controller for a dropdown menu
> Review this Stimulus controller against best practices
> Refactor this controller to use the Values API
> How should I handle state in Stimulus?

Package Contents

better-stimulus/
├── agents/better-stimulus.md          # Main skill
└── references/
    ├── cookbook.md                     # Common patterns
    └── solid.md                       # SOLID principles for Stimulus

Resources

7. spec-driven-development

A lightweight workflow for building production-quality Rails features with AI agents through systematic planning and self-contained specs.

What It Does

Feature	Description
Feature shaping	Convert ideas into structured specs
Task breakdown	Split specs into implementable tasks
Standards discovery	Extract patterns from existing codebases
Progress tracking	YAML-based status for specs and tasks
Agent handoff	Self-contained specs ready for Claude Code

Usage

> Initialize SDD for this project
> Shape a spec for the notifications feature
> Create tasks from the authentication spec
> Show SDD status
> Add a new spec for the billing module

Workflow

Initialize → Shape Spec → Create Tasks → Hand off to Claude Code → Track Progress

Package Contents

spec-driven-development/
├── agents/spec-driven-development.md    # Main skill
├── README.md                             # Full documentation
├── QUICKSTART.md                         # Quick reference
├── scripts/
│   ├── init_sdd.sh                       # Initialize SDD structure
│   ├── new_spec.sh                       # Create new spec
│   └── status.sh                         # Show progress
├── references/
│   ├── rails-standards.md                # Rails conventions
│   ├── hotwire-patterns.md               # Turbo/Stimulus patterns
│   └── document-templates.md             # Spec templates
└── templates/
    ├── standard-template.md              # Spec template
    └── progress.yml                      # Progress tracking

8. rails-security-auditor

A security auditor that scans a Rails application's configuration and produces a structured, actionable report grouped by severity. Grounded in Rails 8.0–8.2 security defaults and covers the framework, application, and infrastructure layers.

What It Does

Scans production environment, initializers, controllers, Gemfile, and CI config
Detects the Rails version from Gemfile.lock and adjusts expectations accordingly
Checks CSRF, security headers, CSP, session cookies, rate limiting, authorization, dependency CVEs, and Rails 8.2 framework defaults
Reports each finding with severity, evidence, plain-language risk explanation, and exact fix
Offers to apply fixes — one, all critical, or all — with minimal diffs

Check Categories

Category	Covers
PROD	`force_ssl`, `assume_ssl`, log level, `filter_parameters`, trusted proxies
CSRF	`protect_from_forgery`, strategy, per-form tokens
HDR	X-Frame-Options, X-Content-Type-Options, Referrer-Policy
CSP	Content Security Policy initializer and directives
SESS	Session cookie `SameSite`, `expire_after`, `httponly`
RATE	`rate_limit` macro, Rack::Attack throttles and safelists
AUTH	Authorization gem, tenant scoping, `allow_unauthenticated_access`
GEM	Brakeman, bundler-audit, Rails CVEs
CI	Security scanning in CI
DATA	Column-level encryption, hardcoded secrets
FWKD	Rails 8.2 framework defaults (CSRF header strategy, transaction-aware jobs)

Usage

> Audit security
> Run a security audit on this Rails app
> Is my CSRF configured correctly?
> Am I missing any security headers?
> Check my Rack::Attack config

Package Contents

rails-security-auditor/
├── agents/rails-security-auditor.md    # Main agent
├── references/
│   └── checks.md                       # Full catalog of checks with fixes
└── .claude-plugin/plugin.json          # Plugin metadata

Team Installation

Add to your project's .claude/settings.json for automatic installation:

{
  "extraKnownMarketplaces": {
    "maquina": {
      "source": {
        "source": "github",
        "repo": "maquina-app/rails-claude-code"
      }
    }
  },
  "enabledPlugins": [
    "rails-simplifier@maquina",
    "rails-upgrade-assistant@maquina",
    "maquina-ui-standards@maquina",
    "recuerd0@maquina",
    "mvp-creator@maquina",
    "better-stimulus@maquina",
    "spec-driven-development@maquina",
    "rails-security-auditor@maquina"
  ]
}

License

MIT

Author

Mario Alberto Chávez Cárdenas

Maquina · GitHub · X

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
.claude-plugin		.claude-plugin
better-stimulus		better-stimulus
maquina-ui-standards		maquina-ui-standards
mvp-creator		mvp-creator
rails-security-auditor		rails-security-auditor
rails-simplifier		rails-simplifier
rails-upgrade-assistant		rails-upgrade-assistant
recuerd0		recuerd0
spec-driven-development		spec-driven-development
CLAUDE.md		CLAUDE.md
LICENSE.txt		LICENSE.txt
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

Rails Claude Code Plugins

Installation

Plugins

1. rails-simplifier

Philosophy

What It Does

Usage

Resources

2. rails-upgrade-assistant

What It Does

Supported Upgrade Paths

Usage

Workflow

Benefits

Package Contents

Requirements

Resources

3. maquina-ui-standards

What It Provides

Usage

Component Example

Package Contents

Requirements

Resources

4. recuerd0

What It Does

Usage

Save Session Workflow

Auto-Save Hooks

Package Contents

Requirements

5. mvp-creator

What It Does

Usage

Workflow

Package Contents

6. better-stimulus

What It Covers

Usage

Package Contents

Resources

7. spec-driven-development

What It Does

Usage

Workflow

Package Contents

8. rails-security-auditor

What It Does

Check Categories

Usage

Package Contents

Team Installation

License

Author

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages