37signals Rails

This is the 37signals playbook: 56 rules across architecture, controllers, domain modeling, state management, and frontend patterns pulled from the Fizzy/Basecamp/HEY codebases and DHH's writings. You get vanilla Rails over gems, rich domain models over service objects, CRUD-only controllers with custom actions modeled as separate resources, Hotwire/Turbo/Stimulus patterns, and the whole Solid suite for jobs, caching, and cables. Use it when you're writing Rails code that leans into the framework instead of fighting it, or when you want to understand why 37signals avoids foreign keys, uses records as state instead of booleans, and computes at write time. The style guide alone comes from 265 Fizzy PRs, so this is practiced convention, not theory.

skills.sh installs: 340
GitHub stars: 222
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pproenca/dot-skills --skill 37signals-rails --agent claude-code

Installs into .claude/skills of the current project.

Files

37signals Rails Best Practices

Comprehensive coding principles and conventions for Ruby on Rails applications, as practiced at 37signals (Basecamp, HEY, Fizzy). Contains 56 rules across 8 categories, prioritized by architectural impact. Derived from official 37signals sources: the Fizzy codebase, STYLE.md, AGENTS.md, the Rails Doctrine, DHH's "On Writing Software Well" series, and the unofficial 37signals style guide (265 Fizzy PRs).