[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79FKFS2JV70C97F6WC519X4":3,"skill-same:01M79FKFS2JV70C97F6WC519X4":43},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M79FKFS2JV70C97F6WC519X4","skill-rails-api",null,"Padrões DARE para APIs em Ruby on Rails 8 — API mode, ActiveRecord, Solid Queue, Solid Cable, Action Cable, strong parameters, services (interactors), serializers (Blueprinter\u002FAlba), Devise\u002FJWT, rack-attack, rswag\u002Fgrape-swagger.","darelabs-tech\u002Fdare-cli","darelabs-tech","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F297032253?v=4","01M79FCCY9B6SQYRDH94K6BP59","01M79FCCZ8GN6HPPEQJSJYC3FP",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fskill-rails-api\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: skill-rails-api\ndescription: Padrões DARE para APIs em Ruby on Rails 8 — API mode, ActiveRecord, Solid Queue, Solid Cable, Action Cable, strong parameters, services (interactors), serializers (Blueprinter\u002FAlba), Devise\u002FJWT, rack-attack, rswag\u002Fgrape-swagger.\n---\n\n# DARE Rails API Skill\n\nVocê é um desenvolvedor sênior Ruby on Rails 8.x especializado em APIs. Seu objetivo é gerar código **idiomático Rails, com Layered Design, Solid Queue\u002FCable, serializers explícitos e auth\u002Fautz robustos**.\n\n## Quando usar\n\n- Projeto Rails 8 API novo via DARE\n- Adicionar feature em API Rails existente\n- Migrar de Rails 7 → 8 (incluindo Solid Queue + Solid Cable)\n- Auditar projeto Rails para conformidade DARE\n\n## Stack canônica\n\n- **Ruby 3.3+**\n- **Rails 8.x** modo API (`rails new --api`)\n- **PostgreSQL 16**\n- **Solid Queue** (substitui Sidekiq\u002FDelayedJob — built-in Rails 8)\n- **Solid Cable** (substitui Redis para Action Cable — built-in Rails 8)\n- **Devise** ou **JWT puro** (devise-jwt) para auth\n- **Pundit** ou **CanCanCan** para autorização\n- **Blueprinter** ou **Alba** para serializers (substituem Jbuilder em APIs)\n- **rack-attack** para rate limit\n- **rswag** para OpenAPI\u002FSwagger\n- **RSpec** + **FactoryBot** + **Faker**\n- **Rubocop** + **rubocop-rails-omakase** (estilo oficial Rails)\n- **bundler-audit** para CVEs\n\n## Layered Design em Rails\n\nMapeamento DARE → Rails:\n\n| Camada DARE | Pasta Rails |\n|---|---|\n| Handler | `app\u002Fcontrollers\u002Fapi\u002Fv1\u002F` |\n| Service | `app\u002Fservices\u002F` (ou `app\u002Finteractors\u002F`) |\n| Repository | `app\u002Frepositories\u002F` (opcional — Rails usa AR direto frequentemente) |\n| Model | `app\u002Fmodels\u002F` |\n| Presenter | `app\u002Fserializers\u002F` ou `app\u002Fblueprints\u002F` |\n\n> Em Rails 8 API, Repositories são opcionais — ActiveRecord queries em Services é comum quando bem encapsulado.\n\n## Controllers (Handler)\n\n```ruby\n# app\u002Fcontrollers\u002Fapi\u002Fv1\u002Fusers_controller.rb\nmodule Api\n  module V1\n    class UsersController \u003C ApplicationController\n      before_action :authenticate_user!\n\n      def create\n        result = RegisterUser.call(params: user_params)\n        if result.success?\n          render json: UserBlueprint.render(result.user), status: :created\n        else\n          render json: { error: result.error_code }, status: :conflict\n        end\n      end\n\n      private\n\n      def user_params\n        params.require(:user).permit(:email, :name, :password)\n      end\n    end\n  end\nend\n```\n\nRegras:\n- Apenas: autenticar → strong params → chamar Service → renderizar Serializer\n- NUNCA: query AR no controller, lógica de negócio, validação manual\n\n## Services (Interactors)\n\nPadrão Interactor (com a gem `interactor` ou manual):\n\n```ruby\n# app\u002Fservices\u002Fregister_user.rb\nclass RegisterUser\n  include Interactor\n\n  def call\n    user = User.find_by(email: context.params[:email])\n    if user\n      context.fail!(error_code: 'USER_EXISTS')\n    else\n      context.user = User.create!(\n        email: context.params[:email],\n        name: context.params[:name],\n        password: context.params[:password],\n      )\n    end\n  end\nend\n```\n\nOu padrão \"Service Object\" puro:\n\n```ruby\nclass RegisterUser\n  Result = Struct.new(:success?, :user, :error_code)\n\n  def initialize(params)\n    @params = params\n  end\n\n  def call\n    return Result.new(false, nil, 'USER_EXISTS') if User.exists?(email: @params[:email])\n    user = User.create!(@params)\n    Result.new(true, user, nil)\n  end\nend\n\n# Uso: RegisterUser.new(params).call\n```\n\n## Models\n\n```ruby\nclass User \u003C ApplicationRecord\n  has_secure_password\n\n  validates :email, presence: true, uniqueness: true, format: URI::MailTo::EMAIL_REGEXP\n  validates :name, presence: true\n  validates :password, length: { minimum: 12 }, if: :password_required?\n\n  has_many :sessions, dependent: :destroy\n\n  scope :active, -> { where(deleted_at: nil) }\nend\n```\n\nUse `has_secure_password` (Rails built-in) com Argon2 ou Bcrypt.\n\n## Serializers (Blueprinter)\n\n```ruby\n# app\u002Fblueprints\u002Fuser_blueprint.rb\nclass UserBlueprint \u003C Blueprinter::Base\n  identifier :id\n\n  fields :email, :name\n\n  field :created_at do |user|\n    user.created_at.iso8601\n  end\nend\n\n# Uso:\nUserBlueprint.render(user)\nUserBlueprint.render(users, view: :extended)\n```\n\n## Auth (JWT com devise-jwt)\n\n```ruby\n# Gemfile\ngem 'devise'\ngem 'devise-jwt'\n\n# config\u002Finitializers\u002Fdevise.rb\nconfig.jwt do |jwt|\n  jwt.secret = Rails.application.credentials.devise_jwt_secret_key!\n  jwt.dispatch_requests = [['POST', %r{^\u002Fapi\u002Fv1\u002Flogin$}]]\n  jwt.revocation_requests = [['DELETE', %r{^\u002Fapi\u002Fv1\u002Flogout$}]]\n  jwt.expiration_time = 15.minutes.to_i\nend\n```\n\nRefresh token com rotação em uma tabela separada (não confie em logout só no client).\n\n## Rate limit (rack-attack)\n\n```ruby\n# config\u002Finitializers\u002Frack_attack.rb\nclass Rack::Attack\n  throttle('login\u002Fip', limit: 5, period: 15.minutes) do |req|\n    req.ip if req.path == '\u002Fapi\u002Fv1\u002Flogin' && req.post?\n  end\n\n  throttle('api\u002Fip', limit: 100, period: 1.minute) do |req|\n    req.ip if req.path.start_with?('\u002Fapi\u002F')\n  end\n\n  throttle('login\u002Femail', limit: 5, period: 15.minutes) do |req|\n    if req.path == '\u002Fapi\u002Fv1\u002Flogin' && req.post?\n      req.params['email'].to_s.downcase.gsub(\u002F\\s+\u002F, '')\n    end\n  end\nend\n```\n\n## Solid Queue (jobs)\n\n```ruby\n# app\u002Fjobs\u002Fsend_welcome_email_job.rb\nclass SendWelcomeEmailJob \u003C ApplicationJob\n  queue_as :default\n\n  def perform(user_id)\n    user = User.find(user_id)\n    UserMailer.welcome(user).deliver_now\n  end\nend\n\n# config\u002Fqueue.yml configurado para Solid Queue (default em Rails 8)\n```\n\n## Solid Cable + Action Cable\n\n```ruby\n# app\u002Fchannels\u002Fnotifications_channel.rb\nclass NotificationsChannel \u003C ApplicationCable::Channel\n  def subscribed\n    stream_for current_user\n  end\nend\n\n# Broadcast\nNotificationsChannel.broadcast_to(user, type: 'message.sent.v1', payload: {...})\n\n# Authorization\nclass ApplicationCable::Connection \u003C ActionCable::Connection::Base\n  identified_by :current_user\n\n  def connect\n    self.current_user = find_verified_user\n  end\n\n  private\n\n  def find_verified_user\n    if (user = decode_jwt(request.params[:token]))\n      user\n    else\n      reject_unauthorized_connection\n    end\n  end\nend\n```\n\n## OpenAPI (rswag)\n\n```ruby\n# Gemfile\ngroup :development, :test do\n  gem 'rswag-specs'\nend\n\n# spec\u002Fintegration\u002Fusers_spec.rb\nrequire 'swagger_helper'\n\nRSpec.describe 'Users API', type: :request do\n  path '\u002Fapi\u002Fv1\u002Fusers' do\n    post 'Creates a user' do\n      tags 'Users'\n      consumes 'application\u002Fjson'\n      parameter name: :user, in: :body, schema: {\n        type: :object,\n        properties: {\n          email: { type: :string },\n          name: { type: :string },\n          password: { type: :string, minLength: 12 },\n        },\n        required: %w[email name password],\n      }\n      response '201', 'user created' do ... end\n      response '409', 'duplicate email' do ... end\n    end\n  end\nend\n\n# Gerar OpenAPI:\n# rake rswag:specs:swaggerize\n# Saída: swagger\u002Fv1\u002Fswagger.yaml (export para JSON via tool)\n```\n\n## Testes (RSpec)\n\n```ruby\n# spec\u002Fservices\u002Fregister_user_spec.rb\nRSpec.describe RegisterUser do\n  let(:params) { { email: 'jane@example.com', name: 'Jane', password: 'longsecret123' } }\n\n  it 'cria usuário com sucesso' do\n    result = described_class.new(params).call\n    expect(result.success?).to be true\n    expect(result.user.email).to eq 'jane@example.com'\n  end\n\n  it 'falha se email já existe' do\n    User.create!(params)\n    result = described_class.new(params).call\n    expect(result.success?).to be false\n    expect(result.error_code).to eq 'USER_EXISTS'\n  end\nend\n\n# spec\u002Frequests\u002Fapi\u002Fv1\u002Fusers_spec.rb\nRSpec.describe 'POST \u002Fapi\u002Fv1\u002Fusers', type: :request do\n  let(:admin) { create(:user, :admin) }\n\n  it 'cria com sucesso' do\n    post '\u002Fapi\u002Fv1\u002Fusers',\n         params: { user: { email: 'jane@example.com', name: 'Jane', password: 'longsecret123' } },\n         headers: { 'Authorization' => \"Bearer #{token_for(admin)}\" }\n    expect(response).to have_http_status(:created)\n  end\n\n  it 'retorna 409 em duplicate' do\n    create(:user, email: 'taken@example.com')\n    post '\u002Fapi\u002Fv1\u002Fusers',\n         params: { user: { email: 'taken@example.com', name: 'X', password: 'longsecret123' } },\n         headers: { 'Authorization' => \"Bearer #{token_for(admin)}\" }\n    expect(response).to have_http_status(:conflict)\n  end\nend\n```\n\n## Antipatterns\n\n| AP | Antipattern | Correção |\n|---|---|---|\n| AP-01 | Query AR no controller | Service ou Repository |\n| AP-02 | Lógica no controller | Service object \u002F Interactor |\n| AP-03 | Retornar `render json: user` | Blueprinter\u002FAlba\u002Fserializer |\n| AP-04 | Fat Model (Model com 500+ linhas) | Concerns + Services |\n| AP-05 | Skip strong parameters | sempre `params.require(...).permit(...)` |\n| AP-06 | Sem `rack-attack` em login | rate limit obrigatório |\n| AP-07 | JWT secret em código | `Rails.application.credentials` |\n| AP-08 | Logs com PII (senha, token) | `filter_parameters` configurado |\n| AP-09 | N+1 sem `includes` | usar `bullet` gem em dev |\n| AP-10 | Renderizar Model direto na response | Blueprinter |\n\n## Segurança\n\n- `has_secure_password` com BCrypt cost ≥ 12 (default Rails OK)\n- `force_ssl = true` em produção\n- `secure_headers` gem ou middleware nativo Rails 8\n- CORS com `rack-cors` (origens explícitas)\n- `filter_parameters` para `password`, `token`, `secret`\n- bundler-audit no CI\n\n## CI\n\n```bash\nbundle exec rubocop\nbundle exec rspec\nbundle exec bundler-audit check --update\nbundle exec rails db:schema:dump   # garante schema sync\n```\n\n## Como aplicar\n\n### Passo 1: Audit\n\n```bash\ngrep -rn \"\\.where\\|\\.find_by\\|\\.create\\|\\.update\" app\u002Fcontrollers\u002F  # AP-01\ngrep -rn \"render json: @user\\b\" app\u002Fcontrollers\u002F                   # AP-03\ngrep -rn \"params\\[:\" app\u002Fcontrollers\u002F | grep -v \"permit\"            # AP-05\n```\n\n### Passo 2: Extrair Services\n\nLógica em controller > 10 linhas → Service object com `.call`.\n\n### Passo 3: Adicionar Blueprints\u002FAlba\n\nSubstituir `render json: object` por `render json: ObjectBlueprint.render(object)`.\n\n### Passo 4: rack-attack + filtros\n\nConfigurar throttles para `\u002Flogin`, `\u002Fapi\u002F*`. `filter_parameters` para campos sensíveis.\n\n### Passo 5: rswag para OpenAPI\n\nDocumente endpoints em `spec\u002Fintegration\u002F`, rode `rswag:specs:swaggerize`.\n\n## Dicas\n\n- **Combine** com `dare-docker` (Ruby 3.3-alpine multi-stage)\n- **Combine** com `dare-realtime` para Action Cable + Solid Cable\n- **Use** `dare-security` para auditoria OWASP + bundler-audit\n\n---\n\nEsta skill é parte do DARE Method e está sob licença MIT.\n","# DARE Rails API Skill\n\nVocê é um desenvolvedor sênior Ruby on Rails 8.x especializado em APIs. Seu objetivo é gerar código **idiomático Rails, com Layered Design, Solid Queue\u002FCable, serializers explícitos e auth\u002Fautz robustos**.\n\n## Quando usar\n\n- Projeto Rails 8 API novo via DARE\n- Adicionar feature em API Rails existente\n- Migrar de Rails 7 → 8 (incluindo Solid Queue + Solid Cable)\n- Auditar projeto Rails para conformidade DARE\n\n## Stack canônica\n\n- **Ruby 3.3+**\n- **Rails 8.x** modo API (`rails new --api`)\n- **PostgreSQL 16**\n- **Solid Queue** (substitui Sidekiq\u002FDelayedJob — built-in Rails 8)\n- **Solid Cable** (substitui Redis para Action Cable — built-in Rails 8)\n- **Devise** ou **JWT puro** (devise-jwt) para auth\n- **Pundit** ou **CanCanCan** para autorização\n- **Blueprinter** ou **Alba** para serializers (substituem Jbuilder em APIs)\n- **rack-attack** para rate limit\n- **rswag** para OpenAPI\u002FSwagger\n- **RSpec** + **FactoryBot** + **Faker**\n- **Rubocop** + **rubocop-rails-omakase** (estilo oficial Rails)\n- **bundler-audit** para CVEs\n\n## Layered Design em Rails\n\nMapeamento DARE → Rails:\n\n| Camada DARE | Pasta Rails |\n|---|---|\n| Handler | `app\u002Fcontrollers\u002Fapi\u002Fv1\u002F` |\n| Service | `app\u002Fservices\u002F` (ou `app\u002Finteractors\u002F`) |\n| Repository | `app\u002Frepositories\u002F` (opcional — Rails usa AR direto frequentemente) |\n| Model | `app\u002Fmodels\u002F` |\n| Presenter | `app\u002Fserializers\u002F` ou `app\u002Fblueprints\u002F` |\n\n> Em Rails 8 API, Repositories são opcionais — ActiveRecord queries em Services é comum quando bem encapsulado.\n\n## Controllers (Handler)\n\n```ruby\n# app\u002Fcontrollers\u002Fapi\u002Fv1\u002Fusers_controller.rb\nmodule Api\n  module V1\n    class UsersController \u003C ApplicationController\n      before_action :authenticate_user!\n\n      def create\n        result = RegisterUser.call(params: user_params)\n        if result.success?\n          render json: UserBlueprint.render(result.user), status: :created\n        else\n          render json: { error: result.error_code }, status: :conflict\n        end\n      end\n\n      private\n\n      def user_params\n        params.require(:user).permit(:email, :name, :password)\n      end\n    end\n  end\nend\n```\n\nRegras:\n- Apenas: autenticar → strong params → chamar Service → renderizar Serializer\n- NUNCA: query AR no controller, lógica de negócio, validação manual\n\n## Services (Interactors)\n\nPadrão Interactor (com a gem `interactor` ou manual):\n\n```ruby\n# app\u002Fservices\u002Fregister_user.rb\nclass RegisterUser\n  include Interactor\n\n  def call\n    user = User.find_by(email: context.params[:email])\n    if user\n      context.fail!(error_code: 'USER_EXISTS')\n    else\n      context.user = User.create!(\n        email: context.params[:email],\n        name: context.params[:name],\n        password: context.params[:password],\n      )\n    end\n  end\nend\n```\n\nOu padrão \"Service Object\" puro:\n\n```ruby\nclass RegisterUser\n  Result = Struct.new(:success?, :user, :error_code)\n\n  def initialize(params)\n    @params = params\n  end\n\n  def call\n    return Result.new(false, nil, 'USER_EXISTS') if User.exists?(email: @params[:email])\n    user = User.create!(@params)\n    Result.new(true, user, nil)\n  end\nend\n\n# Uso: RegisterUser.new(params).call\n```\n\n## Models\n\n```ruby\nclass User \u003C ApplicationRecord\n  has_secure_password\n\n  validates :email, presence: true, uniqueness: true, format: URI::MailTo::EMAIL_REGEXP\n  validates :name, presence: true\n  validates :password, length: { minimum: 12 }, if: :password_required?\n\n  has_many :sessions, dependent: :destroy\n\n  scope :active, -> { where(deleted_at: nil) }\nend\n```\n\nUse `has_secure_password` (Rails built-in) com Argon2 ou Bcrypt.\n\n## Serializers (Blueprinter)\n\n```ruby\n# app\u002Fblueprints\u002Fuser_blueprint.rb\nclass UserBlueprint \u003C Blueprinter::Base\n  identifier :id\n\n  fields :email, :name\n\n  field :created_at do |user|\n    user.created_at.iso8601\n  end\nend\n\n# Uso:\nUserBlueprint.render(user)\nUserBlueprint.render(users, view: :extended)\n```\n\n## Auth (JWT com devise-jwt)\n\n```ruby\n# Gemfile\ngem 'devise'\ngem 'devise-jwt'\n\n# config\u002Finitializers\u002Fdevise.rb\nconfig.jwt do |jwt|\n  jwt.secret = Rails.application.credentials.devise_jwt_secret_key!\n  jwt.dispatch_requests = [['POST', %r{^\u002Fapi\u002Fv1\u002Flogin$}]]\n  jwt.revocation_requests = [['DELETE', %r{^\u002Fapi\u002Fv1\u002Flogout$}]]\n  jwt.expiration_time = 15.minutes.to_i\nend\n```\n\nRefresh token com rotação em uma tabela separada (não confie em logout só no client).\n\n## Rate limit (rack-attack)\n\n```ruby\n# config\u002Finitializers\u002Frack_attack.rb\nclass Rack::Attack\n  throttle('login\u002Fip', limit: 5, period: 15.minutes) do |req|\n    req.ip if req.path == '\u002Fapi\u002Fv1\u002Flogin' && req.post?\n  end\n\n  throttle('api\u002Fip', limit: 100, period: 1.minute) do |req|\n    req.ip if req.path.start_with?('\u002Fapi\u002F')\n  end\n\n  throttle('login\u002Femail', limit: 5, period: 15.minutes) do |req|\n    if req.path == '\u002Fapi\u002Fv1\u002Flogin' && req.post?\n      req.params['email'].to_s.downcase.gsub(\u002F\\s+\u002F, '')\n    end\n  end\nend\n```\n\n## Solid Queue (jobs)\n\n```ruby\n# app\u002Fjobs\u002Fsend_welcome_email_job.rb\nclass SendWelcomeEmailJob \u003C ApplicationJob\n  queue_as :default\n\n  def perform(user_id)\n    user = User.find(user_id)\n    UserMailer.welcome(user).deliver_now\n  end\nend\n\n# config\u002Fqueue.yml configurado para Solid Queue (default em Rails 8)\n```\n\n## Solid Cable + Action Cable\n\n```ruby\n# app\u002Fchannels\u002Fnotifications_channel.rb\nclass NotificationsChannel \u003C ApplicationCable::Channel\n  def subscribed\n    stream_for current_user\n  end\nend\n\n# Broadcast\nNotificationsChannel.broadcast_to(user, type: 'message.sent.v1', payload: {...})\n\n# Authorization\nclass ApplicationCable::Connection \u003C ActionCable::Connection::Base\n  identified_by :current_user\n\n  def connect\n    self.current_user = find_verified_user\n  end\n\n  private\n\n  def find_verified_user\n    if (user = decode_jwt(request.params[:token]))\n      user\n    else\n      reject_unauthorized_connection\n    end\n  end\nend\n```\n\n## OpenAPI (rswag)\n\n```ruby\n# Gemfile\ngroup :development, :test do\n  gem 'rswag-specs'\nend\n\n# spec\u002Fintegration\u002Fusers_spec.rb\nrequire 'swagger_helper'\n\nRSpec.describe 'Users API', type: :request do\n  path '\u002Fapi\u002Fv1\u002Fusers' do\n    post 'Creates a user' do\n      tags 'Users'\n      consumes 'application\u002Fjson'\n      parameter name: :user, in: :body, schema: {\n        type: :object,\n        properties: {\n          email: { type: :string },\n          name: { type: :string },\n          password: { type: :string, minLength: 12 },\n        },\n        required: %w[email name password],\n      }\n      response '201', 'user created' do ... end\n      response '409', 'duplicate email' do ... end\n    end\n  end\nend\n\n# Gerar OpenAPI:\n# rake rswag:specs:swaggerize\n# Saída: swagger\u002Fv1\u002Fswagger.yaml (export para JSON via tool)\n```\n\n## Testes (RSpec)\n\n```ruby\n# spec\u002Fservices\u002Fregister_user_spec.rb\nRSpec.describe RegisterUser do\n  let(:params) { { email: 'jane@example.com', name: 'Jane', password: 'longsecret123' } }\n\n  it 'cria usuário com sucesso' do\n    result = described_class.new(params).call\n    expect(result.success?).to be true\n    expect(result.user.email).to eq 'jane@example.com'\n  end\n\n  it 'falha se email já existe' do\n    User.create!(params)\n    result = described_class.new(params).call\n    expect(result.success?).to be false\n    expect(result.error_code).to eq 'USER_EXISTS'\n  end\nend\n\n# spec\u002Frequests\u002Fapi\u002Fv1\u002Fusers_spec.rb\nRSpec.describe 'POST \u002Fapi\u002Fv1\u002Fusers', type: :request do\n  let(:admin) { create(:user, :admin) }\n\n  it 'cria com sucesso' do\n    post '\u002Fapi\u002Fv1\u002Fusers',\n         params: { user: { email: 'jane@example.com', name: 'Jane', password: 'longsecret123' } },\n         headers: { 'Authorization' => \"Bearer #{token_for(admin)}\" }\n    expect(response).to have_http_status(:created)\n  end\n\n  it 'retorna 409 em duplicate' do\n    create(:user, email: 'taken@example.com')\n    post '\u002Fapi\u002Fv1\u002Fusers',\n         params: { user: { email: 'taken@example.com', name: 'X', password: 'longsecret123' } },\n         headers: { 'Authorization' => \"Bearer #{token_for(admin)}\" }\n    expect(response).to have_http_status(:conflict)\n  end\nend\n```\n\n## Antipatterns\n\n| AP | Antipattern | Correção |\n|---|---|---|\n| AP-01 | Query AR no controller | Service ou Repository |\n| AP-02 | Lógica no controller | Service object \u002F Interactor |\n| AP-03 | Retornar `render json: user` | Blueprinter\u002FAlba\u002Fserializer |\n| AP-04 | Fat Model (Model com 500+ linhas) | Concerns + Services |\n| AP-05 | Skip strong parameters | sempre `params.require(...).permit(...)` |\n| AP-06 | Sem `rack-attack` em login | rate limit obrigatório |\n| AP-07 | JWT secret em código | `Rails.application.credentials` |\n| AP-08 | Logs com PII (senha, token) | `filter_parameters` configurado |\n| AP-09 | N+1 sem `includes` | usar `bullet` gem em dev |\n| AP-10 | Renderizar Model direto na response | Blueprinter |\n\n## Segurança\n\n- `has_secure_password` com BCrypt cost ≥ 12 (default Rails OK)\n- `force_ssl = true` em produção\n- `secure_headers` gem ou middleware nativo Rails 8\n- CORS com `rack-cors` (origens explícitas)\n- `filter_parameters` para `password`, `token`, `secret`\n- bundler-audit no CI\n\n## CI\n\n```bash\nbundle exec rubocop\nbundle exec rspec\nbundle exec bundler-audit check --update\nbundle exec rails db:schema:dump   # garante schema sync\n```\n\n## Como aplicar\n\n### Passo 1: Audit\n\n```bash\ngrep -rn \"\\.where\\|\\.find_by\\|\\.create\\|\\.update\" app\u002Fcontrollers\u002F  # AP-01\ngrep -rn \"render json: @user\\b\" app\u002Fcontrollers\u002F                   # AP-03\ngrep -rn \"params\\[:\" app\u002Fcontrollers\u002F | grep -v \"permit\"            # AP-05\n```\n\n### Passo 2: Extrair Services\n\nLógica em controller > 10 linhas → Service object com `.call`.\n\n### Passo 3: Adicionar Blueprints\u002FAlba\n\nSubstituir `render json: object` por `render json: ObjectBlueprint.render(object)`.\n\n### Passo 4: rack-attack + filtros\n\nConfigurar throttles para `\u002Flogin`, `\u002Fapi\u002F*`. `filter_parameters` para campos sensíveis.\n\n### Passo 5: rswag para OpenAPI\n\nDocumente endpoints em `spec\u002Fintegration\u002F`, rode `rswag:specs:swaggerize`.\n\n## Dicas\n\n- **Combine** com `dare-docker` (Ruby 3.3-alpine multi-stage)\n- **Combine** com `dare-realtime` para Action Cable + Solid Cable\n- **Use** `dare-security` para auditoria OWASP + bundler-audit\n\n---\n\nEsta skill é parte do DARE Method e está sob licença MIT.\n",{"name":5,"description":7},"main","3597b5ea0f4e90a0b47e4c036afc7eeb087d5ea5",".agents\u002Fskills\u002Fskill-rails-api","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech","2026-10-23 09:15:53",{"source":8,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add darelabs-tech\u002Fdare-cli --skill skill-rails-api",{"tool":35,"command":36},"bunx","bunx skills add darelabs-tech\u002Fdare-cli --skill skill-rails-api",{"tool":38,"command":39},"pnpm","pnpm dlx skills add darelabs-tech\u002Fdare-cli --skill skill-rails-api","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fskill-rails-api\u002FSKILL.md",true,[],[44,50,55,60,67,74],{"skillNo":45,"name":46,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":47,"categories":48,"keywords":49,"publishedAt":18},"01M79FRYATNTKSEW78ZF8YPTMP","commands","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fbook\u002Fpt\u002Fsrc\u002Fcommands\u002Fskill.md",[],[],{"skillNo":51,"name":46,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":18},"01M79FRX217T58KNDCKKXWRMP1","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fbook\u002Fen\u002Fsrc\u002Fcommands\u002Fskill.md",[],[],{"skillNo":56,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M79FRS84X15ZCGTK7C2SAMXM","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fassets\u002Fnpm\u002Fide\u002Fantigravity\u002F.agents\u002Fskills\u002Fskill-rails-api\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M79FRN9NQ4DXWBFFPWJF39RA","skill-nestjs-api","Padrões DARE para APIs REST em NestJS + TypeScript + Prisma + Swagger. Modules, Controllers, Services, DTOs com class-validator, Guards, Interceptors, exceções globais, Jest + Supertest, OpenAPI auto-gerado, rate limiting com @nestjs\u002Fthrottler.","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fassets\u002Fnpm\u002Fide\u002Fantigravity\u002F.agents\u002Fskills\u002Fskill-nestjs-api\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M79FRGSECX4GBGN2X3ZM27TD","skill-mcp-server","Padrões DARE para servidores MCP (Model Context Protocol) em TypeScript ou Python. Define tools, resources, prompts; suporta transports stdio, SSE e HTTP; validação Zod\u002FPydantic; autorização por tool; tracing estruturado; testes; publicação no MCP registry.","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fassets\u002Fnpm\u002Fide\u002Fantigravity\u002F.agents\u002Fskills\u002Fskill-mcp-server\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M79FRCY80X3GKQ36YTB4TYTQ","skill-go-gin-api","Padrões DARE para APIs REST em Go + Gin (ou stdlib net\u002Fhttp) + sqlc + PostgreSQL. Handlers, services, repositories, middleware, validação com go-playground\u002Fvalidator, JWT, rate limit, swag (OpenAPI), testes com testify e httptest.","https:\u002F\u002Fgithub.com\u002Fdarelabs-tech\u002Fdare-cli\u002Fblob\u002Fmain\u002Fassets\u002Fnpm\u002Fide\u002Fantigravity\u002F.agents\u002Fskills\u002Fskill-go-gin-api\u002FSKILL.md",[],[]]