code-simplifier

Code Simplifier

機能を維持しながらコードを簡素化し、洗練させるためのガイドです。

使用するタイミング

• リファクタリング、コードの簡素化、クリーンアップ、コードレビュー
• コーディングタスクを完了した後、または論理的なまとまりのあるコードを書いた後
• レビュー前に複雑な PR をクリーンアップするとき
• 可読性と保守性を高めるためにコードをリファクタリングするとき

基本原則

1. 機能を維持する

コードの「やり方」を変え、「何をするか」は決して変えないでください。変更の前後で既存のテストを実行してください。

2. プロジェクト標準に従う

個人の好みよりも、プロジェクトで設定された標準（CLAUDE.md、AGENTS.md、.editorconfig、リンター）に従ってください。

3. 明確さを高める

• ネストした三項演算子は避け、switch または if/else の連鎖を優先してください
• 過度に詰め込んだワンライナーは避け、簡潔さよりも明確さを選んでください
• 明らかなコードを言い換えているだけのコメントは削除してください

4. バランスを保つ

以下のような過度な簡素化は避けてください:

• コードの明確さや保守性を損なう
• 理解しにくい、過度に巧妙な解決策を生み出す
• あまりに多くの関心事を単一の関数にまとめてしまう
• 構成を改善する役立つ抽象化を削除してしまう
• コードのデバッグや拡張を難しくする

5. スコープに集中する

より広い範囲をレビューするよう明示的に指示されない限り、最近変更または手を加えたコードのみを洗練させてください。

リファクタリングパターン

パターン表、動作を変えてしまう等価性の罠、レビューフィードバックの形式については、references/refactoring-patterns.md を参照してください。

完了条件

• リファクタリング後にすべてのテストが通る
• 機能が変わっていない
• コードがプロジェクト標準に従っている
• ネストした三項演算子、過度に詰め込んだワンライナー、新たな不要な抽象化がない
• ロジックが変わった箇所でコメントが更新されている