mcrundo-sustainable-rails-skill

Sustainable Rails Skill for Claude Code

A Claude Code plugin based on Sustainable Web Development with Ruby on Rails by David Bryant Copeland.

Install

claude plugin add mcrundo/sustainable-rails-skill

Then restart Claude Code.

Commands

Command	Purpose
/sustainable:review	Review code changes for sustainability violations
/sustainable:analyze	Full codebase sustainability analysis

What It Checks

• Business logic placement — Logic belongs in service classes, not Active Records
• Database integrity — Constraints (NOT NULL, FK, CHECK, unique indexes) enforce correctness
• Model health — Thin models, minimal callbacks, no scope-as-business-logic
• Controller health — Controllers as "configuration", no business logic
• Boundary classes — Jobs, mailers, rake tasks delegate to services
• Routes — Canonical resources with only:, no unused routes
• Testing strategy — System tests for flows, unit tests for services, constraint tests for models

Core Idea

Business logic is complex and changes frequently. Classes used everywhere (Active Records) amplify bugs. Therefore: keep Active Records simple, put business logic in isolated service classes where bugs are contained.

Reference Files

25 condensed reference files organized into:

• references/core/ — Sustainability principles, Rails architecture, business logic separation
• references/patterns/ — Routes, models, controllers, services, jobs, views, testing, database
• references/topics/ — Auth, APIs, CSS, JavaScript, operations, monoliths, leadership
• references/examples/ — End-to-end feature implementation walkthrough