implement-refactor

Orchestrate end-to-end refactors with tests, transformations, reviews, and documentation.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/tulgardinc/vibe-check --skill implement-refactor-tulgardinc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implement-refactor
Source: https://github.com/tulgardinc/vibe-check/tree/main/.claude/skills/implement-refactor
Command: npx skills add https://github.com/tulgardinc/vibe-check --skill implement-refactor-tulgardinc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill orchestrates the full end-to-end refactor workflow, ensuring tests lock in current behavior, sequentially apply changes, perform reviews, and generate documentation.

Core Features & Use Cases

  • Characterization tests: read architecture and requirements, generate and run tests that verify existing behavior is preserved.
  • Phase-based transformation: execute tasks in dependency order across waves, with safety checks to keep tests green.
  • Review cycle & documentation: spawn reviewers, apply fixes, and produce a comprehensive summary and decisions log.
  • Commit & index updates: finalize changes, update the refactor index, and communicate outcomes.

Quick Start

Invoke the refactor orchestrator with the target refactor name to begin the end-to-end process.

Frequently Asked Questions about implement-refactor

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

FAQPage Schema
How do I orchestrate an end-to-end code migration with automated testing and documentation?

End-to-end code migration is orchestrated by sequentially applying phase-based transformations, locking in current behavior with characterization tests, and generating a final decisions log. This ensures changes are applied safely across dependency waves with continuous review.

What is the best way to safely refactor architecture across multiple phases?

The best way to safely refactor architecture is executing tasks in dependency order across multiple waves. Safety checks keep tests green during phase-based transformation, while spawned reviewers apply fixes to enforce disciplined, auditable migrations.

How do characterization tests preserve existing behavior during a code refactor?

Characterization tests preserve existing behavior during a code refactor by reading the agreed architecture and requirements, then generating and running tests that verify current functionality is maintained before transformations are applied.

Do I need an agreed architecture and dependencies defined before starting an automated refactor?

Yes, an agreed architecture, mapped dependencies, and defined artifacts are required before starting. The orchestrator enforces this prerequisite to apply disciplined transformations, satisfy test locks, and support safe, auditable migrations.

How are code refactoring decisions logged and documented for auditability?

Code refactoring decisions are logged and documented for auditability by spawning a review cycle that produces a comprehensive summary and decisions log. Finalizing changes updates the refactor index and communicates outcomes.

When should I use an automated refactor orchestrator instead of manual code migration?

Use an automated refactor orchestrator instead of manual code migration when your task spans multiple phases, waves, and iterations. It enforces required test locks, change propagation, and decision logging that manual migrations often miss.