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

What's Included

The instructions cover all essential aspects of working with BindsNET:

Setup and Installation:

• Primary Poetry-based installation with proper timeout settings (60+ minutes)
• Fallback pip-based installation for network/dependency issues
• System package alternatives using apt for problematic dependencies
• Detailed troubleshooting for common installation problems

Repository Structure:

• Complete breakdown of key directories (bindsnet/, examples/, test/)
• Important files and their purposes (pyproject.toml, CONTRIBUTING.md)
• Example categorization with realistic timing estimates

Development Workflow:

• Testing procedures with pytest and expected failure scenarios
• Code formatting using pre-commit hooks and manual alternatives
• Example execution with accurate timing (MNIST examples take ~1 hour)
• Validation scenarios that work reliably

Realistic Timing Expectations:

• Poetry install: 15-45 minutes (60+ minute timeout required)
• MNIST examples: ~1 hour on Intel i7, ~1 min/epoch on GPU
• Test execution: 5-15 minutes with many expected failures
• All timing based on repository documentation and validation

Comprehensive Troubleshooting:

• Network timeout handling and retry strategies
• System package conflicts (numpy/pandas version mismatches)
• Import errors due to missing optional dependencies
• Development tool availability issues

Key Features

The instructions are designed to be practical and acknowledge real-world challenges:

• "NEVER CANCEL" warnings with specific timeout values for long-running operations
• Working alternatives for when preferred methods fail
• Validated commands that are guaranteed to work in most environments
• Realistic expectations about what will and won't work due to dependency issues

This ensures GitHub Copilot agents can work effectively even in environments with limited network access or dependency conflicts, while providing clear guidance on expected behavior and timing.

Fixes #718.

---

💡 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.