Skip to content

Conversation

Copy link

Copilot AI commented Aug 13, 2025

This PR adds a comprehensive .github/copilot-instructions.md file that provides GitHub Copilot with detailed guidance on how to work effectively in this Azure DevOps extension codebase.

What's Included

The instructions provide exhaustive guidance covering:

Build & Development Process

  • Bootstrap commands with validated timing (1-60s for yarn install, 3-15s for yarn install-libs)
  • NEVER CANCEL warnings with specific timeout recommendations (60+ minutes for builds)
  • TypeScript compilation workflow using tsc
  • Test suite execution (43 tests in ~10-15 seconds)

Task-Specific Knowledge

  • Documentation for all 9 Azure DevOps custom build tasks:
    • ReplaceTokens, VersionAssemblies, DacPacReport, Tokenizer, CoverageGate
    • TagBuild, AzureWebDeploy, DockerPublish (deprecated), RouteTraffic
  • Critical Node.js version requirements (DacPacReport requires ≤8.x, fails with Node.js 20+)
  • Manual validation scenarios with example token replacement workflows

Repository Structure & Navigation

  • Complete directory structure with key file locations
  • Common command outputs for quick reference
  • CI/CD pipeline documentation (Azure Pipelines, extension packaging)
  • Development workflow patterns and debugging guidance

Validation Approach

All commands and timings have been exhaustively tested and validated:

  • Fresh dependency installation tested from clean state
  • All 43 tests pass consistently
  • Build timing measurements across multiple runs
  • Special failure cases documented (DacPacReport Node.js limitation)

The instructions start with a firm directive to always follow these instructions first before falling back to additional search, ensuring Copilot uses this validated knowledge as the primary source of truth.

This enables any developer (or Copilot) to immediately become productive in the codebase after a fresh clone, with complete confidence in the documented commands and workflows.

Fixes #221.


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

Copilot AI and others added 2 commits August 13, 2025 17:44
Co-authored-by: colindembovsky <1932561+colindembovsky@users.noreply.github.com>
… timing

Co-authored-by: colindembovsky <1932561+colindembovsky@users.noreply.github.com>
Copilot AI changed the title [WIP] ✨Set up Copilot instructions Add comprehensive GitHub Copilot instructions for repository development workflow Aug 13, 2025
Copilot AI requested a review from colindembovsky August 13, 2025 17:53
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.

✨Set up Copilot instructions

2 participants