Request Refactor Plan

The request-refactor-plan skill enables AI agents to analyze existing codebases and generate structured, step-by-step plans for refactoring legacy or complex systems. It breaks down large-scale architectural improvements into manageable tasks without immediately rewriting the entire application.

When to use it

• You have a monolithic application that needs modularization but lack the time to manually draft a migration strategy.
• Your team is struggling with technical debt and requires an objective, high-level roadmap for code cleanup.
• You need to assess the feasibility of migrating from a synchronous architecture to an asynchronous event-driven model.
• You want to identify specific dependencies and risks before committing resources to a major rewrite.

Key capabilities

• Analyzes current code structure to identify technical debt and architectural anti-patterns.
• Generates detailed, sequential action plans for refactoring specific modules or entire systems.
• Breaks down complex engineering goals into discrete, executable steps for developers.
• Provides context-aware recommendations based on the existing technology stack.

Example prompts

• "Analyze our current user authentication module and create a plan to migrate it to OAuth 2.0."
• "Generate a step-by-step refactoring plan to decouple our payment processing logic from the main order service."
• "Review this legacy Python script and outline a strategy to refactor it into a modern, type-safe microservice."

Tips & gotchas

Ensure you provide the AI agent with sufficient context about your current tech stack and specific business constraints before requesting a plan. While the skill generates excellent strategic roadmaps, it does not automatically execute the code changes; human review is required to validate the proposed steps against real-world deployment limitations.