Add comprehensive GitHub Copilot instructions for tiger-linear-mcp-server

[Copilot]

Created a detailed .github/copilot-instructions.md file containing comprehensive guidance for GitHub Copilot coding agents working with the tiger-linear-mcp-server codebase.

Key Features

Submodule Management: Detailed instructions for initializing the src/shared/boilerplate git submodule, including SSH-to-HTTPS fallback configuration and troubleshooting steps for the private timescale/mcp-boilerplate-node dependency.

Build & Development Workflow: Complete npm-based development lifecycle with explicit timing expectations:

• Repository setup and environment configuration
• Build commands with "NEVER CANCEL" warnings and 120+ second timeout recommendations
• Development server and watch mode usage
• MCP Inspector testing procedures

Environment Configuration: Step-by-step Linear API key setup and .env file management with required vs optional variables clearly documented.

Testing & Validation: Comprehensive testing procedures including:

• MCP Inspector configuration and usage
• Claude Desktop integration setup with exact JSON configuration
• Manual validation scenarios for changes
• End-to-end workflow testing

Code Navigation: Detailed guidance on repository structure, key directories (src/apis/, src/utils/, chart/), and development patterns for adding new MCP tools following the existing getIssue.ts pattern.

Limitation Handling: Explicit documentation of what works without the submodule (code editing, formatting, individual TypeScript compilation) vs what requires it (building, running, Docker), with workaround development strategies.

Production Deployment: Docker build instructions and Kubernetes Helm chart deployment guidance with accurate timing expectations.

The instructions follow an imperative tone throughout ("Run this command", "Do not do this") and include exhaustive validation guidance to ensure developers can follow them reliably without trial-and-error.

Fixes #2.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

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

• esm.ubuntu.com
  • Triggering command: /usr/lib/apt/methods/https (dns block)
• github.com (HTTP Only)
  • Triggering command: /usr/bin/ssh -o SendEnv=GIT_PROTOCOL [email protected] git-upload-pack 'timescale/mcp-boilerplate-node' (packet block)
• global.endpoint.security.microsoft.com
  • Triggering command: curl --cacert /tmp/tmp.8rNNWAlSZC.pem -s -S -X POST -d { "client": { "appVersion": "101.25062.0003", "hostname": "pkrvmubgrv54qmi", "platform": "Linux", "machineGuid": "6f9197b5-434f-c141-a57d-b96db976da7c", "orgId": "", "releaseRing": "Production", "productGuid":"c65eac3e-401e-4a0c-82e3-f106f693222f" }, "reports":[ { "$type":"installationReport", "timestamp": "1755635942.883832948", "correlation_id": "10a1070c-cafd-421a-9c0a-97cc516bd9ff", "version": "101.25062.0003", "distro": "ubuntu 24.04", "scenario": "Install", "severity": "I", "stage": "preinstall", "code": "preinstStarted", "text": "" } ] } --max-time 5 --connect-timeout 1 REDACTED -o /dev/null -w %{http_code} (dns block)
  • Triggering command: curl --cacert /tmp/tmp.1rvPYwpJuu.pem -s -S -X POST -d { "client": { "appVersion": "101.25062.0003", "hostname": "pkrvmubgrv54qmi", "platform": "Linux", "machineGuid": "6f9197b5-434f-c141-a57d-b96db976da7c", "orgId": "", "releaseRing": "Production", "productGuid":"c65eac3e-401e-4a0c-82e3-f106f693222f" }, "reports":[ { "$type":"installationReport", "timestamp": "1755635943.961453675", "correlation_id": "10a1070c-cafd-421a-9c0a-97cc516bd9ff", "version": "101.25062.0003", "distro": " ", "scenario": "", "severity": "W", "stage": "preinstall", "code": "LogTelemetryFailed", "text": "error_code=1, lineno=625, command='return $result', func='LogTelemetry'" } ] } --max-time 5 --connect-timeout 1 REDACTED -o /dev/null -w %{http_code} (dns block)
  • Triggering command: curl --cacert /tmp/tmp.pNfyDqWOz9.pem -s -S -X POST -d { "client": { "appVersion": "101.25062.0003", "hostname": "pkrvmubgrv54qmi", "platform": "Linux", "machineGuid": "6f9197b5-434f-c141-a57d-b96db976da7c", "orgId": "", "releaseRing": "Production", "productGuid":"c65eac3e-401e-4a0c-82e3-f106f693222f" }, "reports":[ { "$type":"installationReport", "timestamp": "1755635967.529014627", "correlation_id": "10a1070c-cafd-421a-9c0a-97cc516bd9ff", "version": "101.25062.0003", "distro": " ", "scenario": "Install", "severity": "I", "stage": "postinstall", "code": "postinstStarted", "text": "" } ] } --max-time 5 --connect-timeout 1 REDACTED -o /dev/null -w %{http_code} (dns block)
