Restructure or optimize code without changing behavior (rename, restructure, or improve performance). Use this skill when you already know what to refactor and want it scoped, specified, and broken into reviewable tasks in a single pass, with no requirements interview. You approve the resulting plan before anything is built: this skill plans and stops, so run `/aid-execute` to carry the plan out.
Installs into .claude/skills of the current project.
Are you the author of Aid Refactor?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/andrevianna-aid-refactor)
---
name: aid-refactor
description: >
Restructure or optimize code without changing behavior (rename, restructure, or improve
performance). Use this skill when you already know what to refactor and want it scoped,
specified, and broken into reviewable tasks in a single pass, with no requirements
interview. You approve the resulting plan before anything is built: this skill plans and
stops, so run `/aid-execute` to carry the plan out.
allowed-tools: Read Glob Grep Bash Shell Terminal Write Edit Agent
argument-hint: "[description] -- what to refactor; runs straight to a graded flattened Lite work"
---
# Shortcut: refactor
<!-- GENERATED by generate-profile/scripts/build-shortcut-skills.py from .aid/runtime/templates/shortcut-catalog.yml -- DO NOT EDIT BY HAND; edit the catalog row and re-run the helper, then the full run_generator.py. -->
Bind **VERB=`refactor`**, **ARTIFACT="" (bare verb)**, then run the shared engine at `.aid/runtime/templates/shortcut-engine.md`. The engine scaffolds the flattened Lite work (feature-001 structure) and authors exactly two documents: `REQUIREMENTS.md`, whose `§ 11` feature section carries the technical specification and whose `§ 9` carries the gate criteria, and the task `DETAIL.md` files -- with reduced capture. One feature and one delivery means there is nothing to sequence, so no plan is written and the execution graph is derived from each task's `**Depends on:**` field. It runs the per-document Grading Gates (feature-004) and halts at the FR-10 approval gate. It never executes. This shortcut's `default_type`/`group` are its row in `.aid/runtime/templates/shortcut-catalog.yml`.
