Architecture: How should the Universe/Module hierarchy be structured for A...

Documentation for Sessions

🏗️ Architecture: How should the Universe/Module hierarchy be structured for A...

📋 Decision Context

Question:

How should the Universe/Module hierarchy be structured for AI-trainable, reusable platforms?

Task: Understand and document the space module convention with cosmic hierarchy


🎯 Decision Made

Chosen:

Cosmic metaphor hierarchy (Space→Universe→Galaxy→World→Page)

Options Considered:

  1. Flat module list with positions
  2. Simple project container with installed modules
  3. Cosmic metaphor hierarchy (Space→Universe→Galaxy→World→Page)

💭 Reasoning

The cosmic metaphor is ALREADY implemented in the codebase via MODULE_TYPE_REGISTRY with cosmicTerm properties. It's fun, memorable, intuitive, and AI-trainable. Routes naturally follow the hierarchy (/galaxy/world/page). The existing types (galaxy, world, page-module) with their cosmicTerm values provide the foundation. This approach: 1) Makes module creation fun and easy to remember, 2) Provides clear AI training structure, 3) Routes generate naturally from hierarchy, 4) Already has tooling support (getModuleCosmicTerm helper).


📁 Files Involved


🔗 Related


Auto-generated by MCP Smart Consolidation