docs: Consolidate Phase 2 documentation into unified structure

[dcversus]

Summary

Consolidates all Phase 2 documentation into a unified, maintainable structure following the Three-File Rule from CLAUDE.md. Removes duplicate and outdated documentation files.

Changes

Documentation Consolidation

• Merged 2.1-render-all-maps-integration.md + 2.1-render-all-maps.md → single comprehensive PRP 2.1
• Consolidated EXECUTIVE_SUMMARY, PHASE2_COMPREHENSIVE_SPECIFICATION, PHASE2_BROWSER_VALIDATION, PHASE2_IMPLEMENTATION_REPORT into:
  • README.md - Phase 2 overview with current status
  • 2-advanced-rendering-visual-effects.md - Main PRP with complete DoD

Enhanced Documentation

• ✅ Complete DoD with all 24 maps validation checklist
• ✅ Current status dashboard (82% complete - 9/11 PRPs)
• ✅ Implementation summary (~4,000 lines of code)
• ✅ Performance targets and validation guide
• ✅ Browser testing instructions
• ✅ Next steps with 1-week timeline

Files Removed (Content Merged)

• ❌ 2.1-render-all-maps-integration.md → merged into 2.1-render-all-maps.md
• ❌ EXECUTIVE_SUMMARY.md → merged into README.md
• ❌ PHASE2_COMPREHENSIVE_SPECIFICATION.md → merged into README.md + main PRP
• ❌ PHASE2_BROWSER_VALIDATION.md → merged into README.md (validation section)
• ❌ PHASE2_IMPLEMENTATION_REPORT.md → merged into README.md (status section)

Phase 2 Status

Core Systems: 9/9 complete (100%)

• PostProcessingPipeline (386 lines) ✅
• AdvancedLightingSystem (480 lines) ✅
• GPUParticleSystem (479 lines) ✅
• WeatherSystem (410 lines) ✅
• PBRMaterialSystem (382 lines) ✅
• CustomShaderSystem (577 lines) ✅
• DecalSystem (379 lines) ✅
• MinimapSystem (347 lines) ✅
• QualityPresetManager (552 lines) ✅

Map Integration: 4/6 complete (67%)

• MapRendererCore ✅
• SC2MapLoader ✅
• W3NCampaignLoader ✅
• LZMA Decompression ✅
• MapGallery UI ⏳
• MapViewerApp ⏳

Map Validation: 0/24 pending

Exit Criteria - All 24 Maps

Phase 2 Exit Criteria now explicitly includes validation of all 24 maps from /maps folder:

Warcraft 3 Maps (.w3x) - 13 maps:

• (10)BattleOfFallenBridge.w3x (2.3 MB)
• (12)IceCrown.w3x (9.1 MB)
• (2)AncientIsles.w3x, (2)Concealed Hill.w3x, (2)DuskwoodGlens.w3x
• (4)Deadlock_LV.w3x, (4)TranquilPaths.w3x, (4)Twisted Meadows.w3x
• (6)DarkForest.w3x, (6)GnollWood.w3x, (6)MoonGlade.w3x
• (8)TurtleRock.w3x, (8)Wetlands.w3x

Warcraft 3 Campaigns (.w3n) - 7 campaigns:

• JudgementOfTheDead.w3n (923 MB)
• CallOfTheDragon.w3n (254 MB)
• DimensionOfReflections.w3n (204 MB)
• CovenantOfThePlague.w3n, ReignOfDarkness.w3n, TheBlackRoad.w3n, TourOfDuty.w3n

StarCraft 2 Maps (.sc2map) - 3 maps:

• Acolyte LE.SC2Map (5.5 MB)
• Oceanborn LE.SC2Map (11.8 MB)
• Rosebud LE.SC2Map (10.8 MB)

StarCraft 1 Maps (.scm) - 1 map:

• (2)Benzene.scm (22 KB)

Performance Target: All maps @ 60 FPS @ MEDIUM preset

Validation

# Generate map list
npm run generate-map-list

# Validate all 24 maps
npm run validate-all-maps

# Browser testing (see README.md § Validation & Testing)
npm run dev
# Open http://localhost:5173
# Click "Load All Maps"
# Verify gallery + 60 FPS per map

Impact

Net Change: -2,713 lines (removed duplicates, consolidated content)

• 6 files changed: 855 insertions(+), 3,568 deletions(-)
• Documentation now follows Three-File Rule (CLAUDE.md compliance)
• Single source of truth for Phase 2 status and requirements

Next Steps

1. Implement MapGallery UI (PRP 2.7) - 2 days
2. Integrate MapViewerApp (PRP 2.1) - 1 day
3. Validate all 24 maps - 1 day
4. Browser performance testing - 1 day
5. Documentation & polish - 1 day

Estimated Time to Phase 2 Completion: 1 week (5 days)

---

This PR creates a clean, consolidated documentation structure that makes Phase 2 status and requirements crystal clear. All redundant documentation removed while preserving critical information.