# Project Execution Plan — PoE2 Procedural Tile Map System

## Overview
Transform the FreeExile map system from hardcoded math terrain into a full PoE2-style procedural tile-based world: server generation from seed + biome config, compact binary transfer, client viewport culling + chunk offscreen caching, tile collision & boss gate locking, client-side Fog of War & minimap HUD, and terrain-anchored monster encounters.

## Phase 0: Survey & Technical Mapping
- Spawn 3 parallel survey agents:
  1. `explorer_survey_server`: Survey server procedural map engine, biomes, zone engine, data structures, and binary serialization.
  2. `spec_miner_map`: Extract all technical specifications, constraints, boundaries, protocols, and acceptance criteria from requirements and codebase.
  3. `explorer_survey_client`: Survey client world renderer, isometric math, canvas renderer, mobile memory footprint, collision, and fog/minimap systems.
- Synthesize findings into `PROJECT.md` (Feature Inventory, Architecture, Code Layout, Interfaces, Milestones).

## Phase 1: Dual Track Initiation
- **Track A (Implementation Track)**:
  - Milestone R1: Procedural Tile Map Pipeline Server to Client (`server/world/procedural_map_engine.py`, `server/world/zone_engine.py`, client tile grid reception).
  - Milestone R2: Tile-Based Rendering Viewport Culling + Chunk Caching for Mobile (`client/webapp/js/engine/world_renderer.js`, sprite atlas/colors, mobile RAM ≤8MB).
  - Milestone R3: Tile-Level Collision & Boss Gate Logic (`client/webapp/js/engine/collision_engine.js`, wall sliding, boss gate condition, python unit tests).
  - Milestone R4: Fog of War Client-Side & Minimap HUD (`client/webapp/js/engine/fog_of_war.js`, `client/webapp/js/ui/minimap_hud.js`, persistence).
  - Milestone R5: Encounter Zone Architecture & Terrain-Anchored Spawning (`client/webapp/js/engine/monster_system.js`, POI events, boss gate popup & progress).
- **Track B (E2E Testing Track)**:
  - E2E Test Suite Orchestration (Tiers 1-4: Feature, Boundary, Combinatorial, Real-World Application scenarios).
  - Publish `TEST_READY.md`.

## Phase 2: Final Integration & Hardening
- Final Milestone Phase 1: Pass 100% of E2E Test Suite (Tiers 1-4).
- Final Milestone Phase 2: Adversarial Coverage Hardening (Tier 5 white-box stress testing).
- Forensic Integrity Audit & Independent Security Audit validation.
- Delivery of `handoff.md` and completion reporting to parent.