decompose-file

What problem does it solve?

This Skill addresses the challenge of overly large source code files that hinder maintainability, readability, and developer productivity by providing a structured approach to breaking them down.

Core Features & Use Cases

• Automated Code Decomposition: Analyzes file structure, identifies logical sections, and proposes a plan to split them into smaller, more manageable files.
• Dependency Mapping & Verification: Maps internal dependencies between proposed modules and verifies that no circular dependencies are introduced.
• Automated Refactoring: Optionally executes the decomposition plan, creates new files, updates import statements across the codebase, and verifies the changes with tests.
• Use Case: Refactor a monolithic service file into several smaller, focused modules to improve code organization and reduce cognitive load for the development team.

Quick Start

Decompose the file src/path/to/large-file.ts into smaller modules.