Padrões de engenharia Ruby que o agente segue — não negocia.
Backend Ruby/Rails com o piso da casa: segredo fora do bundle, ActiveRecord parametrizado, strong params, auth server-side, IAM como app separada e testes que carregam a segurança que o compilador não dá.
$ schematize install rubyPisos inegociáveis
Não se desligam "pra ir mais rápido". Lista completa na skill.
Ruby por fit + ADR
Linguagem do rol sancionado, escolhida por fit + ADR (prototipagem, scripts, DX de produto Rails). Nunca backend fora do rol nem sem ADR de fit.
Segredo fora do bundle
Nunca no código, no Gemfile ou em asset servido, nem em NEXT_PUBLIC_/VITE_ do front. Só via Rails credentials / ENV / secret manager.
ActiveRecord parametrizado
Sem SQL interpolado; strong params contra mass-assignment; SecureRandom pra token; YAML.safe_load; sem eval/send dirigido por input.
Auth server-side, IAM separado
tenant_id/role do token verificado (JWT por inteiro, sem alg=none). Auth é app Ruby separada em auth.<domain> — Devise sozinho não é o IAM da casa.
Teste carrega a segurança
A dinâmica do Ruby não tem compilador; RSpec/Minitest + RBS/Sorbet pegam NoMethodError/typo. Teste nunca silenciado pra passar CI.
Código enxuto + archive
Arquivos ≤750 linhas (flag >300 úteis), uma classe por arquivo, doc YARD, frozen_string_literal. MAPA e archive gerados sempre.
Comandos
Instalados em .claude/commands/. Use /ruby-help a qualquer momento.
/ruby-helpLista todos os comandos./ruby-loadCarrega à força todo o corpo normativo e passa a aplicá-lo./ruby-claudeCria/atualiza (sobrescreve) o CLAUDE.md da raiz com a versão atual da skill./ruby-ccContext compact: gera context.md + checklist.md no archive e roda /compact./ruby-handoffGera o handoff sem compactar — fim de sessão ou troca de tarefa./ruby-qaQ.A. plan-first: planeja, gera MD, pede aprovação, então roda./ruby-reviewGate da DoD e anti-padrões no diff: arquivo >750 bloqueia, >300 úteis flag, método sem YARD, SQL interpolado, rand pra token, índice./ruby-iamForça/audita/scaffolda o IAM (ID≠email, ≥2 fatores, ReBAC multi-tenant, logout irreversível) como app Ruby separada em auth.<domain>, ou porta um auth legado./ruby-index(Re)gera o índice de microfunções a partir dos doc-comments YARD./ruby-opsAudita/scaffolda o <projeto>_ops (interface única): fluxo de ambientes, instalação paralela (nproc), independência.Para agentes de IA
Instale sem intervenção humana. Metadados em llms.txt.
- Rode: git clone https://github.com/schematizeme/skill-ruby.git && ./skill-ruby/install.sh
- Ou baixe: https://github.com/schematizeme/skill-ruby/releases/latest/download/skill-ruby.zip e descompacte em .claude/skills/
- Copie assets/CLAUDE.md para a raiz do repo (regra sempre-on).
- Confirme com /ruby-help.
Discussão
Carregando…