File Organization Standards Skill

What problem does it solve?

This Skill helps teams enforce consistent file organization across projects by prescribing a clear top-level structure, naming conventions, and depth limits to improve navigation, collaboration, and maintainability.

Core Features & Use Cases

• Top-Level Structure Template: Provides a recommended repository layout with directories like src, tests, docs, config, scripts, data, reports, and agent workflow metadata.
• Naming Conventions & Depth Rules: Defines domain-driven, descriptive folder and module names and a maximum folder depth to prevent over-complication.
• Guided Organization & Onboarding: Includes guidance to organize existing files, mirror test structures, and avoid common anti-patterns for scalable codebases.
• Use Case: When starting a new software project, apply these standards to instantly set up a clean, navigable structure that teams can follow.

Quick Start

Apply the standard to a new repo by creating the top-level folders as described and renaming modules to domain-focused names.