ruby-refactor

name	ruby-refactor
description	Ruby refactoring guidelines from community best practices. This skill should be used when refactoring, reviewing, or restructuring Ruby code to improve design, readability, and maintainability. Triggers on tasks involving code smells, method extraction, conditional simplification, coupling reduction, design patterns, or Ruby idiom adoption.

Community Ruby Refactoring Best Practices

Comprehensive refactoring guide for Ruby applications, maintained by the community. Contains 45 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.

When to Apply

Reference these guidelines when:

• Refactoring Ruby code to reduce complexity and improve design
• Extracting methods, classes, or value objects from large units
• Simplifying complex conditionals and deep nesting
• Reducing coupling between classes and modules
• Adopting idiomatic Ruby patterns and modern Ruby 3.x features

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Structure & Decomposition	CRITICAL	struct-
2	Conditional Simplification	CRITICAL	cond-
3	Coupling & Dependencies	HIGH	couple-
4	Ruby Idioms	HIGH	idiom-
5	Data & Value Objects	MEDIUM-HIGH	data-
6	Design Patterns	MEDIUM