Rails Doctor

A Rails health report for humans, CI, and AI coding agents.

The gap

Fast agents need guardrails.

Rails teams already trust RuboCop, Brakeman, Bundler Audit, Reek, Flog, Flay, Strong Migrations, SimpleCov, and runtime test signals. Rails Doctor turns that scattered output into one score, one report, and one agent-ready repair brief.

$ rails-doctor --profile ci --format html
Score: 82/100 overall
Changed files: 67/100
Coverage: 88.40% lines
Top fix: posts.user_id has no index

Workflow

One model. Four reports. Explicit repair.

01
Scan

Run mature tools and Rails-specific checks without mutating the repository.

02
Normalize

Convert every issue and coverage metric into severity, confidence, fix guidance, and agent instruction fields.

03
Report

Emit terminal, JSON, Markdown, and static HTML from the same source of truth, including strict coverage thresholds.

04
Handoff

Send filtered findings to Codex, Claude Code, or Cursor only when explicitly requested.

CI-ready

Designed for PRs generated by people and agents.

Rails Doctor separates inherited debt from changed-file risk, uploads report artifacts, and supports thresholds like critical-finding gates, minimum score checks, and medium-severity coverage guardrails.

4 report formats
90% default line target
0 surprise mutations

Open source

Free local scanner. Paid team layer later.

The CLI stays useful under MIT. The future commercial path is hosted report history, team policies, GitHub App checks, and agent remediation queues.

Start with the CLI