Can I manually edit the refactoring plan?

Yes, the plan is stored as a standard markdown file in your repository root. You can manually adjust phases, file lists, or acceptance criteria at any time.

Does it automatically commit my changes?

Yes, upon successful validation of a phase (via tests or type checks), the skill performs an atomic git commit to ensure your progress is versioned and safe.

How does this skill handle AI context limits?

It uses a persistent REFACTOR_PLAN.md file to track the state of the refactor. If a session hits a context limit, the agent can read the plan in a new session and resume exactly where it left off.

When should I use this instead of a standard refactor command?

Use this skill for complex tasks involving 10 or more files, or any project that requires multiple dependent steps that would exceed a single AI conversation's memory.

Workflow Checkpoint Refactor

Name: Workflow Checkpoint Refactor
Author: laurigates

bylaurigates

•

生産性とワークフロー

Orchestrates large-scale code refactoring through persistent, multi-phase plans that survive AI context limits and session boundaries.

This skill provides a structured framework for managing complex refactoring tasks that span dozens of files and multiple development phases. By maintaining a persistent REFACTOR_PLAN.md file, it allows Claude to track progress, validate changes incrementally, and resume work seamlessly across different sessions without losing context. It is particularly useful for breaking down architectural changes into manageable, testable units, ensuring that large-scale codebase migrations remain organized, verifiable, and resilient to context window constraints.

主な機能

01Context limit recovery for seamless session resumption

02Automated multi-phase execution with incremental validation

03Integrated git commit management for atomic phase updates

0410 GitHub stars

05Persistent state tracking via REFACTOR_PLAN.md checkpoints

06Intelligent sub-agent delegation for high-volume file changes

ユースケース

01Implementing sweeping architectural patterns across multiple service layers

02Executing breaking API changes that require updates across 10+ dependent files

03Migrating large legacy codebases to new frameworks or languages phase-by-phase

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add laurigates/claude-plugins workflow-checkpoint-refactor

For use in Claude.ai and ChatGPT

主な機能

01Context limit recovery for seamless session resumption

02Automated multi-phase execution with incremental validation

03Integrated git commit management for atomic phase updates

0410 GitHub stars

05Persistent state tracking via REFACTOR_PLAN.md checkpoints

06Intelligent sub-agent delegation for high-volume file changes

ユースケース

01Implementing sweeping architectural patterns across multiple service layers

02Executing breaking API changes that require updates across 10+ dependent files

03Migrating large legacy codebases to new frameworks or languages phase-by-phase

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add laurigates/claude-plugins workflow-checkpoint-refactor

For use in Claude.ai and ChatGPT