✨ Set up GitHub Copilot instructions for AgQueue repository

[Copilot]

This PR implements comprehensive GitHub Copilot instructions for the AgQueue repository as requested in issue #X. The instructions follow GitHub's best practices for Copilot coding agents and provide detailed context about the project's architecture, development standards, and common workflows.

What's Added

Created .github/copilot-instructions.md with comprehensive documentation covering:

Project Context

• Complete overview of AgQueue as a transactional work queue system
• Key features including transaction management, priority queuing, and gRPC communication
• Architecture breakdown of all projects and their relationships

Development Standards

• StyleCop Analyzers configuration and zero-warning policy
• XML documentation requirements for public APIs
• Coding conventions including int64 primary keys and case-sensitive queue names
• Copyright and company name standards

Technical Details

• gRPC API Structure: All service operations (QueueApi) including queue management, transaction control, and message operations
• Message System: Detailed workflows, properties, states, and lifecycle management
• Transaction Handling: Documentation of the two-level transaction system (database + queue transactions)
• Storage Abstraction: Guidelines for implementing new storage providers

Build & Testing Information

• .NET 5.0 target framework with end-of-life considerations
• Build commands and testing approach using MSTest
• Known package vulnerabilities and limitations
• Integration test patterns using in-process gRPC server

Common Development Tasks

• Step-by-step guides for adding new queue operations
• Instructions for implementing new storage providers
• Message workflow patterns and error handling approaches

Why This Matters

These instructions will enable GitHub Copilot to:

• Generate code that follows the project's established patterns and conventions
• Understand the complex transaction management system
• Properly implement gRPC service methods and storage interfaces
• Maintain consistency with StyleCop rules and documentation standards
• Handle the nuances of the two-level transaction architecture

The instructions provide sufficient context for Copilot to assist effectively with both routine development tasks and complex architectural decisions within the AgQueue ecosystem.

Technical Notes

• Removed accidentally committed XML documentation artifacts
• Instructions account for current technical debt (package vulnerabilities, .NET 5.0 EOL)
• Documented the migration from TCP/REST to gRPC-only architecture
• Included protobuf definitions and message state management details

This establishes a solid foundation for AI-assisted development while maintaining the project's quality standards and architectural integrity.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• http://crl3.digicert.com:443/DigiCertHighAssuranceEVRootCA.crl
  • Triggering command: dotnet restore (http block)
• http://crl3.digicert.com:443/NETFoundationProjectsCodeSigningCA.crl
  • Triggering command: dotnet restore (http block)
• http://crl3.digicert.com:443/sha2-assured-ts.crl
  • Triggering command: dotnet restore (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>✨ Set up Copilot instructions</issue_title>
<issue_description>Configure instructions for this repository as documented in Best practices for Copilot coding agent in your repository.

</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes #11

---

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