ada-refactoring-lifecycle

Routes multi-phase engineering refactoring work to stack-specific skills with plan-first verification.

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/wubing7755/Ada --skill ada-refactoring-lifecycle-wubing7755
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ada-refactoring-lifecycle
Source: https://github.com/wubing7755/Ada/tree/main/skills/software-development/ada-refactoring-lifecycle
Command: npx skills add https://github.com/wubing7755/Ada --skill ada-refactoring-lifecycle-wubing7755

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large-scale refactoring efforts often fail because changes are made without a plan, phases are mixed into single commits, and verification is skipped. This Skill enforces a disciplined lifecycle for engineering-grade refactoring: produce a plan document, get approval, execute phase by phase, verify each phase independently, and commit each phase separately. ## Core Features & Use Cases - Stack-Based Routing: Detects project signals (.sln, .csproj, .razor, Blazor) and routes .NET/C#/Blazor work to ada-dotnet-engineering-refactoring, while other stacks route to the language-agnostic ada-engineering-refactoring skill. - Phased Execution Lifecycle: Requires a plan document in docs/refactoring/ with quality standards, phase goals, change lists, verification criteria, and dependency diagrams before any code changes begin. - Independent Phase Verification: Mandates dotnet build, dotnet test, and dotnet format after every phase, with isolated git commits per phase for bisectability. - Use Case: A user says their Blazor component library does not meet engineering standards and wants a staged architecture upgrade covering domain primitives, orchestrator extraction, and public API stabilization. The Skill routes to the .NET sub-skill and enforces the plan-then-execute workflow. ## Quick Start Ask the agent to plan an engineering-grade, multi-phase refactoring of your project and it will route to the correct stack-specific skill before proposing any changes.

Frequently Asked Questions about ada-refactoring-lifecycle

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

FAQPage Schema
How do I plan a multi-phase refactoring of a .NET project?

Start by writing a plan document in docs/refactoring/ covering quality standards, phase goals, change lists, verification criteria, and a dependency diagram. After user approval, execute each phase independently, running dotnet build, dotnet test, and dotnet format before committing each phase separately.

How does the refactoring router choose between .NET and generic approaches?

It inspects project signals such as .sln, .csproj, .cs, and .razor files. .NET/C#/Blazor projects route to ada-dotnet-engineering-refactoring for domain-primitive and Blazor component patterns, while other stacks route to the language-agnostic ada-engineering-refactoring skill.

When should I not use a phased refactoring lifecycle?

Do not use it for single-file fixes, one-line bug fixes, pre-commit formatting, typo corrections, or isolated code review comments. The lifecycle is designed for systematic multi-phase work spanning multiple files or architectural boundaries.

Why must each refactoring phase be committed separately?

Separate commits keep each phase independently verifiable and make bisecting and reverting possible. Mixing changes across phases in one commit compounds errors and makes it impossible to isolate which phase introduced a failure.

How do I migrate tests when removing a public API?

Migrate consumers while the old API still exists, add replacement coverage in a new test file, then remove the API and its PublicAPI.Unshipped.txt entries. Finally verify the NuGet consumer against packed artifacts and grep for stale references to the removed identifier.