This PR creates comprehensive GitHub Copilot instructions that provide a complete guide for GitHub Copilot coding agents to work effectively in the homebridge/docker-homebridge repository. The instructions document the current state of the repository, including both working functionality and current limitations.

Key Features

Current Build Status Documentation: The instructions clearly document that local Docker builds currently fail due to a pipx install tzupdate dependency issue in the Dockerfile (fails after ~113 seconds at build step 2/9). This provides agents with accurate expectations rather than misleading them to attempt builds that will fail.

Working Validation Methods: Instead of non-functional local builds, the instructions provide validated commands using published images:

# Test stable release
cd test
export HOMEBRIDGE_IMAGE='ghcr.io/homebridge/homebridge:latest'
docker compose up -d
curl -s -o /dev/null -w "%{http_code}" http://localhost:8581  # Should return 200
docker compose down

Comprehensive Validation Scenarios: The instructions include complete end-to-end testing procedures with expected outputs, timing measurements, and validation steps that have all been tested and verified to work.

Repository Architecture Guide: Detailed documentation of the project structure, including:

• Multi-architecture Docker builds (amd64, arm32v7, arm64v8)
• S6 overlay process supervision system
• Automated beta dependency updates via homebridge-beta-bot
• CI/CD pipeline using GitHub Actions

Timing and Timeout Documentation: All commands include measured timing expectations:

• Image pull: ~25 seconds
• Container startup: ~15 seconds
• UI accessibility: Immediate after startup
• Clean shutdown: ~10 seconds

Manual Validation Requirements: The instructions emphasize testing actual functionality, not just build success. Every command has been validated through complete user scenarios including UI accessibility verification and container health checks.

The instructions follow the requested imperative tone ("Run this command", "Do not do this") and include explicit warnings about timeout expectations and build limitations. They provide GitHub Copilot agents with everything needed to work effectively in this repository while avoiding common pitfalls.

Fixes #666.

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.