vscode-viva icon indicating copy to clipboard operation
vscode-viva copied to clipboard

Update copilot-instructions.md to be more helpful for GitHub Copilot Agent

Open Adam-it opened this issue 4 months ago • 5 comments

Based on my experience from the first issue we assigned to GitHub Copilot agent https://github.com/pnp/vscode-viva/pull/563 I noticed we could add some more information to copilot-instructions.md to be more useful for GH Copilot Agent. We could do a bit of research but things I would already add and point out are:

  • always use contributing.md as context
  • always open a PR that targets dev branch and any changes should start from dev branch
  • never update npm-shrinkwrap.json unless you are adding a new dependency, but then I would not trust any Copilot agent to just pick a new npm package to add to our project. So I would say Copilot agent should never introduce any new npm packages to our repo

Adam-it avatar Aug 20 '25 23:08 Adam-it

in the latest release of VS Code we may also consider adding Agents.md which stores dedicated instructions for agents and not for user run prompts for the repo

Adam-it avatar Sep 15 '25 08:09 Adam-it

@Saurabh7019, @nicodecleyre would you like to add anything before we open it up? I suggest we should focus on the following:

  • clarify that GH Copilot Agent should always use and check the contribution guide from contribution.md file before starting work
  • clarify that all new features should start from dev branch and PRs should target dev branch... and NOOOOOT main
  • do not update npm-shrinkwrap.json unless some new npm package is added to package.json but I would suggest GitHub Copilot should NOT decide it on its own

Adam-it avatar Oct 17 '25 20:10 Adam-it

looks good to me for now. I guess improving instructions would be an on-going work as we let Copilot work on more issues.

Saurabh7019 avatar Oct 23 '25 14:10 Saurabh7019

@Adam-it I can work on this asap.

nirav-raval avatar Oct 29 '25 17:10 nirav-raval

@Adam-it I can work on this asap.

All yours

Adam-it avatar Oct 29 '25 17:10 Adam-it

This issue is now closed. Thank you for the PR, @nirav-raval👌

Saurabh7019 avatar Nov 26 '25 15:11 Saurabh7019