Project Folder Structure

Quick Start

For non-trivial projects, read local rules first, then quantify the shape with the bundled helper:

node scripts/structure-snapshot.mjs --root /path/to/project --max-depth 3

Return an audit before edits: scope scanned, local conventions, immovable constraints, crowded areas, mixed lifecycles, ambiguous names, proposed organizing axis, smallest safe batch, migration risk, and verification commands.

Core Rule

Respect the project before applying a pattern. Good organization makes the project easier for humans to understand, change, test, operate, and archive while preserving framework rules, public contracts, generated paths, persisted state, and local conventions.

Workflow