Refactoring Packages

Refactor structure in small, verifiable moves. Preserve behavior while improving dependency shape.

Workflow

1. Inventory the current package tree and dependency graph.

2. Identify cycles, large modules, unstable public APIs, and misplaced responsibilities.

3. Propose a target structure based on change reasons and dependency direction.

4. Move one coherent slice at a time.

5. Update imports, tests, build files, and public documentation as needed.

6. Run the relevant checks after each meaningful batch.

Reference