Add comprehensive GitHub Copilot instructions for Fantasy Map Generator

[Copilot]

This PR creates comprehensive instructions for GitHub Copilot coding agents working in the Fantasy Map Generator repository. The instructions provide essential guidance for developers to quickly understand and work effectively with this complex client-side JavaScript application.

Key Features Added

Deployment Instructions: Complete, validated setup instructions for multiple deployment methods:

• Python HTTP server (python3 -m http.server 8000)
• Docker containerization with nginx
• Shell script alternatives for different platforms

Critical Application Knowledge:

• No build process required - this is a static web application with 232 JavaScript files
• HTTP server mandatory - cannot run with file:// protocol due to security restrictions
• Map generation timing - ~0.66-0.76 seconds for complete fantasy world generation
• "NEVER CANCEL" warnings with specific timeout recommendations

Comprehensive Validation Scenarios: Step-by-step testing procedures including:

• Starting the application and verifying map generation
• Testing the "New Map" button for different world generation
• Verifying layer controls and UI interactions
• Confirming console logs show expected timing patterns

Repository Architecture: Detailed breakdown of the 41MB codebase including:

• Core files (main.js, index.html, versioning.js)
• 44 UI modules in modules/ui/ for editors and tools
• 15 utility libraries for mathematical operations
• 12 visual style presets and configuration files

Quick Reference Commands: Validated file lookup commands and directory navigation to help developers locate frequently modified files like heightmap generators, political entity creators, and rendering modules.

The instructions were thoroughly tested by:

1. Running the Python HTTP server and Docker deployments
2. Generating multiple fantasy maps and verifying ~0.7s generation times
3. Testing all UI interactions including layer controls and map regeneration
4. Validating every command and file path mentioned in the instructions

This enables any GitHub Copilot agent to immediately start working productively in the codebase with accurate, tested information about setup, validation, and common development workflows.

Fixes #1232.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[Copilot]

@Azgaar 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.

[netlify]

✅ Deploy Preview for afmg ready!

Name	Link
🔨 Latest commit	a7f4d52
🔍 Latest deploy log	https://app.netlify.com/projects/afmg/deploys/68b1c500cd2e0d0008e98c04
😎 Deploy Preview	https://deploy-preview-1233--afmg.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[Azgaar]

@copilot, write the instructions

[Copilot]

@copilot, write the instructions

I've written comprehensive GitHub Copilot instructions in .github/copilot-instructions.md (164 lines) covering:

Key Features:

• Complete deployment guide (Python HTTP server, Docker, shell scripts)
• Critical app knowledge (no build process, HTTP server required, ~0.76s map generation)
• Step-by-step validation procedures for testing map generation
• Detailed repository architecture (41MB, 232 JS files, modules breakdown)
• Quick reference commands for common development tasks

Validated Features:

• Python server setup: python3 -m http.server 8000 ✅
• Map generation timing and console logs ✅
• UI interactions (layers, regeneration) ✅
• File structure and navigation commands ✅

The instructions enable any Copilot agent to immediately start working productively with accurate setup, validation, and development workflows.

Added in commit 482618a.

[Copilot]

Pull Request Overview

This PR adds comprehensive GitHub Copilot instructions for the Fantasy Map Generator repository to help developers quickly understand and work with this client-side JavaScript application. The instructions provide essential setup guidance, validation procedures, and architectural overview.

Key changes include:

• Complete deployment instructions with validated HTTP server setup commands
• Critical application knowledge including "no build process" requirements and timing expectations
• Comprehensive validation scenarios with step-by-step testing procedures

[Copilot]

This timing estimate (~1 second) contradicts the more specific timing mentioned in the PR description (~0.66-0.76 seconds). Consider using the more precise timing range for consistency.

Suggested change

	- Map generation should complete in ~1 second for standard configurations
	- Map generation should complete in ~0.66-0.76 seconds for standard configurations

[Copilot]

The example timing (~0.76s) should be consistent with the general timing guidance provided later in the file. Consider updating line 86 to match this more specific range.

Suggested change

	- Look for timing logs, e.g. "TOTAL: ~0.76s"
	- Look for timing logs, e.g. "TOTAL: ~1.0s"