epic-refactor
CommunityCoordinate repo-wide migrations with guardrails.
Software Engineering#architecture#codebase#verification#migration#refactor#guardrails#dependency-order
Authorespensev
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Repo-scale migrations are error-prone and hard to coordinate; Epic Refactor provides a rigorously structured process, guardrails, and documentation to ensure safe, auditable architecture changes across large codebases.
Core Features & Use Cases
- Migration ledger tracks target architecture, modules in scope, dependency order, invariants, validation plans, blockers/rollback notes.
- Dependency-ordered batching executes changes in a coherent sequence to preserve behavior.
- Verification & guardrails run targeted tests and validations after each batch and record results.
- Documentation-driven governance enforces planning contracts and keeps a living refactor report to explain decisions.
Quick Start
Define explicit target architecture and scope, create the refactor report, and begin the first dependency-ordered batch.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: epic-refactor Download link: https://github.com/espensev/ai-skills/archive/main.zip#epic-refactor Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.