se-dhh-rails-style

Enforce DHH Rails conventions in Ruby and Rails codebases.

Updated May 7, 2026
One-click install
npx skills add https://github.com/simonwjackson/pi-software-engineering --skill se-dhh-rails-style
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: se-dhh-rails-style
Source: https://github.com/simonwjackson/pi-software-engineering/tree/main/skills/se-dhh-rails-style
Command: npx skills add https://github.com/simonwjackson/pi-software-engineering --skill se-dhh-rails-style

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Rails projects often diverge from DHH's consistent conventions, leading to inconsistent architecture and harder maintenance. This skill provides a codified set of DHH Rails patterns to align Ruby/Rails codebases with RESTful design, fat models, thin controllers, and Turbo/Stimulus integration.

Core Features & Use Cases

  • Enforces 37signals/DHH Rails conventions for Ruby and Rails projects, with guidance on models, controllers, tests, and code reviews.
  • Covers patterns such as REST purity, fat models, thin controllers, Current attributes, and Hotwire patterns to standardize development across teams.
  • Provides practical examples and a consistent workflow for code reviews and refactors in Rails apps.

Quick Start

Begin by aligning your Ruby/Rails code to the documented DHH conventions and consult the references to apply the patterns immediately.

Frequently Asked Questions about se-dhh-rails-style

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

FAQPage Schema
How do I apply DHH Rails conventions to my Ruby codebase?

DHH Rails conventions standardize Ruby and Rails codebases by enforcing fat models, thin controllers, and REST purity. These 37signals patterns standardize architecture through governance around naming, concerns, Turbo/Stimulus integration, and testing with Minitest and fixtures to ensure consistent, testable code.

What are DHH Rails patterns for fat models and thin controllers?

DHH Rails patterns for fat models and thin controllers enforce placing business logic in models while keeping controllers lightweight. This RESTful design approach, alongside Current attributes and Hotwire integration, ensures consistent and testable Rails application architecture.

How to integrate Turbo and Stimulus using DHH Rails style?

Integrate Turbo and Stimulus using DHH Rails style by following Hotwire patterns specified within the conventions. This governance ensures consistent Turbo/Stimulus integration across Ruby on Rails projects, standardizing development and maintaining REST purity during refactoring tasks.

Does DHH Rails style work with Minitest and fixtures?

DHH Rails style works with Minitest and fixtures by specifying governance around testing to ensure consistent, testable Ruby and Rails code. This aligns development with 37signals Basecamp patterns, enforcing REST purity and Hotwire integration without relying on alternative testing frameworks.

When should I use DHH Rails conventions for refactoring?

Use DHH Rails conventions for refactoring when teams need to align Ruby codebases with RESTful design, fat models, and thin controllers. It provides a consistent workflow for code reviews and standardizes architecture, especially when discussing 37signals patterns like Hotwire.