# ctran/annotate_models

Annotate Rails classes with schema and routes info

Repository: https://github.com/ctran/annotate_models
Canonical: https://ross.abutalabs.com/products/annotate_models
Language: Ruby
License: NOASSERTION
License Family: other
Topics: ruby, rails, activerecord
Last push: 2024-08-05T23:45:54+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 6762, "days_push": 758, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4484, forks 680 (observed 2026-08-28T04:08:51.215833+00:00)

## What it is
A Ruby gem that adds schema summary comments to the top or bottom of ActiveRecord model files, fixtures, tests, factories, and routes.rb in Rails projects. It keeps database column information visible directly in source code as comments.

## Use cases
- show database schema as comments in Rails models
- annotate ActiveRecord models with column info
- add routes summary to routes.rb
- keep factory and fixture files documented with schema
- auto-update model comments after migrations

## When to choose
- you maintain a Rails app and want schema info visible in model files
- your team wants comments refreshed automatically after db migrations
- you want routes.rb annotated with route output

## When to avoid
- you don't use Rails or ActiveRecord
- you dislike generated comments cluttering your source files
- you use a non-Ruby ORM without equivalent tooling

## Facets
- artifact type: library
- maturity: stable
- function: developer-tools, documentation, orm
- domain: developer-tools, web-development, databases, documentation
- platform: ruby
- tags: rails, activerecord, schema-annotations, code-comments, gem

## Member repositories
- ctran/annotate_models (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:51.215833+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:20:30.905749+00:00, confidence not recorded.
  - readme: https://github.com/ctran/annotate_models (fetched 2026-08-28T04:08:51.215833+00:00, sha f5c388c740e9)
- Data as of 2026-08-30T08:39:29.467469+00:00.
