What are the four layers in Layered Rails?

The architecture consists of the Presentation Layer (Controllers/Views), Application Layer (Services/Forms), Domain Layer (Models/Events), and Infrastructure Layer (Active Record/APIs).

How does the /layers:analyze command work?

It scans your codebase to identify abstraction layer violations, high-complexity 'God' objects, and problematic model callbacks that should be extracted.

Can this skill help with legacy Rails apps?

Yes, it includes a gradual adoption planning tool (/layers:gradual) to help you incrementally implement layered patterns without requiring a full system rewrite.

What is the 'Specification Test' mentioned in the skill?

The Specification Test is a diagnostic method used to evaluate if an object's responsibilities exceed its layer's primary concern, signaling that logic should be extracted.

Layered Rails Architecture

Name: Layered Rails Architecture
Author: palkan

bypalkan

•

198

•

Developer Tools

Implements clean architecture and layered design principles for Ruby on Rails applications based on industry best practices.

Layered Rails is a specialized Claude Code skill designed to help developers architect, review, and refactor Ruby on Rails applications using the principles of layered design. Based on the 'Layered Design for Ruby on Rails Applications' methodology, it enforces unidirectional data flow across Presentation, Application, Domain, and Infrastructure layers. Whether you are analyzing a legacy codebase for 'fat models,' planning new feature implementations, or extracting complex logic into Service Objects and Form Objects, this skill provides the architectural guardrails needed to maintain a clean, maintainable, and scalable Rails codebase.

Key Features

01Automated architectural analysis to identify layer violations and 'God' objects.

02Pattern selection guidance for extracting Service Objects, Form Objects, and Query Objects.

03Pull request reviews focused on identifying model callback anti-patterns and logic leaks.

04Support for advanced Rails patterns including ViewComponents, AI agents, and multi-channel notifications.

05198 GitHub stars

06Specification testing to ensure objects adhere to their specific layer responsibilities.

Use Cases

01Refactoring 'Fat Models' or 'God Objects' into discrete, manageable architectural layers.

02Automating architectural code reviews to ensure new features follow unidirectional data flow.

03Planning and executing the gradual adoption of layered design in existing monolithic Rails apps.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add palkan/skills layered-rails

For use in Claude.ai and ChatGPT

Download Skill