refactor-planner

Coordinate contract-first refactor campaigns across multi-phase roadmaps.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/espensev/ai-skills --skill refactor-planner-espensev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor-planner
Source: https://github.com/espensev/ai-skills/tree/main/claude-skills/skills/refactor-planner
Command: npx skills add https://github.com/espensev/ai-skills --skill refactor-planner-espensev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designs and coordinates phased refactor campaigns with contract-first governance to reduce risk and ensure traceable changes across multi-phase codebases.

Core Features & Use Cases

  • Define planning contracts and roadmaps before implementation to establish clear ownership and expectations.
  • Decompose work into phased campaigns with seam extraction to safely migrate functionality.
  • Enforce behavioral invariants and provide rollback strategies to preserve stability during refactors.
  • Generate actionable artifacts (planning docs, campaign markdown, and plan metadata) for auditability and collaboration.

Quick Start

Describe your refactor goal to start a guided, multi-phase campaign design.

Frequently Asked Questions about refactor-planner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a contract-first refactor campaign and how does it reduce migration risk?

A contract-first refactor campaign establishes planning contracts and roadmaps before implementation to ensure traceable changes. By enforcing behavioral invariants and seam extraction sequencing, it reduces risk and preserves system stability throughout multi-phase codebase migrations.

How do I plan a multi-phase architecture migration with rollback strategies?

You can plan a multi-phase migration by decomposing work into phased campaigns using seam extraction to safely migrate functionality. This approach enforces behavioral invariants, provides rollback strategies, and generates actionable artifacts like campaign markdown for transparent, auditable planning.

When do I need to use seam extraction for software modularization?

You need seam extraction for software modularization when safely migrating functionality across a multi-phase codebase. It allows you to extract and isolate components phase-by-phase while enforcing behavioral invariants and providing rollback strategies to preserve stability during architecture changes.

Can I generate actionable planning artifacts for complex codebase refactoring?

Yes, you can generate actionable planning artifacts for codebase refactoring including planning docs, campaign markdown, and plan metadata. These artifacts establish clear ownership and expectations while providing auditability and enabling collaboration across multi-phase refactor campaigns.

What is the best way to coordinate behavior-preserving migrations across multiple phases?

The best way to coordinate behavior-preserving migrations is applying contracts-first ordering and seam extraction sequencing across multi-phase roadmaps. This governs phase-by-phase campaigns from contracts to deployment while enforcing behavioral invariants and providing rollback strategies to preserve stability.

Does contract-first refactoring work for large scale software modularization projects?

Yes, contract-first refactoring suits large scale software modularization projects by coordinating safe campaigns across multi-phase roadmaps. It guides phase-by-phase campaigns from contracts to deployment, enforcing behavioral invariants and providing rollback strategies for traceable architecture changes.