ably-cocoa icon indicating copy to clipboard operation
ably-cocoa copied to clipboard

Add copilot setup workflow and instructions

Open Copilot opened this issue 8 months ago • 3 comments

Added GitHub Copilot agent support for the ably-cocoa repository by creating two new files:

Files Added

.github/workflows/copilot-setup-steps.yml

A GitHub Actions workflow that sets up the complete development environment for Copilot agents, including:

  • Xcode 16.3 selection and environment configuration
  • Simulator reset for clean testing state
  • Dependencies installation (xcbeautify, carthage, submodules, ruby gems)
  • Carthage dependencies update for all platforms
  • Setup verification with version checks

.github/copilot-instructions.md

Comprehensive development instructions for Copilot agents containing:

  • Prerequisites and initial setup steps (make update)
  • All key development commands for building and testing across iOS/tvOS/macOS platforms
  • Dependency management commands for Carthage updates
  • Fastlane commands with required environment variables (ABLY_ENV=sandbox)
  • Project structure overview and common troubleshooting tips

Implementation Details

The workflow follows the same structure and steps as the existing integration-test.yaml workflow, ensuring consistency with the current CI setup. All commands and Make targets have been verified against the actual Makefile and fastlane/Fastfile to ensure accuracy.

This enables GitHub Copilot agents to automatically set up the development environment and understand the available build/test commands when working on tasks in this repository.

Fixes #2061.


💡 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 avatar Jun 11 '25 11:06 Copilot

@owenpearson Thanks for sending me some feedback. Unfortunately, I hit an error while trying to use the custom Copilot setup steps configured for this repository. The error I am seeing is:

No `copilot-setup-steps` job found in your Copilot setup steps workflow file. Please ensure you have a single job named `copilot-setup-steps`. For more details, see https://gh.io/copilot/actions-setup-steps.

Once you or someone with the necessary access fixes the problem, please let me know in a comment and I'll try again. Thanks!

Copilot avatar Jun 11 '25 11:06 Copilot

@owenpearson Thanks for sending me some feedback. Unfortunately, I hit an error while trying to use the custom Copilot setup steps configured for this repository. The error I am seeing is:

No `copilot-setup-steps` job found in your Copilot setup steps workflow file. Please ensure you have a single job named `copilot-setup-steps`. For more details, see https://gh.io/copilot/actions-setup-steps.

Once you or someone with the necessary access fixes the problem, please let me know in a comment and I'll try again. Thanks!

Copilot avatar Jun 11 '25 11:06 Copilot

@copilot can you try running some simple commands to check that changing the job name to copilot-setup-steps actually worked?

owenpearson avatar Jun 11 '25 11:06 owenpearson