Skip to content

Add copilot instructions for XHarness repository#1428

Merged
vitek-karas merged 3 commits intomainfrom
copilot/fix-1427
Jun 27, 2025
Merged

Add copilot instructions for XHarness repository#1428
vitek-karas merged 3 commits intomainfrom
copilot/fix-1427

Conversation

Copy link
Contributor

Copilot AI commented Jun 26, 2025

This PR adds comprehensive GitHub Copilot instructions to help AI assistants understand and work effectively with the XHarness codebase. The instructions are located at .github/copilot-instructions.md as specified in the GitHub documentation.

What's Included

The copilot instructions provide detailed guidance on:

Project Overview & Architecture

  • XHarness as a .NET command-line tool for cross-platform testing
  • Two-layer architecture (tooling and application layers)
  • Platform support: Android, Apple (iOS/tvOS/watchOS/xrOS/Mac Catalyst), WASM, WASI

Technical Knowledge

  • Complete command structure: xharness [platform] [command] [options]
  • All supported platform commands (Android, Apple, WASM, WASI)
  • Standardized exit codes and error handling patterns
  • System requirements and build procedures
  • Key dependencies (ADB, mlaunch, Helix SDK)

Development Guidelines

  • Platform-specific development knowledge
  • Testing strategy (unit, integration, E2E tests)
  • Common implementation patterns for commands
  • Environmental variables and configuration options

Operational Knowledge

  • Repository structure and file organization
  • Troubleshooting guidelines for common issues
  • Development workflow for bug fixes and new features
  • Code quality standards and best practices

Self-Improvement Mechanism

  • Instructions for autonomous updates when discovering new knowledge
  • Emphasis on continuous improvement for effective operation
  • Guidelines for maintaining accuracy and documentation structure

Purpose

These instructions enable AI assistants to:

  • Understand the XHarness architecture and purpose
  • Navigate the codebase effectively
  • Follow established patterns and conventions
  • Implement fixes and features autonomously
  • Troubleshoot common issues
  • Maintain and improve the instructions over time

The goal is to create an autonomous agent capable of solving issues, fixing problems, and adding new features while maintaining code quality and project standards.

Fixes #1427.

Warning

Firewall rules blocked me from connecting to one or more addresses

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

  • 7tjvsblobprodcus341.vsblob.vsassets.io
    • Triggering command: dotnet build /home/REDACTED/work/xharness/xharness/XHarness.sln --verbosity minimal (dns block)
  • c78vsblobprodcus322.vsblob.vsassets.io
    • Triggering command: dotnet build /home/REDACTED/work/xharness/xharness/XHarness.sln --verbosity minimal (dns block)
  • d0svsblobprodcus381.vsblob.vsassets.io
    • Triggering command: dotnet build /home/REDACTED/work/xharness/xharness/XHarness.sln --verbosity minimal (dns block)
  • jd4vsblobprodcus366.vsblob.vsassets.io
    • Triggering command: dotnet build /home/REDACTED/work/xharness/xharness/XHarness.sln --verbosity minimal (dns block)
  • l49vsblobprodcus358.vsblob.vsassets.io
    • Triggering command: dotnet build /home/REDACTED/work/xharness/xharness/XHarness.sln --verbosity minimal (dns block)
  • uy6vsblobprodcus34.vsblob.vsassets.io
    • Triggering command: dotnet build /home/REDACTED/work/xharness/xharness/XHarness.sln --verbosity minimal (dns block)
  • vb4vsblobprodcus33.vsblob.vsassets.io
    • Triggering command: dotnet build /home/REDACTED/work/xharness/xharness/XHarness.sln --verbosity minimal (dns block)
  • yluvsblobprodcus367.vsblob.vsassets.io
    • Triggering command: dotnet build /home/REDACTED/work/xharness/xharness/XHarness.sln --verbosity minimal (dns block)
    • Triggering command: /home/REDACTED/work/xharness/xharness/.dotnet/dotnet msbuild /m /nologo /clp:Summary /v:minimal /nr:true /warnaserror /p:TreatWarningsAsErrors=true /p:ContinuousIntegrationBuild=false /home/REDACTED/work/xharness/xharness/artifacts/toolset/restore.proj /t:__WriteToolsetLocation /clp:ErrorsOnly;NoSummary /p:__ToolsetLocationOutputFile=/home/REDACTED/work/xharness/xharness/artifacts/toolset/10.0.0-beta.25320.5.txt (dns block)

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


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

Co-authored-by: mattleibow <1096616+mattleibow@users.noreply.github.com>
Copilot AI changed the title [WIP] Add copilot instructions Add copilot instructions for XHarness repository Jun 26, 2025
Copilot AI requested a review from mattleibow June 26, 2025 20:37
@akoeplinger
Copy link
Member

@copilot copy the copilot-setup-steps.yml https://github.com/dotnet/sdk/blob/main/.github/workflows/copilot-setup-steps.yml so that you have access to the vsblob.vsassets.io URLs.

…ts.io URLs

Co-authored-by: akoeplinger <1376924+akoeplinger@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Jun 27, 2025

@copilot copy the copilot-setup-steps.yml https://github.com/dotnet/sdk/blob/main/.github/workflows/copilot-setup-steps.yml so that you have access to the vsblob.vsassets.io URLs.

I've copied the copilot-setup-steps.yml workflow from dotnet/sdk to .github/workflows/copilot-setup-steps.yml. This will allow access to the vsblob.vsassets.io URLs that were being blocked by firewall rules. The workflow includes the necessary environment variable COPILOT_AGENT_FIREWALL_ALLOW_LIST_ADDITIONS: "vsblob.vsassets.io" and follows the same pattern as the dotnet/sdk repository. Commit: d6aa4e1

Copilot AI requested a review from akoeplinger June 27, 2025 08:04
@akoeplinger akoeplinger marked this pull request as ready for review June 27, 2025 08:16
@vitek-karas vitek-karas merged commit 1ca2b4a into main Jun 27, 2025
19 checks passed
@vitek-karas vitek-karas deleted the copilot/fix-1427 branch June 27, 2025 11:21
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.

Add copilot instructions

4 participants