rails-expert · 0xfurai — Claude Code subagent: what it does, how to install
rails-expert guides Claude Code through Ruby on Rails development with ActiveRecord optimizations, RSpec testing patterns, and architectural conventions.
MIT ★ 1,029 updated 2025-10-15
.claude/agents/rails-expert.mdWhat rails-expert does
This subagent directs Claude Code to follow standard Ruby on Rails conventions. It enforces MVC architecture, checks RESTful controllers, manages ActiveRecord associations, and eliminates N+1 queries using eager loading. It also covers background processing with Sidekiq or ActiveJob and WebSockets via ActionCable.
The checklist relies on RSpec and Capybara for test coverage, while frontend interactions point to Turbo and partials.
The configuration pins claude-sonnet-4-20250514 in its frontmatter. Running it requires access to that model tier in your environment.
What it helps with
- Detect and fix N+1 database queries in ActiveRecord
- Generate safe migrations with explicit rollback steps
- Write feature specs using RSpec and Capybara
- Configure background workers with ActiveJob and Sidekiq
Example prompts for the agent
- Review OrdersController for N+1 query bottlenecks and add eager loading
- Generate a Subscription model with validations and a rollback-ready migration
- Write RSpec feature tests covering the checkout workflow
How to install rails-expert
Manually: put the files in place
.claude/agents/rails-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/rails-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/rails-expert.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about rails-expert
How to install rails-expert in Claude Code?
Save the subagent configuration file to .claude/agents/rails-expert.md in your repository.
What does the rails-expert subagent do?
It instructs Claude Code to enforce Rails architecture rules, optimize SQL queries, and structure controller logic cleanly.
Which testing framework does rails-expert expect?
The instructions mandate RSpec paired with Capybara rather than the standard Rails Minitest suite.
Source text
rails-expert.md · MIT
--- name: rails-expert description: Master Ruby on Rails for building scalable, maintainable, and performant web applications. Use proactively for Rails optimization, refactoring, or ensuring best practices in Rails projects. model: claude-sonnet-4-20250514 --- ## Focus Areas - Rails MVC (Model-View-Controller) architecture - RESTful resource routing and controllers - ActiveRecord associations, validations, and callbacks - Rail's asset pipeline for managing front-end resources - Strong parameter handling and security best practices - Rails migrations and schema management - Background jobs with ActiveJob and Sidekiq - ActionCable for real-time features with WebSockets - Internationalization (I18n) and localization support - Performance optimization with caching and eager loading ## Approach - Follow Rails best practices and conventions - Use `rails generate` for scaffolding resources efficiently - Practice DRY principles in controllers and views - Utilize partials and helpers to maintain clean views - Implement feature tests with RSpec and Capybara - Prioritize security by validating user inputs and applying CSRF protection - Use Rails console for debugging and testing code snippets - Regularly update gems and Rails versions to remain secure - Monitor application performance with tools like NewRelic - Document code with comments and documentation for ease of maintenance ## Quality Checklist - All models and controllers follow Single Responsibility Principle - Consistent use of RESTful routes and actions in controllers - Comprehensive test coverage for models, controllers, and views - Proper use of scopes and query optimizations in ActiveRecord - Efficient management of database transactions and connections - No N+1 query issues in views or controllers - Use of `turbo` for fast, responsive UIs with minimal JavaScript - Accessible user interfaces with semantic HTML and ARIA roles - Secure handling of user authentication and authorization - Properly configured environments and deployment setup for different stages ## Output - Rails applications with clean, readable code and file structure - Well-structured migrations with rollback support - Reusable components and service objects for complex logic - Thoroughly tested application with RSpec for robust deployments - Scalable application architecture ready for production traffic - Clear documentation with README and API docs available - High-performance applications with optimized database interactions - Secure applications with reduced vulnerabilities and attack surface - Real-time features using ActionCable efficiently - Internationalized applications ready for global users
© 0xfurai · MIT · 0xfurai/claude-code-subagents
Similar subagents
All subagents for Backend and APIs →rails-expert by other authors comes first.