Add comprehensive copilot instructions with validated commands and timing requirements #16913
+271
−9
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR adds comprehensive GitHub Copilot instructions to help AI coding agents work effectively with the VS Code Jupyter extension codebase. The instructions provide validated commands, precise timing requirements, and complete development workflows.
Key Features
Validated Command Set: Every command in the instructions has been tested and timed to ensure it works correctly:
npm install
- 15-20 seconds with postinstall scriptsnpm run compile
- 23-25 seconds for TypeScript + ESBuild compilationnpm run test:unittests
- 7-8 seconds for 1159 unit testsnpm run lint
- 27-30 seconds for ESLint validationnpm run format-fix
- 14-15 seconds for auto-formattingCritical Timeout Requirements: The instructions include explicit "NEVER CANCEL" warnings with specific timeout values:
Manual Validation Scenarios: Provides specific end-to-end testing workflows that agents should follow after making changes:
Comprehensive Architecture Context: Documents the repository structure, platform differences (Node.js vs Web), build system details, and common troubleshooting approaches to help agents understand the codebase organization.
Development Workflow Integration: Maintains the existing component-specific instruction references while adding the foundational development commands and processes that were missing.
The instructions follow the imperative tone requirement ("Run this command", "Do not do this") and start with a firm directive to reference these instructions first before falling back to additional search or context gathering.
This ensures GitHub Copilot coding agents can work efficiently with the codebase without getting stuck on long-running builds or making common development workflow mistakes.
Fixes #16912.
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:
0.0.0.123
node /home/REDACTED/work/vscode-jupyter/vscode-jupyter/node_modules/.bin/mocha --config ./build/.mocha.unittests.js.json ./out/interactive-window/generatedCodeStorageManager.unit.test.js ./out/interactive-window/shiftEnterBanner.unit.test.js ./out/kernels/helpers.unit.test.js ./out/kernels/kernelAutoReConnectMonitor.unit.test.js ./out/kernels/kernelAutoRestartMonitor.unit.test.js ./out/kernels/kernelCrashMonitor.unit.test.js ./out/kernels/kernelDependencyService.unit.test.js ./out/kernels/kernelFinder.unit.test.js ./out/kernels/kernelProvider.node.unit.test.js ./out/kernels/kernelProvider.web.unit.test.js ./out/kernels/kernelRefreshIndicator.node.unit.test.js ./out/kernels/kernelRefreshIndicator.web.unit.test.js ./out/test/package.nls.json.unit.test.js
(packet block)update.code.visualstudio.com
node ./out/test/standardTest.node.js
(dns block)If you need me to access, download, or install something from one of these locations, you can either:
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.