plan-filesystem-layout

What problem does it solve?

This Skill addresses the challenge of maintaining consistent and compliant file/folder organization within an operating system, ensuring that files are placed according to standard OS layout principles (FHS/XDG), repo-native conventions, and envctl/meta placement invariants.

Core Features & Use Cases

• Standard OS Layout Mapping: Maps file/folder organization against FHS 3.0 for Unix-like systems.
• User/App Layout Planning: Utilizes XDG Base Directory concepts for user-scoped data management.
• envctl/meta Placement: Ensures envctl's tool installations adhere to $META_ROOT and compatibility with legacy paths.
• Repo-native Layout Guidelines: Provides Rust Cargo-specific layout guidance for source, tests, and documentation.
• File Inventory Analysis: Offers a detailed inventory of paths, their classification, and verification against standards.
• Boundary and Upgrade Mapping: Identifies cross-boundary issues and outlines upgrade paths for system layout.
• Test and Enforcement Handoff: Defines checks for Feature Forge to enforce layout compliance.

Quick Start

To plan the filesystem layout for a new project, use the plan-filesystem-layout skill and follow the provided guidelines to map your file organization and validate it against standard conventions.