This project follows a fractal tree approach to file organization, where the structure of any part mirrors the whole. This self-similar organization allows confident navigation without needing to understand the entire codebase.
Developers should not need to learn the entire codebase structure to contribute meaningfully to any section.
Circular import chains turn the fractal tree into a generic graph, breaking the tree's integrity and causing runtime issues.
Guides file and folder organization using fractal tree structure: self-similar directories, encapsulation, shared/ folders, mini-library pattern, and kebab-case naming. Use when creating, moving, or renaming files, extracting modules into subdirectories, deciding where shared code belongs, or checking import boundaries. Source: kachkaev/reusable-stuff.