Codegen Refactor Skill

Purpose

• Improve internal quality without changing external behavior/specs (APIs, inputs/outputs, persistence formats, and the meaning of exported/public structs).
• Minimize the change surface and proceed safely in reviewable chunks.
• Proceed in a test-driven manner and match the existing code style (naming, design, structure, error handling).
• Use Serena MCP tools to “read less, find precisely, and edit accurately.”
• This is not for feature work or bug fixes. Limit scope to improving maintainability, performance, testability, and design health.

When to use

• When refactoring work is required based on an Issue.
• When the change requires attention to performance or data races (race conditions).

Deliverables (expected output)

• Tests that transition from failing → passing (conform to the generate-test skill)
• Production code that makes the tests pass
  • All tests and static analysis must complete successfully
• Minimal README/comment/documentation updates (only if necessary)