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,195 stars 136 forks Updated today MIT

Install

View on GitHub

Quality Score: 92/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
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
5 months ago
Last Updated
today
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 weeks 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 weeks ago
iamdemetris
Code & Development Listed

refactoring-strategy

Systematic refactoring methodology with safety guarantees for polyglot codebases. TRIGGER when: user asks to refactor code, restructure a module, split a monolith, do a large rename, extract a service, apply strangler fig, or plan a safe migration of existing code. Also when tech-debt-tracker findings need execution. DO NOT TRIGGER when: user is fixing a bug (use focused-fix), doing TDD on new code (use tdd), or finding tech debt without a plan to fix it (use tech-debt-tracker).

1 Updated 1 weeks ago
DROOdotFOO