DEVELOPMENT WORKFLOW / GitHub community (awesome-copilot)
Multi-file Refactor Planning
Plan a sequenced refactor with repository-specific dependencies, checks and recovery steps.
“Create a concrete plan before starting a multi-file refactor. Use when the user asks to plan, sequence, scope, or safely execute a refactor across multiple files; always investigate first, output the plan, and wait for confirmation before making code changes.”
01 / THE REASONING
Why this made the selection.
- The workflow orders contracts/types before implementations and callers and requires rollback or recovery for the riskiest phases.
- Prepare a cross-module API refactor that updates contracts, implementations and callers in a reviewable order.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/refactor-plan/SKILL.md
- LICENSE
- README.md
Our findings
- The workflow orders contracts/types before implementations and callers and requires rollback or recovery for the riskiest phases.
- The planning format requires file-level dependency relationships and rollback steps. The instructions require planning verification between phases and waiting for confirmation before implementation unless the user explicitly waived that review.
Not established by this review
- Third-party instructions and helpers were not executed; service access, host compatibility and outcomes remain untested.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add github/awesome-copilot/skills/refactor-plan Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/github/awesome-copilot/tree/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/skills/refactor-plan - Install the pinned directory interactively and retain its referenced files; inspect the source before granting tool access.
- Read implementation, tests and configuration, map ownership/coupling and specify validation and recovery between phases before implementation.
Before you start
- Repository read/search access and a concrete desired refactor outcome
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/skills/refactor-plan/SKILL.md
Supports: summary, review, install, access, limitations
- Pinned LICENSE ↗Checked
https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/LICENSE
Supports: license
- Pinned README.md ↗Checked
https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/README.md
Supports: summary, review, install, access, limitations
https://raw.githubusercontent.com/github/awesome-copilot/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/skills/refactor-plan/SKILL.md
Supports: review.findings, bestFor