project-structure

Explain the standard directory and file structure for Bestow Lua game projects, including auto-discovery mechanisms and namespace mapping.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/radical-beard/bestow --skill project-structure-radical-beard
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-structure
Source: https://github.com/radical-beard/bestow/tree/main/template/.claude/skills/project-structure
Command: npx skills add https://github.com/radical-beard/bestow --skill project-structure-radical-beard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill clarifies the expected file and directory structure for Bestow game projects, ensuring proper auto-discovery and hot reloading.

Core Features & Use Cases

  • Standard Project Layout: Understand the default organization for entities, systems, levels, data, and assets.
  • Auto-Discovery: Learn how Bestow maps directories to Lua namespaces (app.*).
  • Module Examples: See practical examples for main.lua, entity factories, system logic, level definitions, and data modules.
  • Use Case: When starting a new Bestow game, use this Skill to set up your project directories correctly from the beginning, avoiding common auto-discovery issues.

Quick Start

Use the project-structure skill to understand the standard Bestow project layout.

Frequently Asked Questions about project-structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure directories in a Bestow Lua game project?▼

Structure Bestow Lua game project directories by organizing entities, systems, levels, data modules, and assets into standard mapped namespaces like `app.*` for proper auto-discovery and hot reloading.

How does auto-discovery work for Lua namespaces in Bestow?▼

Auto-discovery in Bestow maps standard project directories directly to Lua namespaces, such as `app.*`, allowing the engine to automatically locate and load entity factories, system logic, and data modules.

What is the standard file naming convention for Bestow game modules?▼

The standard file naming convention for Bestow game modules ensures proper auto-discovery by aligning file names with directory structures and Lua namespace mappings for efficient game development and maintainability.

Why are my Bestow entity factories and systems not auto-discovering?▼

Bestow entity factories and systems fail to auto-discover when the project directory structure does not correctly map to the expected Lua namespaces, disrupting the standard organization required for hot reloading.

Can I use a custom directory layout for Bestow game assets and levels?▼

Using a custom directory layout for Bestow game assets and levels risks breaking the standard namespace mapping and auto-discovery mechanisms, making the default project structure essential for maintainability.

When do I need to set up namespaces for a new Bestow project?▼

Set up namespaces for a new Bestow project at the very beginning to ensure standard directory organization, enabling proper auto-discovery of level definitions, data modules, and asset organization from the start.