oma-refactor

Featured

Behavior-preserving refactoring specialist - plans and executes safe incremental restructuring with code smell / SATD / hotspot targeting, characterization-test safety nets, metric and coverage gates, and refactor-only commits. Use for refactor, refactoring, code smell, technical debt, legacy code modernization, extract method, hotspot, and characterization test work.

Code & Development 1,240 stars 146 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 93/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Refactor Agent - Behavior-Preserving Restructuring Specialist ## Scheduling ### Goal Improve internal code structure - readability first - without changing observable behavior, through small verified transformations, each gated by a safety net (tests / tooling / types) and committed separately from any behavior change. ### Intent signature - User asks to refactor, clean up, restructure, modernize, de-duplicate, or "make this code maintainable/readable". - User mentions code smells, technical debt, legacy code, long methods/files, god classes, hotspots, characterization tests, or extract/move/rename transformations. - User asks "where should we refactor first?" or wants a refactoring plan/priority for a codebase. ### When to use - Executing a refactoring on specific files/modules (extract, move, rename, decompose, pattern/idiom alignment) - Preparatory refactoring before a feature ("make the change easy, then make the easy change") - Legacy (brownfield) rescue: seam discovery + characterization tests, then restructuring - Refactoring target selection and prioritization (smells + SATD + hotspot = churn x complexity) - Auditing whether code is safe to refactor now (coverage breadth x mutation strength x flakiness) ### When NOT to use - Fixing a reported bug or failing behavior -> use `oma-debug` (refactoring must not change behavior) - Security/performance/accessibility review or quality audit -> use `oma-qa` - System design, module boundary decisions, ADRs, convention ch...

Details

Author
first-fluke
Repository
first-fluke/oh-my-agent
Created
6 months ago
Last Updated
yesterday
Language
TypeScript
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Listed

refactoring-advisor

Identifies safe, high-value refactors that preserve externally observable behavior. Use for debt, smells, or “clean this up” asks. Never changes behavior silently or recommends large rewrites without characterization tests and incremental plan.

0 Updated 1 months ago
willianbs
Code & Development Listed

senior-refactorer

Use when refactoring, cleaning up, extracting a method or component, renaming, moving, inlining, deduping, simplifying, restructuring, addressing a code smell, or paying down technical debt without changing observable behavior. Triggers: refactor, clean up, extract, extract method, extract component, rename, move, inline, dedupe, simplify, restructure, smell, code smell, technical debt, organize, tidy, reshape. Produces a refactor plan, a patch series of small commits (one move per commit), characterization tests when coverage is missing, and a before/after summary proving no behavior change. Not for performance work, see `senior-performance-engineer`. Not for changing behavior or adding features. Not for large structural redesigns, see `staff-software-architect`. Not for PR merge review, see `senior-code-reviewer`.

0 Updated 1 months ago
iamdemetris
Code & Development Listed

safe-refactor

Change internal code structure while preserving observable behavior through small verified steps. Use for renames, extractions, moves, decomposition, and duplication removal when behavior must remain stable. Do not use for bug fixes, public contract changes, dependency or framework migrations, schema migrations, or other work expected to change compatibility or runtime behavior.

1 Updated 3 days ago
adityaarakeri