Refactoring Catalog Selection

SkillDev tools

Use when selecting or composing behavior-preserving refactoring techniques after structural evidence is known, especially when multiple candidate transformations, preconditions, or ordering choices must be compared.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Refactoring Catalog Selection skill

What this skill tells your AI

The instructions your AI receives, as published by bovinphang/frontend-craft in skills/fec-refactoring-catalog/SKILL.md and read by ahel’s review.

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

NeedReference
All 61 techniquesCatalog index
Choose by symptom/causeSelection guide
Order related techniquesComposition guide

Signals

GitHub stars
21
Forks
3
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
fec-refactoring-catalog
Source
github.com/bovinphang/frontend-craft