naming
Big-endian file naming as semantic binding
When & Why to Use This Skill
This Claude skill implements a big-endian file naming convention designed to treat the filesystem as a structured semantic network. By utilizing the 'TYPE-VARIANT.ext' pattern, it enables logical clustering, superior sorting capabilities, and clear semantic binding for all project assets. This approach simplifies data discovery and ensures that files are organized by their primary category first, making it an essential tool for developers and knowledge architects seeking a scalable way to manage complex file hierarchies.
Use Cases
- Scenario 1: Organizing game development or narrative assets (e.g., ROOM.yml, character-hero.yml) to ensure all related entities cluster together during file browsing.
- Scenario 2: Standardizing configuration and schema files in large-scale software projects to improve maintainability and predictable sorting in IDEs and terminal environments.
- Scenario 3: Managing personal or professional knowledge bases where semantic relationships between documents need to be immediately apparent from the filename.
- Scenario 4: Streamlining automated scripts and CI/CD pipelines that process files based on category-specific patterns (e.g., 'cat-*.yml').
| name | naming |
|---|---|
| description | Big-endian file naming as semantic binding |
| license | MIT |
| tier | 1 |
| allowed-tools | [] |
| related | [room, character, yaml-jazz, k-lines] |
| tags | [moollm, naming, filesystem, semantic, convention] |
Naming Skill
"The filesystem is a semantic network."
This skill wraps kernel/NAMING.yml.
Core Pattern
TYPE-VARIANT.ext
| Part | Meaning | Examples |
|---|---|---|
| TYPE | Category/role | cat, staff, ROOM |
| VARIANT | Specific instance | terpie, marieke |
| ext | File type | .yml, .md |
Examples
pub/
├── ROOM.yml # Type only — the pub itself
├── cat-terpie.yml # Type-variant
├── cat-stroopwafel.yml
├── staff-marieke.yml
└── menu-strains.yml # Menu type, strains variant
Sorting Advantage
ls *.yml | sort
# cat-stroopwafel.yml
# cat-terpie.yml
# menu-strains.yml
# ROOM.yml
# staff-marieke.yml
Categories cluster. Finding "all cats" → cat-*.yml
Special Filenames
| Name | Purpose |
|---|---|
ROOM.yml |
Room definition |
CHARACTER.yml |
Character definition |
SKILL.md |
Skill specification |
README.md |
Human landing page |
INDEX.yml |
Registry |
Canonical Forms
See kernel/NAMING.yml for:
- Full naming rules
- Big-endian rationale
- Minsky K-line connection
Dovetails With
Kernel
- kernel/NAMING.yml — definitive reference