• go.microsoft.com
  • Triggering command: /opt/microsoft/mdatp/sbin/wdavdaemon (dns block)
• metadata.google.internal
  • Triggering command: /opt/microsoft/mdatp/sbin/wdavdaemon (dns block)
• unitedstates.cp.wd.microsoft.com
  • Triggering command: /opt/microsoft/mdatp/sbin/wdavdaemon (dns block)
• unitedstates.x.cp.wd.microsoft.com
  • Triggering command: /opt/microsoft/mdatp/sbin/wdavdaemon (dns block)
• wdcp.microsoft.com
  • Triggering command: /opt/microsoft/mdatp/sbin/wdavdaemon (dns block)
• winatp-gw-cus.microsoft.com
  • Triggering command: /opt/microsoft/mdatp/sbin/wdavdaemon edr 16 15 --log_level info (dns block)
• x.cp.wd.microsoft.com
  • Triggering command: curl -s -S -d { "client": { "appVersion": "101.25062.0003", "hostname": "pkrvmubgrv54qmi", "platform": "Linux", "machineGuid": "6f9197b5-434f-c141-a57d-b96db976da7c", "orgId": "", "releaseRing": "Production", "productGuid":"c65eac3e-401e-4a0c-82e3-f106f693222f" }, "reports":[ { "$type":"installationReport", "timestamp": "1755635942.883832948", "correlation_id": "10a1070c-cafd-421a-9c0a-97cc516bd9ff", "version": "101.25062.0003", "distro": "ubuntu 24.04", "scenario": "Install", "severity": "I", "stage": "preinstall", "code": "preinstStarted", "text": "" } ] } -X POST --max-time 5 --connect-timeout 1 REDACTED (dns block)
  • Triggering command: curl -s -S -d { "client": { "appVersion": "101.25062.0003", "hostname": "pkrvmubgrv54qmi", "platform": "Linux", "machineGuid": "6f9197b5-434f-c141-a57d-b96db976da7c", "orgId": "", "releaseRing": "Production", "productGuid":"c65eac3e-401e-4a0c-82e3-f106f693222f" }, "reports":[ { "$type":"installationReport", "timestamp": "1755635944.971893743", "correlation_id": "10a1070c-cafd-421a-9c0a-97cc516bd9ff", "version": "101.25062.0003", "distro": "ubuntu 24.04", "scenario": "Install", "severity": "C", "stage": "preinstall", "code": "InstallStarted", "text": "is_new_install='1', bundle_version='101.25062.0003', branch='release/linux/2506-2', package=''" } ] } -X POST --max-time 5 --connect-timeout 1 REDACTED (dns block)
  • Triggering command: curl -s -S -d { "client": { "appVersion": "101.25062.0003", "hostname": "pkrvmubgrv54qmi", "platform": "Linux", "machineGuid": "6f9197b5-434f-c141-a57d-b96db976da7c", "orgId": "", "releaseRing": "Production", "productGuid":"c65eac3e-401e-4a0c-82e3-f106f693222f" }, "reports":[ { "$type":"installationReport", "timestamp": "1755635947.041977585", "correlation_id": "10a1070c-cafd-421a-9c0a-97cc516bd9ff", "version": "101.25062.0003", "distro": "ubuntu 24.04", "scenario": "Install", "severity": "W", "stage": "preinstall", "code": "mde_netfilter.socketStopFailed", "text": "Reason=/lib/systemd/system//mde_netfilter.socket does not exist" } ] } -X POST --max-time 5 --connect-timeout 1 REDACTED (dns block)

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

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

@murrayju 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.