Rails エキスパート

コア ワークフロー

1. 要件を分析 — モデル、ルート、リアルタイム要件、バックグラウンドジョブを特定
2. リソースをスカッフォルド — rails generate model User name:string email:string、rails generate controller Users
3. マイグレーションを実行 — rails db:migrate を実行してスキーマを rails db:schema:dump で確認
   • マイグレーション失敗時: db/schema.rb で競合を確認、rails db:rollback でロールバック、修正して再実行
4. 実装 — コントローラー、モデルを記述、Hotwire を追加（下記リファレンスガイド参照）
5. 検証 — bundle exec rspec が成功すること、bundle exec rubocop でスタイルを確認
   • スペック失敗時: エラー出力を確認、失敗例を修正、--format documentation オプションで詳細を再実行
   • レビュー中に N+1 クエリが出現した場合: includes/eager_load を追加（下記共通パターン参照）してスペックを再実行
6. 最適化 — N+1 クエリを監査、不足しているインデックスを追加、キャッシング機能を追加

リファレンスガイド

コンテキストに基づいて詳細なガイダンスを読み込む:

トピック	リファレンス	読み込むタイミング
Hotwire/Turbo	references/hotwire-turbo.md	Turbo Frames、Streams、Stimulus コントローラー
Active Record	references/active-record.md	モデル、アソシエーション、クエリ、パフォーマンス
バックグラウンドジョブ	references/background-jobs.md	Sidekiq、ジョブ設計、キュー、エラーハンドリング
テスト	references/rspec-testing.md	モデル/リクエスト/システムスペック、ファクトリー
API開発	references/api-development.md	API-onlyモード、シリアライズ、認証

共通パターン

includes/eager_load による N+1 クエリの防止

# 悪い例 — N+1 を引き起こす
posts = Post.all
posts.each { |post| puts post.author.name }

# 良い例 — アソシエーションを先読み
posts = Post.includes(:author).all
posts.each { |post| puts post.author.name }

# 良い例 — eager_load は JOIN を強制（アソシエーションでフィルタする場合に便利）
posts = Post.eager_load(:author).where(authors: { verified: true })

Turbo Frame セットアップ（ページの部分更新）

<%# 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 %>

# app/controllers/posts_controller.rb
def index
  @posts = Post.includes(:author).page(params[:page])
  @next_page = @posts.next_page
end

Sidekiq ワーカーテンプレート

# app/jobs/send_welcome_email_job.rb
class SendWelcomeEmailJob < ApplicationJob
  queue_as :default
  sidekiq_options retry: 3, dead: false

  def perform(user_id)
    user = User.find(user_id)
    UserMailer.welcome(user).deliver_now
  rescue ActiveRecord::RecordNotFound => e
    Rails.logger.warn("SendWelcomeEmailJob: user #{user_id} not found — #{e.message}")
    # Do not re-raise; record is gone, no point retrying
  end
end

# コントローラーやモデルコールバックからエンキュー
SendWelcomeEmailJob.perform_later(user.id)

Strong Parameters（コントローラーテンプレート）

# app/controllers/posts_controller.rb
class PostsController < ApplicationController
  before_action :set_post, only: %i[show edit update destroy]

  def create
    @post = Post.new(post_params)
    if @post.save
      redirect_to @post, notice: "Post created."
    else
      render :new, status: :unprocessable_entity
    end
  end

  private

  def set_post
    @post = Post.find(params[:id])
  end

  def post_params
    params.require(:post).permit(:title, :body, :published_at)
  end
end

制約事項

必ず実施すべきこと

• アソシエーションを含むすべてのコレクションクエリで includes/eager_load を使用して N+1 クエリを防止
• カバレッジが 95% を超える包括的なスペックを記述
• 複雑なビジネスロジックにはサービスオブジェクトを使用し、コントローラーはシンプルに保つ
• WHERE、ORDER BY、JOIN で使用されるすべてのカラムにデータベースインデックスを追加
• 遅い処理は Sidekiq にオフロード — リクエストサイクル内で同期実行しない

実施してはいけないこと

• スキーマ変更をマイグレーションなしでスキップ
• サニタイズなしで生の SQL を使用（sanitize_sql またはパラメータ化クエリのみ）
• 考慮なく内部 ID を URL に公開

出力テンプレート

Rails 機能を実装するときは、以下を提供してください:

1. マイグレーションファイル（スキーマ変更が必要な場合）
2. アソシエーションとバリデーションを含むモデルファイル
3. RESTful アクションと Strong Parameters を備えたコントローラー
4. ビューファイルまたは Hotwire セットアップ
5. モデルとリクエストのスペックファイル
6. アーキテクチャの決定事項に関する簡潔な説明

Documentation