request-refactor-plan

Guide users through interviews to create detailed refactor plans.

2|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/jupes/agent-forge-harness --skill request-refactor-plan-jupes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: request-refactor-plan
Source: https://github.com/jupes/agent-forge-harness/tree/main/.claude/skills/request-refactor-plan
Command: npx skills add https://github.com/jupes/agent-forge-harness --skill request-refactor-plan-jupes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of planning refactor projects by guiding users through a structured process, ensuring that all aspects of the project are considered before implementation begins.

Core Features & Use Cases

  • Interview-Based Planning: Engages users in a detailed interview to understand the problem, its context, and desired outcomes.
  • Repo Verification: Validates repository reality and confirms or corrects assumptions made by the user.
  • Alternative Evaluation: Considers and discusses alternatives to the proposed solution, ensuring the best approach is chosen.
  • Incremental Planning: Breaks down the refactor into tiny, verifiable working increments for safer implementation.
  • Durable Issue Creation: Uses Beads to create a durable issue with a comprehensive plan, ready for implementation.

Quick Start

Use the request-refactor-plan skill to create a refactor plan for the 'user-authentication' module in the 'core' repository.

Frequently Asked Questions about request-refactor-plan

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

FAQPage Schema
How do I plan a code refactoring project effectively?

To plan a refactoring project effectively, conduct a detailed interview to understand the problem, verify repository context, evaluate alternatives, define scope, and break the implementation into small, verifiable increments for safer execution.

What is the best way to break down a large software refactoring task?

The best way to break down a refactoring task is by splitting it into tiny, verifiable working increments. This structured planning process ensures safer implementation and easier verification during codebase maintenance.

How do I verify repository context before starting a codebase refactor?

Verify repository context by validating the repository's current state against initial assumptions. This refactoring planning process confirms or corrects codebase assumptions before defining the scope and implementation increments.

Can I evaluate alternative refactoring approaches before defining the project scope?

Yes, you should evaluate alternative refactoring approaches before defining the project scope. This planning process involves discussing alternatives to the proposed solution, ensuring the best approach is chosen before breaking down the implementation.

How do I create a durable issue for a refactoring implementation plan?

Create a durable issue for a refactoring implementation plan by using Beads after breaking down the project into small increments. This generates a comprehensive, durable issue ready for collaborative project management and execution.