rails-architecture

Community

Guide Rails 8 architecture for clean, scalable code.

AuthorThibautBaissac
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Rails projects often struggle with deciding where to place code and which architectural patterns to apply (services, concerns, queries, presenters, etc.). This skill provides a structured guide to choose between patterns, design feature architecture, and refactor code for maintainability in Rails 8.

Core Features & Use Cases

  • Guidance on where to place business logic (service objects, queries, concerns) and presentation layer (presenters, view components).
  • Architecture decision tree and mapping between responsibilities (controller, model, service, query, presenter, policy, job, mailer, channel).
  • Reference implementations and patterns to consult during feature planning or refactors.
  • Use Case: when restructuring a monolith into layered architecture with clear boundaries.

Quick Start

Identify a candidate area (e.g., complex business logic) and start by selecting the appropriate pattern from the decision tree to restructure code.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: rails-architecture
Download link: https://github.com/ThibautBaissac/rails_ai_agents/archive/main.zip#rails-architecture

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.