Skills · Claude Code · Agent Skills

Standard di ingegneria Ruby che l'agente segue — non si negozia.

Backend Ruby/Rails con la base della casa: segreti fuori dal bundle, ActiveRecord parametrizzato, strong params, auth lato server, IAM come app separata e test che portano la sicurezza che il compilatore non dà.

Gestito da Lucas Andrade

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

Basi non negoziabili

Non si spengono "per andare più veloce". Elenco completo nella skill.

Ruby per fit + ADR

Linguaggio dell'elenco sancito, scelto per fit + ADR (prototipazione, script, DX di prodotto Rails). Mai un backend fuori elenco né senza ADR di fit.

Segreti fuori dal bundle

Mai nel codice, nel Gemfile o in un asset servito, né in NEXT_PUBLIC_/VITE_ del front. Solo via Rails credentials / ENV / secret manager.

ActiveRecord parametrizzato

Nessun SQL interpolato; strong params contro il mass-assignment; SecureRandom per i token; YAML.safe_load; nessun eval/send guidato dall'input.

Auth lato server, IAM separato

tenant_id/role dal token verificato (JWT per intero, senza alg=none). L'auth è un'app Ruby separata su auth.<domain> — Devise da solo non è l'IAM della casa.

Il test porta la sicurezza

Il dinamismo di Ruby non ha compilatore; RSpec/Minitest + RBS/Sorbet colgono NoMethodError/typo. Un test non viene mai silenziato per passare la CI.

Codice snello + archivio

File ≤750 righe (flag >300 utili), una classe per file, doc YARD, frozen_string_literal. MAP e archivio generati ogni volta.

Comandi

Installati in .claude/commands/. Usa /ruby-help quando vuoi.

/ruby-helpElenca tutti i comandi.
/ruby-loadCarica a forza tutto il corpo normativo e inizia ad applicarlo.
/ruby-claudeCrea/aggiorna (sovrascrive) il CLAUDE.md della radice con la versione attuale della skill.
/ruby-ccContext compact: scrive context.md + checklist.md nell'archivio ed esegue /compact.
/ruby-handoffScrive l'handoff senza compattare — fine sessione o cambio attività.
/ruby-qaQA plan-first: pianifica, genera l'MD, chiede approvazione, poi esegue.
/ruby-reviewGate di DoD e anti-pattern sul diff: file >750 blocca, >300 utili flag, metodo senza YARD, SQL interpolato, rand per token, indice.
/ruby-iamForza/verifica/scaffolda l'IAM (ID≠email, ≥2 fattori, ReBAC multi-tenant, logout irreversibile) come app Ruby separata su auth.<domain>, o porta un auth legacy.
/ruby-index(Ri)genera l'indice delle micro-funzioni dai doc-comment YARD.
/ruby-opsVerifica/scaffolda il <progetto>_ops (interfaccia unica): flusso di ambienti, installazione parallela (nproc), indipendenza.

Per agenti IA

Installa senza intervento umano. Metadati in llms.txt.

  • Esegui: git clone https://github.com/schematizeme/skill-ruby.git && ./skill-ruby/install.sh
  • Oppure scarica: https://github.com/schematizeme/skill-ruby/releases/latest/download/skill-ruby.zip e decomprimi in .claude/skills/
  • Copia assets/CLAUDE.md nella radice del repo (regola sempre attiva).
  • Conferma con /ruby-help.

Non vuoi installare?

Leggi le norme complete e copiale direttamente nel tuo progetto — oppure installa la skill perché l'agente le applichi da solo.