project-structure-guide

name	project-structure-guide
scope	universal
description	Guide for organizing project directories following language-specific best practices. Use when: creating projects, reorganizing structure, adding modules, setting up builds, deciding file placement. Keywords: project, structure, directory, layout, gitignore, scaffold, file placement, utils, helpers, shared, where to put.

Project Structure Guide

Language: English | 繁體中文

Version: 1.1.0 Last Updated: 2026-03-04 Applicability: Claude Code Skills

---

Purpose

This skill provides guidance on structuring projects according to language and framework conventions. It helps create consistent, maintainable directory layouts.

[Physical Binding]

Reality Check

Before confirming the project structure is valid, you MUST:

1. Run the validator: uds check --standard project-structure
2. IF exit_code != 0:
   • Read the error message (e.g., "Missing required directories").
   • Report the violation to the user.
   • Suggest specific commands (mkdir ...) to fix it.
   • RETRY validation after fixes are applied.

Trigger

Use this skill when:

• Creating a new project
• Reorganizing existing project structure
• Adding new modules or features
• Setting up build configuration
• Creating .gitignore files
• Deciding where to place a file (code, docs, config, asset)