CtrlK
BlogDocsLog inGet started
Tessl Logo

igmarin/rails-agent-skills

Curated library of 39 AI agent skills for Ruby on Rails development. Organized by category: planning, testing, code-quality, ddd, engines, infrastructure, api, patterns, context, orchestration, and workflows. Includes 5 callable workflow skills (rails-tdd-loop, rails-review-flow, rails-setup-flow, rails-quality-flow, rails-engines-flow) for complete development cycles. Covers code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and TDD automation.

95

1.20x
Quality

98%

Does it follow best practices?

Impact

95%

1.20x

Average score across 35 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

workflow.mdskills/infrastructure/rails-api-versioning/references/

API Versioning Workflow

Step-by-step guide for introducing a new API version.

Step 1: Create V(N+1) Controllers

Inherit from V(N) controllers and override only changed actions:

# app/controllers/v2/users_controller.rb
module V2
  class UsersController < V1::UsersController
    def index
      # New behavior
      render json: User.all, only: [:id, :name, :email, :phone]
    end
  end
end

Step 2: Add Routes

Add V(N+1) namespace to config/routes.rb:

namespace :api do
  namespace :v1 do
    resources :users
  end

  namespace :v2 do
    resources :users  # New version
  end
end

Step 3: Add Deprecation to V(N)

Include Deprecatable concern in V(N) controllers:

module V1
  class UsersController < ApplicationController
    include Deprecatable
    # ...
  end
end

Step 4: Run Backward Compatibility Specs

Only deploy when all V(N) tests pass.

bundle exec rspec spec/requests/api/backward_compatibility_spec.rb

Step 5: Mark as Deprecated

  1. Update API documentation with deprecation notice
  2. Notify API consumers via email/changelog
  3. Set sunset date (minimum 6 months recommended)

Step 6: Remove After Sunset

After the sunset date has passed:

  1. Remove V(N) routes from config/routes.rb
  2. Delete V(N) controller files
  3. Remove V(N) specs
  4. Update documentation

skills

infrastructure

rails-api-versioning

references

strategies.md

workflow.md

EXAMPLES.md

SKILL.md

README.md

tile.json