ruby-on-rails-best-practices

Provide Ruby on Rails architectural and coding best practices from Basecamp production applications.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/iulspop/misc-skills --skill ruby-on-rails-best-practices-iulspop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ruby-on-rails-best-practices
Source: https://github.com/iulspop/misc-skills/tree/main/.agents/skills/ruby-on-rails-best-practices
Command: npx skills add https://github.com/iulspop/misc-skills --skill ruby-on-rails-best-practices-iulspop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers write, review, and refactor Ruby on Rails code to adhere to established architectural patterns and coding conventions, ensuring maintainability and following "The Rails Way."

Core Features & Use Cases

  • Architecture Guidance: Provides rules for organizing models, controllers, and background jobs.
  • Coding Conventions: Offers best practices for naming, callbacks, and testing.
  • Use Case: When building a new feature in a Rails application, consult this Skill to ensure your models are structured correctly with concerns, your controllers remain thin, and your background jobs are implemented efficiently.

Quick Start

Use the ruby-on-rails-best-practices skill to organize a new Rails model concern.

Frequently Asked Questions about ruby-on-rails-best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are the best practices for structuring Rails models and controllers?

Organize Rails models using concerns for shared logic and keep controllers thin by delegating business logic to models or background jobs. This architecture ensures maintainability and follows The Rails Way.

How do I refactor a Ruby on Rails application to follow The Rails Way?

Refactor a Ruby on Rails application by applying coding conventions for naming, callbacks, and testing. Restructure models, controllers, and background jobs using established patterns to achieve clarity and maintainability.

When should I use concerns in Ruby on Rails models?

Use concerns in Ruby on Rails models to extract and organize shared logic, ensuring code remains maintainable. This pattern prevents model bloat and aligns with established architectural conventions for clarity.

Does this Rails best practices guidance cover Turbo and Hotwire integration?

Yes, this Rails best practices guidance covers Turbo and Hotwire integration. It provides specific architectural patterns and coding refinements for efficiently integrating these frameworks into your application.

What is the best way to implement background jobs in a Rails application?

The best way to implement background jobs in a Rails application is by following established architectural patterns for code organization and efficiency. This ensures maintainable background processing that adheres to The Rails Way.

Are there specific coding conventions for Rails callbacks and testing?

Yes, there are specific coding conventions for Rails callbacks and testing. These rules guide how to implement callbacks safely and structure tests to ensure long-term maintainability and architectural clarity.