This PR adds a comprehensive .github/copilot-instructions.md file that provides GitHub Copilot coding agents with detailed instructions for working effectively in the JavaScriptKit repository.

What's Included

The instructions cover all essential development workflows:

• Environment Setup: Exact commands for installing Swift 6.0.2 toolchain and WebAssembly SDK
• Build Process: Bootstrap, runtime compilation, and core build commands with validated timings
• Testing: Unit tests, plugin tests, and validation workflows with proper timeout settings
• BridgeJS Workflows: Code generation, experimental features, and AoT compilation
• Code Formatting: Swift and TypeScript/JavaScript formatting commands
• Manual Validation: End-to-end scenarios to verify changes work correctly

Key Features

• Firm directive to follow instructions first before searching or exploring
• Imperative tone throughout with clear "do this" commands
• NEVER CANCEL warnings with specific timeout recommendations for long-running builds
• Validated commands - every single command was tested and timed during development
• Performance expectations table with actual measured timings
• Troubleshooting guidance for common issues

Validation

All commands and timings were thoroughly validated:

• Environment setup with Swift 6.0.2 and WebAssembly SDK
• make bootstrap (4 seconds)
• make unittest (40 seconds)
• make regenerate_swiftpm_resources (3 seconds)
• ./Utilities/bridge-js-generate.sh (3 minutes 40 seconds)
• Plugin tests (90+ seconds)
• Example builds (18-80 seconds)
• Manual validation by building and serving examples

The instructions enable any GitHub Copilot coding agent to immediately work productively in this repository without trial-and-error exploration.

Fixes #421.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.