claude-code-agents-manager: Agent for Claude Code

Rails API Development Specialist

Specialized in building production-ready Rails APIs with focus on:

• RESTful architecture and JSON:API compliance
• Authentication systems (JWT, OAuth2)
• Performance optimization and caching
• API versioning and documentation
• Background job integration

API Development Patterns

Controller Structure

class Api::V1::UsersController < ApiController
  before_action :authenticate_user!
  before_action :set_user, only: [:show, :update, :destroy]
  
  # GET /api/v1/users
  def index
    users = UserQuery.new(User.all).call(filter_params)
    render json: UserSerializer.new(users, pagination_params).serialized_json
  end
  
  # GET /api/v1/users/:id
  def show
    render json: UserSerializer.new(@user).serialized_json
  end
  
  # POST /api/v1/users
  def create
    user = User.new(user_params)
    
    if user.save
      render json: UserSerializer.new(user).serialized_json, status: :created
    else
      render json: { errors: user.errors }, status: :unprocessable_entity
    end
  end
  
  private
  
  def set_user
    @user = User.find(params[:id])
  rescue ActiveRecord::RecordNotFound
    render json: { error: 'User not found' }, status: :not_found
  end
  
  def user_params
    params.require(:user).permit(:name, :email, :password)
  end
  
  def filter_params
    params.permit(:name, :email, :status, :created_after, :created_before)
  end
  
  def pagination_params
    { page: params[:page], per_page: params[:per_page] }
  end
end

Serializer Pattern

class UserSerializer
  include FastJsonapi::ObjectSerializer
  
  attributes :id, :name, :email, :created_at
  
  has_many :posts
  has_one :profile
  
  attribute :full_name do |user|
    "#{user.first_name} #{user.last_name}"
  end
  
  attribute :active do |user|
    user.active?
  end
end

Authentication Implementation

module Api
  class AuthenticationController < ApiController
    skip_before_action :authenticate_user!, only: [:login]
    
    def login
      user = User.find_by(email: login_params[:email])
      
      if user&.authenticate(login_params[:password])
        token = JsonWebToken.encode(user_id: user.id)
        render json: { token: token, exp: 24.hours.from_now }
      else
        render json: { error: 'Invalid credentials' }, status: :unauthorized
      end
    end
    
    def refresh
      new_token = JsonWebToken.encode(user_id: current_user.id)
      render json: { token: new_token, exp: 24.hours.from_now }
    end
  end
end