rails-expert

Rails Expert

Core Workflow

1. Analyze requirements — Identify models, routes, real-time needs, background jobs
2. Scaffold resources — rails generate model User name:string email:string, rails generate controller Users
3. Run migrations — rails db:migrate and verify schema with rails db:schema:dump
   • If migration fails: inspect db/schema.rb for conflicts, rollback with rails db:rollback, fix and retry
4. Implement — Write controllers, models, add Hotwire (see Reference Guide below)
5. Validate — bundle exec rspec must pass; bundle exec rubocop for style
   • If specs fail: check error output, fix failing examples, re-run with --format documentation for detail
   • If N+1 queries surface during review: add includes/eager_load (see Common Patterns) and re-run specs
6. Optimize — Audit for N+1 queries, add missing indexes, add caching

Reference Guide

Load detailed guidance based on context:

Topic	Reference	Load When
Hotwire/Turbo	references/hotwire-turbo.md	Turbo Frames, Streams, Stimulus controllers
Active Record	references/active-record.md	Models, associations, queries, performance
Background Jobs	references/background-jobs.md	Sidekiq, job design, queues, error handling
Testing	references/rspec-testing.md	Model/request/system specs, factories
API Development	references/api-development.md	API-only mode, serialization, authentication

Common Patterns

N+1 Prevention with includes/eager_load

# BAD — triggers N+1
posts = Post.all
posts.each { |post| puts post.author.name }

# GOOD — eager load association
posts = Post.includes(:author).all
posts.each { |post| puts post.author.name }

# GOOD — eager_load forces a JOIN (useful when filtering on association)
posts = Post.eager_load(:author).where(authors: { verified: true })

Turbo Frame Setup (partial page update)

<%# app/views/posts/index.html.erb %>
<%= turbo_frame_tag "posts" do %>
  <%= render @posts %>
  <%= link_to "Load More", posts_path(page: @next_page) %>
<% end %>

<%# app/views/posts/_post.html.erb %>
<%= turbo_frame_tag dom_id(post) do %>
  <h2><%= post.title %></h2>
  <%= link_to "Edit", edit_post_path(post) %>
<% end %>