Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Sep 24, 2025

This PR adds a comprehensive set of instruction files to guide various AI agents and tools when working on the OnchainTestKit project. These files provide context-specific guidance for blockchain testing, wallet automation, and the unique challenges of browser extension testing.

Files Added

Core Agent Instructions

  • .github/copilot-instructions.md - GitHub Copilot-specific guidance covering project architecture, development patterns, and code style conventions
  • AGENTS.md - General agent instructions with project overview, key components, and common development workflows
  • CLAUDE.md - Claude-specific instructions emphasizing analytical problem-solving and blockchain testing complexities
  • GEMINI.md - Gemini-specific instructions focusing on optimization strategies and technical excellence

Specialized Development Guides

  • .github/instructions/wallet-development.instructions.md - Comprehensive guide for wallet integration patterns, action types, and extension management
  • .github/instructions/testing-framework.instructions.md - Testing framework usage, configuration patterns, and best practices
  • .github/instructions/node-management.instructions.md - Local blockchain node management, fork mode configuration, and performance optimization
  • .github/instructions/api-development.instructions.md - API design principles, extension points, and security considerations

Key Features

Each instruction file is tailored to its specific audience and includes:

  • Project-specific context about blockchain testing challenges and wallet automation
  • Practical code examples using the actual OnchainTestKit patterns and APIs
  • Architecture guidance covering the modular wallet system, configuration builder, and test framework
  • Best practices for handling asynchronous blockchain operations, browser extension automation, and network management
  • Troubleshooting guides for common issues in blockchain testing environments

Technical Coverage

The instructions cover critical aspects of the OnchainTestKit ecosystem:

  • Multi-wallet support - MetaMask, Coinbase Wallet, and Phantom integration patterns
  • Fork mode testing - Advanced blockchain state forking for realistic test scenarios
  • Browser automation - Complex extension popup handling and context management
  • Network management - Multi-network testing and RPC provider optimization
  • Type safety - Comprehensive TypeScript patterns for blockchain-specific types

These instruction files will help AI agents understand the unique challenges of blockchain application testing and provide more targeted, effective assistance when working on the OnchainTestKit codebase.

Fixes #32.


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

@joe10832 joe10832 marked this pull request as ready for review September 24, 2025 10:07
Copilot AI review requested due to automatic review settings September 24, 2025 10:07
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request.


Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@joe10832 joe10832 self-requested a review September 24, 2025 10:07
@joe10832 joe10832 merged commit 7276e66 into main Sep 24, 2025
3 checks passed
Copy link
Member

@joe10832 joe10832 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot AI changed the title [WIP] Push Add comprehensive AI agent instruction files for development guidance Sep 24, 2025
Copilot AI requested a review from joe10832 September 24, 2025 10:16
Copy link
Member

@joe10832 joe10832 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@joe10832 joe10832 self-requested a review September 24, 2025 10:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Push

2 participants