docs/architecture.md - System design
shared/constants.ts - Game balance data
shared/types.ts - Type definitions

Domain Model

Term	Meaning
Base	Player's civilization layout
Building	Structure on the grid (TownCenter, Farm, Barracks)
Unit	Trainable troop with AI behavior
Resource	Food, Gold, Oil
Age	Technology era (Stone, Bronze, Iron, etc.)
Nation	Civilization with unique bonuses

Project Structure

client/src/
  assets/         # Sprites, tiles, audio
  game/
    scenes/       # Phaser scenes (MainMap, Battle, Loading)
    entities/     # Buildings, Units, Projectiles
    systems/      # Pathfinding, Grid, Input
  ui/             # React/Vue overlays (HUD, Menus)

server/src/
  rooms/          # Colyseus game rooms
  models/         # MongoDB schemas (User, Base, Clan)
  mechanics/      # Authoritative game logic

shared/
  constants.ts    # Building costs, Unit stats
  types.ts        # Shared interfaces

Code Patterns

Isometric Projection

// Grid to Screen
function cartesianToIsometric(x: number, y: number) {
  return {
    x: (x - y) * TILE_WIDTH_HALF,
    y: (x + y) * TILE_HEIGHT_HALF
  };
}

// Screen to Grid
function isometricToCartesian(isoX: number, isoY: number) {
  return {
    x: (isoX / TILE_WIDTH_HALF + isoY / TILE_HEIGHT_HALF) / 2,
    y: (isoY / TILE_HEIGHT_HALF - isoX / TILE_WIDTH_HALF) / 2
  };
}

Server Authority

// Server calculates resources based on time
const elapsed = Date.now() - player.lastUpdate;
const produced = Math.floor(elapsed / 3600000) * farm.productionRate;
player.gold += produced;

State Synchronization

// Colyseus schema for synced state
class GameState extends Schema {
  @type([Building]) buildings = new ArraySchema<Building>();
  @type({ map: Player }) players = new MapSchema<Player>();
}

Code Standards

TypeScript strict - No any without justification
Server authoritative - Never trust client input
Client predicts - Show optimistic updates, reconcile with server
Colyseus for sync - Use schemas for multiplayer state
MongoDB for persistence - Save base layouts, user data
Redis for sessions - Leaderboards, active sessions

Aspect	Standard
Language	TypeScript strict
Game Engine	Phaser 3
UI Framework	React or Vue (overlays)
Backend	Node.js + Colyseus
Database	MongoDB
Caching	Redis

project-context

Project Context Skill

Quick Reference

Key Documentation