fractal-tree-file-structure

Installation
SKILL.md

Fractal tree file structure

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.

Core principles

  • Recursive structure: Every directory follows the same organizational patterns, creating predictable navigation at any depth.
    Developers should not need to learn the entire codebase structure to contribute meaningfully to any section.

  • No circular dependencies: Imports must form a directed acyclic graph. Circular import chains turn the fractal tree into a generic graph, breaking the tree's integrity and causing runtime issues.

  • Organic growth: Start with a single file; extract to subdirectories only when complexity demands it. No boilerplate structure upfront. Group resources by functional purpose, never by file "shape" (no project-wide components/, hooks/, or utils/ folders).

Installs
19
GitHub Stars
7
First Seen
Feb 18, 2026