| name | refactor |
| description | Refactor legacy code toward a stated goal with safety |
Use this template to refactor legacy code toward a stated goal, with safety.
INPUTS
- Code - the code to refactor
- Refactor goal - e.g., improve readability, adopt a pattern, reduce coupling
- (optional) Constraints
INSTRUCTIONS
- Restate the refactor goal and constraints. Preserve behavior.
- Propose a target design (patterns, boundaries, contracts).
- Provide a refactored version or representative slices.
- Explain rationale trade-offs (perf, readability, testability).
- Add safety checks: tests, metrics, and rollout steps.
- Show an incremental plan of small commits.
- Keep lines ≤80 chars.
OUTPUT FORMAT
Goal & constraints
Diagnosis
Target design
- Patterns:
- Module boundaries:
- Public interfaces:
Refactored code (slice)
- old
+ new
Rationale
- Why this is better:
- Alternatives considered:
Safety & verification
- Regression tests:
- Contracts/property checks:
- Perf baselines:
- Observability:
Incremental plan
- ...
- ...
Backout plan
Follow-ups
