rails-expert

# Rails Expert ## Core Workflow 1. **Analyze requirements** — Identify models, routes, real-time needs, background jobs 2. **Scaffold resources** — `rails generate model User name:string email:string`, `rails generate controller Users` 3. **Run migrations** — `rails db:migrate` and verify schema with `rails db:schema:dump` - If migration fails: inspect `db/schema.rb` for conflicts, rollback with `rails db:rollback`, fix and retry 4. **Implement** — Write controllers, models, add Hotwire (see Reference Guide below) 5. **Validate** — `bundle exec rspec` must pass; `bundle exec rubocop` for style - If specs fail: check error output, fix failing examples, re-run with `--format documentation` for detail - If N+1 queries surface during review: add `includes`/`eager_load` (see Common Patterns) and re-run specs 6. **Optimize** — Audit for N+1 queries, add missing indexes, add caching ## Reference Guide Load detailed guidance based on context: | Topic | Reference | Load When | |-------|-----------|-----------| | Hotwire/Turbo | `references/hotwire-turbo.md` | Turbo Frames, Streams, Stimulus controllers | | Active Record | `references/active-record.md` | Models, associations, queries, performance | | Background Jobs | `references/background-jobs.md` | Sidekiq, job design, queues, error handling | | Testing | `references/rspec-testing.md` | Model/request/system specs, factories | | API Development | `references/api-development.md` | API-only mode, serialization, authentica...