Skills · Claude Code · Agent Skills

Estándares de ingeniería Ruby que el agente sigue — sin negociar.

Backend Ruby/Rails con el piso de la casa: secretos fuera del bundle, ActiveRecord parametrizado, strong params, auth del lado del servidor, IAM como app separada y pruebas que aportan la seguridad que el compilador no da.

Mantenido por Lucas Andrade

schematize-ruby · v0.1.2bash
$ schematize install ruby
GitHub →descargar skill (.zip)/ruby-help · github.com/schematizeme/schematize-cli

Pisos no negociables

No se apagan "para ir más rápido". Lista completa en la skill.

Ruby por fit + ADR

Lenguaje del rol sancionado, elegido por fit + ADR (prototipado, scripts, DX de producto Rails). Nunca backend fuera del rol ni sin ADR de fit.

Secretos fuera del bundle

Nunca en el código, en el Gemfile o en un asset servido, ni en NEXT_PUBLIC_/VITE_ del front. Solo vía Rails credentials / ENV / secret manager.

ActiveRecord parametrizado

Sin SQL interpolado; strong params contra mass-assignment; SecureRandom para token; YAML.safe_load; sin eval/send dirigido por input.

Auth del lado del servidor, IAM separado

tenant_id/role del token verificado (JWT por entero, sin alg=none). Auth es app Ruby separada en auth.<domain> — Devise por sí solo no es el IAM de la casa.

La prueba aporta la seguridad

El dinamismo de Ruby no tiene compilador; RSpec/Minitest + RBS/Sorbet atrapan NoMethodError/typo. La prueba nunca se silencia para pasar CI.

Código enjuto + archivo

Archivos ≤750 líneas (flag >300 útiles), una clase por archivo, doc YARD, frozen_string_literal. MAPA y archivo generados siempre.

Comandos

Instalados en .claude/commands/. Usa /ruby-help cuando quieras.

/ruby-helpLista todos los comandos.
/ruby-loadCarga a la fuerza todo el cuerpo normativo y empieza a aplicarlo.
/ruby-claudeCrea/actualiza (sobrescribe) el CLAUDE.md de la raíz con la versión actual de la skill.
/ruby-ccContext compact: escribe context.md + checklist.md en el archivo y ejecuta /compact.
/ruby-handoffEscribe el handoff sin compactar — fin de sesión o cambio de tarea.
/ruby-qaQA plan-first: planifica, genera el MD, pide aprobación y ejecuta.
/ruby-reviewGate de DoD y antipatrones en el diff: archivo >750 bloquea, >300 útiles flag, método sin YARD, SQL interpolado, rand para token, índice.
/ruby-iamFuerza/audita/scaffolda el IAM (ID≠email, ≥2 factores, ReBAC multi-tenant, logout irreversible) como app Ruby separada en auth.<domain>, o porta un auth legado.
/ruby-index(Re)genera el índice de microfunciones desde los doc-comments YARD.
/ruby-opsAudita/scaffolda el <proyecto>_ops (interfaz única): flujo de ambientes, instalación paralela (nproc), independencia.

Para agentes de IA

Instala sin intervención humana. Metadatos en llms.txt.

  • Ejecuta: git clone https://github.com/schematizeme/skill-ruby.git && ./skill-ruby/install.sh
  • O descarga: https://github.com/schematizeme/skill-ruby/releases/latest/download/skill-ruby.zip y descomprime en .claude/skills/
  • Copia assets/CLAUDE.md a la raíz del repo (regla siempre activa).
  • Confirma con /ruby-help.

¿No quieres instalar?

Lee las normas completas y cópialas directo a tu proyecto — o instala la skill para que el agente las aplique solo.