Package Design

Package design is about controlling change, not arranging files aesthetically.

Workflow

1. Identify change reasons: what decisions are likely to vary independently?

2. Map current dependencies and cycles.

3. Group code by stable domain or technical decisions, not by temporary implementation steps.

4. Define public APIs that hide volatile internals.

5. Make dependency direction explicit and acyclic.

6. Plan migration in small, behavior-preserving moves.

Design Rules