request-refactor-plan

Convert vague refactor ideas into incremental plans and GitHub issues.

195|16|Updated Feb 18, 2025
One-click install
npx skills add https://github.com/InditexTech/weavejs --skill request-refactor-plan-inditextech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: request-refactor-plan
Source: https://github.com/InditexTech/weavejs/tree/main/code/.agents/skills/request-refactor-plan
Command: npx skills add https://github.com/InditexTech/weavejs --skill request-refactor-plan-inditextech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers translate vague refactor ideas into a precise, incremental plan and document it as a GitHub issue to guide safe changes.

Core Features & Use Cases

  • Structured interviews to elicit problem scope and possible solutions
  • Repo exploration to verify current state and identify risks
  • Tiny-commit roadmap that breaks changes into smallest, testable steps
  • RFC-style issue drafting with a templated description for review and tracking
  • Decision and testing notes to capture rationale and validation criteria

Quick Start

Run the skill with a description of the refactor goal and its constraints to generate the plan and issue draft.

Frequently Asked Questions about request-refactor-plan

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

FAQPage Schema
How do I break a large codebase refactor into small, safe commits?

To break a large codebase refactor into safe commits, this skill conducts structured interviews and repository inspections to generate a tiny-commit roadmap with clear acceptance criteria and testing notes.

What is the best way to document a codebase refactor plan for a team review?

The best way to document a refactor plan is drafting an RFC-style GitHub issue. This skill generates a templated issue description capturing problem scope, rationale, and an incremental execution roadmap.

How do I structure an interview to scope a software refactoring project?

To structure an interview for a refactoring project, this skill enforces a workflow that elicits problem scope and possible solutions, using your answers to verify the current repository state and identify potential risks.

Can I generate a GitHub issue from a vague codebase analysis idea?

Yes, you can generate a GitHub issue from a vague idea. Run the skill with a description of your refactor goal and constraints to produce an RFC-style issue draft and a structured incremental plan.

Does this refactoring workflow require existing test coverage checks?

Yes, the refactoring workflow requires test-coverage checks. The skill inspects your repository to verify the current state and captures decision and testing notes to define validation criteria for the tiny commits.