refac-module-to-subpackage

Installation
SKILL.md

Module to Subpackage

Convert a monolithic Python module into a subpackage with submodules while preserving all behavior. This is a pure mechanical reorganization — no logic changes, no fixes to pre-existing issues, no improvements.

Core Principle: Pure Reorg

This refactoring must be behavior-preserving. Copy code verbatim. Do not:

  • Fix pre-existing lint/style issues (they'll show up in review — resolve as "pre-existing")
  • Rename functions or change signatures
  • "Improve" code while moving it
  • Add or remove functionality

The goal is a clean diff that only moves code between files. Reviewers should be able to verify the split is correct by confirming every line in the old file appears in exactly one new file.

Phase 1: Structural Inventory

Understand the monolith before designing the split.

Related skills
Installs
8
Repository
dagster-io/erk
GitHub Stars
81
First Seen
Mar 15, 2026