Refactoring Catalog Selection

Overview

Use the complete catalog as a decision aid, not as a list of automatic recipes. Select the smallest technique whose preconditions fit the evidence and behavior contract.

Workflow

1. Locate the standard technique in the catalog index.
2. If starting from a smell or symptom, use the selection guide to compare causes and alternatives.
3. If several transformations are needed, use the composition guide to order only the prerequisites that fit the current code.
4. Load the referenced family detail only when the technique is selected.

Selection Rules

• A smell can have several valid candidates; determine the actual cause first.
• Prefer reversible, local transformations over broad redesign.
• Check public API, routing, state ownership, async/lifecycle, persistence, and SSR boundaries before execution.
• Treat composition edges as conditional relationships, never mandatory pipelines.

Quick Reference