How does this pattern handle Git history?

The pattern specifically utilizes 'git mv' commands rather than standard file moves, ensuring that all commit history and 'git blame' data remain intact for the moved files.

What is the primary benefit of the Codebase Consolidation Pattern?

It allows you to clean up a messy folder structure and group related logic together without breaking any existing imports or losing Git history.

Does this work for private functions?

Yes. While standard wildcard imports don't catch private functions (starting with an underscore), this pattern includes steps to explicitly export them in shims if they are needed for testing.

Will moving files break my existing project imports?

No. This skill uses 'compatibility shims'—thin wrapper files placed at the original locations that redirect imports to the new subpackage.

When is the best time to trigger this skill?

Trigger this when you notice too many root-level files, when related functionality is scattered across different directories, or during a general codebase cleanup phase.

Codebase Consolidation Pattern

Name: Codebase Consolidation Pattern
Author: smith6jt-cop

bysmith6jt-cop

開発者ツール

Reorganizes scattered root-level modules into logical subpackages while maintaining backwards compatibility using import shims.

概要

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

概要

主な機能

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