Migrate to Rslint
Goal
Migrate lint tooling to Rslint with minimal behavior changes and clear validation.
Supported source linters
- ESLint flat config
Migration principles (must follow)
- Official docs first: treat Rslint docs as source of truth for CLI, config, inline directives, VS Code settings, rules, and presets.
- Smallest-change-first: migrate package, command, config, and editor wiring before changing source files.
- Preserve lint intent: keep supported rule severities/options where Rslint supports them; call out unsupported rules/plugins instead of silently dropping behavior.
- Do not rewrite inline directives by default: Rslint supports
eslint-disableandrslint-disable; replace prefixes only when the user asks. - Validate before cleanup: keep old linter dependencies/config until the Rslint command passes for the migrated scope, then remove obsolete linter-only artifacts.
Workflow
Detect source linter
- ESLint flat config:
eslint.config.*,eslintdependency, or package scripts that runeslint. - If the source linter is not covered by a reference yet, inventory the current behavior and explain that no dedicated migration reference exists.
- ESLint flat config:
Apply source-specific migration guide
- ESLint flat config:
references/eslint-flat-config.md
- ESLint flat config:
Validate behavior
- Run the migrated lint command.
- If the project had a fix command, run the migrated fix command only when appropriate for the task.
- Resolve config, rule, and editor-setting issues before removing legacy files.
Cleanup and summarize
- Remove obsolete linter dependencies/config after Rslint is green.
- Summarize changed files, migrated presets/plugins, unsupported gaps, and remaining manual follow-ups.