refactor

Fowler／Martin のコードリファクタリングのベストプラクティス

Martin Fowler のカタログと Clean Code の原則に基づく、包括的なコードリファクタリングガイドです。AI エージェントと LLM 向けに設計されています。8 つのカテゴリにわたる 43 のルールを収録し、影響度順に優先順位を付けて、自動リファクタリングとコード生成を導きます。

適用するタイミング

以下の場合に、このガイドラインを参照してください。

• 保守性を高めるために既存のコードをリファクタリングするとき
• 長いメソッドや大きなクラスを分解するとき
• コンポーネント間の結合を減らすとき
• 複雑な条件分岐を簡素化するとき
• コードの臭いやアンチパターンについてコードレビューするとき

優先度別のルールカテゴリ

優先度	カテゴリ	影響度	プレフィックス
1	構造と分解	重大	struct-
2	結合と依存関係	重大	couple-
3	命名と明確さ	高	name-
4	条件分岐	高	cond-
5	抽象化とパターン	中〜高	pattern-
6	データ構成	中	data-
7	エラー処理	中	error-
8	マイクロリファクタリング	低	micro-

クイックリファレンス

1. 構造と分解（重大）

• struct-extract-method - 長い関数をメソッドとして抽出する
• struct-single-responsibility - 単一責任の原則を適用する
• struct-extract-class - 大きなクラスからクラスを抽出する
• struct-compose-method - 読みやすい処理の流れになるようメソッドを構成する
• struct-function-length - 関数を 20 行未満に保つ
• struct-replace-method-with-object - メソッドをメソッドオブジェクトに置き換える
• struct-parameter-object - パラメーターオブジェクトを導入する

2. 結合と依存関係（重大）

• couple-dependency-injection - 依存性注入を使用する
• couple-hide-delegate - 委譲先を隠して結合を減らす
• couple-remove-middle-man - 過剰な場合は仲介役を取り除く
• couple-feature-envy - メソッドを移動してフィーチャーエンビーを解消する
• couple-interface-segregation - インターフェース分離の原則を適用する
• couple-preserve-whole-object - フィールドではなくオブジェクト全体を渡す

3. 命名と明確さ（高）

• name-intention-revealing - 意図が伝わる名前を使用する
• name-avoid-abbreviations - 略語や頭字語を避ける
• name-consistent-vocabulary - 一貫した用語を使用する
• name-searchable-names - 検索しやすい名前を使用する
• name-avoid-encodings - 名前に型のエンコーディングを含めない

4. 条件分岐（高）

• cond-guard-clauses - ネストした条件分岐をガード節に置き換える
• cond-polymorphism - 条件分岐をポリモーフィズムに置き換える
• cond-decompose - 複雑な条件分岐を分解する
• cond-consolidate - 重複する条件分岐の断片を統合する
• cond-special-case - 特殊ケースオブジェクトを導入する
• cond-lookup-table - 条件分岐をルックアップテーブルに置き換える

5. 抽象化とパターン（中〜高）

• pattern-strategy - アルゴリズムのバリエーションに応じてストラテジーを抽出する
• pattern-template-method - 共通の骨格にテンプレートメソッドを使用する
• pattern-factory - 複雑なオブジェクト生成にファクトリーを使用する
• pattern-open-closed - 開放／閉鎖原則を適用する
• pattern-composition-over-inheritance - 継承よりコンポジションを優先する
• pattern-extract-superclass - 共通の振る舞いを持つスーパークラスを抽出する

6. データ構成（中）

• data-encapsulate-collection - コレクションをカプセル化する
• data-replace-primitive - プリミティブ型をオブジェクトに置き換える
• data-encapsulate-record - レコードをクラスにカプセル化する
• data-split-variable - 複数回代入される変数を分割する
• data-replace-temp-with-query - 一時変数をクエリに置き換える

7. エラー処理（中）

• error-exceptions-over-codes - エラーコードではなく例外を使用する
• error-custom-exceptions - ドメイン固有の例外型を作成する
• error-fail-fast - 事前条件を設けて早期に失敗させる
• error-separate-concerns - エラー処理をビジネスロジックから分離する

8. マイクロリファクタリング（低）

• micro-remove-dead-code - デッドコードを削除する
• micro-inline-variable - 単純な変数をインライン化する
• micro-simplify-expressions - ブール式を簡素化する
• micro-rename-for-clarity - 明確さを高める名前に変更する

使用方法

詳しい説明とコード例については、各リファレンスファイルを参照してください。

• セクションの定義 - カテゴリーの構造と影響レベル
• ルールのテンプレート - 新しいルールを追加するためのテンプレート
• 個別のルール：references/{prefix}-{slug}.md

完全版ドキュメント

すべてのルールを展開した完全なガイドについては、AGENTS.mdを参照してください。