Custom Rules

Manage the project's custom rules file at .ruby-upgrade-toolkit/rules.yml. The other commands (audit, plan, fix, upgrade, status) pick this file up automatically — this skill is purely for authoring and introspection.

Design philosophy. The rules file is project policy, committed to the repo. This skill is a convenience layer over it: power users can edit the YAML by hand and everything still works. Every mutating subcommand shows a diff and confirms before writing.

Backward compatibility guarantee. With no rules.yml, every command in this toolkit behaves byte-identically to a version without this feature. The file is strictly additive.

Canonical references

Load once at the start, reuse for every subcommand: