ruby-on-rails-best-practices

Apply Basecamp's Ruby on Rails architectural patterns and coding conventions.

93|9|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/sergiodxa/agent-skills --skill ruby-on-rails-best-practices
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ruby-on-rails-best-practices
Source: https://github.com/sergiodxa/agent-skills/tree/main/skills/ruby-on-rails-best-practices
Command: npx skills add https://github.com/sergiodxa/agent-skills --skill ruby-on-rails-best-practices

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 by adhering to established architectural patterns and coding conventions derived from Basecamp's production applications, ensuring maintainability and scalability.

Core Features & Use Cases

  • Architecture Guidance: Provides rules for organizing models, concerns, controllers, and background jobs.
  • Coding Conventions: Enforces best practices for naming, callbacks, associations, and testing.
  • Use Case: When building a new feature in a Rails application, consult this Skill to ensure models are structured correctly, concerns are placed appropriately, and background jobs are implemented efficiently, leading to cleaner and more robust code.

Quick Start

Use the ruby-on-rails-best-practices skill to understand how to organize model-specific concerns within their own directories.

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

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

FAQPage Schema
How do I organize model concerns in Ruby on Rails?

To organize model concerns in Ruby on Rails, place model-specific concerns within their own dedicated directories to ensure proper code organization and maintainability. This approach follows Basecamp's production conventions for cleaner architecture.

What are the best practices for Rails background jobs and controllers?

Best practices for Rails background jobs and controllers involve adhering to architectural patterns that enforce naming conventions, callback usage, and efficient job implementation. This ensures robust code organization and maintainability across your application.

When do I need to use concerns vs callbacks in Rails models?

You need to use concerns vs callbacks in Rails models when structuring complex associations and request contexts. Architectural guidance helps determine appropriate placement for concerns and enforces best practices for callbacks to maintain scalability.

Does this Rails architecture guidance work with existing legacy code refactoring?

This Rails architecture guidance works for legacy code refactoring by providing coding conventions and patterns derived from Basecamp's production applications. It helps developers review and refactor code to ensure maintainability and adherence to The Rails Way.

What is the best way to structure Rails real-time features and testing?

The best way to structure Rails real-time features and testing is by following established architectural patterns and coding conventions. This approach addresses specific patterns for real-time functionality and testing to ensure code robustness.

Why should I follow Basecamp's Rails coding conventions over other patterns?

You should follow Basecamp's Rails coding conventions because they are derived from production applications and focus on code organization, maintainability, and scalability. These refinements to The Rails Way ensure cleaner, more robust code across models, controllers, and jobs.