Add copilot-setup-steps.yml as GitHub Actions workflow for automated agent environment configuration

.github/copilot-instructions.md

@@ -22,6 +22,8 @@ xAPI Java is a library that helps you create applications that send or receive x
 
 ## Environment Setup
 
+**Note**: For GitHub Copilot agents, automated environment setup is configured in [copilot-setup-steps.yml](workflows/copilot-setup-steps.yml). The setup steps below are for manual configuration.
+
 ### Java Installation with SDKMAN
 
 This project requires Java 25. We recommend using [SDKMAN!](https://sdkman.io/) to manage Java versions:

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

@@ -0,0 +1,43 @@
+# GitHub Copilot Setup Steps for xAPI Java
+# This workflow configures the environment for GitHub Copilot agents working on this repository.
+# See: https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/coding-agent/customize-the-agent-environment
+
+name: "Copilot Setup Steps"
+
+# Automatically run the setup steps when they are changed to allow for easy validation, and
+# allow manual testing through the repository's "Actions" tab
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+
+jobs:
+  # The job MUST be called `copilot-setup-steps` or it will not be picked up by Copilot.
+  copilot-setup-steps:
+    runs-on: ubuntu-latest
+
+    # Set the permissions to the lowest permissions possible needed for your steps.
+    # Copilot will be given its own token for its operations.
+    permissions:
+      # Contents read permission is needed to clone the repository to install dependencies
+      contents: read
+
+    # You can define any steps you want, and they will run before the agent starts.
+    # If you do not check out your code, Copilot will do this for you.
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Set up JDK 25
+        uses: actions/setup-java@v5
+        with:
+          java-version: "25"
+          distribution: "temurin"
+          cache: maven
+
+      - name: Build with Maven
+        run: ./mvnw -B clean verify -DskipTests --file pom.xml