Set up annotaterb for automatic model schema annotation

[danielpaul]

What

Sets up the annotaterb gem so model files (and their factories) carry an up-to-date schema annotation, and keeps them in sync automatically.

annotaterb is the actively-maintained successor to the original annotate gem and is compatible with Rails 8.

Changes

• Gemfile — add gem "annotaterb" to the :development group; Gemfile.lock locks annotaterb (4.22.0).
• .annotaterb.yml — config generated by rails g annotate_rb:install (gem defaults). Annotations are placed at the top of the file (position: before) and frozen_string_literal magic comments are preserved above them.
• lib/tasks/annotate_rb.rake — rake hook that automatically annotates models after bin/rails db:migrate in development. Added a # frozen_string_literal: true comment to the generated file so it passes the project's RuboCop config.
• Annotations added to app/models/{user,org}.rb and spec/factories/{users,orgs}.rb. This also corrects a stale column order in the pre-existing User annotation so it matches the live schema.

How it works going forward

After this lands, running bin/rails db:migrate re-annotates models automatically. To skip, set ANNOTATERB_SKIP_ON_DB_TASKS=1. To annotate on demand: bundle exec annotaterb models.

Verification

• bundle install succeeds; annotaterb 4.22.0 installed.
• rails g annotate_rb:install generated the config + rake hook.
• bundle exec annotaterb models annotated the models/factories; re-running reports "Model files unchanged" (idempotent).
• Confirmed the db:migrate hook re-annotates a reverted model automatically.
• RuboCop passes on all changed Ruby files.
• App boots and FactoryBot.lint builds both factories successfully.

Note: unrelated db/*_schema.rb changes that db:migrate produced in this environment (a [8.0]→[8.1] schema-format header bump) were intentionally reverted to keep this PR focused on the annotaterb setup.

https://claude.ai/code/session_01Ra2ZHPT8zux5xh8Swo2YmJ

---

Generated by Claude Code