【結論】コード品質を段階的に改善する
コード品質改善はLinterの警告をゼロにする作業ではなく、型検査、テスト、複雑度、セキュリティ、可読性、互換性を合わせて評価します。
Claude Codeへプロジェクト全体を一括修正させず、ルールごと、ディレクトリごと、変更目的ごとに小さく分割します。
自動修正後はGit差分、既存テスト、静的解析、ビルド、公開APIの変更を人間が確認します。
# ターミナルで実行：現在の品質チェックを確認
npm run lint
# ターミナルで実行：型検査を実行
npm run typecheck
# ターミナルで実行：テストを実行
npm test -- --runInBand
# ターミナルで実行：差分を確認
git diff --stat具体的な手順・設定方法
既存のESLint、Ruff、mypy、TypeScript、Formatter設定を読み、変更禁止ルールを確認します。
まず警告を分類し、機械的修正と設計判断が必要な修正を分離します。
一つの分類だけを修正し、各段階でテストと差分レビューを行います。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
lint結果を読み取り専用で分類してください。
自動修正可能、意味変更の可能性あり、設定見直しが必要の3群に分けてください。
今回は未使用importだけを対象とし、公開API、テスト、設定ファイルは変更しないでください。注意点・よくあるエラーと対処法
Linterを通すためにルールを無効化したり、型をanyへ置き換えたりしないでください。
テストが通っても性能、並行処理、セキュリティ、アクセシビリティの回帰は残る可能性があります。
大規模リファクタリングはworktreeや専用ブランチで行い、レビュー可能なコミットへ分割してください。