mihai-rails-style

---

name: mihai-rails-style description: This skill should be used when writing Ruby and Rails code in Mihai's distinctive style, which emphasizes the principles of simplicity and Rails conventions while embracing a practical, no-nonsense approach to modern tooling.

<essential_principles>

Core Philosophy

"Write code that a junior developer can understand. Every line should be obvious."

Practical Rails:

• Rich domain models over service objects
• CRUD controllers with standard actions
• Multi-tenant scoping via Current.organization
• Hotwire (Turbo + Stimulus) for interactivity
• esbuild + Tailwind CLI for assets
• Minitest with fixtures

What to avoid:

• Service objects for everything (use namespaced builders when needed)
• Dependency injection patterns
• Over-engineered abstractions
• Complex JS frameworks (React/Vue/Svelte)
• TypeScript in Rails apps </essential_principles>

1. Controllers - Thin controllers, scoping, before_action setup
2. Models - Validations, scopes, enums, method organization
3. Views - Hotwire, partials, I18n, explicit variables
4. Stimulus - Small controllers, data attributes, clickable rows
5. Testing - Minitest, fixtures, I18n assertions
6. Anti-Patterns - What to avoid and better alternatives
7. Code Review - Review code against Mihai style
8. General Guidance - Philosophy and conventions

Specify a number or describe your task.

After reading relevant references, apply patterns to the user's code.

<quick_reference>

Key Conventions

Multi-tenant scoping:

CopyCurrent.organization.clients.find(params[:id])
Current.organization.contacts.alphabetically

Model organization order:

1. associations
2. validations
3. scopes
4. class methods (class << self)
5. public instance methods
6. private methods

Enums:

Copyenum :status, { draft: "draft", published: "published" }, prefix: true

Scopes:

Copyscope :active, -> { where(active: true) }
scope :alphabetically, -> { order(:name) }
scope :recent, -> { order(created_at: :desc) }

Date queries - use ranges:

Copywhere(created_at: Time.current.beginning_of_day..)
where(created_at: 1.week.ago..)

</quick_reference>

<reference_index>

Domain Knowledge

All detailed patterns in references/:

<success_criteria> Code follows Mihai style when:

• Controllers are thin, models are fat
• All queries scoped through Current.organization
• Models use class << self for class methods
• Enums have explicit values and prefix: true
• Views use partials with explicit variable passing
• I18n for all user-facing text
• Stimulus controllers are small and focused
• Tests use Minitest with fixtures and I18n assertions
• No unnecessary service objects or abstractions </success_criteria>