request-refactor-plan

Interview-driven refactoring planner that breaks changes into tiny, safe commits and files a GitHub issue. Conducts a detailed user interview to understand the problem, explore alternatives, and nail down exact scope before planning Verifies assertions by exploring the repository and assesses existing test coverage in the affected codebase Breaks implementation into the smallest possible commits, each leaving the codebase in a working state Generates a structured GitHub issue with problem statement, solution, detailed commit plan, decision document, testing strategy, and out-of-scope items

INSTALLATION
npx skills add https://github.com/mattpocock/skills --skill request-refactor-plan
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$2a

Problem Statement

The problem that the developer is facing, from the developer's perspective.

Solution

The solution to the problem, from the developer's perspective.

Commits

A LONG, detailed implementation plan. Write the plan in plain English, breaking down the implementation into the tiniest commits possible. Each commit should leave the codebase in a working state.

Decision Document

A list of implementation decisions that were made. This can include:

  • The modules that will be built/modified
  • The interfaces of those modules that will be modified
  • Technical clarifications from the developer
  • Architectural decisions
  • Schema changes
  • API contracts
  • Specific interactions

Do NOT include specific file paths or code snippets. They may end up being outdated very quickly.

Testing Decisions

A list of testing decisions that were made. Include:

  • A description of what makes a good test (only test external behavior, not implementation details)
  • Which modules will be tested
  • Prior art for the tests (i.e. similar types of tests in the codebase)

Out of Scope

A description of the things that are out of scope for this refactor.

Further Notes (optional)

Any further notes about the refactor.

BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card