✨ Set up Copilot instructions following GitHub best practices

[Copilot]

Overview

This PR configures the repository to follow GitHub's best practices for Copilot coding agents as documented at https://gh.io/copilot-coding-agent-tips. The changes create a centralized configuration hub for AI coding agents to quickly understand the project structure, development workflows, and best practices.

What's New

Created .github/agents/ Directory

Added a new .github/agents/README.md (232 lines) that serves as a centralized configuration hub for all AI coding agents. This file provides:

• Overview & Quick Start - Fast onboarding with essential setup commands
• Documentation Structure - Complete guide to all instruction files in the repository
• Key Concepts - Repository purpose, core technologies (TypeScript, Playwright, Viem, Biome), and architecture principles
• Development Guidelines - Code quality standards, build workflows, and testing philosophy
• Agent-Specific Guidance - Tailored instructions for GitHub Copilot, Claude AI, Gemini AI, and other agents
• Critical Files Reference - Highlights of core API surfaces and important files
• Common Tasks - Step-by-step guides for adding wallet support, actions, and configuration changes
• Known Issues - Current limitations and environment requirements
• Best Practices - 5-step approach for agents to follow when making changes
• Security Considerations - Safe development practices for blockchain testing

Updated Existing Documentation

.github/copilot-instructions.md (+7 lines):

• Added reference to the new agents directory in the "GitHub Copilot Configuration" section
• Added new "Agent Configuration Hub" subsection in "Understanding the Agent Architecture"
• Ensures agents can easily discover the centralized configuration

README.md (+1 line):

• Added link to "AI Agent Configuration Hub" as the first item in "Quick Setup Guides"
• Makes the centralized configuration immediately discoverable from the main README

Documentation Structure

The repository now has a clear documentation hierarchy:

README.md → .github/agents/README.md (Hub)
                ↓
    ├── .github/copilot-instructions.md (GitHub Copilot)
    ├── AGENTS.md (General agents)
    ├── CLAUDE.md (Claude AI)
    ├── GEMINI.md (Gemini AI)
    └── .github/instructions/*.instructions.md (Specialized)

Best Practices Implemented

Following GitHub's recommendations for Copilot coding agents:

• ✅ Clear project context and overview in .github/ directory
• ✅ Comprehensive setup instructions with quick start commands
• ✅ Build and test command documentation
• ✅ Code patterns and architecture examples
• ✅ Agent-specific guidance for different AI tools
• ✅ Proper .github/ directory organization
• ✅ Cross-references between instruction files
• ✅ Security considerations for blockchain testing

Verification

All quality checks pass:

• ✅ Build: TypeScript compiles successfully
• ✅ Tests: All 3 tests pass (716ms)
• ✅ Lint: Biome checks pass (27 files)
• ✅ No Breaking Changes: Minimal modifications to existing files

Impact

This setup ensures that:

1. AI coding agents can quickly discover and understand the project
2. Documentation is centralized in .github/agents/ for easy discovery
3. Cross-references make navigation between instruction files seamless
4. New contributors using AI tools have clear, comprehensive guidance
5. The repository follows GitHub's recommended structure for AI-assisted development

The changes are minimal, focused, and follow GitHub's best practices while maintaining backward compatibility with all existing documentation.

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:

• gh.io
  • Triggering command: curl -sL REDACTED (dns 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.

(https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github) extension.</issue_description>

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

Fixes #97

---

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

[Copilot]

Pull Request Overview

This PR sets up GitHub Copilot instructions following GitHub's best practices for AI coding agents. It creates a centralized configuration hub to help AI agents understand the project structure and development workflows.

• Created a comprehensive AI agent configuration hub in .github/agents/README.md
• Added cross-references to connect existing instruction files
• Updated main README with a link to the new configuration hub

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
.github/agents/README.md	New centralized configuration hub providing project overview, setup instructions, and agent-specific guidance
.github/copilot-instructions.md	Added references to the new agents directory and configuration hub
README.md	Added link to AI Agent Configuration Hub in documentation section