القائمة
Use when naming classes, methods, routes in vanilla Rails codebases - enforces concern adjectives (-able/-ible only), no bangs for state, resource naming cascade, and commit message format
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when writing Rails controllers or implementing state changes - enforces resource extraction, thin controllers delegating to models, params.expect, and controller concerns for scoping
Use when designing database schema, writing migrations, or making data storage decisions - enforces UUIDs, account_id multi-tenancy, no foreign keys, and proper index patterns
Use when writing Hotwire (Turbo/Stimulus) code in Rails - enforces dom_id helpers, morph updates, focused Stimulus controllers, and JavaScript private methods
Use when writing background jobs or async operations - enforces thin job wrappers (3-5 lines) that delegate to models using _later/_now naming pattern
Use when writing Rails models - enforces state-as-records not booleans, concerns as adjectives namespaced under model, and concern extraction triggers
Use when defining Rails routes, organizing controller directories, or adding resources - enforces resource extraction, shallow nesting, resolve helpers, and module scoping
| name | vanilla-rails-naming |
| description | Use when naming classes, methods, routes in vanilla Rails codebases - enforces concern adjectives (-able/-ible only), no bangs for state, resource naming cascade, and commit message format |
37signals naming conventions from production Basecamp codebases.
Every state change flows through this cascade:
| Layer | Pattern | Example |
|---|---|---|
| Concern | Adjective (-able/-ible) | Card::Closeable |
| State model | Noun | Closure |
| Controller | Plural noun | ClosuresController |
| Route | Singular resource | resource :closure |
| Method | Plain verb (no !) | card.close |
| Async enqueue | *_later | notify_watchers_later |
| Sync execute | *_now or plain | notify_watchers_now |
If the cascade doesn't flow, the naming is wrong.
# Wrong
Card::Closing # verb
Card::PinManager # Manager/Handler/Service
Card::Closed # past participle
# Right
Card::Closeable
Card::Pinnable
Card::Assignable
If concern name doesn't end in -able/-ible, STOP and rename immediately. No -ing, -er, -ish, Logic, Management, Handler, Service.
Plain verbs for state changes. ! only when non-bang counterpart exists.
# Wrong # Right
card.close! card.close
card.pin! card.pin_by(user)
card.archive! card.archive
_later always at the end of compound verbs:
notify_watchers_later # enqueues job
notify_watchers_now # actual logic (called by job)
pin_and_notify_later # compound verb
app/models/card/closeable.rb # Model-specific concern
app/models/concerns/eventable.rb # Shared concern
app/models/closure.rb # State record
app/controllers/cards/closures_controller.rb
Present tense, lowercase, no type prefixes:
add pin feature to cards
extract closeable concern
fix closure validation
Not: feat:, fix:, [FEATURE], past tense, title case.
| Red flag | Fix |
|---|---|
| Concern not -able/-ible | Rename immediately |
State method with ! | Remove bang |
post :close in routes | resource :closure |
Async without _later | Add suffix |
ClosureController (singular) | ClosuresController (plural) |
Commit with feat: prefix | Present tense, no prefix |