Using SPECTRA Execution Agent with Copilot CLI

Overview

The SPECTRA Execution Agent works with GitHub Copilot CLI for command-line test execution.

Setup

Initialize SPECTRA in your repository:
```
spectra init
```
This creates the execution agent prompt at .github/agents/spectra-execution.agent.md and the bundled SKILLs under .github/skills/.
Install the MCP server (separate global tool):
```
dotnet tool install -g Spectra.MCP
```
Ensure you have GitHub Copilot CLI installed:
```
gh extension install github/gh-copilot
```

Invocation

Use gh copilot suggest with your request:

gh copilot suggest "run spectra tests for auth suite"

Or ask for help:

gh copilot suggest "what spectra test suites are available"

How It Works

Copilot CLI discovers the agent prompt at .github/agents/spectra-execution.agent.md and uses it to:

Connect to the SPECTRA MCP server (spectra-mcp)
List available test suites
Guide you through test execution
Record results and generate reports

Example Usage

# The MCP client launches spectra-mcp on stdio automatically;
# you don't start the server manually for stdio-based clients.
gh copilot suggest "run high priority checkout tests"

Prerequisites

Spectra.MCP global tool installed (dotnet tool install -g Spectra.MCP)
GitHub Copilot CLI extension installed
Repository initialized with spectra init