rails-engine-extraction
Installation
SKILL.md
Rails Engine Extraction
Use this skill when the task is to move existing code out of a Rails app and into an engine.
Prefer incremental extraction over big-bang rewrites. Preserve behavior first, then improve design.
HARD-GATE
DO NOT extract and change behavior in the same step. Extraction must preserve existing behavior; refactoring and improvements belong in a separate step after the move is complete and verified.
Quick Reference
| Extraction Step | Action |
|---|---|
| Identify bounded feature | Choose one coherent responsibility to extract |
| List host dependencies | Document models, services, config the feature needs |
| Define engine boundary | Decide what lives in engine vs host |
| Move stable logic first | POROs, services, value objects before controllers |
| Add adapters | Replace direct host references with config or adapter interfaces |
| Move UI/routes last | Controllers, views, routes only after seams are clear |
Related skills