Refactor Roadmap

SkillDev tools

Create a staged refactor plan for a module. Use when a mid-level developer needs a safe refactor path.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Refactor Roadmap skill

What this skill tells your AI

The instructions your AI receives, as published by proflead/codex-skills-library in skills/planning/refactor-roadmap/SKILL.md and read by ahel’s review.

Purpose

Create a staged refactor plan for a module.

Inputs to request

  • Current pain points and target state.
  • Test coverage and risk tolerance.
  • Dependencies and release constraints.

Workflow

  1. Define current pain points and desired end state.
  2. Break into small, testable steps.
  3. Add guardrails: tests, feature flags, or metrics.

Output

  • Refactor sequence with checkpoints.

Quality bar

  • Ensure each step is reversible.
  • Tie steps to tests or metrics.

Signals

GitHub stars
144
Forks
30
Last commit
Jul 2026
Advanced
Catalog kind
skill
Gateway key
refactor-roadmap
Source
github.com/proflead/codex-skills-library