Pular pro conteúdo

Request Refactor Plan skill

A refatoração vira uma issue no GitHub com o problema, a solução, a lista de commits pequenos, as decisões e o que fica de fora, antes de mexer no código.

por Matt Pocock

instalações
202,4 mil
estrelas no GitHub
303,3 mil
No skills.sh desde
fevereiro de 2026
Licença
MIT

Atualizada no GitHub em 22 de outubro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

O que ela faz

Antes de mudar uma linha, o agente pede uma descrição longa do problema e das ideias que você já tem, vai ao código conferir se o que você disse bate, mostra outras saídas e faz uma entrevista detalhada sobre a implementação. No fim, fica fechado o que muda e o que não muda.

Ele procura os testes que cobrem aquela parte do código e, se faltar, pergunta qual é o plano de teste. Aí quebra o trabalho em commits mínimos, seguindo o conselho do Martin Fowler: cada passo tão pequeno que o programa continua funcionando depois de cada um.

O resultado é uma issue no GitHub num modelo fixo: problema, solução, commits, decisões de implementação (módulos, interfaces, mudanças no banco, contratos de API), decisões de teste e o que fica fora do escopo. O modelo manda não pôr caminho de arquivo nem trecho de código, que envelhecem rápido.

Nas palavras de quem fez

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a…

Matt Pocock, no SKILL.md

Quando usar

  • Uma parte do sistema em que todo mundo tem medo de mexer
  • Refatoração grande que precisa ser feita aos poucos, sem quebrar o site no meio
  • Registrar o plano numa issue antes de passar o trabalho pra outra pessoa ou outro agente
  • Trocar uma biblioteca ou o banco de dados por partes

Depois de instalar, é só pedir assim

  • Quero refatorar o checkout, que virou um arquivo gigante. Me entrevista e monta o plano em commits pequenos numa issue
  • Usa a request-refactor-plan pra planejar a troca do sistema de login, sem mexer no código ainda

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

  • Gen Agent Trust HubPassou
  • SocketPassou
  • SnykPassou

Perguntas

Como instalar a Request Refactor Plan no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Request Refactor Plan, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

A request-refactor-plan ainda existe?

Em agosto de 2026 o autor tirou a skill do repositório mattpocock/skills e disse que o trabalho dela passou pras skills to-spec e improve-codebase-architecture, do mesmo autor. Quem for instalar hoje deve procurar essas duas.

O que ela precisa pra funcionar?

Um projeto com repositório no GitHub e um jeito de o agente abrir issue lá, normalmente o programa gh logado no terminal. Não pede chave de API nem conta paga. No Codex e no Antigravity, funciona se o agente conseguir rodar o gh.

Ela já faz a refatoração?

Não. Ela entrega o plano escrito na issue; os commits ficam pra depois, feitos por você ou por um agente seguindo a lista.

Levar essa skill

1x request-refactor-planR$ 0,00

TotalR$ 0,00

A skill sai aqui mesmo, na hora. Seus dados eu uso pra falar com você sobre o MazyOS.

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/mattpocock/skills

Aprenda a usar

Mais da loja Matt Pocock

Ver a loja Matt Pocock