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.