Can I exclude specific files like migrations from the validation?

Yes, you can create a .refactorignore file to exclude legacy adapters, historical changelogs, or specific rename migrations that must contain the old name by design.

Does this skill support frontend refactoring?

Absolutely. It includes specific checklists for Stimulus controllers, data-action attributes, Turbo frames, and importmaps to maintain full frontend-to-backend consistency.

How does the beads integration work?

When a TASK_ID is set, the skill automatically posts progress comments, detected file changes, and validation results directly to your beads task log, providing a full audit trail.

How does this skill prevent broken references after a rename?

It uses the validate_refactoring function which performs a multi-layer search across Ruby files, ERB templates, and JavaScript to ensure no old strings persist before a task is closed.

Rails Refactoring Workflow

Name: Rails Refactoring Workflow
Author: Kaakati

byKaakati

•

생산성 및 워크플로

Automates and validates complex Ruby on Rails refactoring tasks with cross-layer impact tracking and reference verification.

This skill provides a structured framework for executing large-scale refactors in Ruby on Rails applications, ensuring code consistency and eliminating technical debt. It automates the tracking of renames for classes, attributes, and tables across every application layer—from the Ruby backend and Stimulus controllers to view templates and test suites. By integrating with the beads task management system, it maintains a clear audit trail and provides a validation engine that prevents the completion of tasks until all legacy references are successfully updated or intentionally ignored.

주요 기능

01Deep validation engine to ensure zero orphaned references remain

02Comprehensive cross-layer checklists covering Ruby, Views, JS, and I18n

032 GitHub stars

04Enterprise integration with beads for real-time task status and logging

05Automated tracking for class, attribute, table, and method renames

06Customizable exclusion rules via .refactorignore files

사용 사례

01Migrating database columns while ensuring frontend Stimulus values and API serializers stay in sync

02Moving services between namespaces while maintaining autoloading and file path consistency

03Renaming core domain models and updating all associated associations, controllers, and specs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kaakati/rails-enterprise-dev refactoring-workflow

For use in Claude.ai and ChatGPT

Download Skill