Codebase Consolidation Pattern

소개

This skill provides a systematic approach to refactoring disorganized codebases by grouping related files into structured subpackages. It guides the user through identifying module groups, moving files while preserving Git history, and updating relative imports. Most importantly, it implements a shim pattern that prevents breaking changes for existing code consumers, making it an essential tool for maintaining large-scale Python projects that have grown organically and suffer from root-level file bloat.

주요 기능

• Zero-breakage compatibility shims for legacy imports
• Automated relative import resolution for relocated files
• Logical module grouping and subpackage creation
• Git-history preservation via strategic move workflows
• Standardized __init__.py export management
• 0 GitHub stars

사용 사례

• Refactoring library structures without breaking downstream dependencies
• Cleaning up projects with excessive root-level Python files
• Grouping domain-specific logic into dedicated subpackages