Coordinate repo-wide codebase migrations with dependency-ordered batches and verification.
npx skills add https://github.com/espensev/ai-skills --skill epic-refactor
Please help me install this Agent Skill. Skill: epic-refactor Source: https://github.com/espensev/ai-skills/tree/main/gemini-skills/skills/epic-refactor Command: npx skills add https://github.com/espensev/ai-skills --skill epic-refactor
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.
Define explicit target architecture and scope, create the refactor report, and begin the first dependency-ordered batch.
High-intent search queries and answers about installing and using this skill.
A repo-wide refactor is coordinated through dependency-ordered batching that executes changes sequentially while preserving behavior. A migration ledger tracks target architecture, modules in scope, and validation plans to manage the full scope.
Guardrails in codebase migration are verification checks that run targeted tests after each batch to ensure invariants hold. They prevent cascading failures during architecture changes by validating behavior before proceeding to the next batch.
Plan safe rollbacks for large-scale migrations by maintaining a migration ledger that records blockers and rollback notes for each dependency-ordered batch. Documentation-driven governance ensures decisions are auditable and reversible if validation fails.
Dependency-ordered batching is needed for architecture refactoring when changes span multiple modules with interdependencies. It ensures foundational modules are updated before dependents, preserving system behavior throughout the migration process.
This approach is designed for repo-scale migrations spanning multiple modules requiring strict guardrails and documentation-led governance. Single-module refactors without complex dependency chains likely do not need the full migration ledger and batch verification overhead.
ZendevveCreate or update docs/Architecture/Overview.md with Mermaid diagrams mapping boundaries, dependencies, and contracts.
HomericIntelligenceExecute Mojo or Python test suites and generate validation reports.
aniruddh2003Run static analysis tools to detect security vulnerabilities, type errors, and linting issues.
p-o-ke-naeUpgrade React versions, refactor class components to hooks, and adopt concurrent rendering patterns.
