REPO MAP

Guide for REPO MAP

🗺️ Repository Map & Agent Context

Purpose: This document serves as the high-level map of the loh monorepo. Agents should consult this to understand where to find information and where code belongs.

📂 Core Directory Structure

DirectoryPurposeTech Stack
loh-game/The core Game Client and Server logic.Rust (Bevy ECS)
loh-backend/High-Performance APIs (Auth, Economy).Rust (Axum/Tokio)
loh-cf-workers/Edge Logic (KB Access, Tickets).TypeScript (Cloudflare Workers)
loh-libs/Shared code used by BOTH Game and Backend.Rust (Shared Protocol)
loh-website/Public Website and Wiki.Next.js (React)
loh-ops-tools/Internal Tools (Level Editor, Support).Next.js (Cloudflare Pages)
loh-devops/CI/CD, Infrastructure, Deployment.Docker (K8s/GCP)
knowledge-base/Single Source of Truth for Documentation.Markdown
.agent/workflows/Actionable Instructions for Agents.Markdown

🧠 Knowledge Base Index

Use find_by_name in knowledge-base/ to locate specific docs.
  • /architecture: API Contracts, Network Design, Tool Architecture.
  • /assets: 3D Asset Plans, Art Pipelines, Commission Briefs.
  • /business: Economy Design, Monetization, Growth Strategy.
  • /design: Design Bible (Colors, Fonts), UX Plans.
  • /guides: Developer Guides, QA Principles, Getting Started.
  • /infrastructure: Cloudflare, Docker, Security, AWS Migration.
  • /planning: Task Lists, Sprints, Issue Logs.

🔄 Common Workflows (In .agent/workflows/)

  • guardrails.md: MUST READ. Principal Engineering Standards.
  • code-review.md: Checklist before submitting PRs.
  • update-knowledge-base.md: How to update Game Data.
  • reference-game-data.md: How to look up Items/NPCs.
  • deploy-protection.md: Cloudflare security setup.

🔑 Key Glossaries

  • Bija: Premium currency.
  • Bandhu: Referral program system.
  • Rajdoot: Affiliate program system.
  • Vymanika: The flight/transport system.

⚡ Quick Dev Commands

  • Run Game: cargo run (in loh-game)
  • Run Website: npm run dev (in loh-website)
  • Run Ops: npm run dev (in loh-ops-tools)
  • Test All: cargo test --all (in root)